次の方法で共有

メンバー関係サービス

  • [アーティクル]

注:

このサービスは現在、限られた一連のクライアントと Microsoft の従業員のみが利用できます。 これには、クライアントとパートナーの両方だけでなく、個々の買い手と売り手も含まれます。 たとえば、買い手メンバーは、プラットフォームを通じてクリアするのではなく、売り手メンバーと直接清算関係を設定したい場合があります。

さらに、このフィールドを使用すると、apply_bid_landscape_priority入札ランドスケープ フィードのクライアントである販売者は、特定の購入者のすべての入札を入札状況フィードで確認できます。

注:

  • member_relationこの API サービスのベースとなるデータベース テーブルは、レガシ member_clearing テーブルの機能を置き換えます。 member_clearingテーブルは使用されなくなりました。
  • 顧客の課金と契約に影響を与えるため、Sales Ops を使用して直接明確なリレーションシップを設定または編集する必要があります。 Sales Ops の許可なしに直接明確な関係を設定または編集すると、Xandr がクライアントとの財務上または法的な問題に陥る可能性があります。 Sales Ops が緑色のライトを与えた場合、Justin Pines または IC によって更新が行われます。

REST API

HTTP メソッド エンドポイント 説明
GET https://api.appnexus.com/member-relation?buyer_member_id=MEMBER_ID 他の販売者との買い手として、メンバーのすべての財務関係を表示します。
GET https://api.appnexus.com/member-relation?seller_member_id=MEMBER_ID 他の購入者と売り手としてのメンバーの財務関係をすべて表示します。
GET https://api.appnexus.com/member-relation?id=1,2,3 コンマ区切りリストを使用して、ID で複数のメンバー関係オブジェクトを表示します。
GET https://api.appnexus.com/member-relation?member_id=100&id=1 特定のメンバーの財務関係を表示する:
PUT https://api.appnexus.com/member-relation?member_id=100&id=1 特定のメンバーの財務関係を更新します。
POST https://api.appnexus.com/member-relation?member_id=100 特定のメンバーの財務関係を作成します。
GET https://api.appnexus.com/member-relation/meta フィルター処理および並べ替え可能なフィールドを確認します。

JSON フィールド

名前 型 説明
id int このオブジェクトのシステム ID。
buyer_member_id int このメンバーと関係がある購入者メンバーのメンバー ID。

必須:POST
seller_member_id int このメンバーと関係がある販売者メンバーのメンバー ID。

必須:POST
expose_inventory_sources ブール値 このフィールドは使用されません。

既定値: true
clear_direct ブール値 Xandrがメディアのコストを収集するか、この購入者と売り手のペア間の取引のために売り手の支払いを支払うかどうか。 より正確に:

- 場合 true、Xandr は、メディアのコストを収集したり、この買い手と売り手のペア間のトランザクションの売り手の支払いを支払いません。 Xandr は、その月のすべての直接クリアされたアクティビティに対する の member_contract.direct_clear_fee 値に基づいて、購入者から直接クリア料金のみを収集します。

- の場合 false、Xandr はメディアのコストを収集し、この買い手と売り手のペアの間の取引に対して売り手の支払いを行います。 Xandrは、契約によって決定されたすべてのアクティビティに対して、買い手オークションサービスの控除または手数料または売り手控除を収集します。

既定値: false
apply_bid_landscape_priority ブール値 販売者の入札状況フィードにこの購入者の入札を含めるかどうか。 より正確に:

の場合 trueは、この買い手の入札が上位 15 件でもオークションでの落札でもなくても、売り手の入札状況フィードに常に買い手の入札を含めます。

の場合 falseは、売り手の入札状況を通常と同じように扱います。

既定値: true

例

特定の財務関係を表示する

この例では、ID 別に特定の財務関係を表示します。

$ curl -b cookies https://api.appnexus.com/member-relation?member_id=100&id=1
{
    "response": {
        "dbg_info": {
            "member_last_modified_age": 1436,
            "s1ave_lag": 0,
            "version": "1.13.8.16",
            "start_microtime": 1358438257.7108,
            "time": 30.287027359009,
            "warnings": [],
            "awesomesauce_cache_used": false,
            "db": "06.mysql.sand-08.nym2",
            "s1ave_hit": true,
            "instance": "11.hbapi.sand-08.nym1"
        },
        "member_relation": {
            "apply_bid_landscape_priority": false,
            "clear_direct": true,
            "expose_inventory_sources": true,
            "seller_member_id": 1,
            "buyer_member_id": 2,
            "id": 1
        },
        "num_elements": "",
        "start_element": "",
        "count": 1,
        "status": "OK"
    }
}

