Compartir a través de

Proveedores asociados: respuesta de la oferta

  • Artículo

Advertencia

Hemos deshabilitado el protocolo de integración de suministro (ASI) (anteriormente AppNexus Supply Integration) para las integraciones de suministro del lado servidor a partir del 1 de octubre de 2017. Le recomendamos encarecidamente que migre el suministro al protocolo OpenRTB. Todo en esta sección es contenido heredado.

Después de enviar una solicitud de puja, Xandr devuelve una respuesta de puja en formato JSON. En esta página se explican los posibles campos JSON y sus valores. Los ejemplos de la parte inferior de la página muestran los campos que se devuelven cuando:

  • Xandr envía una oferta
  • Xandr no envía una oferta: no hay ninguna oferta disponible
  • Xandr no envía una oferta: error
  • Xandr envía una creatividad de vídeo VAST (AÚN NO COMPATIBLE)

Sugerencia

Si una oferta de Xandr gana la subasta, debe insertar el precio de la oferta ganadora en la %%pricepaid%% macro de antes de ad_tag colocar la etiqueta en la página web.

Campos JSON

Campo Tipo Description Ejemplo
external_auction_id string El identificador de la subasta del partner de suministro, tal como se envía en la solicitud de puja. "A4s24536"
appnexus_auction_id Entero Xandr tiene su propia subasta para seleccionar la oferta que se va a enviar para su subasta. Este es el identificador del evento de subasta Xandr. 4396943919143109134
bid decimal Valor de CPM de la puja de Xandr. 0.206367
creative_id Entero El identificador del creativo que se sirve si Xandr gana la subasta. 345634
landing_page_url string Dirección URL de la página de aterrizaje de la creatividad. "www.landingpage.com"
brand_id Entero El identificador Xandr para la marca de la creatividad. Para asignar identificadores de marca a nombres, use el Servicio de marca. 12
buyer_member_id Entero Identificador del miembro propietario de la creatividad. 3453
no_bid booleano Si es true, Xandr no tiene una oferta para su subasta. false
request_error booleano Si es true, un error impidió que Xandr enviara una oferta. false
request_error_id Entero Identificador del error. Este campo solo se devuelve cuando request_error es true. Para ver todos los identificadores de error posibles y sus significados, consulte la sección Errores a continuación. 3
ad_tag string La etiqueta de anuncio que se coloca en la página web si Xandr gana la subasta.

Nota: Si desea realizar un seguimiento de los clics, Xandr puede agregar una macro para la dirección URL de clic: &pubclick=%%pub_click_url%%.

Para más información sobre esta funcionalidad, póngase en contacto con el equipo de implementación.		 Consulte los ejemplos siguientes.

Plantillas de suministro

En el caso de las creatividades de vídeo VAST, si necesita parámetros personalizados que no se incluyen normalmente en la ad_tag respuesta de la puja, puede pedir a Xandr que cree una plantilla de suministro automáticamente. Aquí se muestra cómo funciona:

  1. Se comunica directamente con el representante de Xandr sobre los parámetros personalizados que desea devolver para las creatividades de vídeo VAST.
  2. Si Xandr está de acuerdo con su solicitud, Xandr crea una plantilla de suministro y le envía el identificador.
  3. En las solicitudes de puja para las creatividades de vídeo VAST, se incluye el identificador de plantilla de suministro en el template_id campo.
  4. En las respuestas de puja, la plantilla de suministro agrega los parámetros personalizados a la <Extensions> sección de ad_tag.

Ejemplo

Supongamos que desea que Xandr incluya la siguiente información adicional para las creatividades de vídeo DE VAST:

  • Estrategia de licitación (CPM, CPC, etc.)
  • Moneda
  • Origen de la oferta

La plantilla de suministro que Xandr crearía para agregar esta información a la <Extensions> sección de ad_tag:

