Pujas de marcado de anuncios nativos

Artículo
05/17/2024

Native Ad Markup Bidding permite al pujador enviar marcado de anuncios nativo a través adm de en la respuesta de la oferta de OpenRTB. En lugar de registrar todos los recursos creativos nativos que tiene con Xandr, debe registrar solo un único creativo para cada campaña de anuncios o marca que represente; Todos los recursos creativos nativos de esa marca se pueden pasar dinámicamente a través del marcado de anuncios en la respuesta de la puja. En esta página se explica cómo usar esta característica.

Nota:

Esta característica no admite actualmente las pujas con el marcado de anuncios de vídeo nativo. Solo se acepta el marcado de anuncios nativos no de vídeo.

Introducción

El postor debe estar habilitado para usar esta característica. Si no está seguro de si el postor está habilitado, consulte con el representante de su cuenta de Xandr.

Una vez habilitado, se requieren dos pasos para comprar el inventario nativo a través de la oferta de marcado de anuncios:

Registre su creatividad. Para cada marca que represente, debe registrar una única creatividad que represente esa marca. La creatividad debe superar la auditoría de la plataforma. Todos los recursos creativos nativos asociados a esta marca dentro de su pujador servirán a través de esta creatividad. Para obtener más información, consulte Registro de creatividades nativas a continuación.
Realice una puja con los recursos creativos en el inventario nativo. Para obtener más información, consulte La oferta con marcado de anuncios nativos a continuación.

Registro de creatividades nativas

Para cada marca que represente, debe registrar una única creatividad que represente esa marca. Esto se hace mediante el servicio Creative. Al registrar una creatividad nativa, hay algunas consideraciones que debe tener en cuenta:

La creatividad debe representar uno de los anuncios nativos reales que transmitirá dinámicamente en la respuesta de la puja para esta marca. El anuncio específico que elija registrar no importa, pero la creatividad debe contener al menos un recurso de imagen y un recurso de datos coherentes con un anuncio que realmente serviría en el inventario nativo.
Al registrar una creatividad, solo se admiten macros Xandr . Las macros de OpenRTB (como ${AUCTION_PRICE}) no se expandirán.
La creatividad debe enviarse para la auditoría de la plataforma.
No es necesario especificar el campo; Xandr lo establecerá durante la brand_id auditoría.
Asegúrese de incluir rastreadores de impresiones y clics al registrar su creatividad. El marcado de anuncios enviado en la respuesta de la puja debe usar el mismo conjunto de proveedores (o menos) que se registraron con esta creatividad.
Asegúrese de usar la plantilla creativa nativa 39461.

En la sección siguiente se proporciona un ejemplo de definición y registro de una creatividad nativa.

Ejemplo creativo

En este ejemplo se usan cuatro recursos de datos y dos recursos de imagen, pero puede optar por usar una combinación diferente en función de los recursos que desee registrar. (Recuerde que debe tener al menos un recurso de cada tipo). Para obtener más información sobre los recursos creativos nativos, consulte El servicio creativo.

Adición de una creatividad nativa

$ cat native_creative.json
 
{
  "creative": {
    "description": "test description",
    "code": "test_code",
    "code2": "test_code2",
    "allow_audit": 1,
    "template": {
      "id": 39461
    },
    "native_attribute": {
      "link": {
        "url": "https://www.landingpage.com",
        "fallback_url": "https://fallback.com",
        "trackers": [{
          "url": "http://url.com",
          "url_secure": "https://secureurl.com"
        }]
      },
      "data_assets": [
        {
          "data_type": "title",
          "value": "Test Title"
        },
        {
          "data_type": "sponsored_by",
          "value": "Test Sponsor"
        },
        {
          "data_type": "description",
          "value": "Test description."
        },
        {
          "data_type": "call_to_action",
          "value": "Test CTA!"
        }
      ],
      "image_assets": [
        {
          "image_type": "main_image",
          "creative_asset_image": {
            "url": "http://url.com/main_img.png",
            "url_secure": "https://secureurl.com/main_img.png",
            "height": 1200,
            "width": 628
          }
        },
        {
          "image_type": "icon_image",
          "creative_asset_image": {
            "url": "http://url.com/icon_img.png",
            "url_secure": "https://secureurl.com/icon_img.png",
            "height": 150,
            "width": 150
          }
        }
      ],
      "image_trackers": [{
        "url": "http://url.com",
        "url_secure": "https://secureurl.com"
      }],
      "javascript_trackers": [{
        "url": "http://url.com",
        "url_secure": "https://secureurl.com"
      }]
    }
  }
}
 
