この記事では、Klaviyoコネクタの構成方法について説明します。
API情報
このコネクタは、次のベンダーAPIを使用します。
- API名:Klaviyo API
- APIバージョン:2026-01-15
- APIエンドポイント:
https://a.klaviyo.com/api/ - ドキュメント:Klaviyo APIリファレンス
構成
コネクタマーケットプレイスに移動し、新しいコネクタを追加します。詳細については、コネクタについてを参照してください。
コネクタを追加した後、次の項目を構成します。
- プライベートAPIキー
(必須)プライベートAPIキー。詳細については、API認証情報の取得を参照してください。
リストの作成
Klaviyoにリストがまだない場合、または新しいリストを作成する必要がある場合は、次の手順でリストを作成します。
- コネクタ構成ウィンドウで、リストを作成をクリックします。リストを作成ウィンドウが表示されます。
- リスト名にリスト名を入力します。
- 作成をクリックし、次に完了をクリックします。
アクション
| アクション名 | 訪問プロファイル | イベントデータ |
|---|---|---|
| ユーザー属性を更新 | ✓ | ✗ |
| ユーザーをリストに追加(リアルタイム) | ✓ | ✗ |
| ユーザーをリストに追加(バッチ) | ✓ | ✗ |
| ユーザーをリストから削除(リアルタイム) | ✓ | ✗ |
| ユーザーをリストから削除(バッチ) | ✓ | ✗ |
| プロファイルを作成 | ✓ | ✗ |
| プロファイルを作成/更新 | ✓ | ✗ |
アクションの名前を入力し、ドロップダウンメニューからアクションタイプを選択します。
次のセクションでは、各アクションのパラメーターとオプションを構成する方法について説明します。
アクション - ユーザー属性を更新
パラメーター
| パラメーター | 説明 |
|---|---|
| プロファイルID | Klaviyoが各ユーザープロファイルに割り当てるプライマリ識別子。 |
| 外部ID | Klaviyoのユーザープロファイルを、POSシステムなどの外部システム内のユーザープロファイルに関連付けるために使用される一意の識別子。形式は外部システムによって異なります。 |
| メールアドレス | ユーザープロファイルに関連付けられたメールアドレス。 |
| 電話番号 | ユーザープロファイルに関連付けられた電話番号。 |
ユーザー属性
オプションのパラメーター:
| パラメーター | 説明 |
|---|---|
| メールアドレス | 個人のメールアドレス。 |
| 電話番号 | E.164形式の個人の電話番号。 |
| 外部ID | Klaviyoのユーザープロファイルを、POSシステムなどの外部システム内のユーザープロファイルに関連付けるために使用される一意の識別子。形式は外部システムによって異なります。 |
| 匿名ID | モバイルアプリのプロファイルについて、Klaviyoがユーザーをメールアドレスに関連付けられない場合、匿名のモバイルアプリIDがiOSプロファイルを表します。 |
| 名 | 個人の名。 |
| 姓 | 個人の姓。 |
| 組織 | 個人が勤務する会社または社内組織の名前。 |
| 役職 | 個人の役職。 |
| 画像 | プロファイル画像の場所を指すURL。 |
| 住所1 | 番地などを含む住所の1行目。 |
| 住所2 | 建物名などを含む住所の2行目。 |
| 市区町村 | 市区町村名。 |
| 国 | 国名。 |
| 緯度 | 緯度座標。小数点以下4桁の精度を推奨します。 |
| 経度 | 経度座標。小数点以下4桁の精度を推奨します。 |
| 地域 | 州や都道府県など、国内の地域。 |
| 郵便番号 | 郵便番号。 |
| タイムゾーン | タイムゾーン名。IANAタイムゾーンデータベースのタイムゾーンを推奨します。 |
| カスタムプロパティ | このプロファイルに割り当てられている任意のカスタムプロパティをマッピングします。日付属性はISO 8601形式に変換されます。例:2021-09-15 13:34:08+00:00。 |
アクション - ユーザーをリストに追加(リアルタイム)
パラメーター
| パラメーター | 説明 |
|---|---|
| リスト | ユーザーを追加するリストを選択します。 |
ユーザー識別子
ユーザーを検索するために、次のいずれかの識別子を選択します。
| パラメーター | 説明 |
|---|---|
| プロファイルID | Klaviyoが各ユーザープロファイルに割り当てるプライマリ識別子。 |
| 外部ID | Klaviyoのユーザープロファイルを、POSシステムなどの外部システム内のユーザープロファイルに関連付けるために顧客が使用する一意の識別子。形式は外部システムによって異なります。 |
| メールアドレス | ユーザープロファイルに関連付けられたメールアドレス。 |
| 電話番号 | ユーザープロファイルに関連付けられた電話番号。 |
アクション - ユーザーをリストに追加(バッチ)
バッチ制限
このアクションでは、ベンダーへの大容量データ転送をサポートするためにバッチリクエストを使用します。詳細については、バッチアクションを参照してください。次のいずれかのしきい値に達するか、プロファイルが公開されるまで、リクエストはキューに入れられます。
- リクエストの最大数:1000
- 最も古いリクエストからの最大経過時間:10分
- リクエストの最大サイズ:1 MB
パラメーター
| パラメーター | 説明 |
|---|---|
| リスト | ユーザーを追加するリストを選択します。 |
ユーザー識別子
ユーザーを検索するために、次のいずれかの識別子を選択します。
| パラメーター | 説明 |
|---|---|
| プロファイルID | Klaviyoが各ユーザープロファイルに割り当てるプライマリ識別子。 |
| 外部ID | Klaviyoのユーザープロファイルを、POSシステムなどの外部システム内のユーザープロファイルに関連付けるために顧客が使用する一意の識別子。形式は外部システムによって異なります。 |
| メールアドレス | ユーザープロファイルに関連付けられたメールアドレス。 |
| 電話番号 | ユーザープロファイルに関連付けられた電話番号。 |
アクション - ユーザーをリストから削除(リアルタイム)
パラメーター
| パラメーター | 説明 |
|---|---|
| リスト | ユーザーを追加するリストを選択します。 |
ユーザー識別子
ユーザーを検索するために、次のいずれかの識別子を選択します。
| パラメーター | 説明 |
|---|---|
| プロファイルID | Klaviyoが各ユーザープロファイルに割り当てるプライマリ識別子。 |
| 外部ID | Klaviyoのユーザープロファイルを、POSシステムなどの外部システム内のユーザープロファイルに関連付けるために顧客が使用する一意の識別子。形式は外部システムによって異なります。 |
| メールアドレス | ユーザープロファイルに関連付けられたメールアドレス。 |
| 電話番号 | ユーザープロファイルに関連付けられた電話番号。 |
アクション - ユーザーをリストから削除(バッチ)
バッチ制限
このアクションでは、ベンダーへの大容量データ転送をサポートするためにバッチリクエストを使用します。詳細については、バッチアクションを参照してください。次のいずれかのしきい値に達するか、プロファイルが公開されるまで、リクエストはキューに入れられます。
- リクエストの最大数:1000
- 最も古いリクエストからの最大経過時間:10分
- リクエストの最大サイズ:1 MB
パラメーター
| パラメーター | 説明 |
|---|---|
| リスト | ユーザーを追加するリストを選択します。 |
ユーザー識別子
ユーザーを検索するために、次のいずれかの識別子を選択します。
| パラメーター | 説明 |
|---|---|
| プロファイルID | Klaviyoが各ユーザープロファイルに割り当てるプライマリ識別子。 |
| 外部ID | Klaviyoのユーザープロファイルを、POSシステムなどの外部システム内のユーザープロファイルに関連付けるために顧客が使用する一意の識別子。形式は外部システムによって異なります。 |
| メールアドレス | ユーザープロファイルに関連付けられたメールアドレス。 |
| 電話番号 | ユーザープロファイルに関連付けられた電話番号。 |
アクション - プロファイルを作成
プロファイル属性
| パラメーター | 説明 |
|---|---|
| メールアドレス | 個人のメールアドレス。 |
| 電話番号 | E.164 形式の個人の電話番号。 |
| 外部 ID | Klaviyo のユーザープロファイルを、POS システムなどの外部システム内のユーザープロファイルに関連付けるために使用される一意の識別子。形式は外部システムによって異なります。 |
| 匿名 ID | モバイルアプリのプロファイル用。Klaviyo がユーザーをメールアドレスに関連付けられない場合、匿名のモバイルアプリ ID が iOS プロファイルを表します。 |
| 名 | 個人の名。 |
| 姓 | 個人の姓。 |
| 組織 | 個人が勤務する会社または社内組織の名前。 |
| 役職 | 個人の役職。 |
| 画像 | プロファイル画像の URL。 |
| 住所 1 | 住所の1行目。 |
| 住所 2 | 住所の2行目。 |
| 市区町村 | 市区町村名。 |
| 国 | 国名。 |
| 緯度 | 緯度座標。小数点以下4桁の精度を推奨します。 |
| 経度 | 経度座標。小数点以下4桁の精度を推奨します。 |
| 地域 | 州や省など、国内の地域。 |
| 郵便番号 | 郵便番号。 |
| タイムゾーン | タイムゾーン名。IANA Time Zone Database のタイムゾーン名を使用することを推奨します。 |
| カスタムプロパティ | このプロファイルに割り当てられたカスタムプロパティをマッピングします。日付属性は ISO 8601 形式に変換されます。例:2021-09-15 13:34:08+00:00。 |
アクション - プロファイルの作成/更新
プロファイル属性
| パラメーター | 説明 |
|---|---|
| ID | このプロファイルを一意に識別する主キー。Klaviyo によって生成されます。 |
| メールアドレス | 個人のメールアドレス。 |
| 電話番号 | E.164 形式の個人の電話番号。 |
| 外部 ID | Klaviyo のプロファイルを、POS システムなどの外部システム内のプロファイルに関連付けるために使用される一意の識別子。形式は外部システムによって異なります。 |
| 匿名 ID | 他の識別子が利用できない場合にプロファイルを識別するために使用できる ID。 |
| Exchange ID | exchange_id とも呼ばれる、Klaviyo のウェブトラッキングでプロファイルを識別するために使用される暗号化された識別子。Get Profiles エンドポイントを介してプロファイルを取得する際、このフィールドをフィルターとして使用できます。 |
| 名 | 個人の名。 |
| 姓 | 個人の姓。 |
| 組織 | 個人が勤務する会社または社内組織の名前。 |
| ロケール | プロファイルのロケール。(ISO 639-1/2)-(ISO 3166 alpha-2) のような IETF BCP 47 言語タグ形式です。 |
| 役職 | 個人の役職。 |
| プロファイル画像アドレス | プロファイル画像の場所を指す URL。 |
| 住所 1 | 住所の1行目。 |
| 住所 2 | 住所の2行目。 |
| 市区町村 | 市区町村名。 |
| 国 | 国名。 |
| 緯度 | 緯度座標。小数点以下4桁の精度で指定することを推奨します。 |
| 経度 | 経度座標。小数点以下4桁の精度で指定することを推奨します。 |
| 地域 | 州や省など、国内の地域。 |
| 郵便番号 | 郵便番号。 |
| タイムゾーン | タイムゾーン名。IANA Time Zone Database のタイムゾーンを使用することを推奨します。 |
| IP アドレス | IP アドレス。 |
| カスタムプロパティ | このプロファイルに割り当てられたカスタムプロパティをマッピングします。日付属性は ISO 8601 形式に変換されます。例:2021-09-1513:34:08+00:00。 |
| メタ追加プロパティ | このプロパティ配列に追加する単純な値(単一または複数)を選択します。 |
| メタ追加解除プロパティ | このプロパティ配列から削除する単純な値(単一または複数)を選択します。 |
| メタ構成解除 | 値とともにプロパティから完全に削除するキー(単一または複数)を選択します。 |
最終更新日 :: 2026年November月10日