Se usó la API de Cloud Translation para traducir esta página.

Integración de DDM para el seguimiento de aplicaciones de terceros

El siguiente flujo de extremo a extremo describe la configuración del anunciante y la implementación de terceros necesarias para publicar una campaña en los productos de compra de DoubleClick con una solución de seguimiento de aplicaciones de terceros.

Para obtener más información sobre el Marketing digital de DoubleClick en general y una descripción general de las funciones de atribución en la aplicación, consulta la página de antecedentes de Marketing digital de DoubleClick.

El anunciante configura el evento de conversión en DDM para representar la instalación o la conversión (solo en Bid Manager: píxel de conversión) (en Campaign Manager: actividad de Floodlight).
El anunciante "vincula" el evento de conversión de DDM en la interfaz de terceros y proporciona variables clave que identifican a un anunciante y a un grupo de actividad de conversión.
- src es el ID del anunciante que es la fuente de la actividad de Floodlight.
- cat es la cadena de la etiqueta de actividad, que los servidores de Floodlight usan para identificar el grupo de actividades al que pertenece la actividad.
- type es la cadena de la etiqueta del grupo, que identifica el grupo de actividades con el que se asocia la actividad de Floodlight.
- u1, u2, ... (si está disponible) son los pares clave-valor de la variable personalizada de Floodlight.
El anunciante agrega variables para indicar la recopilación de consentimiento para el cumplimiento de la DMA.
- eea se usa para identificar a los usuarios del EEE.
  - eea=0 indica que el usuario no es del EEE.
  - eea=1 indica que el usuario es del EEE.
- ad_user_data es la marca de consentimiento para el uso de datos del usuario con fines publicitarios.
  - Solo se debe configurar si eea=1
  - ad_user_data=0 indica que el usuario rechazó el consentimiento para la transmisión de datos a nivel del usuario a Google con fines publicitarios.
  - ad_user_data=1 indica que el usuario otorgó su consentimiento para la transmisión de datos a nivel del usuario a Google con fines publicitarios.
- npa se usa para el contenido de personalización de anuncios.
  - npa=0 indica que el usuario da su consentimiento para la personalización.
  - npa=1 indica que el usuario no dio su consentimiento para la personalización.
- test_request_reason=dma se puede usar para probar parámetros de la DMA.
  - Valida todos los parámetros de DMA y devuelve advertencias.
  - Devuelve una respuesta múltiple con clics falsos.
  - Registra las conversiones como conversiones de prueba.
Además, el anunciante debe proporcionar a los terceros su token de autorización específico:

token es una cadena alfanumérica específica del anunciante que se debe pasar junto con cada solicitud del servidor a DDM.
El anunciante publica una campaña publicitaria en la aplicación con etiquetas de anuncios publicadas por DBM en intercambios de ofertas en tiempo real o por DCM en medios comprados directamente.
El usuario final ve los anuncios y hace clic en ellos, lo que se registra en DDM.
Cuando el usuario final instala la app o completa un evento de conversión, como "jugar", los servidores externos envían un "ping" a DDM en cada actividad de la app:

