Bidders - クリエイティブ検索サービス

[アーティクル]
07/05/2024

この読み取り専用サービスでは、監査状態、ID、サイズなどの特定の条件に基づいてクリエイティブを検索できます。システムにクリエイティブを追加するには、クリエイティブサービスに関するページを参照してください。

警告

このサービスは Xandr のプラットフォーム上のすべてのクリエイティブを (自分のプラットフォームだけでなく) 検索するため、広すぎる検索によってエラーが発生する可能性があります。結果を確実に得るには、できるだけ検索を絞り込んでください。

実装

REST API

HTTP メソッド	終点	説明
POST	`[https://api..com/creative-search](https://api..com/creative-search)` (creative_search JSON)	クリエイティブを検索するには。
POST	`[https://api..com/creative-search?sort=FIELD_NAME.ASC_OR_DESC](https://api..com/creative-search?sort=FIELD_NAME.ASC_OR_DESC)` (creative_search JSON)	クリエイティブを検索し、結果を並べ替えます。注: クリエイティブの検索に使用されるフィールドは、返されるフィールドとまったく同じではありません。これは、返されたオブジェクトがクリエイティブサービスから描画され、それに応じて書式設定されるためです。このサービスでは、アクティブなクリエイティブのみが検索されます。

JSON フィールド

フィールド	種類	ソート。	使用
`ad_profile_id`	int	いいえ	と共に使用する必要があります`brand_status`。広告プロファイルの ID でクリエイティブを検索します。
`audit_status`	列挙型の配列	はい	監査状態でクリエイティブを検索します。使用可能な値: "no_audit"、"保留中"、"rejected"、"audited" です。
`brand_ids`	整数の配列	いいえ	ブランドの ID でクリエイティブを検索します。
`brand_status`	列挙型の配列	いいえ	と共に使用する必要があります`ad_profile_id`。ブランドのステータスでクリエイティブを検索します。たとえば、これが "信頼済み" に設定されている場合、 `ad_profile_id` で指定された広告プロファイル内のすべての信頼されたブランドが応答で返されます。使用可能な値: "trusted"、"case-by-case"、"banned"。 [ブランドの状態] フィールドは、このフィルターを使用する場合にのみ応答で返されます。
`click_url`	string	はい	フィルターではありません。結果を昇順または降順で並べ替えます。アルファベット順のクリック URL 順序です。
`creative_ids`	整数の配列	はい。クエリ文字列で "id" を使用します。	ID でクリエイティブを検索します。
`description`	文字列	いいえ	説明で用語でクリエイティブを検索します。
`formats`	列挙型の配列	はい。クエリ文字列で "format" を使用します。	クリエイティブをフォーマットで検索します。使用可能な値: "url-html"、"url-js"、"flash"、"image"、"raw-js"、"raw-html"、"iframe-html"、"url-vast"、"text"。
`landing_page_url`	string	はい	フィルターではありません。結果を昇順または降順のアルファベット順のランディングページ URL で並べ替えます。
`media_content`	文字列	いいえ	[original_content] フィールドのデータでクリエイティブを検索します ( 「Creative Service」を参照)。
`media_subtype`	列挙型の配列	いいえ	非推奨、代わりに `media_subtype_ids`を使用します。メディアサブタイプでクリエイティブを検索します。使用可能な値: "Banner"、"Popup"、"Popunder"
`media_subtype_ids`	整数の配列	はい。クエリ文字列で "media_subtype_id" を使用します。	ID を使用して、メディアサブタイプでクリエイティブを検索します。 Media サブタイプサービスを使用して、目的の ID を検索できます。
`media_url`	string	はい	URL でクリエイティブを検索します。
`member_action`	列挙	いいえ	と共に使用する必要があります`member_ids`。これが "exclude" に設定されている場合は、 `member_ids` で指定されたメンバーを検索から除外します。それ以外の場合は、指定した ID が含まれます。
`member_ids`	整数の配列	はい。クエリ文字列で "member_id" を使用します。	と共に使用する必要があります`member_action`。メンバーの ID でクリエイティブを検索します。
`modified_since`	timestamp	いいえ	この日付以降に変更されたクリエイティブを検索します。形式: "YYYY-MM-DD HH:MM:SS"
`review_status`	列挙型の配列	いいえ	(関連する広告プロファイルから) レビューの状態に基づいてクリエイティブを検索します。使用可能な値: "reviewed"、"unreviewed"。レビュー状態フィールドは、このフィルターを使用する場合にのみ応答で返されます。
`size_in_bytes`	string	はい	フィルターではありません。並べ替えの結果は、昇順または降順のサイズ順になります。
`sizes`	文字列の配列	はい。クエリ文字列で "width" と "height" を使用します。	サイズでクリエイティブを検索します (例: "728x90")。
`template_id`	int	はい	クリエイティブテンプレート ID でクリエイティブを検索します。
`uploaded_since`	timestamp	いいえ	この日付以降にアップロードされたクリエイティブを検索します。形式: "YYYY-MM-DD HH:MM:SS"

例

Xandr の監査に合格したすべてのバナークリエイティブを検索する

$ cat creative_search
{
   "creative_search": {
      "audit_status": [
         "audited"
      ],
      "media_subtype": [
         "banner"
      ]
   }
}

