Skip to main content

​
Klaviyo について

Iru は Klaviyo の API から、アカウントユーザーとその権限、API キーとそのスコープ、リストとセグメントのメタデータ、連携の接続 を読み取ります。認証には、設定 → APIキー で作成した プライベート API キー を使用します。Klaviyo のプライベートキーは 作成時にスコープが設定されます。コントロールの対象となるオブジェクトに対して読み取り専用のアクセス権を付与してください。 Iru は メタデータのみ を読み取ります。リストとセグメントの名前と構成は収集されますが、その中のプロフィールは収集されません。

​
仕組み

Klaviyo は 独自の認可スキーム を使用します。ヘッダー値のプレフィックスは Bearer ではなく Klaviyo-API-Key です。また、すべてのリクエストには、API バージョンを固定する ISO 8601 形式の日付を含む revision ヘッダーが必要です。Klaviyo は API のバージョンをパスセグメントではなく日付付きのリビジョンで管理しており、有効なリビジョンがないリクエストは拒否されます。リビジョンは Iru が設定するため、キーのみを指定してください。 リクエストの送信先は https://a.klaviyo.com/api です。構成するサブドメインやアカウントホストはありません。パブリック API キー（クライアント側の購読呼び出しで使用される短い会社 ID）は別の認証情報であり、ここでは認証に使用できません。 公式リファレンス: API リクエストの認証、API のバージョン管理と非推奨化ポリシー。

​
前提条件

  • Klaviyo で API キーを管理 できるアカウントロール。
  • 対象範囲を決定します。Klaviyo ではリストとセグメントの監視を除外でき、除外されたオブジェクトについてはエビデンスが生成されません。

​
Klaviyo を Iru に接続する

Compliance でソースを接続する前に、このタブの手順を完了してください。
1

Klaviyo にサインインする

API キーを管理できるアカウントで Klaviyo にサインインします。
2

設定を開く

左下の アカウントメニュー を開き、設定 を選択します。
3

APIキー を開く

APIキー に移動します。
4

プライベート API キーを作成する

Create private API key を選択します。
5

キーに名前を付けてスコープを設定する

後で連携を監査できるよう、Iru Compliance などのラベルを入力します。キーのアクセスを 読み取り専用 に設定します。カスタムスコープ を使用し、コンプライアンスプログラムの対象となるオブジェクトにのみ読み取りアクセス権を付与します。Accounts、Lists、Segments で Iru が収集するエビデンスをカバーできます。フルアクセスや書き込みスコープは付与しないでください。
6

キーを作成してコピーする

キーを作成し、Klaviyo に表示されている間に値を 一度だけ コピーします。
Iru Compliance タブに進んでください。

​
トラブルシューティング

Iru サイトの ポップアップブロッカー の設定を確認して、もう一度お試しください。
パブリックキーではなく プライベート キーを作成したことを確認してください。パブリックキーはクライアント側の呼び出しで使用される短い会社 ID であり、サーバー間のリクエストを認証することはできません。
プライベートキーが、それらを除外する カスタムスコープ で作成されています。Klaviyo のスコープは作成時に固定されます。必要なスコープを指定して新しいキーを作成してください。
キーにそれらへの読み取りアクセス権がないか、リストとセグメントの監視がこの接続の対象範囲外になっています。
これは想定どおりの動作です。Iru はリストとセグメントの メタデータ を収集し、その中のプロフィールは収集しません。

​
関連記事

Sources の管理

すべての Compliance ソースを参照、管理します。

Compliance を使い始める

フレームワーク、アクション、アーティファクト。

Iru の概要

Endpoint、Compliance、Identity がどのように連携するか。

Artifacts の管理

ソースやアクションから得たエビデンスをアップロード、確認、整理します。