Bidders - メンバー サービス

Xandr のプラットフォーム (通常は買い手または売り手) と財務関係を持つエンティティは、トランザクションを実行する前に、"メンバー" として Xandr のシステムに追加する必要があります。 メンバーは、入札者またはXandr担当者がメンバーサービスに登録できます。

メンバーと契約

広告を購入または販売する前に、メンバーは Xandr と契約する必要があります。 この契約は、財務条件と信用施設 (該当する場合) を確立し、コンテンツの品質や個人を特定できる情報の使用など、Xandr の使用条件にメンバーを拘束します。 入札者はいつでもメンバーを作成できますが、メンバーは契約が承認されるまで入札できません。

REST API

JSON フィールド

プラットフォームの公開

プラットフォーム公開設定は、プラットフォーム上の他のメンバーにアカウントを表示する方法を決定します。 次に示すように、動作が若干異なる 3 つの値があります。

hidden 例

{
  "seller_id": "8253",
  "is_confidential": 1,
  "seller_type": "PUBLISHER"
}

public 例

{
  "seller_id": "7694",
  "seller_type": "INTERMEDIARY",
  "domain": "groupm.com",
  "name": "Xaxis – Slovakia Marketplace"
}

次のサンプル JSON は、このパラメーターを設定する方法を示しています。

{
  "member": {
    "platform_exposure": "public"
  }
}

認証トークン

API Services を使用する場合、認証は常に最初の手順です。 認証トークンは、後で使用するために Cookie ファイルに書き込むことができます。 詳細な手順については、「 認証サービス」を参照してください。

例

メンバーを記述する JSON 形式のファイルを作成する

必須フィールドは、メンバーが入札者に関連付けられている場合は billing_name と bidder_id のみですが、メンバーは Xandr と財務関係があるため、他の課金関連の情報を含める必要があります。

$ cat member
{
        "member" : {
                "active" : true,
                "billing_name" : "My Company",
                "bidder_id" : 2,
                "billing_address_1" : "One Coke Way",
                "billing_city" : "Atlanta",
                "billing_region" : "GA",
                "billing_country" : "US",
        "email_code" : "cola"
        }
}

メンバー ファイルをインプレッション バス キャッシュに追加する

$ curl -b cookies -c cookies -X POST --data-binary @member 'https://api.adnxs.com/member'
{
        "response":{
                "status":"OK","id":1
        }
}

次に、変更された JSON 形式のファイルを使用してメンバーを変更します

$ cat member_mod
{
        "member" : {
                "active" : true,
                "billing_name" : "My Company",
                "bidder_id" : 2,
                "billing_address_1" : "Building 5",
                "billing_address_2" : "Company Complex",
                "billing_city" : "Atlanta",
                "billing_region" : "GA",
                "billing_country" : "US",
                "billing_postal_code" : "33608"
        }
}

メンバー ID を使用して、インプレッション バス キャッシュ内のメンバー情報を更新する

$ curl -b cookies -c cookies-X PUT --data-binary @member_mod 'https://api.adnxs.com/member/1'
{
        "response":{
                "status":"OK"
        }
}

メンバーに関する情報を表示する

$ curl -b cookies -c cookies 'https://api.adnxs.com/member/1'
{
   "response":{
      "status":"OK",
      "member": {
        "id": 334,
        "agent_id": null,
        "code": null,
        "active": true,
        "buyer_credit_limit": 0,
        "billing_name" : "My Company",
                "bidder_id" : 2,
                "billing_address_1" : "Building 5",
                "billing_address_2" : "Company Complex",
                "billing_city" : "Atlanta",
                "billing_region" : "GA",
                "billing_country" : "US",
                "billing_postal_code" : "33608"
        "email_code": "cola",
        "seller_revshare_pct": 95,
        "price_buckets": [
        ],
        "default_tag_id": null,
        "default_ad_profile_id": 251,
        "buyer_clearing_fee_pct": null,
        "serving_domain": {
          "cname": null,
          "type": null
        },
        "last_activity": "2010-04-08 03:38:16",
        "timezone": "EST5EDT"
      }
   }
}