Iterableコネクタ構成ガイド

コネクタアクション

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

構成の構成

コネクタマーケットプレイスに移動し、新しいコネクタを追加します。詳細については、コネクタについてを参照してください。

コネクタを追加したら、次の構成を構成します：

• ホスト
  • EUベースのAPIエンドポイントの場合は、https://app.eu.iterable.comを選択します。
  • USベースのAPIエンドポイントの場合は、https://app.iterable.comを選択します。
• APIキー

APIキーは、Iterableコネクタメニューのインテグレーション > APIキーに移動することで見つけることができます。

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

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

続行をクリックしてコネクタアクションを構成します。アクションの名前を入力し、ドロップダウンメニューからアクションタイプを選択します。

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

アクション — イベントの追跡（バッチ処理）

バッチ制限

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

• リクエストの最大数：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です。データが適切にフォーマットされていることを確認してください。日付タイプの属性が提供された場合、コネクタは値を上記の適切な日付形式に変換します。
データフィールド	テンプレートにマージするフィールド。
テンプレート変数	データ入力としてテンプレート変数を提供します（参照：テンプレート変数ガイド）。 ネストしたテンプレート変数はドット表記法で名前を付けます（例：items.name）。 ネストしたテンプレート変数は通常、データレイヤーリスト属性から作成されます。
テンプレート	ボディデータで参照されるテンプレートを提供します（参照：テンプレートガイド）。 テンプレートは、名前でサポートされるフィールドに二重中括弧で注入されます（例：{{SomeTemplateName}}）。

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

パラメータ

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

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

パラメータ

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

アクション — ユーザーを登録する (ASのみ)

パラメータ

パラメータ	説明
Subscription Group	サブスクリプショングループを選択します。
Subscription Group ID	ユーザーを登録するメッセージチャネル、メッセージタイプ、またはメールリストのIDを提供します。
Email	登録を作成したいユーザーのメールアドレスを提供します。
User ID	登録を作成したいユーザーのユーザーIDを提供します。Email または User ID のいずれかを指定する必要があります。

アクション — ユーザーの登録を解除する (ASのみ)

パラメータ

パラメータ	説明
Subscription Group	サブスクリプショングループを選択します。
Subscription Group ID	ユーザーの登録を解除するメッセージチャネル、メッセージタイプ、またはメールリストのIDを提供します。
Email	登録を解除するユーザーのメールアドレスを提供します。
User ID	登録を解除するユーザーのユーザーIDを提供します。Email または User ID のいずれかを指定する必要があります。

アクション — ユーザーをリストに登録する

パラメータ

パラメータ	説明
List	ユーザーを登録するリストを選択します。
Email	プロフィールがすでにユーザーIDを構成して存在する場合を除き、メールは構成されていなければなりません。その場合、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 のいずれかを指定する必要があります。
Data Fields	ユーザープロフィールに保存するデータフィールド。
Template Variables	データ入力としてテンプレート変数を提供します（参照：Template Variables Guide）。 ネストしたテンプレート変数はドット表記法で名前を付けます（例：items.name）。 ネストしたテンプレート変数は通常、データレイヤーリスト属性から作成されます。
Templates	Body Dataで参照するテンプレートを提供します（参照：Templates Guide）。 テンプレートは、名前でサポートされているフィールドに二重中括弧で注入されます（例：{{SomeTemplateName}}）。

アクション — ユーザーをリストから登録解除する

パラメータ

パラメータ	説明
List	ユーザーを登録解除するリストを選択します。
Email	ユーザーのメール。
User ID	通常はデータベースが生成したIDです。Email または User ID のいずれかを指定する必要があります。
Campaign	キャンペーンに登録解除を属性します。 キャンペーンについての詳細はキャンペーンの紹介を参照してください。
Channel Unsubscribe	リストの関連チャネルからメールを登録解除します。

アクション — ユーザーのメールを更新する

パラメータ

