Iterable コネクタ構成ガイド

構成の構成

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

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

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

API キーを見つけるには、Iterable サイトで Integrations > API Keys に移動します。

サポートされるアクション

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

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

次へをクリックするか、アクションタブに移動します。ここでアクションを構成し、トリガーします。

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

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

バッチ制限

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

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

パラメータ

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

アクション — GDPRに準拠してユーザーを忘れる

パラメータ

パラメータ	説明
メール	Iterableプロジェクトから指定されたユーザーのデータを削除し、将来のデータ収集を防ぎたい場合は、ユーザーのメールを提供してください。
APIキーオーバーライド	APIキーを入力するか、APIキーの属性をマッピングして、コネクタ構成で指定されたAPIキーをオーバーライドします。

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

パラメータ

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

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

パラメータ

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

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

パラメータ

パラメータ	説明
ワークフローID	トリガーするワークフローのID。詳細については、Iterable: ワークフローの紹介を参照してください。
リスト	リスト内のすべてのユーザーに対してワークフローをトリガーします。
メール	指定されたメールアドレスのワークフローをトリガーします。メールまたはリストのみでトリガーします。
データフィールド	トリガーイベントに関連する追加データ。
テンプレート変数	データ入力としてテンプレート変数を提供します。詳細については、テンプレート変数ガイドを参照してください。 ドット表記を使用してネストされたテンプレート変数に名前を付けます。例：items.name。ネストされたテンプレート変数は通常、データレイヤーリスト属性から構築されます。
テンプレート	本文データで参照されるテンプレートを提供します。詳細については、テンプレートガイドを参照してください。 テンプレートは名前で二重中括弧を使用してサポートされるフィールドに注入されます。例：{{SomeTemplateName}}。
APIキーオーバーライド	コネクタ構成で指定されたAPIキーをオーバーライドするためにAPIキーを入力するか、APIキーの属性をマッピングします。

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

パラメータ

パラメータ	説明
購読グループ	購読グループを選択します。
購読グループID	ユーザーを購読するメッセージチャンネル、メッセージタイプ、またはメールリストのIDを提供します。
メール	購読を作成したいユーザーのメールアドレスを提供します。
ユーザーID	購読を作成したいユーザーのユーザーIDを提供します。メールまたはユーザーIDのいずれかが指定されている必要があります。
APIキーオーバーライド	コネクタ構成で指定されたAPIキーをオーバーライドするためにAPIキーを入力するか、APIキーの属性をマッピングします。

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

パラメータ

パラメータ	説明
購読グループ	購読グループを選択します。
購読グループ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のいずれかが指定されている必要があります。
データフィールド	ユーザープロファイルに保存するデータフィールド。
テンプレート変数	データ入力としてテンプレート変数を提供します。詳細については、テンプレート変数ガイドを参照してください。 ドット表記を使用してネストされたテンプレート変数に名前を付けます。例：items.name。ネストされたテンプレート変数は通常、データレイヤーリスト属性から構築されます。
テンプレート	本文データで参照されるテンプレートを提供します。詳細については、テンプレートガイドを参照してください。 テンプレートは名前で二重中括弧を使用してサポートされるフィールドに注入されます。例：{{SomeTemplateName}}。
APIキーオーバーライド	コネクタ構成で指定されたAPIキーをオーバーライドするためにAPIキーを入力するか、APIキーの属性をマッピングします。

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

パラメータ

パラメータ	説明
リスト	購読解除するリストを選択します。
メール	ユーザーメール。
ユーザーID	通常はデータベースで生成されたIDです。メールまたはユーザーIDのいずれかが指定されている必要があります。
キャンペーン	キャンペーンに購読解除する属性。詳細については、Iterable: キャンペーンの紹介を参照してください。
チャンネル購読解除	リストに関連するチャンネルからメールを購読解除します。
APIキーオーバーライド	コネクタ構成で指定されたAPIキーをオーバーライドするためにAPIキーを入力するか、APIキーの属性をマッピングします。

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

パラメータ

パラメータ	説明
新しいメール	必須。新しいユーザーメール。
現在のメール	現在のユーザーメール。
現在のユーザーID	通常はデータベースで生成されたIDです。メールまたはユーザーIDのいずれかが指定されている必要があります。
APIキーオーバーライド	コネクタ構成で指定されたAPIキーをオーバーライドするためにAPIキーを入力するか、APIキーの属性をマッピングします。

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

パラメータ

パラメータ	説明
メール	ユーザーメール。
ネストされたオブジェクトのマージ	トップレベルのオブジェクトを上書きするのではなくマージします。デフォルト値はFalseです。例えば、ユーザープロファイルが{mySettings:{mobile:true}}を含み、変更連絡先フィールドが{mySettings:{email:true}}を含む場合、結果のプロファイルは{mySettings:{mobile:true,email:true}}を含みます。
ユーザーIDを優先	ユーザーがまだ存在しない場合、指定されたユーザーIDで新しいユーザーを作成します。
ユーザーID	通常はデータベースで生成されたIDです。メールまたはユーザーIDのいずれかが指定されている必要があります。
ユーザーデータフィールド	ユーザープロファイルに保存するデータフィールド。
ユーザーデータフィールドテンプレート変数	データ入力としてテンプレート変数を提供します。詳細については、テンプレート変数ガイドを参照してください。 ドット表記を使用してネストされたテンプレート変数に名前を付けます。例：items.name。ネストされたテンプレート変数は通常、データレイヤーリスト属性から構築されます。

