--- title: Iterable コネクタ構成ガイド description: この記事では、Iterable コネクタの構成方法について説明します。 url: https://docs.tealium.com/ja/server-side-connectors/iterable-connector/ --- ## 構成 コネクタマーケットプレイスにアクセスし、新しいコネクタを追加します。詳細については、[コネクタについて](https://docs.tealium.com/about-connectors/)を参照してください。 コネクタを追加した後、以下の構成を構成します： * **ホスト** * 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通知を送信| ✓| ✓| |メールアドレスにメールを送信| ✓| ✓| |ワークフローをトリガー| ✓| ✓| |ユーザーをサブスクリプションに追加| ✓| ✗| |ユーザーをサブスクリプションから削除| ✓| ✗| |ユーザーをリストに登録| ✓| ✗| |ユーザーをリストから解除| ✓| ✗| |ユーザーのメールを更新| ✓| ✓| |ショッピングカートを更新| ✓| ✓| |購入を追跡| ✓| ✓| |顧客データをマージ | ✓ | ✓ | **次へ** をクリックするか、**アクション** タブに進みます。 次のセクションでは、各アクションのパラメータとオプションの構成方法について説明します。 ### イベント追跡（バッチ処理） #### バッチ制限 このアクションは、バッチリクエストを使用してベンダーへの大量データ転送をサポートします。詳細については、[バッチアクション](https://docs.tealium.com/batched-actions/)を参照してください。次のいずれかの閾値に達するか、プロファイルが公開されるまでリクエストがキューに入れられます： * 最大リクエスト数：1000 * 最古のリクエストからの最大時間：10分 * リクエストの最大サイズ：4 MB #### パラメータ |パラメータ| 説明| |---| ---| |イベント名| (必須) イベントの名前。| |作成日時| イベントが発生した時間。指定されていない場合は、イベントが受信された時間に構成されます。Unixタイムスタンプを期待します。このフィールドがマッピングされていない場合、現在のタイムスタンプで初期化されます。| |メール| **メール** または **ユーザーID** のいずれかを入力してユーザーを識別する必要があります。両方が入力されている場合は、**メール** が優先されます。| |イベントID| 入力されたIDのイベントが存在する場合、そのイベントは更新されます。**イベントID** が指定されていない場合、新しいIDが自動的に生成されて返されます。このIDは512バイトを超えることはできません。| |ユーザーID| `updateUser` コールに渡されたユーザーID。| |キャンペーン| | |プロジェクトテンプレート| テンプレートID。詳細については、[Iterable: テンプレートの紹介](https://support.iterable.com/hc/en-us/articles/205480315-Introduction-to-Templates-)を参照してください。| |データフィールド| イベントに関連する追加データ。例：アイテムの金額や数量。同じ名前のイベントの場合、同じ名前のデータフィールドは同じタイプでなければなりません。| |テンプレート変数| | |テンプレート| | | APIキーオーバーライド | APIキーを入力するか、APIキーの属性をマッピングして、コネクタ構成で指定されたAPIキーをオーバーライドします。 | ### ユーザー追加（バッチ処理） #### バッチ制限 このアクションは、バッチリクエストを使用してベンダーへの大量データ転送をサポートします。詳細については、[バッチアクション](https://docs.tealium.com/batched-actions/)を参照してください。次のいずれかの閾値に達するか、プロファイルが公開されるまでリクエストがキューに入れられます： * 最大リクエスト数：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: キャンペーンの紹介](https://support.iterable.com/hc/en-us/articles/360050203812-Introduction-to-Campaigns-)を参照してください。| |マーケティング送信の繰り返しを許可| デフォルトはTrueです。| |受信者のメール| **メール** または **ユーザーID** のいずれかを入力してユーザーを識別する必要があります。両方が入力されている場合は、**メール** が優先されます。| |受信者のユーザーID| `updateUser` コールに渡されたユーザーID。| |送信時刻| 最大365日先までのメッセージのスケジュールを構成します。過去に構成されている場合、メッセージは即時に送信されます。予想される形式は `YYYY-MM-DD HH:MM:SS` です。データが適切にフォーマットされていることを確認してください。**Date** タイプの属性が提供された場合、コネクタは値を上記の適切な日付形式に変換します。| |データフィールド| テンプレートにマージするフィールド。| |テンプレート変数| | |テンプレート| | | APIキーオーバーライド | APIキーを入力するか、APIキーの属性をマッピングして、コネクタ構成で指定されたAPIキーをオーバーライドします。 | ### メールアドレスにメールを送信 #### パラメータ |パラメータ| 説明| |---| ---| |キャンペーン| キャンペーンID。詳細については、[Iterable: キャンペーンの紹介](https://support.iterable.com/hc/en-us/articles/360050203812-Introduction-to-Campaigns-)を参照してください。| |繰り返しマーケティング送信を許可| デフォルトはTrueです。| |受信者のメール| **メール**または**ユーザーID**のいずれかを入力してユーザーを識別する必要があります。両方が入力された場合、**メール**が優先されます。| |受信者のユーザーID| `updateUser`コールに渡されたユーザーID。| |送信時刻| メッセージを最大365日後までスケジュール構成可能。過去に構成された場合、メッセージは即時送信されます。期待される形式は`YYYY-MM-DD HH:MM:SS`です。データが適切にフォーマットされていることを確認してください。**日付**タイプの属性が提供された場合、コネクタは値を上記の適切な日付形式に変換します。| |データフィールド| メールテンプレートにマージするフィールド。| |メタデータ| Webhookを通じて返送されるメタデータ。レンダリングには使用されません。| |テンプレート変数| | |テンプレート| | | APIキーオーバーライド | コネクタ構成で指定されたAPIキーをオーバーライドするためにAPIキーを入力するか、APIキーの属性をマッピングします。 | ### トリガーワークフロー #### パラメータ |パラメータ| 説明| |---| ---| |ワークフローID| トリガーするワークフローのID。詳細については、[Iterable: ワークフローの紹介](https://support.iterable.com/hc/en-us/articles/205480265-Introduction-to-Workflows-)を参照してください。| |リスト| リスト内のすべてのユーザーに対してワークフローをトリガーします。| |メール| 指定されたメールアドレスに対してワークフローをトリガーします。**メール**または**リスト**のみでトリガーします。| |データフィールド| トリガーイベントに関連する追加データ。| |テンプレート変数| | |テンプレート| | | 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: キャンペーンの紹介](https://support.iterable.com/hc/en-us/articles/360050203812-Introduction-to-Campaigns-)を参照してください。| |チャンネル登録解除| リストに関連するチャンネルからメールを登録解除します。| | APIキーオーバーライド | コネクタ構成で指定されたAPIキーをオーバーライドするためにAPIキーを入力するか、APIキーの属性をマッピングします。 | ### ユーザーメールの更新 #### パラメータ |パラメータ| 説明| |---| ---| |新しいメール| (必須) 新しいユーザーメール。| |現在のメール| 現在のユーザーメール。| |現在のユーザーID| 通常はデータベースで生成されたIDです。**メール**または**ユーザーID**のいずれかが指定されている必要があります。| | APIキーオーバーライド | コネクタ構成で指定されたAPIキーをオーバーライドするためにAPIキーを入力するか、APIキーの属性をマッピングします。 | ### ショッピングカートの更新 #### パラメータ |パラメータ| 説明| |---| ---| |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** のいずれかが指定されている必要があります。| |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| **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: キャンペーンへの導入](https://support.iterable.com/hc/en-us/articles/360050203812-Introduction-to-Campaigns-) を参照してください。| |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キーのための属性をマッピングします。 |