$ curl -b cookies -c cookies -X POST -s @native_creative.json 'https://api..com/creative/123'
 
{
  "response": {
    "status": "OK",
    "id": 12345,
    "count": 1,
    "start_element": 0,
    "num_elements": 100,
    "creative": {
      "id": 12345,
      "active": true,
      "member_id": 123,
      "description": "test description",
      "code": "test_code",
      "code2": "test_code2",
      "audit_status": "pending",
      "allow_audit": true,
      "ssl_status": "pending",
      "allow_ssl_audit": true,
      "template": {
        "id": 39461
      },
      "native_attribute": {
        ...
      },
      ...
    },
    "dbg": {
      ...
  }
}

Puja con marcado de anuncio nativo

Nota:

Esta característica no admite actualmente las pujas con el marcado de anuncios de vídeo nativo. Solo se acepta el marcado de anuncios nativos no de vídeo.

Una vez que haya registrado una instancia de Native Creative y haya superado la auditoría de la plataforma, puede empezar a pujar por esa creatividad mediante el protocolo OpenRTB.

Nota:

Xandr admite la versión 1.1 de la API de anuncios nativos dinámicos de OpenRTB.

Algunas consideraciones que hay que tener en cuenta:

crid El campo o adid debe incluirse en la respuesta de la puja para identificar la creatividad que se registró. El crid valor debe coincidir con el de code;adid la creatividad debe coincidir con el de idla creatividad.
Los recursos creativos nativos se deben pasar a través del seatbid.bid.adm.native objeto . Asegúrese de incluir recursos de imagen, recursos de datos, rastreadores de impresiones y seguimientos de clics. Estos recursos servirán en lugar del recurso creativo que registró inicialmente.

Nota:

Los recursos creativos con los que puja debe pertenecer a la misma marca que el recurso creativo que registró inicialmente. Xandr examina y revisa periódicamente el contenido creativo del marcado de anuncios para asegurarse de que este contenido es coherente con la creatividad registrada. Si hay una discrepancia, la auditoría de la plataforma puede rechazar la creatividad. Los rechazos frecuentes de auditoría creativa debido a la rotación de marcas pueden dar lugar a que se revoque el acceso a la característica Ofertas de marcado de anuncios con nativo.
Si no pasa recursos creativos nativos en la respuesta de la puja o los recursos tienen un formato incorrecto, el contenido creativo registrado servirá de forma predeterminada.

Campos admitidos de respuesta de puja

Nota:

Los campos siguientes se omiten en la respuesta de puja: adomain y ver.
La marca se establece durante la auditoría de la plataforma de la creatividad registrada, por lo que adomain no es necesario.

Bid (objeto)

Campo	Tipo	Descripción
`adm`	string	Transmite el marcado del anuncio en caso de que la puja gane. El `native` objeto (que se describe a continuación) debe pasarse como una cadena codificada en JSON.

Objeto nativo

Campo	Tipo	Descripción
`assets`	matriz de objetos	(Obligatorio) Lista de los recursos del anuncio nativo. Vea Asset Object (Objeto de recurso ) a continuación.
`link`	object	(Obligatorio) Vínculo de destino predeterminado para el anuncio nativo. Cada recurso individual puede tener su propio objeto de vínculo, que se aplica si se hace clic en ese recurso. Si un vínculo de recurso individual no tiene un objeto de vínculo, se usa el objeto de vínculo primario. Vea Vincular objeto a continuación.
`imptrackers`	matriz de cadenas	Matriz de direcciones URL de seguimiento de impresiones que se espera que devuelvan una imagen 1x1 o una respuesta HTTP 204 (sin contenido). Normalmente, esto solo se pasa cuando se usan rastreadores de terceros. En este campo se admiten las siguientes macros de OpenRTB: - `${AUCTION_ID}` - Xandr `auction_id_64`. - `${AUCTION_BID_ID}` - Id. de la oferta especificada en el `bidid` campo en la respuesta de la oferta. - `${AUCTION_IMP_ID}` - Id. de la impresión, del `impid` campo en el `bid` objeto del `seatbid` objeto. - `${AUCTION_SEAT_ID}` - Id. del asiento ganador, del `seat` campo del `seatbid` objeto. - `${AUCTION_AD_ID}` - Id. de la creatividad del comprador, del `adid` campo en el `bid` objeto del `seatbid` objeto. - `${AUCTION_PRICE}` - Borrar el precio de la impresión en la moneda especificada en el `cur` campo en la respuesta de la oferta. - `${AUCTION_CURRENCY}` - Moneda del precio de compensación, tal como se especifica en el `cur` campo de la respuesta de la oferta.
`jstracker`	string	Seguimiento de impresiones de JavaScript opcional. Debe encapsularse en `<script>` etiquetas. En este campo se admiten las siguientes macros de OpenRTB: - `${AUCTION_ID}` - Xandr `auction_id_64`. - `${AUCTION_BID_ID}` - Id. de la oferta especificada en el `bidid` campo en la respuesta de la oferta. - `${AUCTION_IMP_ID}` - Id. de la impresión, del `impid` campo en el `bid` objeto del `seatbid` objeto. - `${AUCTION_SEAT_ID}` - Id. del asiento ganador, del `seat` campo del `seatbid` objeto. - `${AUCTION_AD_ID}` - Id. de la creatividad del comprador, del `adid` campo en el objeto de puja del `seatbid` objeto. - `${AUCTION_CURRENCY}` - Moneda del precio de compensación, tal como se especifica en el `cur` campo de la respuesta de la oferta.
`privacy`	string	Si se indicó soporte técnico en la solicitud, dirección URL de una página que informa al usuario sobre la actividad de destino del comprador.
`ext`	object	Se usa para identificar extensiones específicas de Xandr en la respuesta de la oferta de OpenRTB.

Objeto ext nativo

Xandr admite un único objeto en el objeto ext nativo para admitir extensiones específicas de Xandr:

Campo	Tipo	Descripción
`appnexus`	object	Especifica las extensiones específicas de Xandr (anteriormente AppNexus) para la respuesta de puja de OpenRTB.

Objeto AppNexus ext nativo

Xandr admite los siguientes campos en el objeto de appnexus extensión:

Campo	Tipo	Description
`third_party_imptrackers`	matriz de cadenas	Matriz de direcciones URL de seguimiento de impresiones que se espera que devuelvan una imagen 1x1 o una respuesta HTTP 204 (sin contenido). Las siguientes macros de OpenRTB se expandirán como cadenas vacías: - `${AUCTION_PRICE}` - Borrar el precio de la impresión en la moneda especificada en el `cur` campo en la respuesta de la oferta. - `${AUCTION_CURRENCY}` - Moneda del precio de compensación, tal como se especifica en el `cur` campo de la respuesta de la oferta. Todas las demás macros de OpenRTB se expandirán normalmente.

Objeto asset

Xandr admite los campos siguientes para definir uno o varios objetos nativos asset que se incluirán como una cadena codificada en JSON como parte del native objeto en el adm campo del bid objeto.

Campo	Tipo	Description
`id`	integer	(Obligatorio) Identificador de recurso único. Debe coincidir con un identificador de recurso en la solicitud.
`required`	integer	`1` Establézcalo en si el pujador requiere que se muestre el recurso.
`title`	object	Objeto title, para los recursos de título. Vea Title Object (Objeto de título ) a continuación.
`img`	object	Objeto de imagen, para los recursos de imagen. Vea Image Object (Objeto de imagen ) a continuación.
`data`	object	Objeto de datos, para recursos de datos como clasificaciones, precios, etc. Vea Objeto de datos a continuación.
`link`	object	Este objeto no se admite en nuestra implementación nativa.

Title (objeto)

Se usa para definir un recurso de título en un objeto nativo.

Campo	Tipo	Descripción
`text`	string	(Obligatorio) Texto de un elemento title.

Objeto de imagen

Se usa para definir un recurso de imagen en un objeto nativo. Se usa para todos los elementos de imagen del anuncio nativo, como iconos, imagen principal, etc.

Campo	Tipo	Descripción
`url`	string	(Obligatorio) Dirección URL del recurso de imagen.
`w`	integer	(Recomendado) Ancho de la imagen, en píxeles.
`h`	integer	(Recomendado) Alto de la imagen, en píxeles.
`ext`	object	Se usa para identificar extensiones específicas de Xandr (anteriormente AppNexus) en la respuesta de la oferta de OpenRTB.

Objeto ext de imagen

Xandr admite un único objeto en el objeto ext nativo para admitir extensiones específicas de Xandr (anteriormente AppNexus):

Campo	Tipo	Descripción
`appnexus`	object	Especifica las extensiones específicas de Xandr (anteriormente AppNexus) para la respuesta de puja de OpenRTB.

Imagen ext AppNexus (objeto)

Xandr admite los siguientes campos en el objeto de appnexus extensión:

Campo	Tipo	Descripción
`prevent_crop`	booleano	Permite al comprador indicar si la imagen se puede recortar o no. Esto se puede aplicar al icono y a la imagen principal. - Si la marca está establecida en 1, la imagen no se puede recortar (rellenar). - Si la marca está establecida en 0, la imagen se puede recortar (ajustar). - Si la marca no se pasa en/comportamiento predeterminado: 0; se supone que las imágenes permiten modificaciones a menos que se indique explícitamente lo contrario.

Objeto de datos

Se usa para definir un recurso de datos en un objeto nativo. Se usa para todos los elementos varios de un anuncio nativo, como clasificaciones, precio, recuento de revisiones, descargas, etc.

Campo	Tipo	Descripción
`label`	string	Nombre de cadena de formato opcional del tipo de datos.
`value`	string	Cadena con formato de datos que se va a mostrar (como `"5 stars"` o `"$10"`).

Link (objeto)

Se usa para definir el vínculo de un recurso nativo. Cuando se hace clic en , el usuario se lleva a la ubicación del vínculo. Solo se puede definir en el objeto nativo primario.

Campo	Tipo	Descripción
`url`	string	(Obligatorio) Dirección URL de aterrizaje del vínculo en el que se puede hacer clic. Las macros no se pueden usar en este campo.
`clicktrackers`	Matriz de cadenas	Matriz de direcciones URL de seguimiento de terceros que se desencadenarán cuando se haga clic en el vínculo.
`fallback`	string	Dirección URL de reserva que se usará si el dispositivo no admite la dirección URL.

Ejemplo de respuesta de puja

{
    "seatbid": [
        {
            "bid": [
                {
                    "nurl": "https://rtb-fakeurl.com/lax/wintrk=CwE&wp=${AUCTION_PRICE}&curr=${AUCTION_CURRENCY}&aid=${AUCTION_AD_ID}",
                    "adid": "12345",
                    "crid": "test_code",
                    "price": 2.50,
                    "adm": "{\"assets\":[{\"id\":1,\"img\":{\"url\":\"https://url.com/dynamic_main_img.jpg\",\"w\":1200,\"h\":628}},{\"id\":2,\"title\":{\"text\":\"Dynamic Title\"}},{\"id\":3,\"data\":{\"value\":\"Dynamic Description\"}},{\"id\":4,\"data\":{\"value\":\"Dynamic Sponsor\"}}],\"link\":{\"url\":\"https://www.landingpage.com\",\"clicktrackers\":[\"https://thirdparty-clicktracker-1.com\",\"https://thirdparty-clicktracker-2.com\"],\"fallback\":\"https://fallback-url.com\"},\"imptrackers\":[\"https://imptracker.com\"]}",
                    "impid": "3226285750417000001",
                    "id": "6ab34155-c960-1111-abcd-52b7321adbbb"
                }
            ],
            "seat": "123"
        }
    ],
    "id": "3",
    "cur": "USD"
        }
    ]
}

