接続情報 - Klaviyo

本ページでは、Klaviyoに接続するための設定（接続情報）について説明します。
転送に関する設定については、転送元 - Klaviyoを参照ください。

利用上の注意・制約

認証方式

• Private API Key

設定項目

Klaviyo側で必要な作業

Private API Keyの取得方法

プライベートAPIキーを取得するには、KlaviyoアカウントでOwner、Admin、またはManagerのロールが必要です。

1. Klaviyoにログインします。
2. 画面右上のアカウントアイコンをクリックし、Settingsを選択します。
3. 左側のメニューからAPI Keysタブを選択します。
4. Create Private API Keyボタンをクリックします。
5. APIキーの名称やスコープを設定します。
   • Key Name: TROCCOなど、識別しやすい名前を入力します。
   • Scope: 以下のいずれかを選択します：
     • Read-only: データの閲覧のみ可能（推奨）
     • Full: データの作成、削除、変更が可能
     • Custom: 個別にアクセス権限を設定
6. CreateをクリックしてAPIキーを作成します。
7. 表示されたプライベートAPIキーをコピーして、安全な場所に保存します。

APIキーのスコープ設定

TROCCOはKlaviyoからデータを読み取るだけなので、セキュリティの観点からRead-onlyスコープの使用を推奨します。

Read-onlyスコープで必要な権限

以下のエンドポイントへの読み取りアクセスが必要です。

• Campaigns
• Events
• Flows
• Lists
• Metrics
• Profiles
• Reviews
• Segments

困ったときには・トラブルシューティング

認証エラーが発生する

Error: 400 Bad Request - Invalid or missing API key

考えられる原因

• プライベートAPIキーが正しく入力されていない可能性があります。
• APIキーが削除されている可能性があります。
• 異なるKlaviyoアカウントのAPIキーを使用している可能性があります。

対処方法

1. 入力したAPIキーがpk_で始まることを確認してください。
2. APIキーに不要なスペースや改行が含まれていないか確認してください。
3. Klaviyoの管理画面でAPIキーが有効であることを確認してください。
4. 必要に応じて、新しいAPIキーを作成して再度設定してください。

アクセス権限エラーが発生する

考えられる原因

• APIキーのスコープが不足している可能性があります。
• Klaviyoアカウントのロールが変更された可能性があります。

対処方法

1. KlaviyoのAPI Keys設定画面で、使用しているAPIキーのスコープを確認してください。
2. TROCCOで必要なデータの読み取り権限があることを確認してください。
3. 必要に応じて、適切なスコープを持つ新しいAPIキーを作成してください。