Oferta de marcado de anuncios nativo 1.2 (ADM)

2025-04-01

Requisitos para usar ADM nativo 1.2

Native Ad Markup Bidding (ADM) permite al licitador enviar marcado de anuncio nativo a través del adm campo en la respuesta de la oferta de OpenRTB. En lugar de registrar cada creatividad con Microsoft Monetize, registre una creatividad para cada una de las combinaciones siguientes:

Campaña o marca de anuncios únicos que represente
Lenguaje compatible único

Importante

El adomain campo es obligatorio. La personalización de marca de la dirección URL proporcionada debe coincidir con la del contenido del adm campo y la creatividad registrada.

Nota:

Se recomienda encarecidamente usar BURL para el seguimiento de gastos e impresiones en el servidor Monetizar.

Introducción a Native ADM

El pujador debe estar habilitado para esta característica. Si no está seguro de si el postor está habilitado, consulte con el representante de la cuenta monetizar o abra una incidencia de soporte técnico del producto.

Una vez habilitado, siga estos dos pasos para comprar inventario a través de ADM:

Registrar creativos de marca individual: todos los recursos creativos asociados a esta marca servirán a través de esta creatividad registrada.
Puja con recursos creativos dinámicos : el marcado de anuncio enviado en la respuesta de la puja debe coincidir con la creatividad registrada.

Nota:

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

Registro de creatividades nativas

Registre una creatividad por marca y combinación de idioma mediante el Servicio creativo. Tenga en cuenta lo siguiente al registrar una creatividad:

La creatividad debe representar uno de los anuncios reales pasados dinámicamente en la respuesta de la puja para esta marca.
- El anuncio específico elegido para el registro no importa.
- La creatividad debe ser apta para servir en el inventario monetizar.
El creativo debe someterse a una auditoría de plataforma.
Al registrar una creatividad nativa, se admiten varias macros de OpenRTB y Microsoft. Consulte la sección Macros de seguimiento a continuación para obtener una lista de las macros admitidas en adm.
No es necesario especificar el brand_id campo; Monetizar establece esto durante la auditoría.
Las pujas deben usar el protocolo OpenRTB.
Incluya seguimientos de impresiones y clics al registrar su creatividad. El marcado de anuncios en la respuesta de la puja debe usar el mismo conjunto de proveedores (o menos) que se registraron con la creatividad.

Puja con ADM nativo

Especificaciones

Nota:

Consulte las especificaciones nativas de IAB v1.2.

Consideraciones

Use la plantilla 39461creativa nativa .
Los recursos creativos nativos se deben pasar a través del seatbid.bid.adm objeto .
- Incluya recursos de imagen, recursos de datos y seguimientos de eventos.
- Estos recursos servirán en lugar del recurso creativo que registró inicialmente.

Objeto de puja de la respuesta de puja

Los demás objetos de respuesta de puja no aparecen aquí. Para obtener más información, consulte nuestra documentación sobre la respuesta de la oferta.
Los licitadores deben enviar el marcado de anuncios en el campo Estándar de OpenRTB seatbid.bid.adm .
Debe incluir un identificador de creatividad registrado en uno de los siguientes campos de respuesta de puja (adid, crid).
El crid valor o adid debe coincidir con el objeto creativo de marca correspondiente.

Campos de respuesta de puja

Campo	Tipo	Descripción
`adm`	string	Medios para transmitir el marcado de anuncios en caso de que la puja gane; reemplaza el aviso de victoria si el marcado se incluye en ambos. El formato debe ser una cadena codificada en JSON.
`adomain`	string	Obligatorio: dirección URL que representa la marca del `adm` contenido enviado en la respuesta de la puja.
`adid`	string	El identificador de creatividad monetizar registrado, que se puede ver a través de la API mediante creative service.
`crid`	string	El identificador creativo del sistema del licitador. Se usa para hacer referencia a una creatividad monetizar basada en el código creativo tal y como se establece a través del Servicio creativo. Nota: Si se envían ambos valores, tiene `adid` prioridad sobre `crid`y `crid` se omite.