$ curl -b cookies -c cookies -X POST -d @creative_search 'https://api.adnxs.com/creative-search'
{
   "response": {
      "status": "OK",
      "creatives": [
         {
            "id": "48652",
            "width": "300",
            "height": "250",
            "media_url": "https:\/\/cdn.adnxs.com\/p\/05\/d1\/cd\/fe\/05d1cxxxxxx221db2ba8b.png",
            "content": null,
            "format": "image",
            "member_id": "408",
            "brand_id": "1",
            "click_url": "https:\/\/www.sample.com",
            "audit_status": "audited",
            "size_in_bytes": "14545",
            "landing_page_url": null,
            "last_activity": "2010-07-23 16:40:41",
            "created_on": "2010-04-30 07:20:23",
            "media_subtypes": [
               "banner"
            ],
            "pop_values": null
            },
         {
            "id": "73163",
            "width": "300",
            "height": "250",
            "media_url": null,
            "content": "<iframe src=\"https:\/\/xxxx.net\/udm\/img.fetch?sid=2773;tid=2;ev=1;dt=1;\" width=300
             height=250 Marginwidth=0 Marginheight=0 Hspace=0 Vspace=0 Frameborder=0 Scrolling=No><\/iframe>
             <noscript><a href=\"https:\/\/fletcher.net\/udm\/clk.cpx?sid=2773;ev=2;tid=2;dt=3\"><img src=\
             "https:\/\/sample.net\/udm\/img.fetch?sid=2773;ev=1;tid=2;dt=3\" width=300 height=250 border=0>
             <\/a><\/noscript>",
            "format": "iframe-html",
            "member_id": "333",
            "brand_id": "17",
            "click_url": "",
            "audit_status": "audited",
            "size_in_bytes": "0",
            "landing_page_url": "https:\/\/www.appleblueberry.com",
            "last_activity": "2010-09-07 23:33:45",
            "created_on": "2010-08-25 16:31:43",
            "media_subtypes": [
               "banner"
            ],
            "pop_values": null
         },
         ...
      ]
   }
}

2012-01-01 00:00:00 以降にアップロードされたすべてのフラッシュクリエイティブを検索します

$ cat creative_search
{
   "creative_search": {
      "formats": [
         "flash"
      ],
      "uploaded_since": "2012-01-01 00:00:00"
   }
}

$ curl -b cookies -c cookies -X POST -d @creative_search 'https://api.adnxs.com/creative-search'
{
   "response": {
      "status": "OK",
      "creatives": [
         {
            "id": "1207858",
            "width": "160",
            "height": "600",
            "media_url": "https:\/\/cdn.adnxs.com\/p\/c7\/6d\/5b\/bd\/c76d5bbdxxxxx8b9e1507c07cbe61.swf",
            "content": null,
            "format": "flash",
            "member_id": "326",
            "brand_id": "4467",
            "click_url": "https:\/\/clickclick.com\/witness\/p=28xxx96\/c=6sxd3",
            "audit_status": "audited",
            "size_in_bytes": "40077",
            "landing_page_url": "https:\/\/www.destination.com",
            "last_activity": "2012-01-01 15:56:59",
            "created_on": "2012-01-01 02:34:14",
            "media_subtypes": [
               "banner"
            ],
            "pop_values": null
         },
         {
            "id": "1207859",
            "width": "160",
            "height": "600",
            "media_url": "https:\/\/cdn.adnxs.com\/p\/3b\/d6\/f6\/1d\/3bd6f61dkdh4473djfb579430ed.swf",
            "content": null,
            "format": "flash",
            "member_id": "326",
            "brand_id": "4467",
            "click_url": "https:\/\/clickclick.com\/witness\/p=2ddssd6\/c=3423",
            "audit_status": "audited",
            "size_in_bytes": "32094",
            "landing_page_url": "https:\/\/www.destination.com",
            "last_activity": "2012-01-01 15:57:36",
            "created_on": "2012-01-01 02:35:52",
            "media_subtypes": [
               "banner"
            ],
            "pop_values": null
         },
         ...
      ]
   }
}

メンバー 333 に属するすべての 728x90 および 300x250 イメージクリエイティブを検索する

$ cat creative_search
{
   "creative_search": {
      "sizes": [
         "728x90",
         "300x250"
      ],
      "formats": [
         "image"
      ],
      "member_ids": [
         333
      ]
   }
}

$ curl -b cookies -c cookies -X POST -d @creative_search 'https://api.adnxs.com/creative-search'
{
   "response": {
      "status": "OK",
      "creatives": [
         {
            "id": "61967",
            "width": "300",
            "height": "250",
            "media_url": "https://cdn.adnxs.com/p/c8/fb/12/56/c8fb125634xxxx2e67a783d91cf.png",
            "content": null,
            "format": "image",
            "member_id": "333",
            "brand_id": "1",
            "click_url": "https://www.clickplace.com/",
            "audit_status": "no_audit",
            "size_in_bytes": "29433",
            "landing_page_url": null,
            "last_activity": "2011-05-13 02:34:47",
            "created_on": "2010-07-28 20:44:22",
            "media_subtypes": [
               "banner"
            ],
            "pop_values": null
         },
         {
            "id": "291801",
            "width": "728",
            "height": "90",
            "media_url": "https://cdn.adnxs.com/p/54/62/87/d1/546287aasxxx8e6431960ad2b1fb.png",
            "content": null,
            "format": "image",
            "member_id": "333",
            "brand_id": "2450",
            "click_url": "https://thatplace.com/careers",
            "audit_status": "audited",
            "size_in_bytes": "24091",
            "landing_page_url": "https://thatplace.com/careers",
            "last_activity": "2011-05-13 03:30:00",
            "created_on": "2011-04-05 18:28:29",
            "media_subtypes": [
               "banner"
            ],
            "pop_values": null
         },
         ...
      ]
   }
   }

次の方法で共有

Bidders - クリエイティブ検索サービス

実装

REST API

JSON フィールド

例

その他のリソース