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

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

En el siguiente flujo de extremo a extremo, se describe la configuración del anunciante y la implementación de terceros que se requiere para publicar una campaña en productos orientados a la compra de DoubleClick con una solución de seguimiento de apps de terceros. Para obtener más información general sobre el marketing digital de DoubleClick y una descripción general de la función de atribución en la app, consulta la página de antecedentes del marketing digital de DoubleClick.

El anunciante configura el evento de conversión en DDM para representar la instalación o conversión (solo Bid Manager - píxel de conversión) (Campaign Manager - Actividad de Floodlight).
Evento de conversión de anunciante de vínculos de DDM en la interfaz de terceros y proporciona variables clave que identifican un anunciante y un grupo de actividad de conversión.
- src es el ID del anunciante que representa la fuente de la actividad de Floodlight.
- cat es la string de la etiqueta de actividad que los servidores de Floodlight usan para identificar el grupo al que pertenece la actividad.
- type es la string de la etiqueta del grupo, que identifica el grupo de actividad con el que está asociada la actividad de Floodlight.
- u1, u2, ... (si están disponibles) son los pares clave-valor de variables personalizadas de Floodlight.
Además, el anunciante debe proporcionarle a su tercero un token específico de autorización: token es una string alfanumérica específica del anunciante que debe pasarse junto con cada solicitud de servidor a DDM.
El anunciante publica una campaña de anuncios en la app con etiquetas de anuncios publicadas por DBM en intercambios de ofertas en tiempo real o publicadas por DCM en medios comprados directamente.
El usuario final ve los anuncios registrados por DDM o hace clic en ellos.
Cuando el usuario final instala la app o completa un evento de conversión (juego, juego, etc.), servidores de terceros y DDM en cada actividad de la app
```
https://ad.doubleclick.net/ddm/s2s/appactivity/src=1234567;cat=fghij456;type=abcde123;u1=[friendlyname1];ord=1312312312
```
Donde:
- src es el ID del anunciante que representa la fuente de la actividad de Floodlight.
- cat es la string de la etiqueta de actividad que los servidores de Floodlight usan para identificar el grupo al que pertenece la actividad.
- type es la string de la etiqueta del grupo, que identifica el grupo de actividades con el que está asociada la actividad de Floodlight.
- ord es un número al azar que se usa para que la etiqueta de Floodlight sea única.
- u1, u2, ... (si están disponibles) son los pares clave-valor de variables personalizadas de Floodlight.
con parámetros adicionales enviados mediante carga útil JSON en una solicitud POST HTTP:
```
{
  "app": {
    "bundle": "com.rovio.angrybirds"
  },
  "device": {
    "ua": "Mozilla/5.0 (iPhone; CPU iPhone OS 6_0 like Mac OS X) AppleWebKit/536.26 (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 donde se realizó la actividad de conversión no está disponible.
- bundle (si está disponible) es el campo de objeto de la app que contiene un valor de string del nombre del paquete de Play Store o el ID de la 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 de dispositivo que representa la string usuario-agente de la app en la que se grabó 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 string de hash MD5 del valor del IDFA en mayúsculas o del ID de publicidad de Google Play.
- lmt es un número entero, con un valor de 1 si el usuario habilitó la opción "Limitar seguimiento de anuncios" con IDFA/AdID, o 0 si no está configurada.
DDM responderá con una respuesta JSON sobre si el evento de conversión se atribuye a una vista o un clic que entrega DCM y, en caso de ser SÍ, información adicional sobre el evento (última vista o clic):
```
- Ad ID
- Site ID
- Placement ID
- Creative ID
- Timestamp
```
Un ejemplo de respuesta JSON puede verse de la siguiente manera:
```
{"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"}
```
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 se atribuye = 1) es el ID de anuncio de la última impresión.
- last_impression_site_id (si se atribuye = 1) es el ID del sitio para la última impresión.
- last_impression_placement_id (si se atribuye = 1) es el ID de posición de la última impresión.
- last_impression_creative_id (si se atribuye = 1) es el ID de la creatividad de la última impresión.
- last_click_ad_id (si se atribuyó = 1 y se atribuyó un clic) es el ID del anuncio del último clic.
- last_click_site_id (si se atribuye = 1 y se atribuyó un clic) es el ID del sitio del último clic.
- last_click_placement_id (si se atribuye = 1 y se atribuyó un clic) es el ID de posición del último clic.
- last_click_creative_id (si se atribuye = 1 y se atribuyó un clic) es el ID de la creatividad del último clic.
- last_click_exclid corresponde a un ID de clic único propagado a través de la macro %eiid!
con códigos de error HTTP para los siguientes casos:
- HTTP 204 si se superó la cuota de solicitudes.
- HTTP 400 cuando se considera que la solicitud no es válida (p.ej., faltan parámetros obligatorios) y el servidor recurre 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 campaña en su sistema; el anunciante también podrá ver los informes de conversiones en DCM con los mismos parámetros que se mencionaron anteriormente.