Ejemplo de URL para usuarios que no se encuentran en el EEE
```
https://ad.doubleclick.net/ddm/s2s/appactivity/src=1234567;cat=fghij456;type=abcde123;u1=[friendlyname1];ord=1312312312;eea=0;npa=0
```
Ejemplo de URL para el usuario en el EEE
```
https://ad.doubleclick.net/ddm/s2s/appactivity/src=1234567;cat=fghij456;type=abcde123;u1=[friendlyname1];ord=1312312312;eea=1;ad_user_data=1;npa=0
```
Donde:
- src es el ID del anunciante que es la fuente de la actividad de Floodlight.
- cat es la cadena de la etiqueta de actividad, que los servidores de Floodlight usan para identificar el grupo de actividades al que pertenece la actividad.
- type es la cadena de la etiqueta del grupo, que identifica el grupo de actividades con el que se asocia la actividad de Floodlight.
- ord es un número aleatorio que se usa para que la etiqueta de Floodlight sea única.
- u1, u2, ... (si está disponible) son los pares clave-valor de la variable personalizada de Floodlight.
- eea identifica si el usuario se encuentra en el EEE.
- ad_user_data identifica si el usuario otorga su consentimiento para las cookies y la Medición.
- npa identifica si el usuario da su consentimiento para la personalización.
con parámetros adicionales enviados a través de una carga útil de JSON en un HTTP POST:
```
{
  "app": {
    "bundle": "com.rovio.angrybirds"
  },
  "device": {
    "ua": "Mozilla/5.0 (KHTML, like Gecko) Version/6.0 Mobile/10A5376e Safari/8536.25",
    "ip": "108.176.57.230",
    "didmd5": "A2D2DA47AC2DE1BCA16883BD5CAA6F2F",
    "lmt": 1
  }
}
```
y el token de autorización del anunciante se pasa en el encabezado de autorización HTTP:
```
Authorization: Token token="[advertiser authorization token string]"
```
Donde:
- app (obligatorio) es el objeto JSON que representa la app en la que se produjo la actividad de conversión. Usa app: {} si la app en la que se produjo la actividad de conversión no está disponible.
- bundle (si está disponible) es el campo del objeto de la app que contiene un valor de cadena del nombre del paquete de Play Store o el ID de App Store.
- device es el objeto JSON que representa el dispositivo en el que se produjo la actividad de conversión.
- ua es el campo del objeto del dispositivo que representa la cadena del agente de usuario de la app en la que se registró una actividad. Este parámetro es obligatorio.
- ip (si está disponible) es la dirección IPv4 del dispositivo asignada al dispositivo. Este parámetro es obligatorio.
- didmd5 es la cadena de hash MD5 del valor del IDFA o del ID de publicidad de Google Play en mayúsculas.
- lmt es un número entero, con un valor de 1 si el usuario habilitó la opción "Limitar el seguimiento de anuncios" con IDFA o ID del anuncio, o 0 si no se configuró.
DDM responderá con una respuesta JSON que indicará si el evento de conversión se atribuye a una vista o a un clic publicados por DCM y, si la respuesta es "SÍ", proporcionará información adicional sobre el evento (última vista o clic):
- ID del anuncio
- ID del sitio
- ID de posición
- ID de la creatividad
- Marca de tiempo
Una respuesta JSON de ejemplo podría verse así:
```
{
  "attributed": 1,  // Whether the conversion can be attributed to a DCM event.
  "last_impression_ad_id":283641088,
  "last_impression_site_id":1408067,
  "last_impression_placement_id":107616368,
  "last_impression_creative_id":60162352,
  "last_impression_timestamp":1415647607,
  "last_click_ad_id":283641088,
  "last_click_site_id":1408067,
  "last_click_placement_id":107616368,
  "last_click_creative_id":60162352,
  "last_click_timestamp":1415647657,
  "last_click_exclid":"CKm0nLKhyssCFceH2wod8l4I4A",
  "cps": <cps>,
  "ad_events": [
    <ad event objects>
  ],
  "warnings": [<warning strings>],
  "errors": [<error strings>],
}
```
Donde:
- attributed es el valor 1 (si la conversión se puede atribuir a una impresión o un clic) o 0 (si no se puede atribuir).
- last_impression_ad_id (si attributed = 1) es el ID del anuncio de la última impresión.
- last_impression_site_id (si attributed = 1) es el ID del sitio de la última impresión.
- last_impression_placement_id (si attributed = 1) es el ID de la posición de la última impresión.
- last_impression_creative_id (si attributed = 1) es el ID de la creatividad de la última impresión.
- last_click_ad_id (si attributed = 1 y se atribuyó un clic) es el ID del anuncio del último clic.
- last_click_site_id (si attributed = 1 y se atribuyó un clic) es el ID del sitio para el último clic.
- last_click_placement_id (si attributed = 1 y se atribuyó un clic) es el ID de la posición del último clic.
- last_click_creative_id (si attributed = 1 y se atribuyó un clic) es el ID de la creatividad para el último clic.
- last_click_exclid corresponde a un ID de clic único que se completa con la macro %eiid!.
A partir de la aplicación de la LMD en marzo de 2024, también estarán disponibles los siguientes campos:
- cps indica a qué servicio básico de la plataforma pertenece el evento.
  - a : Anuncios
  - m : Maps
  - p : Play Store
  - s : Búsqueda
  - h : Shopping
  - y : YouTube
- ad_events es un array de objetos ad_event que contiene todos los eventos de conversión.
  - El objeto ad_event tiene los siguientes campos:
  - product_type es una cadena que informa el producto responsable de la conversión. Será DCM o DBM.
  - interaction_type es el tipo de interacción que generó el evento. impression o click.
  - conversion_metric es la métrica de conversiones que se usa para la atribución. conversion o view_through_conversion.
  - timestamp es la marca de tiempo de UNIX en la que se produjo el evento del anuncio, con precisión de microsegundos. Este valor se debe usar para la atribución de último clic.
  - campaign_type identifica el tipo de campaña que generó el evento del anuncio.
  - line_item_id (solo para DBM) es el ID de la línea de pedido de DBM que generó el evento del anuncio.
  - line_item_name (solo para DBM) es el nombre de la línea de pedido de DBM que generó el evento del anuncio.
  - placement_id (solo para DCM) es el ID de la etiqueta de posición de DCM que generó el evento del anuncio.
  - placement_name (solo para DCM) es el nombre de la etiqueta de posición de DCM que generó el evento del anuncio.
  - external_customer_id es el identificador del anunciante propietario de la campaña que generó el evento del anuncio.
    - Si product es DBM, este campo representa el ID del anunciante de DBM.
    - Si product es DCM, este campo representa el ID de anunciante de DCM.
  - creative_id es el ID de la unidad de anuncios de la creatividad que produjo el evento del anuncio.
    - Si product es DBM, este campo representa el ID de la creatividad de DBM.
    - Si product es DCM, este campo representa el ID de la creatividad de DCM.
  - exchange_id (solo para DBM) es el ID del intercambio que publicó el anuncio de DBM.
  - insertion_order_id (solo para DBM) es el ID del pedido de inserción de DBM.
  - site_id (solo en DCM) es el ID del sitio de DCM para el evento del anuncio.
  - cps indica a qué servicio de la Plataforma principal pertenece el evento del anuncio. Consulta la explicación completa del campo cps que se encuentra más arriba en la documentación para obtener más detalles.
