Klaviyoコネクタ構成ガイド

API情報

このコネクタは以下のベンダーAPIを使用します：

• API名：Klaviyo API
• APIバージョン：2025-01-15
• APIエンドポイント：https://a.klaviyo.com/api/
• ドキュメント：Klaviyo APIリファレンス

構成の構成

コネクタマーケットプレイスにアクセスし、新しいコネクタを追加します。コネクタの追加方法については、コネクタについてを参照してください。

コネクタを追加した後、以下の構成を構成します：

• プライベートAPIキー

必須。プライベートAPIキー。詳細については、API認証情報の取得を参照してください。

リストの作成

Klaviyoにまだリストがない場合や新しいリストを作成する必要がある場合は、以下の手順でリストを作成します：

1. コネクタ構成ウィンドウでリスト作成をクリックします。リスト作成ウィンドウが表示されます。
2. リスト名の下にリスト名を入力します。
3. 作成をクリックし、その後完了をクリックします。

アクション

アクション名	AudienceStream	EventStream
ユーザー属性の更新	✓	✗
リストへのユーザー追加（リアルタイム）	✓	✗
リストへのユーザー追加（バッチ処理）	✓	✗
リストからのユーザー削除（リアルタイム）	✓	✗
リストからのユーザー削除（バッチ処理）	✓	✗
プロファイルの作成	✓	✗
プロファイルの作成/更新	✓	✗

アクション名を入力し、ドロップダウンメニューからアクションタイプを選択します。

次のセクションでは、各アクションのパラメータとオプションの構成方法について説明します。

アクション - ユーザー属性の更新

パラメータ

パラメータ	説明
プロファイルID	Klaviyoが各ユーザープロファイルに割り当てる主要な識別子。
外部ID	外部システム（例：販売ポイントシステム）のユーザープロファイルとKlaviyoユーザープロファイルを関連付けるために使用される一意の識別子。形式は外部システムによって異なります。
メール	ユーザープロファイルに関連付けられたメールアドレス。
電話番号	ユーザープロファイルに関連付けられた電話番号。

ユーザー属性

オプションのパラメータ：

パラメータ	説明
メール	個人のメールアドレス。
電話番号	E.164形式の個人の電話番号。
外部ID	外部システム（例：販売ポイントシステム）のユーザープロファイルとKlaviyoユーザープロファイルを関連付けるために使用される一意の識別子。形式は外部システムによって異なります。
匿名ID	Klaviyoがユーザーをメールアドレスと関連付けることができない場合、iOSプロファイルを表す匿名モバイルアプリIDが使用されます。
名	個人の名前。
姓	個人の姓。
組織	個人が勤める会社または組織の名前。
職位	個人の職位。
画像	プロファイル画像の場所を指すURL。
住所1	住所の第一行。
住所2	住所の第二行。
市	市の名前。
国	国の名前。
緯度	緯度座標。小数点以下4桁の精度を推奨します。
経度	経度座標。小数点以下4桁の精度を推奨します。
地域	国内の地域、例えば州や県。
郵便番号	郵便番号。
タイムゾーン	タイムゾーン名。IANAタイムゾーンデータベースからのタイムゾーンを推奨します。
カスタムプロパティ	このプロファイルに割り当てられた任意のカスタムプロパティ。日付属性はISO 8601形式に変換されます。例：2021-09-15 13:34:08+00:00。

アクション - リストへのユーザー追加（リアルタイム）

パラメータ

パラメータ	説明
リスト	ユーザーを追加するリストを選択します。

ユーザー識別子

ユーザーを検索するために以下のいずれかの識別子を選択します：

パラメータ	説明
プロファイルID	Klaviyoが各ユーザープロファイルに割り当てる主要な識別子。
外部ID	顧客が外部システム（例：販売ポイントシステム）のユーザープロファイルとKlaviyoユーザープロファイルを関連付けるために使用する一意の識別子。形式は外部システムによって異なります。
メール	ユーザープロファイルに関連付けられたメールアドレス。
電話番号	ユーザープロファイルに関連付けられた電話番号。

アクション - リストへのユーザー追加（バッチ処理）

バッチ制限

このアクションは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。詳細については、バッチアクションを参照してください。リクエストは、次のいずれかの閾値に達するか、プロファイルが公開されるまでキューに入れられます：

• 最大リクエスト数：1000
• 最古のリクエストからの最大時間：10分
• リクエストの最大サイズ：1 MB

パラメータ

パラメータ	説明
リスト	ユーザーを追加するリストを選択します。

ユーザー識別子

ユーザーを検索するために以下のいずれかの識別子を選択します：

パラメータ	説明
プロファイルID	Klaviyoが各ユーザープロファイルに割り当てる主要な識別子。
外部ID	顧客が外部システム（例：販売ポイントシステム）のユーザープロファイルとKlaviyoユーザープロファイルを関連付けるために使用する一意の識別子。形式は外部システムによって異なります。
メール	ユーザープロファイルに関連付けられたメールアドレス。
電話番号	ユーザープロファイルに関連付けられた電話番号。

