> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iru.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Klaviyo

> スコープを限定した読み取り専用のプライベート API キーを使用して Klaviyo を Iru Compliance に接続し、アカウントユーザーのアクセス、スコープを含む API キーのインベントリ、リストとセグメントのメタデータを収集します。

### Klaviyo について

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

Iru は **メタデータのみ** を読み取ります。リストとセグメントの名前と構成は収集されますが、**その中のプロフィールは収集されません**。

### 仕組み

```http theme={null}
Authorization: Klaviyo-API-Key YOUR_PRIVATE_API_KEY
revision: 2024-10-15
```

Klaviyo は **独自の認可スキーム** を使用します。ヘッダー値のプレフィックスは `Bearer` ではなく `Klaviyo-API-Key` です。また、すべてのリクエストには、API バージョンを固定する ISO 8601 形式の日付を含む **`revision`** ヘッダーが必要です。Klaviyo は API のバージョンをパスセグメントではなく日付付きのリビジョンで管理しており、有効なリビジョンがないリクエストは拒否されます。リビジョンは Iru が設定するため、キーのみを指定してください。

リクエストの送信先は `https://a.klaviyo.com/api` です。構成するサブドメインやアカウントホストはありません。**パブリック** API キー（クライアント側の購読呼び出しで使用される短い会社 ID）は別の認証情報であり、ここでは認証に使用できません。

| 項目 | 値 |
| - | - |
| **カテゴリ** | マーケティング |
| **認証** | Klaviyo-API-Key（プライベート API キー） |

公式リファレンス: [API リクエストの認証](https://developers.klaviyo.com/en/docs/authenticate_)、[API のバージョン管理と非推奨化ポリシー](https://developers.klaviyo.com/en/docs/api_versioning_and_deprecation_policy)。

### 前提条件

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

### Klaviyo を Iru に接続する

<Tabs>
  <Tab title="Klaviyo">
    <Note>
      Compliance でソースを接続する前に、このタブの手順を完了してください。
    </Note>

    <Steps>
      <Step title="Klaviyo にサインインする">
        API キーを管理できるアカウントで Klaviyo にサインインします。
      </Step>

      <Step title="設定を開く">
        左下の **アカウントメニュー** を開き、**設定** を選択します。
      </Step>

      <Step title="APIキー を開く">
        **APIキー** に移動します。
      </Step>

      <Step title="プライベート API キーを作成する">
        **Create private API key** を選択します。
      </Step>

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

      <Step title="キーを作成してコピーする">
        キーを作成し、Klaviyo に表示されている間に値を **一度だけ** コピーします。
      </Step>
    </Steps>

    <Note>
      [**Iru Compliance**](#iru-compliance) タブに進んでください。
    </Note>
  </Tab>

  <Tab title="Iru Compliance">
    <Note>
      先に [**Klaviyo**](#klaviyo) タブの手順を完了してください。
    </Note>

    <Steps>
      <Step title="ソースを開く">
        Iru Compliance の左側のナビゲーションバーで **コンプライアンス** を展開し、**ソース** を選択します。

        <Frame>
          <img src="https://mintcdn.com/iru/tI0HDLDwHj8r9Ile/assets/media/images/iru-navigation-compliance-sources.png?fit=max&auto=format&n=tI0HDLDwHj8r9Ile&q=85&s=87dcef15fc17d2fb9a6e53f454e41710" alt="左側のナビゲーション: Compliance を展開し、Sources を選択した状態" width="410" height="1024" data-path="assets/media/images/iru-navigation-compliance-sources.png" />
        </Frame>
      </Step>

      <Step title="Klaviyo をオンにする">
        **Klaviyo** を探します（**カテゴリ** または **名前または説明で検索** を使用します）。そのカードで **トグル** をオンにします。コネクタウィザード用のブラウザタブまたはウィンドウが開く場合があります。
      </Step>

      <Step title="プライベート API キーを貼り付ける">
        **プライベート API キー** を貼り付けます。
      </Step>

      <Step title="接続を完了する">
        **資格情報を送信** を選択します。接続に成功すると、ウィザードに **接続が構成されました** と表示されます。
      </Step>

      <Step title="ソースが有効であることを確認する">
        **Iru が外部サービスへのアクセスをリクエストしています** のブラウザタブを閉じてから **コンプライアンス** → **ソース** に戻り、**Klaviyo** カードが **有効** になっていることを確認します。
      </Step>
    </Steps>
  </Tab>
</Tabs>

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

<AccordionGroup>
  <Accordion title="ソースをオンにしても何も開かない">
    Iru サイトの **ポップアップブロッカー** の設定を確認して、もう一度お試しください。
  </Accordion>

  <Accordion title="認証が失敗する">
    パブリックキーではなく **プライベート** キーを作成したことを確認してください。パブリックキーはクライアント側の呼び出しで使用される短い会社 ID であり、サーバー間のリクエストを認証することはできません。
  </Accordion>

  <Accordion title="一部のオブジェクトで 403 が返される">
    プライベートキーが、それらを除外する **カスタムスコープ** で作成されています。Klaviyo のスコープは作成時に固定されます。必要なスコープを指定して新しいキーを作成してください。
  </Accordion>

  <Accordion title="リストとセグメントが表示されない">
    キーにそれらへの読み取りアクセス権がないか、リストとセグメントの監視がこの接続の対象範囲外になっています。
  </Accordion>

  <Accordion title="プロフィールデータが表示されない">
    これは想定どおりの動作です。Iru はリストとセグメントの **メタデータ** を収集し、その中のプロフィールは収集しません。
  </Accordion>
</AccordionGroup>

### 関連記事

<CardGroup cols={2}>
  <Card title="Sources の管理" icon="plug" href="/ja/compliance/sources-management">
    すべての Compliance ソースを参照、管理します。
  </Card>

  <Card title="Compliance を使い始める" icon="rocket" href="/ja/compliance/getting-started-with-compliance">
    フレームワーク、アクション、**アーティファクト**。
  </Card>

  <Card title="Iru の概要" icon="layer-group" href="/ja/iru/platform-overview/iru-overview">
    Endpoint、Compliance、Identity がどのように連携するか。
  </Card>

  <Card title="Artifacts の管理" icon="folder-open" href="/ja/compliance/artifacts-management">
    ソースやアクションから得たエビデンスをアップロード、確認、整理します。
  </Card>
</CardGroup>