Digital Platform API - プラットフォーム メンバー サービス

  • [アーティクル]

これは読み取り専用サービスで、購入先および販売先の他の Xandr プラットフォーム メンバーに関する公開情報が表示されます。 また、データ プロバイダーに関する情報も表示されます。

REST API

HTTP メソッド エンドポイント 説明
GET https://api.appnexus.com/platform-member 情報を公開したすべてのメンバーを表示します。
GET https://api.appnexus.com/platform-member?active=1 情報を公開したアクティブなメンバーのみを表示します。
GET https://api.appnexus.com/platform-member?id=MEMBER_ID 特定のメンバーを表示します。

JSON フィールド

フィールド 種類 説明
active Boolean の場合 true、メンバーは です active。
bidder object そのメンバーがインプレッションを購入するために使用する入札者の ID と名前。
contact_info object メンバーの連絡先と追加情報。
daily_imps_any_audit_status int 監査状態を持つインベントリを通じた 1 日あたりのインプレッション数。これには、 の両方が含まれますunauditedseller-reviewedXandr-reviewed。Xandr-and-seller-reviewed
daily_imps_appnexus_reviewed int Xandr によって監査されたインベントリによる 1 日あたりのインプレッション数。
daily_imps_appnexus_seller_reviewed int 次の 3 つの監査状態 seller-reviewedのいずれか (、 Xandr-reviewed、および両方 Xandr-and-seller-reviewed) を持つインベントリを通じた 1 日あたりのインプレッション数。
daily_imps_self_audited int 非推奨。
daily_imps_unaudited int 非推奨。
daily_imps_verified int 非推奨。
default_discrepancy_pct double Xandr と供給パートナーが獲得したインプレッションとして記録された過去の不一致に基づいて、Xandr が特定の外部供給パートナーの各入札から差し引く割合。
description string メンバーの説明。
email string メンバーへの連絡に使用する電子メール アドレス。
has_resold ブール値 の場合 true、メンバーは他のメンバーに再販のインベントリを公開しています。 インベントリ再販サービスを使用して、公開されているインベントリに関する情報を表示できます。
id int メンバーの ID。
is_iash_compliant ブール型 の場合 true、メンバーは IASH に準拠しています。
last_modified timestamp メンバー エントリが最後に変更された日時。
name string メンバーの名前。
primary_type 列挙 メンバーの種類。このメンバーが Xandr で実行するトランザクションの主な種類を示します。 使用可能な値:
- "network"
- "buyer"
- "seller"
- "data_provider"
platform_exposure 列挙 プラットフォーム上のメンバーの可視性。 使用可能な値:
- "public" - メンバー名が表示されます。
- "private" - メンバー ID のみが表示されます。
- "hidden" - メンバーは、このサービスによってまったく表示されません。
seller_member_groups object 販売者メンバーのグループの ID、名前、表示順序と、エントリが作成され、最後に変更された日時。
seller_type 列挙 メンバーと Xandr の間の販売関係。 使用可能な値:
- "platform" - Xandr は、メンバーの契約に基づいて在庫を販売するためにメンバーに請求します。
- "partner" - Xandr は、このメンバーの在庫を購入する際の契約に基づいて、販売に対してメンバーに課金するのではなく、購入者に請求します。
visibility_rules object が の場合primary_type"seller"、メンバーの入札要求に含まれる詳細レベル。 詳細については 、以下の「可視性ルール」 を参照してください。

可視性ルール

フィールド 種類 説明
expose_publishers ブール型 使用されていません。 販売者は、常に入札要求で発行元 ID を送信します。

選択した顧客のみ: の場合 false、販売者は入札要求で発行元 ID を送信しません。
expose_tags ブール型 使用されていません。 このフィールドは、ほとんどの顧客が使用できません。 プレースメント ID は常に入札リクエストに渡されます。

選択した顧客のみ: の場合 true、販売者は入札要求でプレースメント ID を送信します。
expose_age ブール型 の場合 true、販売者は入札要求でユーザーの年齢を送信します。
expose_gender ブール型 の場合 true、販売者は入札要求でユーザーの性別を送信します。
expose_universal_categories ブール型 使用されていません。
expose_custom_categories 列挙 販売者の入札要求におけるカスタム コンテンツ カテゴリの可視性。 使用可能な値:
- "none" - カスタム カテゴリは入札要求に渡されません。
- "all" - すべてのカスタム カテゴリが入札要求で渡されます。
- "list" - 配列に custom_categories 一覧表示されているカスタム カテゴリは、入札要求で渡されます。
custom_categories オブジェクトの配列 販売者が入札要求で渡すカスタム コンテンツ カテゴリ (が "list"の場合expose_custom_categories)。
url_exposure 列挙 販売者の入札要求におけるインプレッション URL の可視性。 使用可能な値:
- "full" - 完全な URL は入札要求で渡されます。
- "domain" - 入札要求では、URL のドメインのみが渡されます。
- "hidden" - URL は入札要求で渡されません。 販売者の既定の URL が設定されている場合は、引き続き販売者の既定の URL を受け取る可能性があることに注意してください。

例

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

