Iterableコネクタの構成ガイド

コネクタのアクション

アクション名	AudienceStream	EventStream
イベントのトラッキング（バッチ処理）	✗	✓
ユーザーのアップサート（バッチ処理）	✓	✓
GDPRに準拠してユーザーを削除	✓	✓
ユーザーにSMS通知を送信	✓	✓
メールアドレスにメールを送信	✓	✓
ワークフローのトリガー	✓	✓
ユーザーの購読（ASのみ）	✓	✗
ユーザーの購読解除（ASのみ）	✓	✗
ユーザーをリストに購読	✓	✗
ユーザーをリストから購読解除	✓	✗
ユーザーのメールアドレスを更新	✓	✓
ショッピングカートを更新	✓	✓
購入をトラッキング	✓	✓

構成の構成

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

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

• APIキー
  Iterable ConnectorメニューのIntegrations > API Keysに移動して、APIキーを取得できます。

コネクタの構成が完了したら、Doneをクリックします。

アクションの構成 — パラメータとオプション

コネクタのアクションを構成するには、Continueをクリックしてください。アクションの名前を入力し、ドロップダウンメニューからアクションのタイプを選択します。

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

アクション — イベントのトラッキング（バッチ処理）

バッチ制限

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

• 最大リクエスト数：1000
• 最も古いリクエストからの経過時間の最大値：10分
• リクエストの最大サイズ：4MB

パラメータ

パラメータ	説明
イベント名	（必須）イベントの名前。
作成日時	イベントが発生した時刻。指定されていない場合は、イベントが受信された時刻に構成されます。Unixタイムスタンプが必要です。このフィールドがマッピングされていない場合、現在のタイムスタンプで初期化されます。
メールアドレス	ユーザーを識別するために、メールアドレスまたはユーザーIDのいずれかを入力する必要があります。両方が入力されている場合は、メールアドレスが優先されます。
イベントID	指定されたIDのイベントが存在する場合、イベントが更新されます。イベントIDが指定されていない場合、新しいIDが自動的に生成されて返されます。ただし、このIDの長さは512バイトを超えることはできません。
ユーザーID	updateUser呼び出しで渡されたユーザーID。
キャンペーン	変換に関連付けられたキャンペーン。 キャンペーンについての詳細は、キャンペーンの概要を参照してください。
プロジェクトテンプレート	テンプレートID。 テンプレートについての詳細は、テンプレートの概要を参照してください。
データフィールド	イベントに関連付けられた追加データ（例：アイテムの金額や数量）です。 同じ名前のイベントの場合、同じ名前のデータフィールドは同じタイプである必要があります。
テンプレート変数	データ入力としてテンプレート変数を提供します（テンプレート変数ガイドを参照）。 ドット表記法（例：items.name）でネストされたテンプレート変数の名前を指定します。 ネストされたテンプレート変数は通常、データレイヤーリスト属性から構築されます。
テンプレート	ボディデータ内で参照するテンプレートを提供します（テンプレートガイドを参照）。 テンプレートは、二重中括弧で名前を挿入してサポートされるフィールドに注入されます（例：{{SomeTemplateName}}）。

アクション — ユーザーのアップサート（バッチ処理）

バッチ制限

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

• 最大リクエスト数：1000
• 最も古いリクエストからの経過時間の最大値：10分
• リクエストの最大サイズ：4MB

パラメータ

パラメータ	説明
メールアドレス	プロファイルにユーザーIDが構成されていない場合は、メールアドレスを構成する必要があります。プロファイルが既に存在する場合、ユーザーIDからメールアドレスへのルックアップが行われます。
ネストされたオブジェクトのマージ	上位レベルのオブジェクトを上書きする代わりにマージします（デフォルト：False）。たとえば、ユーザープロファイルにデータがある場合：{mySettings:{mobile:true}}、連絡先フィールドの変更データがある場合：{mySettings:{email:true}}、結果のプロファイルは次のようになります：{mySettings:{mobile:true,email:true}}。
ユーザーIDを優先	ユーザーがまだ存在しない場合、指定されたユーザーIDで新しいユーザーを作成します。
ユーザーID	通常はデータベースで生成されたIDです。メールアドレスまたはユーザーIDのいずれかを指定する必要があります。
データフィールド	ユーザープロファイルに保存するデータフィールドです。
テンプレート変数	データ入力としてテンプレート変数を提供します（テンプレート変数ガイドを参照）。 ドット表記法（例：items.name）でネストされたテンプレート変数の名前を指定します。 ネストされたテンプレート変数は通常、データレイヤーリスト属性から構築されます。
テンプレート	ユーザーデータフィールド内で参照するテンプレートを提供します（テンプレートガイドを参照）。 テンプレートは、二重中括弧で名前を挿入してサポートされるフィールドに注入されます（例：{{SomeTemplateName}}）。

