取引の適格性要件: 取引を設定する

[アーティクル]
02/26/2024

Xandr のオープンエクスチェンジで取引を行うために満たす必要がある要件の 1 つは、取引サービスを理解していることを確認することです。理解を示すために、AN Talent(882) と AN Challenge(1370) の 2 人の Xandr テストメンバーとの取引を作成します。取引は同じ在庫を表す必要があるため、常に同じ入札要求に表示されます。各取引では、1 日あたり 10,000 インプレッションを超えるインプレッションを確認する必要があります。

手順 1: 購入者メンバー AN Talent との取引を設定する (882)

フィールド	型 (長さ)	説明	予期される値 (テストの場合)
`code`	string (100)	取引のカスタムコード。メモ：このフィールドは必須であり、PMP オブジェクトの取引 ID フィールドを介して受信入札要求に渡される内部取引 ID を表します。	PMP のオブジェクト、取引 ID フィールドに渡す値。
`nacme`	string (255)	取引の名前。	APN テスト取引 1
`active`	ブール型	true の場合、取引はアクティブです。取引は、このフィールドが true で、過去 (または null) であり、 `start_date` 将来 (または null) `end_date` である場合にのみ買い手が利用できる点に注意してください。	true
`start_date`	timestamp	取引が買い手に提供され始める日時。これが設定されている場合、形式は "YYYY-MM-DD HH:MM:SS" である必要があります。	2017-01-01 00:00:00
`end_date`	timestamp	取引が買い手に提供されなくなった日と時刻。これが設定されている場合、形式は "YYYY-MM-DD HH:MM:SS" である必要があります。	2037-01-01 00:00:00
`floor_price`	double	買い手が取引の資格を得るために入札する必要がある最小 CPM 値。	0.5
`use_deal_floor`	ブール型	true の場合は、 `floor_price` が取引に適用されます。	true
`buyer`	object	この取引をターゲットにできる購入メンバー。詳細については、以下の「購入者」を参照してください。	882
`type`	object	取引の種類。プラットフォーム販売者の場合、取引はオープンオークションまたはプライベートオークションです。詳細については、以下の「型」を参照してください。	2

バイヤー

購入者オブジェクトは、で POST設定できますが、で PUT更新することはできません。購入者を変更する場合は、新しい取引を作成する必要があります。オブジェクトには buyer 、次のフィールドが含まれている必要があります。

フィールド	種類	説明	予期される値 (テストの場合)
`id`	int	購入者のメンバー ID。	882

型

オブジェクトには type 、次のフィールドが含まれている必要があります。

フィールド	型 (長さ)	説明	予期される値 (テストの場合)
`id`	int	取引の種類を表す ID。使用可能な値: - 1 = オープンオークション「オープンオークション」では、他の手段を介して在庫をターゲットとする取引と買い手をターゲットとする買い手は、印象を競います。取引を対象とする買い手が最高額の入札を送信し、その入札が取引のフロアをクリアした場合、その買い手はオークションに勝ち、2番目に高い入札または取引フロア価格のどちらか高い方を支払います。取引以外の購入者の 1 人が最高額の入札を送信した場合、その購入者はオークションに勝ち、2 番目に高い入札または ECP のどちらか高い方を支払います。 - 2 = プライベートオークション「プライベートオークション」では、プライベート取引をターゲットとするバイヤーが最初に印象を競います。次に、どの取引購入者も勝たなかった場合、オークションは他の手段を介して在庫をターゲットとするバイヤーに開かれます。取引を対象とする購入者が、取引のフロアよりも高く、他のプライベートオークション入札よりも高い入札を送信した場合、その買い手はオークションに勝ち、プライベートオークションから 2 番目に高い入札または取引フロア価格のどちらか高い方を支払います。プライベートオークションの取引がフロアをクリアしない場合は、オープンオークションの最高入札が勝ち、オープンオークションから 2 番目に高い入札または ECP のどちらか高い方を支払います。これらのさまざまな種類のオークションのしくみを示す例については、ドキュメントの「取引オークションの仕組み」を参照してください。	プライベートオークション

手順 2: 購入者メンバーの AN チャレンジに同じ取引を設定する (1370)

フィールド	型 (長さ)	説明	予期される値 (テストの場合)
`code`	string (100)	取引のカスタムコード。メモ：このフィールドは必須であり、PMP のオブジェクトである取引 ID フィールドを介して受信入札要求に渡される内部取引 ID を表します。	PMP のオブジェクト、取引 ID フィールドに渡す値。
`name`	string (255)	取引の名前。	APN テスト取引 2
`active`	ブール型	true の場合、取引はアクティブです。取引は、このフィールドが true で、過去 (または null) であり、 `start_date` 将来 (または null) `end_date` である場合にのみ買い手が利用できる点に注意してください。	true
`start_date`	timestamp	取引が買い手に提供され始める日時。これが設定されている場合、形式は "YYYY-MM-DD HH:MM:SS" である必要があります。	2017-01-01 00:00:00
`end_date`	timestamp	取引が買い手に提供されなくなった日と時刻。これが設定されている場合、形式は "YYYY-MM-DD HH:MM:SS" である必要があります。	2037-01-01 00:00:00
`floor_price`	double	買い手が取引の資格を得るために入札する必要がある最小 CPM 値。	0.5
`use_deal_floor`	ブール型	true の場合は、 `floor_price` が取引に適用されます。	true
`buyer`	object	この取引をターゲットにできる購入メンバー。詳細については、以下の「購入者」を参照してください。	1370
`type`	object	取引の種類。プラットフォーム販売者の場合、取引はオープンオークションまたはプライベートオークションです。詳細については、以下の「型」を参照してください。	2

