Digital Platform API - オブジェクト制限サービス

Xandr は、プラットフォームで使用できる広告申込情報、キャンペーン、クリエイティブ、パブリッシャー、サイト、プレースメント、パッケージ、取引、仲介ネットワーク、仲介入札の数を制限します。 さらに、Xandr では、1 つのドメイン リストで使用できるドメインの数、1 つのプロファイルで使用できる特定のターゲットの数、1 つの配置に割り当てることができるコンテンツ カテゴリの数が制限されます。 クリエイティブを除くすべてのオブジェクト タイプでは、アクティブオブジェクトと非アクティブオブジェクトの両方が制限に対してカウントされます。 クリエイティブの場合、期限切れでないオブジェクトのみが制限に対してカウントされます。

オブジェクト制限サービスを使用すると、これらの制限を表示し、現在の使用状況を事前に監視できます。

REST API

JSON フィールド

マッピングの制限

JSON 応答のこの部分は、、"domain_list"、および "placement" オブジェクト型に対"profile"してのみ設定されます。

プロファイルの場合

ドメイン リストの場合

配置の場合

例

すべてのオブジェクトの種類の制限と現在の使用状況を表示する

$ curl -b cookies -c cookies 'https://api.appnexus.com/object-limit'
{
    "response": {
        "status": "OK",
        "count": 21,
        "start_element": 0,
        "num_elements": 100,
        "object-limits": [
            {
                "object_type": "site",
                "limit": 10000,
                "mappings": [
                ],
                "count_active": 8,
                "count_inactive": 0,
                "count_total": 8
            },
            {
                "object_type": "publisher",
                "limit": 3000,
                "mappings": [
                ],
                "count_active": 8,
                "count_inactive": 0,
                "count_total": 8
            },
            {
                "object_type": "profile",
                "limit": null,
                "mappings": {
                    "site_targets": 100,
                    "publisher_targets": 300,
                    "inventory_source_targets": 500,
                    "content_category_targets": 300,
                    "placement_targets": 250,
                    "segment_targets": 400
                },
                "count_active": null,
                "count_inactive": null,
                "count_total": null
            },
            {
                "object_type": "placement",
                "limit": 20000,
                "mappings": [
                ],
                "count_active": 21,
                "count_inactive": 0,
                "count_total": 21
            },
            {
                "object_type": "line_item",
                "limit": 3000,
                "mappings": [
                ],
                "count_active": 4,
                "count_inactive": 1,
                "count_total": 5
            },
            {
                "object_type": "domain_list",
                "limit": null,
                "mappings": {
                    "domain": 30000
                },
                "count_active": null,
                "count_inactive": null,
                "count_total": null
            },
            {
                "object_type": "creative",
                "limit": 10000,
                "mappings": [
                ],
                "count_active": 32,
                "count_inactive": 0,
                "count_total": 32
            },
            {
                "object_type": "campaign",
                "limit": 10000,
                "mappings": [
                ],
                "count_active": 6,
                "count_inactive": 6,
                "count_total": 12
            }
        ]
    }
}

クリエイティブの制限と現在の使用状況を表示する

$ curl -b cookies -c cookies 'https://api.appnexus.com/object-limit?object_type=creative'
{
    "response": {
        "status": "OK",
        "count": 2,
        "start_element": 0,
        "num_elements": 100,
        "object-limits": [
            {
                "object_type": "creative",
                "limit": 10000,
                "mappings": [
                ],
                "count_active": 32,
                "count_inactive": 0,
                "count_total": 32
            }
        ]
    }
}

既定の制限

既定のオブジェクト制限とよく寄せられる質問の一覧については、「 API 使用状況の制約」を参照してください。

オブジェクトの削除

広告申込情報、キャンペーン、パブリッシャー、サイト、またはプレースメントの上限に近づいたり、上限に達したりすると、 Network Advertiser Analytics や Network Publisher Analytics などのレポートを使用して、過去 30 日間に変更または使用されていないオブジェクトを特定し、それらのオブジェクトを手動で削除できます。 広告申込情報やキャンペーンの場合は、クエリ文字列フィルターを使用して、最初または最後にインプレッションが発生したタイミングに基づいてオブジェクトを検索することもできます。 詳細については、「 広告申込情報サービス と キャンペーン サービス 」を参照してください。

クリエイティブの制限に近づくか上限に達した場合は、期限切れでないクリエイティブを削除する必要があります。 期限切れでないクリエイティブのフィールドは is_expired に false設定されています。 期限切れのクリエイティブを削除した場合、クリエイティブの数には影響しません。