Partager via

API de plateforme numérique - Service de marque

Le service de marque en lecture seule vous permet de voir quelles marques d’annonceurs sont inscrites dans notre système, les URL associées à chaque marque, le nombre de créations actives affectées à chaque marque, etc. Vous pouvez également utiliser le service de marque pour obtenir l’ID attribué à une marque spécifique. Cet ID est utilisé dans le service de profil publicitaire et comme entrée facultative pour le service créatif.

Les marques sont classées par société et par catégorie. Pour plus d’informations, consultez Service d’entreprise de marque et Service de catégorie .

API REST

HTTP, méthode Endpoint Description
GET https://api.appnexus.com/brand Afficher toutes les marques

Remarque : la réception de toutes les marques peut prendre un certain temps, car, par défaut, la réponse vous indique le nombre de créations actives affectées à chaque marque. Pour supprimer num_creatives de la réponse et accélérer considérablement l’appel, vous pouvez transmettre simple=true la chaîne de requête, c’est-à-dire https://api.appnexus.com/brand?simple=true.
GET https://api.appnexus.com/brand?search=BRAND_NAME Afficher toutes les marques dont le nom contient certains caractères
GET https://api.appnexus.com/brand?url_search=BRAND_URL Afficher toutes les marques avec des URL contenant des mots complets
GET https://api.appnexus.com/brand?id=BRAND_ID Afficher une marque particulière

Champs JSON

Champ Type Description
category_id int ID de la catégorie associée à la marque.
company_id int ID de la société associée à la marque.
id int ID de la marque.
is_premium valeur booléenne Si truela valeur est , la marque est une marque premium.
last_modified string Lorsque la marque a été modifiée pour la dernière fois.
name string Nom de la marque.
num_creatives int Déconseillé. Retourne actuellement 0.
parent_brand_id int est parent_brand_id l’ID de la société propriétaire de la marque enfant.
Valeur par défaut : null

Remarque : le paramètre « default_brand_status » dans règles de qualité des annonces est remplacé lorsqu’un vendeur définit un paramètre d’approbation explicite pour la marque parente d’une marque. Xandr regroupe les entités dans des relations parent/enfant.
Si un vendeur bloque ou approuve une marque parente, toutes les marques enfants sans approbation ou paramètre de blocage explicite héritent des paramètres de qualité des annonces du vendeur pour la marque parente de cette marque.
Contactez le représentant de compte Xandr si les rapports d’erreurs d’enchères incluent des marques que vous pensez ne sont pas bloquées par vos paramètres de qualité d’annonce.
urls tableau de chaînes URL associées à la marque. Le format est ["brandurl.com", "brandurl.net", ...]

Exemples

Afficher toutes les marques

$ 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
    }
}

Afficher la marque 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": {
            ...
        }
    }
}
  • Last updated on