Preguntas frecuentes

¿Por qué tengo que registrar un creativo para cada marca que represento?

La directiva de Xandr prohíbe la rotación de marca en los creativos. Al registrar una creatividad para cada marca con la que trabaje, su creatividad podrá pasar la auditoría de Xandr. Esto maximizará el inventario nativo en el que puede servir. Xandr se asegura de que cada creatividad cumpla con nuestras directivas de auditoría realizando una auditoría inicial y, a continuación, escaneando periódicamente el contenido creativo que el licitador pasa dinámicamente en sus respuestas de puja. Si el contenido dinámico servido por el pujador difiere sustancialmente de la creatividad registrada (es decir, imágenes y texto para una marca diferente), se volverá a auditar y se podrá rechazar.

¿Se me cobrarán las tarifas de auditoría creativa por el marcado de anuncios creativos con revisión periódica?

No. Las tarifas de auditoría creativa solo se aplicarán durante la auditoría inicial de la creatividad.

¿Qué ocurre si native Creative pasa la auditoría inicial pero produce un error en un reaudit posterior?

Su creativo no podrá servir. El error de auditoría puede deberse a la rotación de marcas. Si cree que se ha producido un error en su creatividad o si tiene otras preguntas, póngase en contacto con el servicio de atención al cliente y seleccione la categoría "Auditoría creativa".