アクション — GDPRに準拠してユーザーを削除

パラメータ

パラメータ	説明
メールアドレス	指定したユーザーのデータをIterableプロジェクトから削除し、将来のデータ収集を防止する場合は、ユーザーのメールアドレスを指定します。

アクション — ユーザーにSMS通知を送信

パラメータ

パラメータ	説明
キャンペーン	キャンペーンID。 キャンペーンについての詳細は、キャンペーンの概要を参照してください。
繰り返しマーケティング送信を許可	デフォルトはTrueです。
受信者のメールアドレス	ユーザーを識別するために、メールアドレスまたはユーザーIDのいずれかを入力する必要があります。両方が入力されている場合は、メールアドレスが優先されます。
受信者のユーザーID	updateUser呼び出しで渡されたユーザーID。
送信日時	メッセージを最大365日先までスケジュールします。過去に構成されている場合、メッセージはすぐに送信されます。期待される形式はYYYY-MM-DD HH:MM:SSです。データが正しくフォーマットされていることを確認してください。Dateタイプの属性が提供された場合、コネクタは値を適切な日付形式に変換します（上記の形式を参照）。
データフィールド	テンプレートにマージするフィールドです。
テンプレート変数	データ入力としてテンプレート変数を提供します（テンプレート変数ガイドを参照）。 ドット表記法（例：items.name）でネストされたテンプレート変数の名前を指定します。 ネストされたテンプレート変数は通常、データレイヤーリスト属性から構築されます。
テンプレート	ボディデータ内で参照するテンプレートを提供します（テンプレートガイドを参照）。 テンプレートは、二重中括弧で名前を挿入してサポートされるフィールドに注入されます（例：{{SomeTemplateName}}）。

アクション — メールアドレスにメールを送信

パラメータ

パラメータ	説明
キャンペーン	キャンペーンID。 キャンペーンについての詳細は、キャンペーンの概要を参照してください。
繰り返しマーケティング送信を許可	デフォルトはTrueです。
受信者のメールアドレス	ユーザーを識別するために、メールアドレスまたはユーザーIDのいずれかを入力する必要があります。両方が入力されている場合は、メールアドレスが優先されます。
受信者のユーザーID	updateUser呼び出しで渡されたユーザーID。
送信日時	メッセージを最大365日先までスケジュールします。過去に構成されている場合、メッセージはすぐに送信されます。期待される形式はYYYY-MM-DD HH:MM:SSです。データが正しくフォーマットされていることを確認してください。Dateタイプの属性が提供された場合、コネクタは値を適切な日付形式に変換します（上記の形式を参照）。
データフィールド	メールテンプレートにマージするフィールドです。
メタデータ	Webhook経由で返されるメタデータ。レンダリングには使用されません。
テンプレート変数	データ入力としてテンプレート変数を提供します（テンプレート変数ガイドを参照）。 ドット表記法（例：items.name）でネストされたテンプレート変数の名前を指定します。 ネストされたテンプレート変数は通常、データレイヤーリスト属性から構築されます。
テンプレート	ボディデータ内で参照するテンプレートを提供します（テンプレートガイドを参照）。 テンプレートは、二重中括弧で名前を挿入してサポートされるフィールドに注入されます（例：{{SomeTemplateName}}）。

アクション — ワークフローのトリガー

パラメータ

パラメータ	説明
ワークフローID	トリガーするワークフローのID。 ワークフローについての詳細は、ワークフローの概要を参照してください。
リスト	リスト内のすべてのユーザーに対してワークフローをトリガーします。
メールアドレス	指定したメールアドレスに対してワークフローをトリガーします。EmailまたはListのいずれかでのみトリガーします。
データフィールド	トリガーイベントに関連付けられた追加データです。
テンプレート変数	データ入力としてテンプレート変数を提供します（テンプレート変数ガイドを参照）。 ドット表記法（例：items.name）でネストされたテンプレート変数の名前を指定します。 ネストされたテンプレート変数は通常、データレイヤーリスト属性から構築されます。
テンプレート	ボディデータ内で参照するテンプレートを提供します（テンプレートガイドを参照）。 テンプレートは、二重中括弧で名前を挿入してサポートされるフィールドに注入されます（例：{{SomeTemplateName}}）。