Objeto ADM

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`	objeto	Obligatorio: vínculo de destino predeterminado para el anuncio nativo. Cada recurso individual puede tener su propio objeto de vínculo. Si un vínculo de recurso no tiene un objeto de vínculo, se usa el objeto de vínculo primario. Vea Vincular objeto a continuación.
`eventtrackers`	matriz de objetos	Matriz de objetos de seguimiento. Consulte Event Trackers Response Object (Objeto de respuesta de seguimiento de eventos).
`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`	objeto	Se usa para identificar extensiones específicas de Monetize en la respuesta de puja de OpenRTB.
`ver`	string	Versión nativa. Solo `1.2` se admite.

Objeto de respuesta de seguimiento de eventos

Campo	Tipo	Descripción
`event`	integer	Tipo de evento del que se va a realizar el seguimiento. Tipos admitidos: 1. Impresión : seguimiento de impresiones 2. Viewable-mrc50 : impresión visible mediante la definición de MRC (50 % a la vista durante 1 segundo) 3. Viewable-mrc100 – 100% a la vista durante 1 segundo 4. Viewable-video50 : impresión visible para vídeo mediante la definición de MRC (50% a la vista durante 2 segundos)
`method`	integer	Tipo de seguimiento solicitado: 1. `img` – Seguimiento de píxeles de imagen (la dirección URL proporcionada se insertará como un píxel de 1x1 en el momento del evento) 2. `js` – Seguimiento basado en JavaScript (la dirección URL proporcionada se insertará como una etiqueta JS en el momento del evento)
`url`	string	Dirección URL de la imagen o seguimiento de JS. En este campo se admiten las siguientes macros de OpenRTB: - `${AUCTION_ID}` – Monetizar 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 del objeto bid del `seatbid` objeto. - `${AUCTION_SEAT_ID}` – Id. del asiento ganador, del `seat` campo del `seatbid` objeto. - `${AUCTION_AD_ID}` – Id. del creativo del comprador, del `adid` campo en el objeto de puja del objeto de asiento. - `${AUCTION_CURRENCY}` – Moneda del precio de compensación, tal como se especifica en el `cur` campo de la respuesta de la oferta.

Objeto nativo `ext`

Monetize admite un único objeto ext nativo para extensiones específicas de Monetizar.

Definiciones de campo

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

Objeto asset

Monetize admite los campos siguientes para definir uno o varios objetos de recursos nativos, que se incluyen como una cadena codificada en JSON en el adm campo del objeto bid.

Definiciones de campo

Campo	Tipo	Descripción
`id`	integer	Requerido: 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`	objeto	Objeto title para los recursos de título. Vea Title Object (Objeto de título) a continuación.
`img`	objeto	Objeto de imagen para los recursos de imagen. Vea Image Object (Objeto de imagen ) a continuación.
`data`	objeto	Objeto de datos para los recursos de datos, como clasificaciones y precios. Vea Objeto de datos a continuación.

Title (objeto)

Define un recurso de título en un objeto nativo adm .

Campo	Tipo	Descripción
`text`	string	Obligatorio: texto de un elemento title.
`len`	integer	Longitud del título que se va a proporcionar.