"ad_tag":"<?xml version="1.0" encoding="UTF-8" standalone="no"?><VAST version="2.0" xmlns:xsi=
                "http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="vast.xsd">
                <Ad id="560469"><Wrapper><AdSystem version="1.0">adnxs</AdSystem><VASTAdTagURI><![CDA
                TA[http://ib.adnxs.com/ab?enc=AAAAAAAA8D8AAAAAAADwPwAAAAAAAPA_AAAAAAAA8D8AAAAAAADwPwkWl1e
                GIxl9XgZfiHCnHw8p021QAAAAADd8CQBVBAAAVQQAAA0AAABVjQgAMmgBAAAAAQBVU0QAVVNEAAEAAQASEwAAVgAB
                BAMCAQUAAIIAaRIvXgAAAAA.&cnd=%21chngsgiT1QUQ1ZoiGAAgstAFMAA4kqYEQARI1QhQt_glWABgLmgAcAB4A
                IABAIgBAJABAZgBAaABAagBALABALkBAAAAAA AA8D_BAQA AAAAAAPA_yQEzMzMzMzMDQNkBAAAAAAAA8D_gAQA.
                &udj=uf%28%27a%27%2C+51512%2C+1349374761%29%3Buf%28%27r%27%2C+560469%2C+1349374761%29%3B&
                ccd=%212gSgJwiT1QUQ1ZoiGLLQBSAE&vpid=171&referrer=espn.com&dlo=1&pp=%%pricepaid%%]>
                </VASTAdTagURI><Impression></Impression><Creatives><Creative AdID="560469"><Linear>
                </Linear></Creative></Creatives><Extensions><Extension type="Partner Name">
                <Price model="CPM" currency="USD" source="AppNexus">1</Price></Extension>
                </Extensions></Wrapper></>"

Nota:

Para obtener la respuesta de puja completa para una creatividad de vídeo VAST, consulte los ejemplos siguientes.

Errores

Cuando un error impide que Xandr envíe una oferta, en request_error_id la respuesta le ayuda a diagnosticar el problema.

request_error_id Significado
1 La sintaxis de la solicitud de puja era incorrecta.
2 No se pudo analizar el identificador de miembro de la solicitud.
3 La solicitud no se ha asignado a un identificador de usuario de Xandr.
4 La solicitud de puja no incluyeba external_auction_id.
5 La solicitud no se ha asignado a una ubicación.
6 No se pudo realizar la subasta de Xandr.
7 El formato solicitado ad_format no coincidía con el formato de selección de ubicación.
8 Xandr bloquea el inventario (por ejemplo page_url, ) o el usuario (por ejemplo, ip_address).
9 El ad_format parámetro (obligatorio) no se pasó en la solicitud.

Nota:

**El identificador de error 8 también se desencadenará si el perfil de destino global del miembro de compra excluye el dominio pasado.

Ejemplos

Xandr envía una oferta

{
    "external_auction_id": "A4s24536",
    "appnexus_auction_id": 4396943919143109000,
    "request_error": false,
    "no_bid": false,
    "bid": 0.206367,
    "creative_id": 345634,
    "landing_page_url": "http://www.landingpage.com",
    "brand_id": 12,
    "buyer_member_id": 328,
    "ad_tag": "<scriptsrc='http: //ib.adnxs.com/ab?enc=nkFD_wQXyz-iXL8FfvnHPwAAAAAAAOA_oly_BX75xz-eQUP_BBfLP0p8RFYC0OIKHKmTLdGzBl2rOWpOAAAAALGQCADLAQAAbAEAAAIAAACyGQkAmwkBAAEAAABVU0QAVVNEANgCWgC0AoMDvw4BAgUCAQQAAAAAciHhvwAAAAA.&tt_code=13394&udj=uf%28%27a%27%2C+1008%2C+1315584427%29%3Buf%28%27c%27%2C+117682%2C+1315584427%29%3Buf%28%27g%27%2C+51717%2C+1315584427%29%3Buf%28%27r%27%2C+596402%2C+1315584427%29%3Bppv%2815221%2C+%27784417993571728458%27%2C+1315584427%2C+1318176427%2C+117682%2C+67995%29%3Bppv%2815223%2C+%27784417993571728458%27%2C+1315584427%2C+1315670827%2C+117682%2C+67995%29%3Bppv%2815225%2C+%27784417993571728458%27%2C+1315584427%2C+1318176427%2C+117682%2C+67995%29%3Bppv%2815227%2C+%27784417993571728458%27%2C+1315584427%2C+1318176427%2C+117682%2C+67995%29%3Bppv%2815229%2C+%27784417993571728458%27%2C+1315584427%2C+1318176427%2C+117682%2C+67995%29%3Bppv%2815231%2C+%27784417993571728458%27%2C+1315584427%2C+1318176427%2C+117682%2C+67995%29%3B&cnd=!VyRDEwiylwcQsrMkGAAgm5MEMAA4tAVAAEjsAlAAWABgrARoAHAAeACAAQCIAQCQAQGYAQGgAQGoAQOwAQC5AUw3iUFg5cA_wQFwscHFBhfLP8kBmpmZmZmZ8T_ZAYV80LNZ9eM_4AHkKA..&ccd=!XASOJAiylwcQsrMkGJuTBCAA&referrer=http: //www.nydailynews.com&media_subtypes=1&pp=%%pricepaid%%'></script>"
}

Xandr no envía una oferta: no hay ninguna oferta disponible

{
   "external_auction_id":"A4s24536",
   "no_bid":true,
   "request_error":false
}

Xandr no envía una oferta: error

{
   "external_auction_id":"A4s24536",
   "no_bid":true,
   "request_error":true,
   "request_error_id":2
}

Xandr envía una creatividad de vídeo VAST (AÚN NO COMPATIBLE)

Cuando Xandr envía una creatividad de vídeo VAST:

  • La creatividad se pasa como XML DE VAST con escape en el ad_tag campo.
  • Si la puja gana la subasta, debe desajuste el contenido antes de colocarlo en la página.
  • Si la puja gana la subasta, debe insertar el precio de la oferta ganadora (en CPM) en la %%pricepaid%% macro de ad_tag.
  • Si ha pedido a Xandr que cree una plantilla de suministro que pase parámetros personalizados en las pujas creativas de VAST, esos parámetros personalizados aparecerán dentro de la <Extensions> etiqueta del XML dentro de ad_tag. En el ejemplo siguiente, la plantilla de suministro ha agregado información adicional sobre el precio de la oferta. Para obtener más información sobre las plantillas de suministro, consulte Plantillas de suministro anteriores.

Sugerencia

Siguiendo la práctica estándar del sector, Xandr no registra una impresión VAST al ganar. En su lugar, la impresión solo se registra una vez que se inicia el vídeo (el usuario hace clic en reproducir, etc.).

{
   "external_auction_id":"A4s24536",
   "appnexus_auction_id":4396943919143109134,
   "request_error":false,
   "no_bid":false,
   "bid":2.000000,
   "creative_id":345634,
   "landing_page_url":"http://www.landingpage.com",
   "brand_id":12,
   "buyer_member_id":328,
   "ad_tag":"<?xml version="1.0" encoding="UTF-8" standalone="no"?><VAST version="2.0" xmlns:xsi=
                "http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="vast.xsd">
                <Ad id="560469"><Wrapper><AdSystem version="1.0">adnxs</AdSystem><VASTAdTagURI><![CDA
                TA[http://ib.adnxs.com/ab?enc=AAAAAAAA8D8AAAAAAADwPwAAAAAAAPA_AAAAAAAA8D8AAAAAAADwPwkWl1e
                GIxl9XgZfiHCnHw8p021QAAAAADd8CQBVBAAAVQQAAA0AAABVjQgAMmgBAAAAAQBVU0QAVVNEAAEAAQASEwAAVgAB
                BAMCAQUAAIIAaRIvXgAAAAA.&cnd=%21chngsgiT1QUQ1ZoiGAAgstAFMAA4kqYEQARI1QhQt_glWABgLmgAcAB4A
                IABAIgBAJABAZgBAaABAagBALABALkBAAAAAA AA8D_BAQA AAAAAAPA_yQEzMzMzMzMDQNkBAAAAAAAA8D_gAQA.
                &udj=uf%28%27a%27%2C+51512%2C+1349374761%29%3Buf%28%27r%27%2C+560469%2C+1349374761%29%3B&
                ccd=%212gSgJwiT1QUQ1ZoiGLLQBSAE&vpid=171&referrer=espn.com&dlo=1&pp=%%pricepaid%%]>
                </VASTAdTagURI><Impression></Impression><Creatives><Creative AdID="560469"><Linear>
                </Linear></Creative></Creatives><Extensions><Extension type="Partner Name">
                <Price model="CPM" currency="USD" source="AppNexus">1</Price></Extension>
                </Extensions></Wrapper></>"
}

Nota:

Los campos de oferta siguientes solo son visibles para los empleados de Xandr.

Xandr envía una oferta para un acuerdo

{
    "external_auction_id": "A4s24536",
    "appnexus_auction_id": 4396943919143109000,
    "request_error": false,
    "no_bid": false,
    "bid": 0.206367,
    "creative_id": 345634,
    "landing_page_url": "http://www.landingpage.com",
    "brand_id": 12,
    "buyer_member_id": 328,
    "deal_code": "This is a big deal",
    "deal_id": 123456,
    "ad_tag": "<scriptsrc='http: //ib.adnxs.com/ab?enc=nkFD_wQXyz-iXL8FfvnHPwAAAAAAAOA_oly_BX75xz-eQUP_BBfLP0p8RFYC0OIKHKmTLdGzBl2rOWpOAAAAALGQCADLAQAAbAEAAAIAAACyGQkAmwkBAAEAAABVU0QAVVNEANgCWgC0AoMDvw4BAgUCAQQAAAAAciHhvwAAAAA.&tt_code=13394&udj=uf%28%27a%27%2C+1008%2C+1315584427%29%3Buf%28%27c%27%2C+117682%2C+1315584427%29%3Buf%28%27g%27%2C+51717%2C+1315584427%29%3Buf%28%27r%27%2C+596402%2C+1315584427%29%3Bppv%2815221%2C+%27784417993571728458%27%2C+1315584427%2C+1318176427%2C+117682%2C+67995%29%3Bppv%2815223%2C+%27784417993571728458%27%2C+1315584427%2C+1315670827%2C+117682%2C+67995%29%3Bppv%2815225%2C+%27784417993571728458%27%2C+1315584427%2C+1318176427%2C+117682%2C+67995%29%3Bppv%2815227%2C+%27784417993571728458%27%2C+1315584427%2C+1318176427%2C+117682%2C+67995%29%3Bppv%2815229%2C+%27784417993571728458%27%2C+1315584427%2C+1318176427%2C+117682%2C+67995%29%3Bppv%2815231%2C+%27784417993571728458%27%2C+1315584427%2C+1318176427%2C+117682%2C+67995%29%3B&cnd=!VyRDEwiylwcQsrMkGAAgm5MEMAA4tAVAAEjsAlAAWABgrARoAHAAeACAAQCIAQCQAQGYAQGgAQGoAQOwAQC5AUw3iUFg5cA_wQFwscHFBhfLP8kBmpmZmZmZ8T_ZAYV80LNZ9eM_4AHkKA..&ccd=!XASOJAiylwcQsrMkGJuTBCAA&referrer=http: //www.nydailynews.com&media_subtypes=1&pp=%%pricepaid%%'></script>"
}