商品属性

パラメータ	説明
商品ID	商品のID。
SKU	商品のSKU。
名前	商品名。
説明	商品の説明。
カテゴリ	商品カテゴリ。
サブカテゴリ	商品サブカテゴリ。
価格	商品価格。
数量	商品の数量。
画像URL	商品画像のURL。
URL	商品ページのURL。
商品データフィールド	追加の商品プロパティ。 複数の商品を追加するための配列型属性を提供します。配列型属性は同じ長さでなければなりません。 商品データフィールドの配列と商品属性の配列は同じ長さでなければなりません。 単一値属性を使用することができ、各商品に適用されます。
商品テンプレート変数	データ入力としてテンプレート変数を提供します。詳細については、テンプレート変数ガイドを参照してください。 ドット表記でネストされたテンプレート変数を名付けます。例：items.name。 ネストされたテンプレート変数は通常、データレイヤーリスト属性から構築されます。
商品テンプレート	ネストされたオブジェクトのサポートが必要な場合、このセクションでテンプレートを定義します。 テンプレートはJSON配列形式を期待しています。 テンプレートが定義されている場合、商品属性セクションの構成は無視されます。 商品テンプレートまたは商品属性のいずれかを指定する必要があります。 詳細については、テンプレートガイドを参照してください。
APIキーオーバーライド	コネクタ構成で指定されたAPIキーをオーバーライドするためにAPIキーを入力するか、APIキーのための属性をマッピングします。

アクション — 購入追跡

パラメータ

パラメータ	説明
合計	必須。注文総額。
購入ID	購入トランザクションのID。
作成日時	イベントが発生した時間。指定されていない場合は、受信した時間に構成されます。Unixタイムスタンプを期待します。このフィールドがマッピングされていない場合、現在のタイムスタンプで初期化されます。

ユーザー属性

パラメータ	説明
メール	メールまたはユーザーIDのいずれかを入力してユーザーを識別する必要があります。両方が入力されている場合、メールが優先されます。
ネストされたオブジェクトのマージ	トップレベルのオブジェクトを上書きするのではなくマージします。デフォルト値はFalseです。例えば、ユーザープロファイルに{mySettings:{mobile:true}}が含まれ、連絡先変更フィールドに{mySettings:{email:true}}が含まれている場合、結果のプロファイルは{mySettings:{mobile:true,email:true}}を含みます。
ユーザーIDを優先	指定されたユーザーIDで新しいユーザーを作成します。ユーザーがまだ存在しない場合。
ユーザーID	通常はデータベースで生成されたIDです。メールまたはユーザーIDのいずれかを指定する必要があります。
キャンペーン	キャンペーンID。詳細については、Iterable: キャンペーンへの導入を参照してください。
プロジェクトテンプレート	テンプレートID。 詳細については、Iterable: テンプレートへの導入を参照してください。
データフィールド	追跡する追加のフィールド。
ユーザーデータフィールド	ユーザープロファイルに保存するデータフィールド。
データフィールドテンプレート変数	データ入力としてテンプレート変数を提供します。詳細については、テンプレート変数ガイドを参照してください。 ドット表記でネストされたテンプレート変数を名付けます。例：items.name。 ネストされたテンプレート変数は通常、データレイヤーリスト属性から構築されます。
データフィールドテンプレート	データフィールドおよびユーザーデータフィールドで参照するためのテンプレートを提供します。詳細については、テンプレートガイドを参照してください。 テンプレートは名前で二重中括弧を使用してサポートされるフィールドに注入されます。例：{{SomeTemplateName}}。

顧客データのマージ

ソースユーザーパラメータ

パラメータ	説明
ソースメール	メールによってソースユーザープロファイルを識別します。このパラメータは文字列または配列であることができます。配列のサイズ制限は10です。
ソースユーザーID	ユーザーIDによってソースユーザープロファイルを識別します。このパラメータは文字列または配列であることができます。配列のサイズ制限は10です。

宛先ユーザーパラメータ

パラメータ	説明
宛先メール	メールによって宛先ユーザープロファイルを識別します。このパラメータは文字列または配列であることができます。配列のサイズ制限は10で、ソースパラメータと同じサイズでなければなりません。
宛先ユーザーID	ユーザーIDによって宛先ユーザープロファイルを識別します。このパラメータは文字列または配列であることができます。配列のサイズ制限は10で、ソースパラメータと同じサイズでなければなりません。
APIキーオーバーライド	コネクタ構成で指定されたAPIキーをオーバーライドするためにAPIキーを入力するか、APIキーのための属性をマッピングします。