Tango Email サービス

注:

このサービスは現在、限られた一連のクライアントと Microsoft の従業員のみが利用できます。

このサービスは、Email テンプレート サービスと組み合わせて使用され、チームは Tango のシステム メールの送信を管理できます。 チームが API チームではなくシステム メールを管理できるようにすると、Tango チームはシステム メールの変更をより迅速に反復処理してデプロイできます。

注:

このサービスはすべてのメンバーに表示されますが、Xandr の従業員のみが使用する必要があります。 したがって、このドキュメントは、さらなる通知が行われるまで Xandr の従業員にのみ表示されます。

REST API

HTTP メソッド	エンドポイント	説明
POST	https://api.appnexus.com/tango-email (send_email JSON)	システムメールを送信します。

JSON フィールド

名前	型	説明
id	int	送信される電子メール メッセージの ID。 既定値: 自動インクリメントされた数値。
email_id	int	電子メールの設定と書式設定に使用されたテンプレートの ID。 Email テンプレート サービスを使用して、使用可能な電子メール テンプレートとその ID の一覧を表示できます。 必須:POST
sender_user_id	int	読み取り専用。 電子メールを送信したユーザーの ID (このサービスに POSTed)。 管理者は、このフィールドの値を設定して、それ以外のメール送信者を定義できます。
sender_member_id	int	読み取り専用。 電子メールを送信したユーザー (このサービスに POSTed) に関連付けられているメンバーの ID。 管理者は、このフィールドの値を設定して、それ以外のメール送信者を定義できます。
recipient_user_id	int	電子メールを受信する必要があるユーザーの ID。 必須:POST
recipient_member_id	int	メールを受信するユーザーに関連付けられているメンバーの ID。
partner_relationship_id	int	電子メール メッセージが関連付けられているパートナー関係の ID。 必須:POST
partner_relationship_deal_id	int	電子メール メッセージが関連付けられている取引の ID。
additional_fields	オブジェクトの配列	この配列を使用して、フィールドで定義した電子メール テンプレートに存在する可能性がある追加のマクロの値を email_id 定義できます。 たとえば、メール テンプレートにデータ プレースホルダーが %deal_name% 含まれている場合は、この配列に含めて deal_name = "My Favorite Deal" 、メール テキスト内に表示する取引名を指定できます。
recipient_is_buyer	ブール値	の場合 true、メールの受信者はパートナー関係の購入者です。 このフィールドは現在使用されていません。 既定値: false

例

システム メールを送信する

$ cat send_email
{
 "tango_email":
  {     "email_id" : 19,
        "recipient_member_id" : 3837,
        "partner_relationship_id" : 175
  }
}

$ curl -b cookies -c cookies -X POST -d @send_email.json "https://api.appnexus.com/tango-email"
{
  "response": {
    "status": "OK",
    "id": 0,
    "count": 1
  }
}