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

コネクタのアクション

アクション名	AudienceStream	EventStream
キャンペーン紹介イベントの記録	✓	✓
アンバサダーの更新	✓	✓
アンバサダーコミッションの追加	✓	✓
連絡先の削除	✓	✓

構成の構成

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

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

ユーザー名：
ユーザー名の検索方法については、次を参照してください：https://docs.getambassador.com/docs/authentication
APIキー：
APIキーの検索方法については、次を参照してください：https://docs.getambassador.com/docs/authentication

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

次へをクリックするか、アクションタブに移動します。ここでは、コネクタのアクションを構成します。

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

アクション - キャンペーン紹介イベントの記録

パラメータ

パラメータ	説明
メールアドレス	顧客のメールアドレス。このエンドポイントの詳細については、次を参照してください：https://docs.getambassador.com/v2.0.0/reference#eventrecord。
キャンペーンUID	キャンペーンのID。製品IDが使用されていない場合は必須です。
製品ID	キャンペーンに割り当てられた製品ID。キャンペーンUIDの代わりに使用できます。キャンペーンUIDが使用されていない場合は必須です。
ショートコード	リファラーの「mbsy」ショートコード。初期のコミッションに必要です。
収益	イベントの収益金額。デフォルト値は `0` です。
トランザクションUID	イベントの一意のトランザクションID。
IPアドレス	顧客のIPアドレス。
顧客UID	顧客の内部で一意のID。
名前	顧客の名前。
姓	顧客の姓。
カスタムフィールド1	カスタムフィールド。アンバサダーに関連します。
カスタムフィールド2	カスタムフィールド。アンバサダーに関連します。
カスタムフィールド3	カスタムフィールド。アンバサダーに関連します。
新しいアンバサダーへのメール送信	新しいアンバサダーへのログイン資格情報をメールで送信します (`1`=はい、`0`=いいえ)。デフォルト値は `1` です。
新しいアンバサダーの無効化	作成された新しいアンバサダーは無効化されます (`1`=はい、`0`=いいえ)。デフォルト値は `0` です。
顧客の自動作成	顧客がアンバサダーでない場合、作成します (`1`=はい、`0`=いいえ)。デフォルト値は、2013年11月5日以降にアンバサダーに登録した場合は `0`、それ以外の場合は `1` です。
グループIDへの追加	新しいアンバサダーが作成されるグループを定義します。このパラメータを使用すると、デフォルトのグループ構成とアンバサダーの現在のグループが上書きされます。グループIDはカンマで区切られる必要があります。 `add_to_group_id`= `-1` の場合、アンバサダーはどのグループにも追加されません。
イベントデータ1	カスタムフィールド。イベントに関連します。
イベントデータ2	カスタムフィールド。イベントに関連します。
イベントデータ3	カスタムフィールド。イベントに関連します。
承認されたコミッション	コミッションのステータス (`1`=承認済み、`0`=保留中)。値を入力すると、キャンペーンの自動承認構成が上書きされます。指定されていない場合は、キャンペーンの構成が使用されます。
住所	顧客の住所。
都市	顧客の都市。
州	顧客の州。
郵便番号	顧客の郵便番号。
国	顧客の国。
電話	顧客の電話番号。

アクション - アンバサダーの更新

パラメータ

パラメータ	説明
UID	アンバサダーの内部で一意のID。メールアドレスが提供されていない場合は必須です。メールアドレスとUIDの両方が提供されている場合、UIDが優先されます。このエンドポイントの詳細については、次を参照してください：https://docs.getambassador.com/v2.0.0/reference#ambassadorupdate。
メールアドレス	アンバサダーのメールアドレス。 UIDが提供されていない場合は必須です。メールアドレスとUIDの両方が提供されている場合、UIDが優先されます。
新しいメールアドレス	アンバサダーの新しいメールアドレス。
新しいUID	アンバサダーの新しいUID。
名前	アンバサダーの新しい名前。
姓	アンバサダーの新しい姓。
カスタムフィールド1	カスタムフィールド1の新しい値。
カスタムフィールド2	カスタムフィールド2の新しい値。
カスタムフィールド3	カスタムフィールド3の新しい値。
アンバサダーの無効化	1=アンバサダーの無効化。0=アンバサダーの有効化。デフォルト値は `0` です。無効化すると、アンバサダーのステータスが「Banned」に変更されます。
ウェルカムメールの送信	(1=はい、0=いいえ)。
住所	アンバサダーの新しい住所。
都市	アンバサダーの新しい都市。
州	アンバサダーの新しい州。
郵便番号	アンバサダーの新しい郵便番号。
国	アンバサダーの新しい国。
電話	アンバサダーの新しい電話番号。
PayPalのメールアドレス	アンバサダーの新しいPayPalのメールアドレス。
会社	アンバサダーの新しい会社名。
グループの構成	既存のアンバサダーを配置するグループを定義します。このパラメータを使用すると、デフォルトのグループ構成とアンバサダーの現在のグループが上書きされます。グループIDはカンマで区切られる必要があります。

アクション - アンバサダーコミッションの追加

パラメータ

パラメータ	説明
UID	アンバサダーの内部で一意のID。メールアドレスが使用されていない場合は必須です。両方が存在する場合、UIDが優先されます。このエンドポイントの詳細については、次を参照してください：https://docs.getambassador.com/v2.0.0/reference#commissionadd。
アンバサダーのメールアドレス	アンバサダーのメールアドレス。 UIDが使用されていない場合は必須です。両方が存在する場合、UIDが優先されます。
キャンペーンUID	キャンペーンのID。
コミッション金額	コミッションの金額。
顧客のメールアドレス	顧客のメールアドレス。
名前	顧客の名前。
姓	顧客の姓。
収益金額	収益の金額。
トランザクションUID	コミッションの一意のトランザクションID。
リファラーUID	リファラーの内部で一意のID。
顧客UID	顧客の内部で一意のID。
承認されたコミッション	`1`=承認済みのコミッション、`0`=保留中のコミッション。
新しいアンバサダーへのメール送信	新しいアンバサダーへのログイン資格情報をメールで送信します (`1`=はい、`0`=いいえ)。
新しいアンバサダーの無効化	作成された新しいアンバサダーは無効化されます (`1`=はい、`0`=いいえ)。
イベントデータ1	カスタムフィールド。イベント/コミッションに関連します。
イベントデータ2	カスタムフィールド。イベント/コミッションに関連します。
イベントデータ3	カスタムフィールド。イベント/コミッションに関連します。

アクション - 連絡先の削除

パラメータ

パラメータ	説明
メールアドレス	削除する連絡先のメールアドレス。このエンドポイントの詳細については、次を参照してください：https://docs.getambassador.com/v2.0.0/reference#complianceremove。