Iterable コネクタ構成ガイド
この記事では、Iterable コネクタの構成方法について説明します。
構成
コネクタマーケットプレイスにアクセスし、新しいコネクタを追加します。詳細については、コネクタについてを参照してください。
コネクタを追加した後、以下の構成を構成します：
- ホスト
- EUベースのAPIエンドポイントの場合、https://app.eu.iterable.com を選択します。
- USベースのAPIエンドポイントの場合、https://app.iterable.com を選択します。
- API キー: Iterable API キーを入力します。
API キーを見つけるには、Iterable サイトで Integrations > API Keys にある Iterable Connector メニューにアクセスします。
アクション
| アクション名 | AudienceStream | EventStream |
|---|---|---|
| イベント追跡（バッチ処理） | ✗ | ✓ |
| ユーザー追加（バッチ処理） | ✓ | ✓ |
| GDPRに準拠してユーザーを削除 | ✓ | ✓ |
| ユーザーにSMS通知を送信 | ✓ | ✓ |
| メールアドレスにメールを送信 | ✓ | ✓ |
| ワークフローをトリガー | ✓ | ✓ |
| ユーザーをサブスクリプションに追加 | ✓ | ✗ |
| ユーザーをサブスクリプションから削除 | ✓ | ✗ |
| ユーザーをリストに登録 | ✓ | ✗ |
| ユーザーをリストから解除 | ✓ | ✗ |
| ユーザーのメールを更新 | ✓ | ✓ |
| ショッピングカートを更新 | ✓ | ✓ |
| 購入を追跡 | ✓ | ✓ |
| 顧客データをマージ | ✓ | ✓ |
次へ をクリックするか、アクション タブに進みます。
次のセクションでは、各アクションのパラメータとオプションの構成方法について説明します。
イベント追跡（バッチ処理）
バッチ制限
このアクションは、バッチリクエストを使用してベンダーへの大量データ転送をサポートします。詳細については、バッチアクションを参照してください。次のいずれかの閾値に達するか、プロファイルが公開されるまでリクエストがキューに入れられます：
- 最大リクエスト数：1000
- 最古のリクエストからの最大時間：10分
- リクエストの最大サイズ：4 MB
パラメータ
| パラメータ | 説明 |
|---|---|
| イベント名 | (必須) イベントの名前。 |
| 作成日時 | イベントが発生した時間。指定されていない場合は、イベントが受信された時間に構成されます。Unixタイムスタンプを期待します。このフィールドがマッピングされていない場合、現在のタイムスタンプで初期化されます。 |
| メール | メール または ユーザーID のいずれかを入力してユーザーを識別する必要があります。両方が入力されている場合は、メール が優先されます。 |
| イベントID | 入力されたIDのイベントが存在する場合、そのイベントは更新されます。イベントID が指定されていない場合、新しいIDが自動的に生成されて返されます。このIDは512バイトを超えることはできません。 |
| ユーザーID | updateUser コールに渡されたユーザーID。 |
| キャンペーン |
|
| プロジェクトテンプレート | テンプレートID。詳細については、Iterable: テンプレートの紹介を参照してください。 |
| データフィールド | イベントに関連する追加データ。例：アイテムの金額や数量。同じ名前のイベントの場合、同じ名前のデータフィールドは同じタイプでなければなりません。 |
| テンプレート変数 |
|
| テンプレート |
|
| APIキーオーバーライド | APIキーを入力するか、APIキーの属性をマッピングして、コネクタ構成で指定されたAPIキーをオーバーライドします。 |
ユーザー追加（バッチ処理）
バッチ制限
このアクションは、バッチリクエストを使用してベンダーへの大量データ転送をサポートします。詳細については、バッチアクションを参照してください。次のいずれかの閾値に達するか、プロファイルが公開されるまでリクエストがキューに入れられます：
- 最大リクエスト数：1000
- 最古のリクエストからの最大時間：10分
- リクエストの最大サイズ：4 MB
パラメータ
| パラメータ | 説明 |
|---|---|
| メール | プロファイルが既にユーザーIDで存在する場合を除き、メールを構成する必要があります。プロファイルが既に存在する場合は、ユーザーID から メール へのルックアップが実行されます。 |
| ネストされたオブジェクトのマージ | トップレベルのオブジェクトを上書きするのではなくマージします。デフォルト値は False です。例えば、ユーザープロファイルに {mySettings:{mobile:true}} が含まれており、変更された連絡先フィールドに {mySettings:{email:true}} が含まれている場合、結果のプロファイルは {mySettings:{mobile:true,email:true}} を含むことになります。 |
| ユーザーIDを優先 | ユーザーがまだ存在しない場合、指定されたユーザーIDで新しいユーザーを作成します。 |
| ユーザーID | 通常はデータベースで生成されたIDです。メール または ユーザーID のいずれかが指定されている必要があります。 |
| データフィールド | ユーザープロファイルに格納するデータフィールド。 |
| テンプレート変数 |
|
| テンプレート |
|
| APIキーオーバーライド | APIキーを入力するか、APIキーの属性をマッピングして、コネクタ構成で指定されたAPIキーをオーバーライドします。 |
GDPRに準拠してユーザーを削除
パラメータ
| パラメータ | 説明 |
|---|---|
| メール | 指定されたユーザーのデータをIterableプロジェクトから削除し、今後のデータ収集を防ぎたい場合は、ユーザーのメールを提供してください。 |
| APIキーオーバーライド | APIキーを入力するか、APIキーの属性をマッピングして、コネクタ構成で指定されたAPIキーをオーバーライドします。 |
ユーザーにSMS通知を送信
パラメータ
| パラメータ | 説明 |
|---|---|
| キャンペーン | キャンペーンID。詳細については、Iterable: キャンペーンの紹介を参照してください。 |
| マーケティング送信の繰り返しを許可 | デフォルトはTrueです。 |
| 受信者のメール | メール または ユーザーID のいずれかを入力してユーザーを識別する必要があります。両方が入力されている場合は、メール が優先されます。 |
| 受信者のユーザーID | updateUser コールに渡されたユーザーID。 |
| 送信時刻 | 最大365日先までのメッセージのスケジュールを構成します。過去に構成されている場合、メッセージは即時に送信されます。予想される形式は YYYY-MM-DD HH:MM:SS です。データが適切にフォーマットされていることを確認してください。Date タイプの属性が提供された場合、コネクタは値を上記の適切な日付形式に変換します。 |
| データフィールド | テンプレートにマージするフィールド。 |
| テンプレート変数 |
|
| テンプレート |
|
| APIキーオーバーライド | APIキーを入力するか、APIキーの属性をマッピングして、コネクタ構成で指定されたAPIキーをオーバーライドします。 |
メールアドレスにメールを送信
パラメータ
| パラメータ | 説明 |
|---|---|
| キャンペーン | キャンペーンID。詳細については、Iterable: キャンペーンの紹介を参照してください。 |
| 繰り返しマーケティング送信を許可 | デフォルトはTrueです。 |
| 受信者のメール | メールまたはユーザーIDのいずれかを入力してユーザーを識別する必要があります。両方が入力された場合、メールが優先されます。 |
| 受信者のユーザーID | updateUserコールに渡されたユーザーID。 |
| 送信時刻 | メッセージを最大365日後までスケジュール構成可能。過去に構成された場合、メッセージは即時送信されます。期待される形式はYYYY-MM-DD HH:MM:SSです。データが適切にフォーマットされていることを確認してください。日付タイプの属性が提供された場合、コネクタは値を上記の適切な日付形式に変換します。 |
| データフィールド | メールテンプレートにマージするフィールド。 |
| メタデータ | Webhookを通じて返送されるメタデータ。レンダリングには使用されません。 |
| テンプレート変数 |
|
| テンプレート |
|
| APIキーオーバーライド | コネクタ構成で指定されたAPIキーをオーバーライドするためにAPIキーを入力するか、APIキーの属性をマッピングします。 |
トリガーワークフロー
パラメータ
| パラメータ | 説明 |
|---|---|
| ワークフローID | トリガーするワークフローのID。詳細については、Iterable: ワークフローの紹介を参照してください。 |
| リスト | リスト内のすべてのユーザーに対してワークフローをトリガーします。 |
| メール | 指定されたメールアドレスに対してワークフローをトリガーします。メールまたはリストのみでトリガーします。 |
| データフィールド | トリガーイベントに関連する追加データ。 |
| テンプレート変数 |
|
| テンプレート |
|
| APIキーオーバーライド | コネクタ構成で指定されたAPIキーをオーバーライドするためにAPIキーを入力するか、APIキーの属性をマッピングします。 |
ユーザーをサブスクリプションに追加
パラメータ
| パラメータ | 説明 |
|---|---|
| サブスクリプショングループ | サブスクリプショングループを選択します。 |
| サブスクリプショングループID | ユーザーを登録するメッセージチャンネル、メッセージタイプ、またはメールリストのIDを提供します。 |
| メール | サブスクリプションを作成するユーザーのメールアドレスを提供します。 |
| ユーザーID | サブスクリプションを作成するユーザーのユーザーIDを提供します。メールまたはユーザーIDのいずれかが指定されている必要があります。 |
| APIキーオーバーライド | コネクタ構成で指定されたAPIキーをオーバーライドするためにAPIキーを入力するか、APIキーの属性をマッピングします。 |
ユーザーをサブスクリプションから削除
パラメータ
| パラメータ | 説明 |
|---|---|
| サブスクリプショングループ | サブスクリプショングループを選択します。 |
| サブスクリプショングループID | ユーザーを登録解除するメッセージチャンネル、メッセージタイプ、またはメールリストのIDを提供します。 |
| メール | 登録解除するユーザーのメールアドレスを提供します。 |
| ユーザーID | 登録解除するユーザーのユーザーIDを提供します。メールまたはユーザーIDのいずれかが指定されている必要があります。 |
| APIキーオーバーライド | コネクタ構成で指定されたAPIキーをオーバーライドするためにAPIキーを入力するか、APIキーの属性をマッピングします。 |
リストにユーザーを登録
パラメータ
| パラメータ | 説明 |
|---|---|
| リスト | ユーザーを登録するリストを選択します。 |
| メール | プロファイルが既にユーザーIDで存在する場合を除き、メールを構成する必要があります。その場合、ユーザーIDからメールへのルックアップが実行されます。 |
| ネストされたオブジェクトのマージ | 上位レベルのオブジェクトを上書きするのではなくマージします。デフォルト値はFalseです。例えば、ユーザープロファイルに{mySettings:{mobile:true}}が含まれ、変更連絡先フィールドに{mySettings:{email:true}}が含まれる場合、結果のプロファイルは{mySettings:{mobile:true,email:true}}を含みます。 |
| ユーザーID優先 | ユーザーがまだ存在しない場合、指定されたユーザーIDで新しいユーザーを作成します。 |
| ユーザーID | 通常はデータベースで生成されたIDです。メールまたはユーザーIDのいずれかが指定されている必要があります。 |
| データフィールド | ユーザープロファイルに格納するデータフィールド。 |
| テンプレート変数 |
|
| テンプレート |
|
| APIキーオーバーライド | コネクタ構成で指定されたAPIキーをオーバーライドするためにAPIキーを入力するか、APIキーの属性をマッピングします。 |
リストからユーザーを登録解除
パラメータ
| パラメータ | 説明 |
|---|---|
| リスト | ユーザーを登録解除するリストを選択します。 |
| メール | ユーザーのメール。 |
| ユーザーID | 通常はデータベースで生成されたIDです。メールまたはユーザーIDのいずれかが指定されている必要があります。 |
| キャンペーン | キャンペーンに対する登録解除属性。詳細については、Iterable: キャンペーンの紹介を参照してください。 |
| チャンネル登録解除 | リストに関連するチャンネルからメールを登録解除します。 |
| APIキーオーバーライド | コネクタ構成で指定されたAPIキーをオーバーライドするためにAPIキーを入力するか、APIキーの属性をマッピングします。 |
ユーザーメールの更新
パラメータ
| パラメータ | 説明 |
|---|---|
| 新しいメール | (必須) 新しいユーザーメール。 |
| 現在のメール | 現在のユーザーメール。 |
| 現在のユーザーID | 通常はデータベースで生成されたIDです。メールまたはユーザーIDのいずれかが指定されている必要があります。 |
| APIキーオーバーライド | コネクタ構成で指定されたAPIキーをオーバーライドするためにAPIキーを入力するか、APIキーの属性をマッピングします。 |
ショッピングカートの更新
パラメータ
| パラメータ | 説明 |
|---|---|
| ユーザーのメールアドレス。 | |
| Merge Nested Objects | トップレベルのオブジェクトを上書きするのではなく、マージします。デフォルト値は False です。例えば、ユーザープロファイルが {mySettings:{mobile:true}} を含み、連絡先変更フィールドが {mySettings:{email:true}} を含む場合、結果のプロファイルは {mySettings:{mobile:true,email:true}} を含むことになります。 |
| Prefer User ID | ユーザーがまだ存在しない場合、指定されたユーザーIDで新しいユーザーを作成します。 |
| User ID | 通常はデータベースで生成されたIDです。Email または User ID のいずれかが指定されている必要があります。 |
| User Data Fields | ユーザープロファイルに保存するデータフィールド。 |
| User Data Fields Template Variables |
|
| User Data Fields Templates |
|
アイテム属性
| パラメータ | 説明 |
|---|---|
| Item ID | 商品アイテムID。 |
| SKU | 商品SKU。 |
| Name | 商品名。 |
| Description | 商品説明。 |
| Category | 商品カテゴリ。 |
| Subcategory | 商品サブカテゴリ。 |
| Price | 商品価格。 |
| Quantity | 商品数量。 |
| Image URL | 商品画像のURL。 |
| URL | 商品ページのURL。 |
| Items Data Fields |
|
| Items Template Variables |
|
| Items Template |
|
| API Key Override | コネクタ構成で指定されたAPIキーを上書きするためにAPIキーを入力するか、APIキーのための属性をマッピングします。 |
購入追跡
パラメータ
| パラメータ | 説明 |
|---|---|
| Total | (必須) 注文総額。 |
| Purchase ID | 購入トランザクションのID。 |
| Created At | イベントが発生した時間。指定されていない場合は、イベントが受信された時間に構成されます。Unixタイムスタンプを期待します。このフィールドがマップされていない場合、現在のタイムスタンプで初期化されます。 |
ユーザー属性
| パラメータ | 説明 |
|---|---|
| Email または User ID のいずれかが入力されている必要があります。両方が入力されている場合、Email が優先されます。 | |
| Merge Nested Objects | トップレベルのオブジェクトを上書きするのではなく、マージします。デフォルト値は False です。例えば、ユーザープロファイルが {mySettings:{mobile:true}} を含み、連絡先変更フィールドが {mySettings:{email:true}} を含む場合、結果のプロファイルは {mySettings:{mobile:true,email:true}} を含むことになります。 |
| Prefer User ID | ユーザーがまだ存在しない場合、指定されたユーザーIDで新しいユーザーを作成します。 |
| User ID | 通常はデータベースで生成されたIDです。Email または User ID のいずれかが指定されている必要があります。 |
| Campaign | キャンペーンID。詳細については、Iterable: キャンペーンへの導入 を参照してください。 |
| Project Template |
|
| Data Fields | 追跡する追加フィールド。 |
| User Data Fields | ユーザープロファイルに保存するデータフィールド。 |
| Data Fields Template Variables |
|
| Data Fields Templates |
|
アイテム属性
| パラメータ | 説明 |
|---|---|
| Item ID | 商品アイテムID。 |
| SKU | 商品SKU。 |
| Name | 商品名。 |
| Description | 商品説明。 |
| Category | 商品カテゴリ。 |
| Subcategory | 商品サブカテゴリ。 |
| Price | 商品価格。 |
| Quantity | 購入された商品の数量。 |
| Image URL | 商品画像のURL。 |
| URL | 商品ページのURL。 |
| Items Data Fields |
|
| Items Template Variables |
|
| Items Template |
|
| API Key Override | コネクタ構成で指定されたAPIキーを上書きするためにAPIキーを入力するか、APIキーのための属性をマッピングします。 |
顧客データのマージ
ソースユーザーパラメータ
| パラメータ | 説明 |
|---|---|
| Source Email | ソースユーザープロファイルをメールで識別します。このパラメータは文字列または配列であることができます。配列のサイズ制限は10です。 |
| Source User ID | ソースユーザープロファイルをユーザーIDで識別します。このパラメータは文字列または配列であることができます。配列のサイズ制限は10です。 |
宛先ユーザーパラメータ
| パラメータ | 説明 |
|---|---|
| Destination Email | 宛先ユーザープロファイルをメールで識別します。このパラメータは文字列または配列であることができます。配列のサイズ制限は10であり、ソースパラメータと同じサイズでなければなりません。 |
| Destination User ID | 宛先ユーザープロファイルをユーザーIDで識別します。このパラメータは文字列または配列であることができます。配列のサイズ制限は10であり、ソースパラメータと同じサイズでなければなりません。 |
| API Key Override | コネクタ構成で指定されたAPIキーを上書きするためにAPIキーを入力するか、APIキーのための属性をマッピングします。 |
最終更新日 :: 2025年December月10日