Bidders - メンバー サービス
注意
メンバーは Xandr のシステムに統合され、メンバー サービスを介して管理されます。
Xandr のプラットフォーム (通常は買い手または売り手) と財務関係を持つエンティティは、トランザクションを実行する前に、"メンバー" として Xandr のシステムに追加する必要があります。 メンバーは、入札者またはXandr担当者がメンバーサービスに登録できます。
広告を購入または販売する前に、メンバーは Xandr と契約する必要があります。 この契約は、財務条件と信用施設 (該当する場合) を確立し、コンテンツの品質や個人を特定できる情報の使用など、Xandr の使用条件にメンバーを拘束します。 入札者はいつでもメンバーを作成できますが、メンバーは契約が承認されるまで入札できません。
注意
- 他のプラットフォーム メンバーに関する情報をお探しの場合は、 プラットフォーム メンバー サービスを使用します。
- bidder サンドボックス環境では、メンバー サービスのすべての機能を使用できます。
- メンバー サービスは 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 | 既存のメンバーを変更するには。 |
フィールド | 種類 | 説明 |
---|---|---|
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.com mycompany.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 参照してください。 |
{
"seller_id": "8253",
"is_confidential": 1,
"seller_type": "PUBLISHER"
}
{
"seller_id": "7694",
"seller_type": "INTERMEDIARY",
"domain": "groupm.com",
"name": "Xaxis – Slovakia Marketplace"
}
次のサンプル JSON は、このパラメーターを設定する方法を示しています。
{
"member": {
"platform_exposure": "public"
}
}
API Services を使用する場合、認証は常に最初の手順です。 認証トークンは、後で使用するために Cookie ファイルに書き込むことができます。 詳細な手順については、「 認証サービス」を参照してください。
必須フィールドは、メンバーが入札者に関連付けられている場合は 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
}
}
$ 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"
}
}
$ 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"
}
}
}