英語で読む

次の方法で共有


Bidders - メンバー サービス

注意

メンバーは Xandr のシステムに統合され、メンバー サービスを介して管理されます。

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

メンバーと契約

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

注意

  • 他のプラットフォーム メンバーに関する情報をお探しの場合は、 プラットフォーム メンバー サービスを使用します。
  • bidder サンドボックス環境では、メンバー サービスのすべての機能を使用できます。
  • メンバー サービスは API アクセスを許可しません。 これは 、ユーザー サービスを介して行われます。

REST API

HTTP メソッド エンドポイント 説明
GET https://api.adnxs.com/member すべてのメンバーを表示するには。
GET https://api.adnxs.com/member/MEMBER_ID 特定のメンバーを表示するには。

注意

以下の呼び出しは、Xandr 従業員にのみ表示されます。 "管理者" user_typeを持つユーザーが作成できます。

HTTP メソッド エンドポイント 説明
POST https://api.adnxs.com/member 新しいメンバーを追加するには。
PUT https://api.adnxs.com/member/MEMBER_ID 既存のメンバーを変更するには。

JSON フィールド

フィールド 種類 説明
active ブール型 メンバーが在庫の提供や入札を行えるかどうか。
agent_id string インベントリ アグリゲーター メンバーに使用されます。
allow_ad_profile_override このフィールドは現在使用されていません。
audit_notify_email string Xandr がこのメンバーに属するクリエイティブを監査するたびに、このメール アドレスに詳細な応答が送信されます。 応答には、クリエイティブの監査状態と、クリエイティブが監査に合格していない理由が含まれます。 このフィールドでは、複数のコンマ区切りメール アドレスがサポートされます。
bidder_id int メンバーの入札を管理する入札者。 インベントリのみを販売するメンバーの場合は空白にすることができます。
billing_address_1 string(255) メンバーのアドレスの最初の行。
billing_address_2 string(255) メンバーのアドレスの 2 行目。
billing_city string(100) メンバーの住所の市区町村。
billing_country string(50) メンバーの国。
billing_name string(100) 課金名 (誰にチェックを書き込むか)。
必須 On:POST
billing_postal_code string(50) メンバーの住所の郵便番号。
billing_region string メンバーのアドレスのリージョン。
buyer_clearing_fee_pct double 料金として請求された在庫に対して支払われた CPM の割合。
buyer_credit_limit double Xandr を使用して在庫を購入するときのこのメンバーの与信限度額。 読み取り専用です。
code string(100) 内部 ID を追加するオプションの方法。
contact_email このフィールドは現在使用されていません。
default_ad_profile_id int メンバーに属するすべての TinyTag の広告プロファイルを設定する場合。
default_tag_id int 不明なコードを使用してタグが呼び出されている場合に配信するクリエイティブの ID。
dongle string メンバーが入札者から関連するデバッグ出力にアクセスできるようにするデバッグ オークション ("dongle" パラメーターとして) に渡すことができるパスワード。
email_code string(50) 電子メール コードは、TinyTags が電子メール タグ処理ツールを使用して処理されるときに使用される一意の値です。 英数字を指定する必要があります。
id int メンバーの ID。
必須 On:PUT
last_activity timestamp この bidder インスタンスに対する最後の変更のタイムスタンプ。
platform_exposure 詳細については、以下を参照してください。
price_buckets 配列 プリエンプティブ タグを使用する場合、販売メンバーがサード パーティの広告サーバーの価格に Price Bucket を必要とする場合があります。 サード パーティの広告サーバーが必要とする統合の種類によっては、値が [{"price_bucket": 10}, {"price_bucket": 20}. . . ]
または
[{"price_bucket": 10, "width": 300, "height":200", "pixel_url": "https://..."}, . . . ].
prioritize_margin ブール型 "true"に設定した場合、Xandr は広告申込情報の最小マージン設定に基づいて、管理対象キャンペーンに対して入札/入札なしチェックを実行します。

[ "false"] に設定した場合、Xandr は広告申込情報の最小値に基づいて、管理対象キャンペーンに対して入札/入札チェックを実行しません。
seller_revshare_pct double bidder-users とメンバーの読み取り専用。
Xandr が販売者の収益から取り出す割合。
serving_domain 文字列の配列 メンバーを販売するためのタグを生成するときに使用されます。 (つまり、代わりにib.adnxs.commycompany.adnxs.com)。
"serving_domain": {"cname": null,"type": null}
読み取り専用です。
sherlock_notify_email string 自動クリエイティブ スキャン システムである Sherlock が、このメンバーに属するクリエイティブをスキャンするたびに、このメール アドレスに応答が送信されます。 応答には、クリエイティブの監査状態と、クリエイティブが監査に合格していない理由が含まれます。 詳細については、「 Sherlock」を参照してください。
このフィールドでは、複数のコンマ区切りメール アドレスがサポートされます。
timezone string メンバーのタイムゾーンは、レポートの既定のタイムゾーンです。
使用可能な値については、「 レポートのタイムゾーン」を参照してください。
既定値は "EST5EDT" です。

プラットフォームの公開

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

プラットフォームの露出値 動作
hidden メンバーは表示されません。

手記:platform_exposure"hidden" に設定すると、sellers.json ファイルのメンバー "name" フィールドと"domain" フィールドが非表示になり、メンバーシートが"is_confidential": 1として一覧表示されます。 たとえば、hidden参照してください。
これにより、一部の DSP が、 "schain" オブジェクトで透過的でない販売者からインプレッションを購入することを選択できない可能性があるため、在庫の収益化が制限される可能性があります。
private メンバーは "メンバー 123" として表示されます。ここで、123 はメンバー ID です。
public 課金名を使用してメンバーが表示されます。

手記:platform_exposure"public" に設定すると、メンバー "name""domain" フィールドがsellers.json ファイルに表示されます。 たとえば、public参照してください。

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_namebidder_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"
      }
   }
}