デジタル プラットフォーム API - ブランド サービス
読み取り専用ブランド サービスを使用すると、システムに登録されている広告主ブランド、各ブランドに関連付けられている URL、各ブランドに割り当てられているアクティブなクリエイティブの数などを確認できます。 また、ブランド サービスを使用して、特定のブランドに割り当てられた ID を取得することもできます。 この ID は 広告プロファイル サービス で使用され、 クリエイティブ サービスのオプションの入力として使用されます。
ブランドは、会社とカテゴリ別に分類されます。 詳細については、 ブランド会社サービス と カテゴリ サービス に関するページを参照してください。
REST API
| HTTP メソッド | エンドポイント | 説明 |
|---|---|---|
GET |
https://api.appnexus.com/brand |
すべてのブランドを表示する 注: 既定では、各ブランドに割り当てられているアクティブなクリエイティブの数が応答で示されるため、すべてのブランドを受け取るのに時間がかかる場合があります。 応答から削除 num_creativesし、呼び出しを大幅に高速化するには、クエリ文字列 (つまり) https://api.appnexus.com/brand?simple=trueを渡simple=trueします。 |
GET |
https://api.appnexus.com/brand?search=BRAND_NAME |
特定の文字を含む名前を持つすべてのブランドを表示する |
GET |
https://api.appnexus.com/brand?url_search=BRAND_URL |
完全な単語を含む URL を含むすべてのブランドを表示する |
GET |
https://api.appnexus.com/brand?id=BRAND_ID |
特定のブランドを表示する |
JSON フィールド
| フィールド | 種類 | 説明 |
|---|---|---|
category_id |
int | ブランドに関連付けられているカテゴリの ID。 |
company_id |
int | ブランドに関連付けられている会社の ID。 |
id |
int | ブランドの ID。 |
is_premium |
ブール値 | の場合 true、ブランドはプレミアム ブランドです。 |
last_modified |
string | ブランドが最後に変更されたとき。 |
name |
string | ブランドの名前。 |
num_creatives |
int | 非推奨。 現在、0 を返します。 |
parent_brand_id |
int | parent_brand_idは、子ブランドを所有する会社の ID です。 既定値: null 注: 広告品質ルール の "default_brand_status" 設定は、販売者がブランドの親ブランドに対して明示的な信頼設定を設定するとオーバーライドされます。 Xandr は、エンティティを親/子リレーションシップにグループ化します。 販売者が親ブランドをブロックまたは承認した場合、明示的な承認またはブロック設定を持たないすべての子ブランドは、そのブランドの親ブランドの販売者の広告品質設定を継承します。 入札エラーレポートに広告品質設定によってブロックされていないと思われるブランドが含まれている場合は、Xandr アカウント担当者にお問い合わせください。 |
urls |
文字列の配列 | ブランドに関連付けられている URL。 形式は ["brandurl.com"、、 "brandurl.net"...] です。 |
例
すべてのブランドを表示する
$ curl -b cookies -c cookies 'https://api.appnexus.com/brand'
"response": {
"status": "OK",
"brands": [
{
"id": 1,
"name": "Unknown",
"urls": null,
"num_creatives": 130070,
"is_premium": false,
"category_id": 0,
"company_id": 0,
"last_modified": "2010-04-23 20:12:22"
},
{
"id": 2,
"name": "1800Flowers",
"urls": [
"https://ww10.1800baskets.com",
"https://ww10.1800flowers.com",
"https://ww10.1800flowers.com/collection.do?dataset=10291",
"https://ww10.1800flowers.com/collection.do?dataset=10361",
"https://ww10.1800flowers.com/collection.do?dataset=11806",
"https://ww10.1800flowers.com/collection.do?dataset=12226",
"https://ww11.1800flowers.com",
"https://ww12.1800flowers.com",
"https://ww30.1800baskets.com",
"https://ww30.1800flowers.com",
"https://ww31.1800flowers.com",
"https://ww31.1800flowers.com/collection.do?dataset=10291",
"https://ww31.1800flowers.com/collection.do?dataset=11488",
"https://ww31.1800flowers.com/collection.do?dataset=11806",
"https://ww31.1800flowers.com/product.do?baseCode=96457",
"https://ww32.1800flowers.com",
"https://www.1800flowers.com",
"https://www.myfuncards.com",
"https://www.youtube.com/watch?v=3IIA5pHzeMU"
],
"num_creatives": 304,
"is_premium": false,
"category_id": 86,
"company_id": 0,
"last_modified": "2011-04-29 15:30:47"
},
{
"id": 3,
"name": "Ace Hardware",
"urls": [
"https://westlakehardware3.reachlocal.net",
"https://www.acehardware.com",
"https://www.facebook.com/acehardware",
"https://www.westlakehardware.com"
],
"num_creatives": 28,
"is_premium": false,
"category_id": 24,
"company_id": null,
"last_modified": "2010-03-26 21:56:36"
},
{
"id": 4,
"name": "Acura",
"urls": [
"https://acuragta.ca",
"https://acuraoftroy.com",
"https://acuraoftroy.com/",
"https://cuv.acura.ca",
"https://davewhiteacura.com",
"https://detroitacura.com",
"https://garyforceacura5-px.rtrk.com",
"https://michiganacuradealers.com",
"https://milehighacura.com",
"https://nyacuradealers.com",
"https://postnewsads.com/M/MileHighAcura/01.10.12",
"https://radleyacura.com",
"https://rockymountainacuradealers1.reachlocal.net",
"https://socalacuradealers.com",
"https://urlrockymountainacuradealers--com.reachlocal.net",
"https://urlrockymountainacuradealers--com.reachlocal.net/",
"https://www.acura.ca",
"https://www.acura.com",
"https://www.acurafinancialservices.com",
"https://www.acuragassavings.com",
"https://www.acuraofmobile.com",
"https://www.acuraofspringfield.com",
"https://www.foxacura.com",
"https://www.hanselacura.com",
"https://www.jaywolfeacura.com",
"https://www.kingacura.com",
"https://www.losgatosacura.com",
"https://www.parkaveacura.com",
"https://www.primeacura.com",
"https://www.sdacuradealers.com",
"https://www.shieldops.com",
"https://www.socalacuradealers.com",
"https://www.socalacuradealers.com/",
"https://www.springfieldacura.com",
"https://www.springfieldacura.com/",
"https://www.walkeracura.com"
],
"num_creatives": 314,
"is_premium": false,
"category_id": 4,
"company_id": null,
"last_modified": "2010-03-26 21:56:36"
},
{
"id": 5,
"name": "Adobe",
"urls": [
"https://acrobat.try.na.sem.adobe.com",
"https://cem.solutions.adobe.com",
"https://dev.vintedge.com/adobe",
"https://digitalmarketing.adobe-solutions.de/forms/digital_index_report_adzine",
"https://store1.adobe.com",
"https://success.adobe.com",
"https://success.adobe.com/en",
"https://success.adobe.com/en/uk/sem/products/studentandteachereditions/design.md/?sdid=JCBOG",
"https://success.adobe.com/en/uk/sem/products/studentandteachereditions/dwp.md?sdid=JUEGI",
"https://success.adobe.com/fr",
"https://summit.adobe.com",
"https://tryit.adobe.com",
"https://tryit.adobe.com/de",
"https://tryit.adobe.com/fr",
"https://tryit.adobe.com/nl",
"https://tryit.adobe.com/uk",
"https://www.adobe-solutions.de",
"https://www.adobe.com",
"https://www.adobe.com/au",
"https://www.adobe.com/de",
"https://www.adobe.com/fr",
"https://www.adobe.com/nz",
"https://www.adobe.com/products/acrobatpro",
"https://www.adobe.com/products/creativesuite/design",
"https://www.adobe.com/products/creativesuite/web",
"https://www.adobe.com/products/photoshop/photoshop",
"https://www.adobe.com/products/photoshop/photoshopextended",
"https://www.adobe.com/products/premiere",
"https://www.adobe.com/products/premiere/switch",
"https://www.adobe.com/se",
"https://www.adobe.com/uk",
"https://www.adobenordic.com",
"https://www.adobenordic.com/80procent/fi",
"https://www.amazon.com/adobe",
"https://www.amazon.com/advertising",
"https://www.amazon.de/dp/B0076MNR8W",
"https://www.amazon.de/dp/B0076YCBTG",
"https://www.deedshop.com",
"https://www.omniture.com/en",
"https://www.omniture.com/static/2288",
"https://www.studentandteachereditions.adobe.com",
"https://www.theeventmicrosite.com/acrobatx/",
"https://www.todo-descargas.com",
"https://store1.adobe.com",
"https://store1.adobe.com/cfusion/store",
"https://store2.adobe.com",
"https://students-adobe.com/DE",
"https://www.acrobat.com",
"https://www.adobe.com",
"https://www.facebook.com/lightroom",
"www.adobe.com/tw"
],
"num_creatives": 609,
"is_premium": false,
"category_id": 5,
"company_id": null,
"last_modified": "2010-03-26 21:56:36"
},
...
],
"count": 31492,
"start_element": null,
"num_elements": null
}
}
ブランドの表示 10
$ curl -b cookies -c cookies 'https://api.appnexus.com/brand?id=10'
{
"response": {
"brand": {
"id": 10,
"name": "Apple",
"urls": [
"es.apple.com/us/album/windows-down-single/id536331831",
"https://ipad.vodafone.it/offerta_privati_nuovo_ipad",
"https://itunes.apple.com",
"https://itunes.apple.com/album/making-mirrors/id485468305",
"https://itunes.apple.com/artist/id450757148",
"https://itunes.apple.com/ca",
"https://itunes.apple.com/ca/album/id525173605",
"https://itunes.apple.com/ca/norahjones",
"https://itunes.apple.com/Coldplay",
"https://itunes.apple.com/fr/app/logic-immo-immobilier-achat/id308025617",
"https://itunes.apple.com/gb/app/parcelgenie",
"https://itunes.apple.com/gb/preorder/contrast/id520686041",
"https://itunes.apple.com/hk",
"https://itunes.apple.com/ie/album/glee-the-music-the-christmas",
"https://itunes.apple.com/NoelGallagher",
"https://itunes.apple.com/sa",
"https://itunes.apple.com/se/app/id505461593?mt=8",
"https://itunes.apple.com/us",
"https://itunes.apple.com/us/app/american-express/id362348516?mt=8",
"https://itunes.apple.com/us/app/id467810884?mt=8",
"https://itunes.apple.com/us/app/idg-connect-it-white-paper/id477692770",
"https://itunes.apple.com/us/app/marca-ipad-edition",
"https://itunes.apple.com/us/app/my-town-2/id442345455",
"https://itunes.apple.com/us/app/my-town-2/id442345455?mt=8",
"https://itunes.apple.com/us/podcast/max-vangeli-podcast",
"https://itunes.apple.com/us/preorder/california-37/id510442545",
"https://itunes.apple.com/us/preorder/gossamer/id535198341",
"https://mygreenapple.nl/",
"https://store.apple.com",
"https://store.apple.com/be-fr",
"https://store.apple.com/be-nl",
"https://store.apple.com/ca/browse/home/shop_mac/family/macbook_pro",
"https://www.amazon.de/apple",
"https://www.apple.com",
"https://www.apple.com/au",
"https://www.apple.com/itunes",
"https://www.apple.com/itunes/andrewbird",
"https://www.facebook.com/AppleInc",
"https://www.iclg.com",
"https://www.iphonelar.com",
"https://www.macway.com",
"https://www.microconseil.com/newipadantilles"
],
"num_creatives": 212,
"is_premium": false,
"category_id": 5,
"company_id": null,
"last_modified": "2010-03-26 21:56:36"
},
"status": "OK",
"count": 1,
"start_element": null,
"num_elements": null,
"dbg_info": {
...
}
}
}