アクション - リストからのユーザー削除（リアルタイム）

パラメータ

パラメータ	説明
リスト	ユーザーを追加するリストを選択します。

ユーザー識別子

ユーザーを検索するために以下のいずれかの識別子を選択します：

パラメータ	説明
プロファイルID	Klaviyoが各ユーザープロファイルに割り当てる主要な識別子。
外部ID	顧客が外部システム（例：販売ポイントシステム）のユーザープロファイルとKlaviyoユーザープロファイルを関連付けるために使用する一意の識別子。形式は外部システムによって異なります。
メール	ユーザープロファイルに関連付けられたメールアドレス。
電話番号	ユーザープロファイルに関連付けられた電話番号。

アクション - リストからのユーザー削除（バッチ処理）

バッチ制限

このアクションは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。詳細については、バッチアクションを参照してください。リクエストは、次のいずれかの閾値に達するか、プロファイルが公開されるまでキューに入れられます：

• 最大リクエスト数：1000
• 最古のリクエストからの最大時間：10分
• リクエストの最大サイズ：1 MB

パラメータ

パラメータ	説明
リスト	ユーザーを追加するリストを選択します。

ユーザー識別子

ユーザーを検索するために以下のいずれかの識別子を選択します：

パラメータ	説明
プロファイルID	Klaviyoが各ユーザープロファイルに割り当てる主要な識別子。
外部ID	顧客が外部システム（例：販売ポイントシステム）のユーザープロファイルとKlaviyoユーザープロファイルを関連付けるために使用する一意の識別子。形式は外部システムによって異なります。
メール	ユーザープロファイルに関連付けられたメールアドレス。
電話番号	ユーザープロファイルに関連付けられた電話番号。

アクション - プロファイルの作成

プロファイル属性

パラメータ	説明
Email	個人のメールアドレス。
電話番号	個人の電話番号（E.164形式）。
外部ID	Klaviyoユーザープロファイルを外部システムのユーザープロファイルと関連付けるために使用される一意の識別子。形式は外部システムによって異なります。
匿名ID	モバイルアプリプロファイル用。Klaviyoがユーザーをメールアドレスと関連付けることができない場合、匿名のモバイルアプリIDがiOSプロファイルを表します。
名	個人の名前。
姓	個人の姓。
組織	個人が勤務する会社または組織の名前。
職位	個人の職位。
画像	プロファイル画像のURL。
住所1	住所の第一行目。
住所2	住所の第二行目。
市	市の名前。
国	国の名前。
緯度	緯度座標。小数点以下4桁の精度を推奨します。
経度	経度座標。小数点以下4桁の精度を推奨します。
地域	国内の地域、例えば州や省。
郵便番号	郵便番号または郵便コード。
タイムゾーン	タイムゾーンの名前。IANAタイムゾーンデータベースからのタイムゾーン名の使用を推奨します。
カスタムプロパティ	このプロファイルに割り当てられたカスタムプロパティをマッピングします。日付属性はISO 8601形式に変換されます。例：2021-09-15 13:34:08+00:00。

アクション - プロファイルの作成/更新

プロファイル属性

パラメータ	説明
ID	このプロファイルを一意に識別する主キー。Klaviyoによって生成されます。
メールアドレス	個人のメールアドレス。
電話番号	個人の電話番号（E.164形式）。
外部ID	Klaviyoプロファイルを外部システムのプロファイルと関連付けるために使用される一意の識別子。形式は外部システムによって異なります。
匿名ID	他の識別子が利用できない場合にプロファイルを識別するために使用できるID。
交換ID	exchange_idとしても知られており、Klaviyoのウェブトラッキングによってプロファイルを識別するために使用される暗号化された識別子です。Get Profilesエンドポイントを介してプロファイルを取得する際にこのフィールドをフィルターとして使用できます。
名	個人の名前。
姓	個人の姓。
組織	個人が勤務する会社または組織の名前。
ロケール	プロファイルのロケール。IETF BCP 47言語タグ形式（ISO 639-1/2)-(ISO 3166 alpha-2)。
職位	個人の職位。
プロファイル画像アドレス	プロファイル画像の場所を指すURL。
住所行1	住所の第一行目。
住所行2	住所の第二行目。
市	市の名前。
国	国の名前。
緯度	緯度座標。小数点以下4桁の精度を提供することを推奨します。
経度	経度座標。小数点以下4桁の精度を提供することを推奨します。
地域	国内の地域、例えば州や省。
郵便番号	郵便番号。
タイムゾーン	タイムゾーンの名前。IANAタイムゾーンデータベースからのタイムゾーンの使用を推奨します。
IPアドレス	IPアドレス。
カスタムプロパティ	このプロファイルに割り当てられたカスタムプロパティをマッピングします。日付属性はISO 8601形式に変換されます。例：2021-09-1513:34:08+00:00。
メタ追加プロパティ	このプロパティ配列に追加する単純な値または値を選択します。
メタ削除プロパティ	このプロパティ配列から削除する単純な値または値を選択します。
メタ未構成	プロパティから完全に削除するキーまたはキーを選択します。