メンバーが買い手 (または売り手) として機能するすべての財務関係を表示する

この例では、メンバーが他の売り手からの買い手として機能するすべての関係を表示します。他の購入メンバーに対する売り手として機能するすべての関係を表示するには、代わりに パラメーターを 次のように seller_member_id 変更します。

$ curl -b cookies https://api.appnexus.com/member-relation?buyer_member_id=100
{
    "response": {
        "dbg_info": {
            "s1ave_miss": "no_service_index",
            "version": "1.13.13",
            "start_microtime": 1360770598.1499,
            "time": 22.953033447266,
            "warnings": [],
            "awesomesauce_cache_used": false,
            "db": "master",
            "s1ave_hit": false,
            "instance": "30.bm-hbapi.prod.nym1"
        },
        "member_relations": [
            {
                "apply_bid_landscape_priority": false,
                "clear_direct": true,
                "expose_inventory_sources": true,
                "seller_member_id": 72,
                "buyer_member_id": 100,
                "id": 4
            }
        ],
        "num_elements": "",
        "start_element": "",
        "count": 1,
        "status": "OK"
    }
}

特定のメンバーリレーションシップ オブジェクトを更新する

$ cat update-member-relation.json

{
    "member_relation": {
        "expose_inventory_sources": false
    }
}

$ curl -b cookies -X PUT "https://api.appnexus.com/member-relation?member_id=1309&id=1"
{
    "response": {
        "dbg_info": {
            "master_time": 417.2089099884,
            "proxy": true,
            "master_instance": "05.hbapi.sand-08.lax1",
            "version": "1.13.8.17",
            "start_microtime": 1358958675.3114,
            "time": 762.11285591125,
            "warnings": [],
            "awesomesauce_cache_used": false,
            "parent_dbg_info": {
                "version": "1.13.8.17",
                "start_microtime": 1358958675.4393,
                "time": 417.2089099884,
                "warnings": [],
                "awesomesauce_cache_used": false,
                "db": "master",
                "s1ave_hit": false,
                "instance": "05.hbapi.sand-08.lax1"
            },
            "db": "master",
            "s1ave_hit": false,
            "instance": "10.hbapi.sand-08.nym1"
        },
        "member_relation": {
            "apply_bid_landscape_priority": false,
            "clear_direct": true,
            "expose_inventory_sources": false,
            "seller_member_id": 1,
            "buyer_member_id": 2,
            "id": 1
        },
        "num_elements": "",
        "start_element": "",
        "id": "1",
        "count": 1,
        "status": "OK"
    }
}

新しいメンバーリレーションシップ オブジェクトを作成する

$ cat new-member-relation.json

{
    "member_relation": {
        "expose_inventory_sources": true,
        "seller_member_id": 1308,
        "buyer_member_id": 1309,
        "clear_direct": true
    }
}

$ curl -b cookies -X POST -d @new-member-relation.json "https://api.appnexus.com/member-relation?member_id=1309"
{
    "response": {
        "dbg_info": {
            "master_time": 391.0858631134,
            "proxy": true,
            "master_instance": "05.hbapi.sand-08.lax1",
            "version": "1.13.8.17",
            "start_microtime": 1358963519.9095,
            "time": 556.19502067566,
            "warnings": [],
            "awesomesauce_cache_used": false,
            "parent_dbg_info": {
                "version": "1.13.8.17",
                "start_microtime": 1358963520.0377,
                "time": 391.0858631134,
                "warnings": [],
                "awesomesauce_cache_used": false,
                "db": "master",
                "s1ave_hit": false,
                "instance": "05.hbapi.sand-08.lax1"
            },
            "db": "master",
            "s1ave_hit": false,
            "instance": "11.hbapi.sand-08.nym1"
        },
        "member_relation": {
            "apply_bid_landscape_priority": false,
            "clear_direct": true,
            "expose_inventory_sources": true,
            "seller_member_id": 1312,
            "buyer_member_id": 1309,
            "id": 65
        },
        "num_elements": "",
        "start_element": "",
        "id": "65",
        "count": 1,
        "status": "OK"
    }
    }