--- title: Klaviyoコネクタ構成ガイド description: この記事では、Klaviyoコネクタの構成方法について説明します。 url: https://docs.tealium.com/ja/server-side-connectors/klaviyo-connector/ --- ## API情報 このコネクタは以下のベンダーAPIを使用します： * API名：Klaviyo API * APIバージョン：2026-01-15 * APIエンドポイント：`https://a.klaviyo.com/api/` * ドキュメント：[Klaviyo APIリファレンス](https://developers.klaviyo.com/en/reference/api_overview) ## 構成の構成 コネクタマーケットプレイスにアクセスし、新しいコネクタを追加します。コネクタを追加する一般的な手順については、[コネクタについて](https://docs.tealium.com/about-connectors/)を参照してください。 コネクタを追加した後、以下の構成を構成します： * **プライベートAPIキー** （必須）プライベートAPIキー。詳細については、[API認証情報の取得](https://developers.klaviyo.com/en/docs/retrieve_api_credentials)を参照してください。 ### リストの作成 Klaviyoにまだリストがない場合や新しいリストを作成する必要がある場合は、以下の手順でリストを作成します： 1. **コネクタ構成**ウィンドウで**リスト作成**をクリックします。**リスト作成**ウィンドウが表示されます。 2. **リスト名**の下にリスト名を入力します。 3. **作成**をクリックし、次に**完了**をクリックします。 ## アクション | アクション名 | AudienceStream | EventStream | | --- | :---: | :---: | | ユーザー属性の更新 | ✓ | ✗ | | リストへのユーザー追加（リアルタイム） | ✓ | ✗ | | リストへのユーザー追加（バッチ処理） | ✓ | ✗ | | リストからのユーザー削除（リアルタイム） | ✓ | ✗ | | リストからのユーザー削除（バッチ処理） | ✓ | ✗ | | プロファイルの作成 | ✓ | ✗ | | プロファイルの作成/更新 | ✓ | ✗ | アクション名を入力し、ドロップダウンメニューからアクションタイプを選択します。 次のセクションでは、各アクションのパラメータとオプションの構成方法について説明します。 ### アクション - ユーザー属性の更新 #### パラメータ | **パラメータ** | **説明** | | --- | --- | | プロファイルID | Klaviyoが各ユーザープロファイルに割り当てる主要な識別子。 | | 外部ID | 外部システム（例：販売ポイントシステム）のユーザープロファイルとKlaviyoユーザープロファイルを関連付けるために使用される一意の識別子。形式は外部システムによって異なります。 | | メール | ユーザープロファイルに関連付けられたメールアドレス。 | | 電話番号 | ユーザープロファイルに関連付けられた電話番号。 | #### ユーザー属性 オプションのパラメータ： | **パラメータ** | **説明** | | --- | --- | | メール | 個人のメールアドレス。 | | 電話番号 | [E.164](https://en.wikipedia.org/wiki/E.164)形式の個人の電話番号。 | | 外部ID | 外部システム（例：販売ポイントシステム）のユーザープロファイルとKlaviyoユーザープロファイルを関連付けるために使用される一意の識別子。形式は外部システムによって異なります。 | | 匿名ID | Klaviyoがユーザーをメールアドレスと関連付けることができない場合、iOSプロファイルを表す匿名モバイルアプリID。 | | 名 | 個人の名前。 | | 姓 | 個人の姓。 | | 組織 | 個人が勤める会社または組織の名前。 | | 職位 | 個人の職位。 | | 画像 | プロファイル画像の場所を指すURL。 | | 住所1 | 住所の第一行。 | | 住所2 | 住所の第二行。 | | 市 | 市の名前。 | | 国 | 国の名前。 | | 緯度 | 緯度座標。小数点以下4桁の精度を推奨します。 | | 経度 | 経度座標。小数点以下4桁の精度を推奨します。 | | 地域 | 国内の地域、例えば州や省。 | | 郵便番号 | 郵便番号。 | | タイムゾーン | タイムゾーン名。[IANAタイムゾーンデータベース](https://www.iana.org/time-zones)からのタイムゾーンを推奨します。 | | カスタムプロパティ | このプロファイルに割り当てられた任意のカスタムプロパティ。日付属性はISO 8601形式に変換されます。例：`2021-09-15 13:34:08+00:00`。| ### アクション - リストへのユーザー追加（リアルタイム） #### パラメータ | **パラメータ** | **説明** | | --- | --- | | リスト | ユーザーを追加するリストを選択します。 | #### ユーザー識別子 ユーザーを検索するために以下のいずれかの識別子を選択します： | **パラメータ** | **説明** | | --- | --- | | プロファイルID | Klaviyoが各ユーザープロファイルに割り当てる主要な識別子。 | | 外部ID | 顧客が外部システム（例：販売ポイントシステム）のユーザープロファイルとKlaviyoユーザープロファイルを関連付けるために使用する一意の識別子。形式は外部システムによって異なります。 | | メール | ユーザープロファイルに関連付けられたメールアドレス。 | | 電話番号 | ユーザープロファイルに関連付けられた電話番号。 | ### アクション - リストへのユーザー追加（バッチ処理） #### バッチ制限 このアクションは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。詳細については、[バッチアクション](https://docs.tealium.com/batched-actions/)を参照してください。リクエストは、次のいずれかの閾値に達するか、プロファイルが公開されるまでキューに入れられます： * 最大リクエスト数：1000 * 最古のリクエストからの最大時間：10分 * リクエストの最大サイズ：1 MB #### パラメータ | **パラメータ** | **説明** | | --- | --- | | リスト | ユーザーを追加するリストを選択します。 | #### ユーザー識別子 ユーザーを検索するために以下のいずれかの識別子を選択します： | **パラメータ** | **説明** | | --- | --- | | プロファイルID | Klaviyoが各ユーザープロファイルに割り当てる主要な識別子。 | | 外部ID | 顧客が外部システム（例：販売ポイントシステム）のユーザープロファイルとKlaviyoユーザープロファイルを関連付けるために使用する一意の識別子。形式は外部システムによって異なります。 | | メール | ユーザープロファイルに関連付けられたメールアドレス。 | | 電話番号 | ユーザープロファイルに関連付けられた電話番号。 | ### アクション - リストからのユーザー削除（リアルタイム） #### パラメータ | **パラメータ** | **説明** | | --- | --- | | リスト | ユーザーを追加するリストを選択します。 | #### ユーザー識別子 ユーザーを検索するために以下のいずれかの識別子を選択します： | **パラメータ** | **説明** | | --- | --- | | プロファイルID | Klaviyoが各ユーザープロファイルに割り当てる主要な識別子。 | | 外部ID | 顧客が外部システム（例：販売ポイントシステム）のユーザープロファイルとKlaviyoユーザープロファイルを関連付けるために使用する一意の識別子。形式は外部システムによって異なります。 | | メール | ユーザープロファイルに関連付けられたメールアドレス。 | | 電話番号 | ユーザープロファイルに関連付けられた電話番号。 | ### アクション - リストからのユーザー削除（バッチ処理） #### バッチ制限 このアクションは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。詳細については、[バッチアクション](https://docs.tealium.com/batched-actions/)を参照してください。リクエストは、次のいずれかの閾値に達するか、プロファイルが公開されるまでキューに入れられます： * 最大リクエスト数：1000 * 最古のリクエストからの最大時間：10分 * リクエストの最大サイズ：1 MB #### パラメータ | **パラメータ** | **説明** | | --- | --- | | リスト | ユーザーを追加するリストを選択します。 | #### ユーザー識別子 ユーザーを検索するために以下のいずれかの識別子を選択します： | **パラメータ** | **説明** | | --- | --- | | プロファイルID | Klaviyoが各ユーザープロファイルに割り当てる主要な識別子。 | | 外部ID | 顧客が外部システム（例：販売ポイントシステム）のユーザープロファイルとKlaviyoユーザープロファイルを関連付けるために使用する一意の識別子。形式は外部システムによって異なります。 | | メール | ユーザープロファイルに関連付けられたメールアドレス。 | | 電話番号 | ユーザープロファイルに関連付けられた電話番号。 | ### アクション - プロファイルの作成 #### プロファイル属性 | **パラメータ** | **説明** | | --- | --- | | Email | 個人のメールアドレス。 | | 電話番号 | 個人の電話番号（[E.164](https://en.wikipedia.org/wiki/E.164)形式）。 | | 外部ID | Klaviyoユーザープロファイルを外部システム（例：販売ポイントシステム）のユーザープロファイルと関連付けるために使用される一意の識別子。形式は外部システムによって異なります。 | | 匿名ID | モバイルアプリプロファイル用。Klaviyoがユーザーをメールアドレスと関連付けることができない場合、匿名のモバイルアプリIDがiOSプロファイルを表します。 | | 名 | 個人の名前。 | | 姓 | 個人の姓。 | | 組織 | 個人が勤務する会社または組織の名前。 | | 職位 | 個人の職位。 | | 画像 | プロファイル画像のURL。 | | 住所1 | 住所の第一行目。 | | 住所2 | 住所の第二行目。 | | 市区町村 | 市区町村名。 | | 国 | 国名。 | | 緯度 | 緯度座標。小数点以下4桁の精度を推奨します。 | | 経度 | 経度座標。小数点以下4桁の精度を推奨します。 | | 地域 | 国内の地域、例えば州や省。 | | 郵便番号 | 郵便番号または郵便コード。 | | タイムゾーン | タイムゾーン名。[IANAタイムゾーンデータベース](https://www.iana.org/time-zones)からのタイムゾーン名の使用を推奨します。 | | カスタムプロパティ | このプロファイルに割り当てられたカスタムプロパティをマッピングします。日付属性はISO 8601形式に変換されます。例：`2021-09-15 13:34:08+00:00`。| ### アクション - プロファイルの作成/更新 #### プロファイル属性 | **パラメータ** | **説明** | | --- | --- | | ID | このプロファイルを一意に識別する主キー。Klaviyoによって生成されます。 | | メールアドレス | 個人のメールアドレス。 | | 電話番号 | 個人の電話番号（[E.164](https://en.wikipedia.org/wiki/E.164)形式）。 | | 外部ID | Klaviyoプロファイルを外部システムのプロファイルと関連付けるために使用される一意の識別子。形式は外部システムによって異なります。 | | 匿名ID | 他の識別子が利用できない場合にプロファイルを識別するために使用できるID。 | | 交換ID | `exchange_id`としても知られており、Klaviyoのウェブトラッキングによってプロファイルを識別するために使用される暗号化された識別子です。プロファイルを取得するGet Profilesエンドポイントでこのフィールドをフィルターとして使用できます。 | | 名 | 個人の名前。 | | 姓 | 個人の姓。 | | 組織 | 個人が勤務する会社または組織の名前。 | | ロケール | プロファイルのロケール。[IETF BCP 47](https://en.wikipedia.org/wiki/IETF_language_tag)言語タグ形式（ISO 639-1/2)-(ISO 3166 alpha-2)。 | | 職位 | 個人の職位。 | | プロファイル画像アドレス | プロファイル画像の場所を指すURL。 | | 住所行1 | 住所の第一行目。 | | 住所行2 | 住所の第二行目。 | | 市区町村 | 市区町村名。 | | 国 | 国名。 | | 緯度 | 緯度座標。小数点以下4桁の精度を推奨します。 | | 経度 | 経度座標。小数点以下4桁の精度を推奨します。 | | 地域 | 国内の地域、例えば州や省。 | | 郵便番号 | 郵便番号。 | | タイムゾーン | タイムゾーン名。[IANAタイムゾーンデータベース](https://www.iana.org/time-zones)からのタイムゾーン名の使用を推奨します。 | | IPアドレス | IPアドレス。 | | カスタムプロパティ | このプロファイルに割り当てられたカスタムプロパティをマッピングします。日付属性はISO 8601形式に変換されます。例：`2021-09-1513:34:08+00:00`。 | | メタ追加プロパティ | このプロパティ配列に追加する単純な値または値を選択します。 | | メタ削除プロパティ | このプロパティ配列から削除する単純な値または値を選択します。 | | メタ削除 | プロパティから完全に削除するキーまたはキーを選択します。