Compartir a través de


API de plataforma digital: servicio de marca

El Servicio de marca de solo lectura le permite ver qué marcas anunciantes están registradas en nuestro sistema, las direcciones URL asociadas a cada marca, el número de creativos activos asignados a cada marca, etc. También puede usar el Servicio de marca para obtener el identificador asignado a una marca específica. Este identificador se usa en el servicio de perfil de anuncios y como entrada opcional para el servicio Creative.

Las marcas se clasifican por empresa y categoría. Para obtener más información, consulte Servicio de empresa de marca y Servicio de categoría .

API de REST

Http (método) Endpoint Description
GET https://api.appnexus.com/brand Ver todas las marcas

Nota: Puede tardar un tiempo en recibir todas las marcas porque, de forma predeterminada, la respuesta indica el número de creatividades activas asignadas a cada marca. Para quitar num_creatives de la respuesta y acelerar significativamente la llamada, puede pasar simple=true la cadena de consulta, es decir, https://api.appnexus.com/brand?simple=true.
GET https://api.appnexus.com/brand?search=BRAND_NAME Ver todas las marcas con nombres que contienen determinados caracteres
GET https://api.appnexus.com/brand?url_search=BRAND_URL Visualización de todas las marcas con direcciones URL que contienen palabras completas
GET https://api.appnexus.com/brand?id=BRAND_ID Visualización de una marca determinada

Campos JSON

Campo Tipo Description
category_id Entero Identificador de la categoría asociada a la marca.
company_id Entero Identificador de la empresa asociada a la marca.
id Entero Identificador de la marca.
is_premium booleano Si truees , la marca es una marca premium.
last_modified string La última vez que se modificó la marca.
name string Nombre de la marca.
num_creatives Entero Obsoleto. Actualmente devuelve 0.
parent_brand_id Entero parent_brand_id es el identificador de la empresa propietaria de la marca secundaria.
Valor predeterminado: null

Nota: La configuración "default_brand_status" de las reglas de calidad de anuncios se invalidará cuando un vendedor establezca una configuración de confianza explícita para la marca primaria de una marca. Xandr agrupa las entidades de marcas en relaciones primarias o secundarias.
Si un vendedor bloquea o aprueba una marca primaria, todas las marcas secundarias sin una aprobación explícita o configuración de bloque heredarán la configuración de calidad del anuncio del vendedor para la marca primaria de esa marca.
Póngase en contacto con el representante de la cuenta de Xandr si los informes de errores de la oferta incluyen marcas que cree que no están bloqueadas por la configuración de calidad del anuncio.
urls matriz de cadenas Direcciones URL asociadas a la marca. El formato es ["brandurl.com", "brandurl.net", ...]

Ejemplos

Ver todas las marcas

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

Ver marca 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": {
            ...
        }
    }
}