アクション — ユーザーの購読（ASのみ）

パラメータ

パラメータ	説明
購読グループ	購読するグループを選択します。
購読グループID	ユーザーを購読するメッセージチャネル、メッセージタイプ、またはメールリストのIDを指定します。
メールアドレス	購読を作成するユーザーのメールアドレスを指定します。
ユーザーID	購読を作成するユーザーのユーザーIDを指定します。メールアドレスまたはユーザーIDのいずれかを指定する必要があります。

アクション — ユーザーの購読解除（ASのみ）

パラメータ

パラメータ	説明
購読グループ	購読を解除するグループを選択します。
購読グループID	ユーザーを購読解除するメッセージチャネル、メッセージタイプ、またはメールリストのIDを指定します。
メールアドレス	ユーザーを購読解除するユーザーのメールアドレスを指定します。
ユーザーID	ユーザーを購読解除するユーザーのユーザーIDを指定します。メールアドレスまたはユーザーIDのいずれかを指定する必要があります。

アクション — ユーザーをリストに購読

パラメータ

パラメータ	説明
リスト	ユーザーを購読するリストを選択します。
メールアドレス	プロファイルにユーザーIDが構成されていない場合は、メールアドレスを構成する必要があります。既にプロファイルが存在する場合、ユーザーIDからメールアドレスへのルックアップが行われます。
ネストされたオブジェクトのマージ	上位レベルのオブジェクトを上書きする代わりにマージします（デフォルト：False）。たとえば、ユーザープロファイルにデータがある場合：{mySettings:{mobile:true}}、連絡先フィールドの変更データがある場合：{mySettings:{email:true}}、結果のプロファイルは次のようになります：{mySettings:{mobile:true,email:true}}。
ユーザーIDを優先	ユーザーがまだ存在しない場合、指定されたユーザーIDで新しいユーザーを作成します。
ユーザーID	通常はデータベースで生成されたIDです。メールアドレスまたはユーザーIDのいずれかを指定する必要があります。
データフィールド	ユーザープロファイルに保存するデータフィールドです。
テンプレート変数	データ入力としてテンプレート変数を提供します（テンプレート変数ガイドを参照）。 ドット表記法（例：items.name）でネストされたテンプレート変数の名前を指定します。 ネストされたテンプレート変数は通常、データレイヤーリスト属性から構築されます。
テンプレート	ユーザーデータフィールド内で参照するテンプレートを提供します（テンプレートガイドを参照）。 テンプレートは、二重中括弧で名前を挿入してサポートされるフィールドに注入されます（例：{{SomeTemplateName}}）。

アクション — ユーザーをリストから購読解除

パラメータ

パラメータ	説明
リスト	ユーザーを購読解除するリストを選択します。
メールアドレス	ユーザーのメールアドレス。
ユーザーID	通常はデータベースで生成されたIDです。メールアドレスまたはユーザーIDのいずれかを指定する必要があります。
キャンペーン	キャンペーンに対して購読解除を属性付けします。 キャンペーンについての詳細は、キャンペーンの概要を参照してください。
チャネルの購読解除	リストに関連付けられたチャネルからメールを購読解除します。

アクション — ユーザーのメールアドレスを更新

パラメータ

パラメータ	説明
新しいメールアドレス	新しいユーザーのメールアドレス（必須）。
現在のメールアドレス	現在のユーザーのメールアドレス。
現在のユーザーID	通常はデータベースで生成されたIDです。メールアドレスまたはユーザーIDのいずれかを指定する必要があります。

アクション — ショッピングカートを更新

パラメータ

