APSISコネクタ構成ガイド | サーバーサイドコネクター

コネクタアクション

アクション名	AudienceStream	EventStream
Create Subscriber and Add to Mailing List (Queued)	✓	✗
Update Subscriber (Queued)	✓	✗
Add Subscriber to Mailing List	✓	✗
Remove Subscriber from Mailing List	✓	✗
Delete Subscriber (Queued)	✓	✗
Send Transactional Email	✓	✗

構成の構成

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

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

API Key
- APIキーを取得するには、APSIS Proアカウントにログインし、Accountセクションを選択します。
- API Keysリンクを見つけて、新しいAPIキーを生成します。
- 1つのアカウントで複数のAPIキーを持つことができます。
- Account Settingsセクションでキーを管理できます。
- 詳細については、APSIS: Getting Startedを参照してください。

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

Nextをクリックするか、Actionsタブに進みます。ここでコネクタアクションを構成します。

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

アクション - Create Subscriber and Add to Mailing List (Queued)

バッチ制限

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

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

パラメータ

パラメータ	説明
Mailing List	追加するメーリングリストのID。メーリングリストIDを知っている場合は、カスタム値として入力できます。追加するリストを選択するか、リストIDを直接提供します。詳細については、SubscriberService.CreateSubscriberを参照してください。
Create Mode	登録者のアカウントがすでに存在している場合、このパラメータが「Create or Update」に構成されていると、登録者のデータが更新されます。ダブルオプトインで登録する場合、既存の登録者を更新することはできません。
Country code	登録者の国コード。
Desired format	登録者の希望する形式。
Email address	必須。登録者のメールアドレス。
External ID	登録者の外部ID。
Name	登録者の名前。
Password	登録者のパスワード。
Phone number	登録者の電話番号。
Demographic Data	登録者のデモグラフィックデータフィールドのリスト。データフィールドのキーと可能な値は、APSISアカウント管理コンソールで定義されています。
Template Variables	オプション。デモグラフィックデータのテンプレート変数を提供します。詳細については、コネクターテンプレート変数を参照してください。ドット表記でネストされたテンプレート変数を命名します。例：`items.name` ネストされたテンプレート変数は通常、データレイヤーリスト属性から構築されます。
Templates	オプション：デモグラフィックデータで参照されるテンプレートを提供します。詳細については、コネクターテンプレートについてを参照してください。テンプレートは、サポートされるフィールドに名前で二重中括弧で挿入されます。例：`{{SomeTemplateName}}`。

アクション - Update Subscriber (Queued)

バッチ制限

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

パラメータ

パラメータ	説明
Country code	登録者の国コード。
Desired format	登録者の希望する形式。
Email address	必須。登録者のメールアドレス。
Name	登録者の名前。
Password	登録者のパスワード。
Phone number	登録者の電話番号。
User ID	登録者のID。詳細については、Update Subscribersを参照してください。
Demographic Data	登録者のデモグラフィックデータフィールドのリスト。データフィールドのキーと可能な値は、アカウント管理コンソールで定義されています。
Template Variables	オプション。デモグラフィックデータのテンプレート変数を提供します。詳細については、コネクターテンプレート変数を参照してください。ドット表記でネストされたテンプレート変数を命名します。例：`items.name` ネストされたテンプレート変数は通常、データレイヤーリスト属性から構築されます。
Templates	オプション：デモグラフィックデータで参照されるテンプレートを提供します。詳細については、コネクターテンプレート変数を参照してください。テンプレートは、サポートされるフィールドに名前で二重中括弧で挿入されます。例：`{{SomeTemplateName}}`。

アクション - Add Subscriber to Mailing List

パラメータ

パラメータ	説明
Mailing List	追加するリストを選択するか、リストIDを直接提供します。詳細については、SubscriberService.CreateSubscriberを参照してください。メーリングリストIDを知っている場合は、カスタム値として入力できます。
Subscriber’s Email	必須。登録者のメールアドレス。
Subscriber’s ID	登録者のID。詳細については、Update Subscribersを参照してください。

アクション - Remove Subscriber from Mailing List

パラメータ

パラメータ	説明
Mailing List	追加するリストを選択するか、リストIDを直接提供します。詳細については、SubscriberService.CreateSubscriberを参照してください。メーリングリストIDを知っている場合は、カスタム値として入力できます。
Subscriber’s Email	必須。登録者のメールアドレス。
Subscriber’s Id	登録者のID。詳細については、Update Subscribersを参照してください。

アクション - Delete Subscriber (Queued)

バッチ制限

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

パラメータ

パラメータ	説明
Subscriber’s Email	必須。登録者のメールアドレス。

アクション - トランザクショナルメール送信

パラメータ

パラメータ	説明
トランザクショナルプロジェクト	トランザクショナルプロジェクトを選択します。プロジェクトのID。詳細については、トランザクショナルメール送信を参照してください。
非アクティブプロジェクトの無効化	プロジェクトが非アクティブの場合に送信を許可するかどうかを示す真偽値デフォルト値は true です。
国コード	加入者の国コード。
HTML用のデモグラフィックデータ	加入者のデモグラフィックデータフィールドのリスト。データフィールドのキーと可能な値は、APSISアカウント管理コンソールで定義されています。
希望の形式	加入者の希望する形式。
メールアドレス	必須。加入者のメールアドレス
外部ID	加入者の外部ID。
名前	加入者の名前。
電話番号	加入者の電話番号。
送信日	送信日。
送信タイプ	可能な値: m - マーケティング t - トランザクショナル（デフォルト）
デモグラフィックデータ	加入者のデモグラフィックデータフィールドのリスト。データフィールドのキーと可能な値は、APSISアカウント管理コンソールで定義されています。
テンプレート変数	オプション。デモグラフィックデータ用のテンプレート変数を提供します。詳細については、コネクターテンプレート変数を参照してください。ドット表記でネストされたテンプレート変数を名付けます。例: `items.name` ネストされたテンプレート変数は通常、データレイヤーリスト属性から構築されます。
テンプレート	オプション: デモグラフィックデータで参照されるテンプレートを提供します。詳細については、コネクターテンプレートについてを参照してください。テンプレートは名前で指定され、サポートされるフィールドにダブルカーリーブレースで注入されます。例えば、`{{SomeTemplateName}}`。