購入者メンバー AN Challenge (1370)

購入者オブジェクトは、で POST設定できますが、で PUT更新することはできません。購入者を変更する場合は、新しい取引を作成する必要があります。

オブジェクトには buyer 、次のフィールドが含まれている必要があります。

フィールド	種類	説明	予期される値 (テストの場合)
`id`	int	購入者のメンバー ID。	1370

取引の種類

オブジェクトには type 、次のフィールドが含まれている必要があります。

フィールド	型 (長さ)	説明	予期される値 (テストの場合)
`id`	int	取引の種類を表す ID。使用可能な値: - 1 = オープンオークション「オープンオークション」では、他の手段を介して在庫をターゲットとする取引と買い手をターゲットとする買い手は、印象を競います。取引を対象とする買い手が最高額の入札を送信し、その入札が取引のフロアをクリアした場合、その買い手はオークションに勝ち、2番目に高い入札または取引フロア価格のどちらか高い方を支払います。取引以外の購入者の 1 人が最高額の入札を送信した場合、その購入者はオークションに勝ち、2 番目に高い入札または ECP のどちらか高い方を支払います。 - 2 = プライベートオークション「プライベートオークション」では、プライベート取引をターゲットとするバイヤーが最初に印象を競います。次に、どの取引購入者も勝たなかった場合、オークションは他の手段を介して在庫をターゲットとするバイヤーに開かれます。取引を対象とする購入者が、取引のフロアよりも高く、他のプライベートオークション入札よりも高い入札を送信した場合、その買い手はオークションに勝ち、プライベートオークションから 2 番目に高い入札または取引フロア価格のどちらか高い方を支払います。プライベートオークションの取引がフロアをクリアしない場合は、オープンオークションの最高入札が勝ち、オープンオークションから 2 番目に高い入札または ECP のどちらか高い方を支払います。これらのさまざまな種類のオークションのしくみを示す例については、ドキュメントの「取引オークションの仕組み」を参照してください。	プライベートオークション

手順 3: レビューのために取引を送信する

取引サービスを適切に構築し、上記の説明に従って両方の取引を設定したと確信したら、トラフィックをレビューするためにサポートケースを送信してください。作成した Xandr 取引 ID の両方を含めます。プロセスの最後の手順を更新します。

Deal Service API

REST API

新しい取引を追加します。

POST https://api.appnexus.com/deal 
(deal JSON)

既存の取引を変更する:

PUT https://api.appnexus.com/deal?id=DEAL_ID
(deal_update JSON)

購入者に対するすべての取引を表示します。

GET https://api.appnexus.com/deal

特定の取引を表示する:

GET https://api.appnexus.com/deal?id=DEAL_ID

コンマ区切りのリストを使用して、ID で複数の取引を表示します。

GET https://api.appnexus.com/deal?id=1,2,3

取引を削除する:

DELETE https://api.appnexus.com/deal?id=DEAL_ID

例

呼び出しの例POST

$ cat new_test_deal_1
 
{
    "deal": {
        "code": "APN-TEST1",
        "use_deal_floor": true,
        "name": "APN Test Deal 1",
        "active": true,
        "start_date": "2016-12-01 01:00:00",
        "end_date": "2037-01-01 00:00:00",
        "floor_price": 0.5,
        "currency": "USD",
        "buyer": {
            "id": 882
        },
        "type": {
            "id": 2
        }
    }
}
 
$ curl -b cookies -c cookies -X POST -d @new_test_deal_1.json 'https://api.appnexus.com/deal'
 
{
    "response": {
        "status": "OK",
        "count": 1,
        "id": 64,
        "start_element": 0,
        "num_elements": 100,
        "deal": {
            "id": 64,
            "code": "APN-TEST1,
            "name": "APN Test Deal 1",
            "description": null,
            "active": true,
            "start_date": "2016-12-01 01:00:00",
            "end_date": "2037-01-01 00:00:00",
            "profile_id": null,
            "package_id": null,
            "floor_price": 0.5,
            "currency": "USD",
            "use_deal_floor": true,
            "last_modified": "2013-12-04 20:43:44",
            "seller": {
                "id": 2345,
                "name": "Seller 123"
            },
            "buyer": {
                "id": 882,
                "bidder_id": 2,
                "name": "AN Talent"
            },
            "type": {
                "id": 2,
                "name": "Private Auction"
            },
            "brands": null,
            "ask_price": 0,
            "size_preference": null
        }
    }
}

次の方法で共有