Bidders - オブジェクト制限サービス

Xandr は、プラットフォームで使用できる期限切れでないクリエイティブの数を制限します。 さらに、Xandr では、1 つのドメイン リストで使用できるドメインの数と、1 つのプロファイルで使用できる特定のターゲットの数が制限されます。 クリエイティブを除くすべてのオブジェクト タイプでは、アクティブオブジェクトと非アクティブオブジェクトの両方が制限に対してカウントされます。 クリエイティブの場合、期限切れでないオブジェクトのみが制限に対してカウントされます。 クリエイティブの有効期限は、過去 14 日間に配信も変更も行われなかった場合 (15 日目は 期限切れとして更新されます)。

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

REST API

HTTP メソッド	エンドポイント	説明
GET	https://api.adnxs.com/object-limit	すべてのオブジェクトの種類の制限と現在の使用状況を表示します。
GET	https://api.adnxs.com/object-limit?object_type=OBJECT_TYPE	特定のオブジェクトの種類の制限と現在の使用状況を表示します。 ヒント：使用可能なオブジェクトの種類は、creativeprofileおよび domain_listです。

JSON フィールド

フィールド	種類	説明
count_active	int	アクティブなオブジェクトの現在の数。 クリエイティブの場合、このカウントには期限切れのクリエイティブは含まれません。
count_inactive	int	削除されたオブジェクトを含まない非アクティブなオブジェクトの現在の数。 クリエイティブの場合、このカウントには期限切れのクリエイティブは含まれません。
count_total	int	アクティブなオブジェクトと非アクティブなオブジェクトの現在の合計数。 クリエイティブの場合、このカウントには期限切れのクリエイティブは含まれません。
limit	int	入札者が許可するオブジェクトの最大数。 を除く "creative"すべてのオブジェクト型に対して、アクティブオブジェクトと非アクティブオブジェクトの両方が制限値としてカウントされます。 クリエイティブの場合、期限切れでないオブジェクトのみが制限に対してカウントされます。
mapping_limits	object	このフィールドは、 型と "domain_list" オブジェクト型に対"profile"してのみ設定されます。 各プロファイルおよびドメイン リスト内のオブジェクトの制限が一覧表示されます。たとえば、1 つのプロファイルで使用できるセグメント ターゲットの最大数や、1 つのドメイン リストで使用できるドメインの最大数などです。 詳細については、以下の「マッピング制限」を参照してください。
object_type	列挙	オブジェクトの種類を指定します。 使用可能な値: "creative"、、 "profile"または "domain_list"。 メモ：と の場合、limitcount_activecount_inactive、および count_total フィールドには のnull値が表示されます。Xandr では、使用できるプロファイルとドメイン リストの数は制限されません。"profile""domain_list" ただし、Xandr では、各プロファイルまたはドメイン リスト内のオブジェクトの数が制限されます。 これらの制限がフィールドに mapping_limits 表示されます。

マッピングの制限

JSON 応答のこの部分は、 および "domain_list" オブジェクト型に対"profile"してのみ設定されます。 各プロファイルおよびドメイン リスト内のオブジェクトの制限が一覧表示されます。

プロファイルの場合

フィールド	種類	説明
content_category_targets	int	1 つのプロファイルでターゲットにできるカスタム コンテンツ カテゴリの最大数。
inventory_source_targets	int	廃止。
placement_targets	int	1 つのプロファイルでターゲットにできる配置の最大数。
platform_content_category_targets	int	1 つのプロファイルでターゲットにできる Xandr で定義されたコンテンツ カテゴリの最大数。
postal_code_targets	int	1 つのプロファイルでターゲットにできる郵便番号の最大数。
publisher_targets	int	1 つのプロファイルでターゲットにできるパブリッシャーの最大数。
segment_group_targets	int	1 つのプロファイルでターゲットにできるセグメント グループの最大数。
segment_targets	int	1 つのプロファイルでターゲットにできるセグメントの最大数。
site_targets	int	1 つのプロファイルでターゲットにできるサイトの最大数。

ドメイン リストの場合

フィールド	種類	説明
domains	int	1 つのドメイン リストに含めることができるドメインまたは除外できるドメインの最大数。

例

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

$ curl -b cookies -c cookies 'https://api.adnxs.com/object-limit'
{
    "response": {
        "status": "OK",
        "count": null,
        "start_element": null,
        "num_elements": null,
        "object-limits": [
            {
                "object_type": "profile",
                "limit": null,
                "mapping_limits": {
                    "inventory_source_targets": 500,
                    "content_category_targets": 300,
                    "platform_content_category_targets": 300,
                    "postal_code_targets": 4000,
                    "segment_targets": 400,
                    "publisher_targets": 300,
                    "site_targets": 100,
                    "placement_targets": 250,
                    "segment_group_targets": 400
                },
                "count_active": null,
                "count_inactive": null,
                "count_total": null
            },
            {
                "object_type": "domain_list",
                "limit": null,
                "mapping_limits": {
                    "domains": 30000
                },
                "count_active": null,
                "count_inactive": null,
                "count_total": null
            },
            {
                "object_type": "creative",
                "limit": 16000,
                "mapping_limits": [
                ],
                "count_active": 0,
                "count_inactive": 0,
                "count_total": 0
            }
        ],
        "dbg": {
        ...
        }
    }
}

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

$ curl -b cookies -c cookies 'https://api.adnxs.com/object-limit?object_type=creative'
{
    "response": {
        "status": "OK",
        "count": null,
        "start_element": null,
        "num_elements": null,
        "object-limits": [
            {
                "object_type": "creative",
                "limit": 16000,
                "mapping_limits": [
                ],
                "count_active": 0,
                "count_inactive": 0,
                "count_total": 0
            }
        ],
        "dbg": {
            ...
        }
    }
}

FAQ

オブジェクトの制限に関してよく寄せられる質問の一覧については、「 オブジェクトの制限 - FAQ」を参照してください。

オブジェクトの削除

ドメイン リストまたはプロファイル ターゲットの制限に近づくと、非アクティブ、未使用、または不要なオブジェクトを削除する必要があります。

• ドメイン リストからドメインを削除するには、PUTドメイン リスト サービスを呼び出して配列を更新しますdomains。
• プロファイルからターゲットを削除する方法については、「 拡張入札者プロファイル」を参照してください。

クリエイティブの上限に近づくと、期限切れでないクリエイティブを削除する必要があります。 期限切れでないクリエイティブのフィールドは is_expired に false設定されています。

注:

期限切れのクリエイティブを削除した場合、クリエイティブの数には影響しません。

クリエイティブを削除するには、クリエイティブ サービスをDELETE呼び出します。