- warnings es un array de advertencias que produjo el evento de conversión.
- errors es un array de errores que produjo el evento de conversión con códigos de error HTTP para las siguientes situaciones:
  - HTTP 204 si se excedió la cuota de solicitudes
  - HTTP 400 cuando la solicitud se considera no válida (por ejemplo, faltan parámetros obligatorios y el servidor recurrió al seguimiento de píxeles).
  - HTTP 401 si el token de autorización no es válido
  - HTTP 404 para cualquier solicitud incorrecta.
El anunciante podrá ver los informes de la campaña en tu sistema, así como los informes de conversiones en DCM con los mismos parámetros.

Ejemplos de respuestas adicionales después de que se aplique la LMD en marzo de 2024

Ejemplo de una respuesta del seguimiento de conversiones atribuidas en la que la conversión se atribuye a las interacciones con anuncios de Búsqueda y de YouTube, pero se rechaza el consentimiento de uso cruzado de los CPS de la Búsqueda y de YouTube según los artículos 5(2)(b) y 5(2)(c):
```
{
  attributed: 1,
  last_impression_ad_id: 283641088,
  last_impression_site_id: 1408067,
  last_impression_placement_id: 107616368,
  last_impression_creative_id: 60162352,
  last_impression_timestamp: 1415647607,
  last_click_ad_id: 283641088,
  last_click_site_id: 1408067,
  last_click_placement_id: 107616368,
  last_click_creative_id: 60162352,
  last_click_timestamp: 1415647655,
  last_click_exclid: "CKm0nLKhyssCFceH2wod8l4I4A",
  cps: "s",
  ad_events: [{
      cps : "s",
      product_type: "DCM",
      interaction_type: "click",
      ad_event_type: "click",
      campaign_type: "Display",
      placement_id: 107616368,
      placement_name: "TEST PLACEMENT NAME",
      external_customer_id: 7480542,
      creative_id: 60162352,
      timestamp: 1415647655.123456,
      site_id: 1408067,
      }, {
      cps : "s",
      product_type:"DCM",
      interaction_type: "impression",
      ad_event_type: "impression",
      campaign_type: "Display",
      placement_id: 107616368,
      placement_name: "TEST PLACEMENT NAME",
      external_customer_id: 7480542,
      creative_id: 60162352,
      timestamp: 1415647607.123456,
      site_id: 1408067
      },{
      cps : "y",
      product_type: "DCM",
      ad_event_type: "click",
      campaign_type: "Display",
      placement_id: 107616370,
      placement_name: "Placement on Youtube",
      external_customer_id: 7480542,
      creative_id: 6016444,
      timestamp: 14344344.123456,
      site_id: 140806
      },
  ]}
```
Ejemplo de una respuesta afirmativa del seguimiento de conversiones para una campaña de DBM:
```
{
  attributed: 1,
  last_click_ad_id: 283641088,
  last_click_site_id: 1408067,
  last_click_placement_id: 107616368,
  last_click_creative_id :60162352,
  last_click_timestamp: 1415647655,
  last_click_exclid: "CKm0nLKhyssCFceH2wod8l4I4A"
  cps: "y",
  ad_events: [{
    product_type: "DBM",
    interaction_type: "click",
    ad_event_type: "click",
    campaign_type: "Display",
    line_item_id: 123456789,
    line_item_name: "TEST LINE ITEM NAME",
    external_customer_id: 2550,
    creative_id: 512333,
    exchange_id: 132,
    insertion_order_id: 523423,
    timestamp: 1432681913.123456
    cps: "y"
  },
  {
    product_type: "DCM",
    interaction_type: "click",
    campaign_type: "Display",
    placement_id: 9342323,
    placement_name: "TEST PLACEMENT NAME",
    external_customer_id: 7480542,
    creative_id: 8234234,
    timestamp: 1432681913.123456,
    cps: "y"
  }
]}
```

Integración de DDM para el seguimiento de aplicaciones de terceros Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Integración de DDM para el seguimiento de aplicaciones de terceros