Nota:

Los frecuentes rechazos de auditoría creativa debidos a marcas rotatorias pueden dar lugar a que se revoque el acceso a la característica Ofertas de marcado de anuncios con nativo.

¿A dónde voy para obtener más ayuda?

Si tiene preguntas adicionales, póngase en contacto con el representante de su cuenta o con el servicio de atención al cliente.

Página Ajustes de imagen inteligente

Compartir a través de

Pujas de marcado de anuncios nativos

Introducción

Registro de creatividades nativas

Ejemplo creativo

Adición de una creatividad nativa

Puja con marcado de anuncio nativo

Campos admitidos de respuesta de puja

Bid (objeto)

Objeto nativo

Objeto ext nativo

Objeto AppNexus ext nativo

Objeto asset

Title (objeto)

Objeto de imagen

Objeto ext de imagen

Imagen ext AppNexus (objeto)

Objeto de datos

Link (objeto)

Ejemplo de respuesta de puja

Preguntas frecuentes

¿Por qué tengo que registrar un creativo para cada marca que represento?

¿Se me cobrarán las tarifas de auditoría creativa por el marcado de anuncios creativos con revisión periódica?

¿Qué ocurre si native Creative pasa la auditoría inicial pero produce un error en un reaudit posterior?

¿A dónde voy para obtener más ayuda?

Recursos adicionales

Compartir a través de

Pujas de marcado de anuncios nativos

Introducción

Registro de creatividades nativas

Ejemplo creativo

Adición de una creatividad nativa

Puja con marcado de anuncio nativo

Campos admitidos de respuesta de puja

Bid (objeto)

Objeto nativo

Objeto ext nativo

Objeto AppNexus ext nativo

Objeto asset

Title (objeto)

Objeto de imagen

Objeto ext de imagen

Imagen ext AppNexus (objeto)

Objeto de datos

Link (objeto)

Ejemplo de respuesta de puja

Preguntas frecuentes

¿Por qué tengo que registrar un creativo para cada marca que represento?

¿Se me cobrarán las tarifas de auditoría creativa por el marcado de anuncios creativos con revisión periódica?

¿Qué ocurre si native Creative pasa la auditoría inicial pero produce un error en un reaudit posterior?

¿A dónde voy para obtener más ayuda?

Tema relacionado

Recursos adicionales