パラメータ	説明
New Email	新しいユーザーメール。（必須）
Current Email	現在のユーザーメール。
Current User ID	通常はデータベースが生成したIDです。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 のいずれかを指定する必要があります。
User Data Fields	ユーザープロフィールに保存するデータフィールド。
User Data Fields Template Variables	データ入力としてテンプレート変数を提供します（参照：Template Variables Guide）。 ネストしたテンプレート変数はドット表記法で名前を付けます（例：items.name）。 ネストしたテンプレート変数は通常、データレイヤーリスト属性から作成されます。
User Data Fields Templates	User Data Fieldsで参照するテンプレートを提供します（参照：Templates Guide）。 テンプレートは、名前でサポートされているフィールドに二重中括弧で注入されます（例：{{SomeTemplateName}}）。
Item ID	商品のアイテムID。
SKU	商品のSKU。
Name	商品名。
Description	商品の説明。
Category	商品のカテゴリ。
Subcategory	商品のサブカテゴリ。
Price	商品の価格。
Quantity	商品の数量。
Image URL	商品画像のURL。
URL	商品ページのURL。
Items Data Fields	追加のアイテムプロパティ。 複数のアイテムを追加するための配列型属性を提供します。配列型属性は等しい長さでなければなりません。 Items Data Fieldsの配列とItems Attributesの配列は等しい長さでなければなりません。 単一値属性を使用することができ、各アイテムに適用されます。
Items Template Variables	データ入力としてテンプレート変数を提供します（参照：Template Variables Guide）。 ネストしたテンプレート変数はドット表記法で名前を付けます（例：items.name）。 ネストしたテンプレート変数は通常、データレイヤーリスト属性から作成されます。
Items Template	ネストされたオブジェクトのサポートが必要な場合、このセクションでテンプレートを定義します。 テンプレートはJSON配列形式を期待します。 テンプレートが定義されている場合、Items Attributes セクションからの構成は無視されます。 Items Template または Items Attributes のいずれかを指定する必要があります。 テンプレートについての詳細情報（参照：Templates Guide）。

アクション — 購入を追跡する

パラメータ

パラメータ	説明
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。 キャンペーンについての詳細はキャンペーンの紹介をご覧ください。
Project Template	テンプレートID。 テンプレートについての詳細はテンプレートの紹介をご覧ください。
Data Fields	追跡する追加のフィールド。
User Data Fields	ユーザープロファイルに保存するデータフィールド。
Data Fields Template Variables	データ入力としてテンプレート変数を提供します（参照：テンプレート変数ガイド）。 ネストしたテンプレート変数はドット表記法で名前を付けます（例：items.name）。 ネストしたテンプレート変数は通常、データレイヤーリスト属性から作成されます。
Data Fields Templates	Data FieldsとUser Data Fieldsで参照されるテンプレートを提供します（参照：テンプレートガイド）。 テンプレートは、サポートされるフィールドに名前で二重中括弧で注入されます（例：{{SomeTemplateName}}）。
Item ID	商品アイテムID。
SKU	商品SKU。
Name	商品名。
Description	商品説明。
Category	商品カテゴリ。
Subcategory	商品サブカテゴリ。
Price	商品価格。
Quantity	購入した商品の数量。
Image URL	商品画像のURL。
URL	商品ページのURL。
Items Data Fields	追加のアイテムプロパティ。 複数のアイテムを追加するための配列型属性を提供します。配列型属性は等しい長さでなければなりません。 Items Data Fields配列とItems Attributes配列は等しい長さでなければなりません。 単一値属性を使用することができ、それぞれのアイテムに適用されます。
Items Template Variables	データ入力としてテンプレート変数を提供します（参照：テンプレート変数ガイド）。 ネストしたテンプレート変数はドット表記法で名前を付けます（例：items.name）。 ネストしたテンプレート変数は通常、データレイヤーリスト属性から作成されます。
Items Template	ネストされたオブジェクトのサポートが必要な場合、このセクションでテンプレートを定義します。 テンプレートはJSON配列形式を期待します。 テンプレートが定義されている場合、Items Attributesセクションからの構成は無視されます。 Items TemplateまたはItems Attributesのいずれかを指定する必要があります。 テンプレートについての詳細情報（参照：テンプレートガイド）。