$ curl -b cookies -c cookies 'https://api.appnexus.com/platform-member?id=74'
{
    "response": {
        "status": "OK",
        "platform-member": {
            "id": 74,
            "name": "PubMatic",
            "description": null,
            "primary_type": "seller",
            "platform_exposure": "public",
            "email": null,
            "daily_imps_verified": 200168000,
            "daily_imps_self_audited": 200168000,
            "daily_imps_unaudited": 168582133,
            "daily_imps_any_audit_status": 885677200,
            "daily_imps_appnexus_reviewed": 557187900,
            "daily_imps_appnexus_seller_reviewed": 557187900,
            "is_iash_compliant": false,
            "has_resold": false,
            "visibility_rules": {
                "expose_publishers": true,
                "expose_tags": true,
                "expose_age": true,
                "expose_gender": true,
                "expose_universal_categories": true,
                "url_exposure": "full",
                "expose_custom_categories": "none"
            },
            "bidder": {
                "id": "0",
                "name": "internal bidder"
            },
            "seller_type": "partner",
            "contact_info": [
                {
                    "name": "PubMatic RTB Team",
                    "title": null,
                    "email": "RTB@pubmatic.com",
                    "phone": null,
                    "address": null,
                    "address_2": null,
                    "city": "New York",
                    "country": "USA",
                    "region": "NY",
                    "postal_code": null,
                    "additional_info": "PubMatic can significantly increase the reach of your media buy, increase the efficiency of acquiring new publishers, and strengthen your publisher relationships. Contact us to learn how we can work together.",
                    "website_url": null,
                    "types": [
                        "supply"
                    ]
                }
            ],
            "active": true,
            "last_modified": "2013-06-21 17:48:49",
            "default_discrepancy_pct": 1
        },
        "count": 1,
        "start_element": 0,
        "num_elements": 100
    }
}

情報を公開したすべてのメンバーに関する情報を表示する

$ curl -b cookies -c cookies 'https://api.appnexus.com/platform-member'
{
    "response": {
        "status": "OK",
        "platform-members": [
            {
                "id": 3,
                "name": "MikeOnAds",
                "description": null,
                "primary_type": "seller",
                "platform_exposure": "public",
                "email": null,
                "daily_imps_verified": 100,
                "daily_imps_self_audited": 100,
                "daily_imps_unaudited": 0,
                "daily_imps_any_audit_status": 2800,
                "daily_imps_appnexus_reviewed": 2600,
                "daily_imps_appnexus_seller_reviewed": 2600,
                "is_iash_compliant": false,
                "has_resold": true,
                "visibility_rules": {
                    "expose_publishers": true,
                    "expose_tags": true,
                    "expose_age": true,
                    "expose_gender": true,
                    "expose_universal_categories": true,
                    "url_exposure": "full",
                    "expose_custom_categories": "none"
                },
                "bidder": {
                    "id": "2",
                    "name": "DisplayWords"
                },
                "seller_type": "partner",
                "active": true,
                "last_modified": "2013-06-18 10:10:51",
                "default_discrepancy_pct": null
            },
            {
                "id": 7,
                "name": "Adify",
                "description": null,
                "primary_type": "network",
                "platform_exposure": "public",
                "email": null,
                "daily_imps_verified": null,
                "daily_imps_self_audited": null,
                "daily_imps_unaudited": null,
                "daily_imps_any_audit_status": null,
                "daily_imps_appnexus_reviewed": null,
                "daily_imps_appnexus_seller_reviewed": null,
                "is_iash_compliant": true,
                "has_resold": true,
                "visibility_rules": {
                    "expose_publishers": true,
                    "expose_tags": true,
                    "expose_age": true,
                    "expose_gender": true,
                    "expose_universal_categories": true,
                    "url_exposure": "full",
                    "expose_custom_categories": "none"
                },
                "bidder": {
                    "id": "0",
                    "name": "internal bidder"
                },
                "seller_type": "partner",
                "active": false,
                "last_modified": "2012-09-13 13:13:39",
                "default_discrepancy_pct": null
            },
            {
                "id": 8,
                "name": "Ning",
                "description": null,
                "primary_type": "network",
                "platform_exposure": "public",
                "email": null,
                "daily_imps_verified": null,
                "daily_imps_self_audited": null,
                "daily_imps_unaudited": null,
                "daily_imps_any_audit_status": null,
                "daily_imps_appnexus_reviewed": null,
                "daily_imps_appnexus_seller_reviewed": null,
                "is_iash_compliant": false,
                "has_resold": true,
                "visibility_rules": {
                    "expose_publishers": true,
                    "expose_tags": true,
                    "expose_age": true,
                    "expose_gender": true,
                    "expose_universal_categories": true,
                    "url_exposure": "full",
                    "expose_custom_categories": "none"
                },
                "bidder": {
                    "id": "0",
                    "name": "internal bidder"
                },
                "seller_type": "platform",
                "active": false,
                "last_modified": "2012-09-13 13:13:39",
                "default_discrepancy_pct": null
            },
            ...
        ],
        "count": 335,
        "start_element": 0,
        "num_elements": 100
    }
}