Objeto de imagen

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`	objeto	Se usa para identificar extensiones específicas de Monetize en la respuesta de puja de OpenRTB.

Image `ext` (objeto)

Monetize admite un solo objeto nativo ext para extensiones específicas de Monetize (anteriormente AppNexus).

Definiciones de campo

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

Image `ext` AppNexus (objeto)

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

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

Objeto de datos

Se admiten todos los tipos de recursos de datos que se encuentran en la especificación 1.2 de anuncios nativos de IAB OpenRTB.

Link (objeto)

Define el vínculo de un recurso nativo. Cuando se hace clic en , el usuario se dirige a la dirección URL especificada. Este objeto solo se puede definir en el objeto primario adm .

Definiciones de campo

Campo	Tipo	Descripción
`url`	string	(Obligatorio) Dirección URL de aterrizaje del vínculo en el que se puede hacer clic. No se admiten macros.
`clicktrackers`	Matriz de cadenas	Matriz de direcciones URL de seguimiento de terceros desencadenadas cuando se hace clic en el vínculo.
`fallback`	string	Dirección URL de reserva si el dispositivo no admite la dirección URL principal.

Macros personalizadas

Cuando un licitador habilitado envía el marcado de anuncios, se omite el seatbid.bid.ext.appnexus.custom_macros campo de extensión.

Si no se devuelve el admarkup campo, el contenido creativo registrado servirá de forma predeterminada. En este caso, seatbid.bid.ext.appnexus.custom_macros se admite como de costumbre.

Definiciones de campo

Campo	Tipo	Descripción
`custom_macros`	matriz de objetos	Identifica objetos de macro personalizados.

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": {
            "link": {
              "url": "https://rtb-fakeurl.com"
            },
            "ver": "1.2",
            "assets": [
              {
                "id": 1,
                "img": {
                  "w": 1200,
                  "h": 627,
                  "url": "https://rtb-fake-image-url.com",
                  "ext": {
                    "appnexus": {
                      "prevent_crop": 1
                    }
                  }
                }
              },
              {
                "id": 2,
                "title": {
                  "text": "AD"
                }
              },
              {
                "id": 3,
                "data": {
                  "value": "abc.com"
                }
              }
            ],
            "privacy": "https://rtb-fake-privacy-url.com",
            "eventtrackers": [
              {
                "event": 1,
                "method": 1,
                "url": "https://rtb-fakeurl.com/price=${AUCTION_PRICE}"
              }
            ]
          },
          "impid": "3226285750417000001",
          "id": "6ab34155-c960-1111-abcd-52b7321adbbb"
        }
      ],
      "seat": "123"
    }
  ],
  "id": "3",
  "cur": "USD"
}

Seguimiento de impresiones del lado servidor

Para los licitadores que usan ADM nativo, envíe la dirección URL de notificación de win en seatbid.bid.nurl. Se espera que el pujador incluya la ${PRICE_PAID} macro o ${AUCTION_PRICE} en esta dirección URL para recibir información sobre el precio de la victoria.

Definiciones de campo

Campo	Tipo	Descripción
`nurl` / `burl`	integer	La dirección URL de notificación de win, que se quita como un píxel en el explorador web o el SDK. Nuestro servidor hace ping a esta dirección URL cuando recibe una notificación del lado cliente del dispositivo, lo que indica que hemos ganado la subasta. Las respuestas se enviarán en el lado servidor. Esto ocurre simultáneamente mientras registramos la impresión. La longitud máxima son `2000` caracteres con macros expandidas. Para los licitadores que usan nativo `adm`, se espera que el pujador incluya la `${PRICE_PAID}` macro o `${AUCTION_PRICE}` en esta dirección URL para recibir información sobre el precio de la ganancia.

Macros de seguimiento

Algunos publicadores auditan periódicamente las creatividades, lo que puede generar falsos eventos de seguimiento de impresiones y clics. Cuando Microsoft detecta eventos de auditoría:

Cualquier macro con codificación ${AUCTION_PRICE} URL de adm se expande a la cadena "AUDIT".
Cualquier macro codificada en ${AN_IS_AUDIT} URL se expande a 1.

Las macros siguientes admiten el seguimiento de impresiones y clics. Consulte el siguiente ejemplo de macros de ADM para obtener detalles de uso.

Referencia de macro

Macro	Descripción
`${AN_IMP_URL}`	Se expande a una dirección URL de seguimiento de impresiones de Microsoft y está pensada para anteponer el píxel de seguimiento de impresiones del pujador. Cuando se representa el anuncio, la dirección URL expandida redirige al píxel del pujador y expande correctamente la `${AUCTION_PRICE}` macro. Todas las macros del píxel del pujador deben estar codificadas en url en `adm`.
`${AN_CLICK_URL}`	Se expande a una dirección URL de seguimiento de clics de Microsoft y está pensada para anteponer el píxel de seguimiento de clics del pujador. Cuando se hace clic en el anuncio, la dirección URL expandida redirige al píxel del pujador y expande correctamente la `${AUCTION_PRICE}` macro. El píxel del pujador y `${AUCTION_PRICE}` debe estar codificado en dirección URL en `adm`.
`${AN_IS_AUDIT}`	Se expande hasta `1` cuando se producen eventos de auditoría (impresiones y clics) y se expande a `0` en caso contrario. Debe estar codificado en dirección URL cuando se incluye en una dirección URL siguiente `${AN_IMP_URL}` o `${AN_CLICK_URL}`.
`${AUCTION_ID}`	Representa el identificador único de la subasta (`auction_id_64`).
`${AUCTION_BID_ID}`	Representa el identificador único de la puja especificada en el `bidid` campo en la respuesta de la puja.
`${AUCTION_IMP_ID}`	Representa el identificador único de la impresión del `impid` campo en el objeto bid del `seatbid` objeto .
`${AUCTION_SEAT_ID}`	Representa el identificador único del asiento ganador del `seat` campo del `seatbid` objeto.
`${AUCTION_AD_ID}`	Representa el identificador único de la creatividad del comprador desde el `adid` campo del objeto bid del `seatbid` objeto.
`${AUCTION_PRICE}`	Representa el precio de compensación de la impresión en la moneda especificada en el `cur` campo en la respuesta de la oferta.
`${AUCTION_PRICE:HMAC-SHA1-XOR}`	Representa una versión segura del precio de la subasta. Precio de compensación de la impresión en la moneda especificada en el `cur` campo en la respuesta de la oferta.
`${AUCTION_CURRENCY}`	Representa la moneda del precio de compensación como se especifica en el `cur` campo de la respuesta de la oferta.
`${CREATIVE_CODE}`	Representa el `code` campo establecido en el objeto creativo a través de la API al registrar una creatividad.
`${AN_PAYMENT_TYPE}`	Representa el identificador del tipo de pago de la oferta, especificado en el `bid_payment_type` campo de la respuesta de la oferta.
`${AUCTION_LOSS}`	Representa el código de motivo de pérdida de la subasta. Para obtener una lista completa de los códigos de motivo de pérdida admitidos, consulte Códigos de motivo de pérdida.
`${AN_SOURCE_FD}`	Representa la entidad responsable de la decisión de venta de impresiones final: - `0`: Exchange (valor predeterminado). Microsoft Monetize mantiene la subasta final. - `1`: origen ascendente. La oferta se pasa a una subasta de licitación de encabezados o a un suministro externo.

Codificación y notificación

Todas las macros de OpenRTB deben estar codificadas en URL. Para usar estas macros, asegúrese de que están correctamente codificadas en píxeles, como se describió anteriormente.

Microsoft admite tanto seatbid.bid.nurl como seatbid.bid.burl para la notificación win del lado servidor. Estos deben enviarse en el campo de respuesta de puja correspondiente.

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.

Compartir a través de

Oferta de marcado de anuncios nativo 1.2 (ADM)

Requisitos para usar ADM nativo 1.2

Introducción a Native ADM

Registro de creatividades nativas

Puja con ADM nativo

Especificaciones

Consideraciones

Objeto de puja de la respuesta de puja

Campos de respuesta de puja

Objeto ADM

Objeto de respuesta de seguimiento de eventos

Objeto nativo ext

Definiciones de campo

Objeto asset

Definiciones de campo

Title (objeto)

Objeto de imagen

Image ext (objeto)

Definiciones de campo

Image ext AppNexus (objeto)

Objeto de datos

Link (objeto)

Definiciones de campo

Macros personalizadas

Definiciones de campo

Ejemplo de respuesta de puja

Seguimiento de impresiones del lado servidor

Definiciones de campo

Macros de seguimiento

Referencia de macro

Codificación y notificación

Ejemplo creativo

Temas relacionados

Recursos adicionales

Objeto nativo `ext`

Image `ext` (objeto)

Image `ext` AppNexus (objeto)