パラメータ	説明
メールアドレス	ユーザーのメールアドレス。
ネストされたオブジェクトのマージ	上位レベルのオブジェクトを上書きする代わりにマージします（デフォルト：False）。たとえば、ユーザープロファイルにデータがある場合：{mySettings:{mobile:true}}、連絡先フィールドの変更データがある場合：{mySettings:{email:true}}、結果のプロファイルは次のようになります：{mySettings:{mobile:true,email:true}}。
ユーザーIDを優先	ユーザーがまだ存在しない場合、指定されたユーザーIDで新しいユーザーを作成します。
ユーザーID	通常はデータベースで生成されたIDです。メールアドレスまたはユーザーIDのいずれかを指定する必要があります。
ユーザーデータフィールド	ユーザープロファイルに保存するデータフィールドです。
ユーザーデータフィールドのテンプレート変数	データ入力としてテンプレート変数を提供します（テンプレート変数ガイドを参照）。 ドット表記法（例：items.name）でネストされたテンプレート変数の名前を指定します。 ネストされたテンプレート変数は通常、データレイヤーリスト属性から構築されます。
ユーザーデータフィールドのテンプレート	ネストされたオブジェクトをサポートする場合は、このセクションを使用してテンプレートを定義します。 テンプレートはJSON配列形式を想定しています。 テンプレートが定義されている場合、アイテム属性セクションの構成は無視されます。 Items TemplateまたはItems Attributesのいずれかを指定する必要があります。 テンプレートについての詳細は（テンプレートガイドを参照）。

アクション — 購入をトラッキング

パラメータ

パラメータ	説明
合計	（必須）
購入ID	購入トランザクションのID。
作成日時	イベントが発生した時刻。指定されていない場合は、イベントが受信された時刻に構成されます。Unixタイムスタンプが必要です。このフィールドがマッピングされていない場合、現在のタイムスタンプで初期化されます。
メールアドレス	ユーザーを識別するために、メールアドレスまたはユーザーIDのいずれかを入力する必要があります。両方が入力されている場合は、メールアドレスが優先されます。
ネストされたオブジェクトのマージ	上位レベルのオブジェクトを上書きする代わりにマージします（デフォルト：False）。たとえば、ユーザープロファイルにデータがある場合：{mySettings:{mobile:true}}、連絡先フィールドの変更データがある場合：{mySettings:{email:true}}、結果のプロファイルは次のようになります：{mySettings:{mobile:true,email:true}}。
ユーザーIDを優先	ユーザーがまだ存在しない場合、指定されたユーザーIDで新しいユーザーを作成します。
ユーザーID	通常はデータベースで生成されたIDです。EmailまたはUser IDのいずれかを指定する必要があります。
キャンペーン	キャンペーンID。 キャンペーンについての詳細は、キャンペーンの概要を参照してください。
プロジェクトテンプレート	テンプレートID。 テンプレートについての詳細は、テンプレートの概要を参照してください。
データフィールド	追加のフィールドをトラッキングします。
ユーザーデータフィールド	ユーザープロファイルに保存するデータフィールドです。
データフィールドのテンプレート変数	データ入力としてテンプレート変数を提供します（テンプレート変数ガイドを参照）。 ドット表記法（例：items.name）でネストされたテンプレート変数の名前を指定します。 ネストされたテンプレート変数は通常、データレイヤーリスト属性から構築されます。
データフィールドのテンプレート	データフィールドとユーザーデータフィールドで参照するテンプレートを提供します（テンプレートガイドを参照）。 テンプレートは、二重中括弧で名前を挿入してサポートされるフィールドに注入されます（例：{{SomeTemplateName}}）。
アイテムID	商品のアイテムID。
SKU	商品のSKU。
名前	商品の名前。
説明	商品の説明。
カテゴリ	商品のカテゴリ。
サブカテゴリ	商品のサブカテゴリ。
価格	商品の価格。
数量	商品の数量。
画像URL	商品の画像のURL。
URL	商品ページのURL。
アイテムデータフィールド	追加のアイテムプロパティです。 複数のアイテムを追加するために配列タイプの属性を提供します。配列タイプの属性は同じ長さである必要があります。 アイテムデータフィールドの配列とアイテム属性の配列は同じ長さである必要があります。 単一の値属性を使用することもでき、それは各アイテムに適用されます。
アイテムのテンプレート変数	データ入力としてテンプレート変数を提供します（テンプレート変数ガイドを参照）。 ドット表記法（例：items.name）でネストされたテンプレート変数の名前を指定します。 ネストされたテンプレート変数は通常、データレイヤーリスト属性から構築されます。
アイテムのテンプレート	ネストされたオブジェクトをサポートする場合は、このセクションを使用してテンプレートを定義します。 テンプレートはJSON配列形式を想定しています。 テンプレートが定義されている場合、アイテム属性セクションの構成は無視されます。 Items TemplateまたはItems Attributesのいずれかを指定する必要があります。 テンプレートについての詳細は（テンプレートガイドを参照）。