Documentación Advertising Integraciones con Experience Cloud

Código JavaScript para Analytics for Advertising

Last update: Fri Jul 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Temas:

Creado para:

Usuario
Desarrollador

Anunciantes solo con Advertising DSP

Para Advertising DSP, la integración de Analytics for Advertising realiza un seguimiento de las interacciones de sitios de pulsaciones y vistas. Las visitas de pulsación se rastrean mediante el código estándar de Adobe Analytics en sus páginas web; el código Analytics captura los parámetros de ID de AMO e ID de EF en la dirección URL de la página de aterrizaje y los rastrea en sus respectivos eVars reservados. Puede realizar un seguimiento de las visitas de visualización mediante la implementación de un fragmento de JavaScript en sus páginas web.

En la primera vista de página de una visita al sitio, el código JavaScript de Adobe Advertising comprueba si el visitante ha visto o hecho clic anteriormente en un anuncio. Si el usuario ha entrado anteriormente en el sitio mediante un clic o no ha visto un anuncio, se ignora al visitante. Si el visitante ha visto un anuncio y no ha entrado al sitio mediante un clic durante la ventana retrospectiva de clic establecida en el Adobe Advertising, el código JavaScript de Adobe Advertising a) usa el servicio de ID de Experience Cloud para generar un ID suplementario (SDID) o b) usa el método de Adobe Experience Platform Web SDK generateRandomID para generar un StitchID. Cualquiera de los ID se utiliza para unir los datos del Adobe Advertising con la visita de Adobe Analytics del visitante. A continuación, Adobe Analytics consulta al Adobe Advertising el ID de AMO y el ID de EF asociados con la exposición del anuncio. A continuación, el ID de AMO y los ID de EF se rellenan en sus respectivos eVars. Estos valores persisten durante un periodo designado (de forma predeterminada, 60 días).

Analytics envía métricas de tráfico del sitio (como vistas de página, visitas y tiempo empleado) y cualquier evento estándar o personalizado de Analytics al Adobe Advertising cada hora, usando el ID de EF como clave. Estas métricas de Analytics se ejecutan a través del sistema de atribución de Adobes Advertising para conectar las conversiones al historial de clics y exposiciones.

NOTE

La lógica de seguimiento de JavaScript de Adobe Advertising se produce en el lado del Adobe y, por lo tanto, no tiene prácticamente ningún impacto en el tiempo de carga de la página.

Por el contrario, la lógica del conector de datos DCM a Analytics (con Google Campaign Manager 360) para Advertising DSP se produce en el lado del cliente. La vinculación del lado del cliente ralentiza la carga de página y aumenta el riesgo de pérdida de datos. Esto ocurre porque el JavaScript Analytics debe hacer ping a DoubleClick y esperar a que DoubleClick devuelva los datos del último clic/impresión a Analytics. Cuando su equipo DSP configure el conector de datos DCM, debe especificar cuánto tiempo está dispuesto a retrasar la página.

Implementación del código JavaScript

La biblioteca JavaScript consta de dos líneas que permiten que Analytics y el Adobe Advertising se comuniquen entre sí. Si la integración de Analytics for Advertising se completó durante la implementación de Adobe Advertising, ya debería haber recibido este código con instrucciones sobre cómo implementarlo.

El código

Implementaciones que utilizan el código del servicio de identidad de Experience Cloud `visitorAPI.js`

<script src="https://www.everestjs.net/static/le/last-event-tag-latest.min.js">
<script>
     if("undefined" != typeof AdCloudEvent)
          AdCloudEvent('IMS ORG Id','rsid');
</script>

Implementaciones que utilizan el código de Experience Platform Web SDK `alloy.js`

<script src="https://www.everestjs.net/static/le/last-event-tag-latest.min.js">
<script>
     if("undefined" != typeof AdCloudEvent)
          stitchId = AdCloudEvent('IMS ORG Id','rsid').generateRandomId();
</script>

Dónde colocar el código

La función de JavaScript Analytics for Advertising debe ir después del servicio de ID de Experience Cloud, pero antes que el código de App Measurement de Analytics. Esto garantiza que el identificador suplementario (SDID) o StitchID se incluya en la llamada de Analytics.

Colocación de código

Validando implementación de código

Puede realizar la validación utilizando cualquier tipo de herramienta de detector de paquetes (como Charles, Fiddler o Chrome Developer Tools) comparando los valores de los cuatro identificadores entre la solicitud que va al Adobe Advertising y la solicitud que va a Analytics, como se describe a continuación.

Confirmar el código con Chrome Developer Tools validate-js-chrome

Abra Chrome Developer Tools y haga clic en la ficha Red.
Cargue una página de sitio web que contenga el JavaScript Analytics for Advertising.
Filtre la ficha Network por last y revise dos filas:
- La primera fila es la llamada a la biblioteca de JavaScript y se titula last-event-tag-latest.min.js.
- La segunda fila es la llamada que envía la solicitud al Adobe Advertising. Comienza de la siguiente manera: _les_imsOrgId=[your_imsOrgId_here]&_les_url=[your_encoded_url]
  
  Si no ve la llamada al Adobe Advertising, es posible que no sea la primera vista de página de la visita. Para realizar pruebas, puede eliminar la cookie de modo que la siguiente llamada sea la primera vista de página de la visita correspondiente:
1. En la ficha Aplicación, busque la cookie adcloud y compruebe que la cookie contiene _les_v (última visita) con un valor de y y una marca de tiempo UTC epoch que caduca en 30 minutos.
  1. Elimine la cookie adcloud y actualice la página.
(Implementaciones que utilizan el código del servicio de identidad de Experience Cloud visitorAPI.js) Filtre en /b/ss para ver la visita de Analytics.
(Implementaciones que usan el Experience Platform Web SDK alloy.jscode) Filter on /interact para comprobar que la carga de la solicitud al Edge Network contiene advertisingStitchID.

Compare los valores de ID entre las dos visitas. Todos los valores deben estar en parámetros de cadena de consulta, excepto el ID del grupo de informes en la visita de Analytics, que es la ruta de la URL inmediatamente después de /b/ss/.

table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4
ID	Parámetro de Analytics	Edge Network	Parámetro de Adobe Advertising
Organización de IMS de Experience Cloud	`mcorgid`		`_les_imsOrgid`
ID de datos suplementario	sdid		`_les_sdid`
ID de unión	stitchId	`advertisingStitchID` bajo la propiedad `_adcloud`
Analytics Report Suite	El valor después de `/b/ss/`		`_les_rsid`
ID de visitante de Experience Cloud	mid		`_les_mid`

Si los valores de ID coinciden, se confirma la implementación de JavaScript. El Adobe Advertising envía al servidor Analytics cualquier detalle de seguimiento de clics o visualizaciones, si existe.

Confirmar el código con Adobe Experience Cloud Debugger

Abra Adobe Experience Cloud Debugger en su página de inicio.
Vaya a la ficha Network.
En la barra de herramientas Solutions Filter, haga clic en Adobe Advertising y Analytics.
En la fila del parámetro Request URL - Hostname, busque lasteventf-tm.everesttech.net.
En la fila Request - Parameters, audite las señales generadas, de forma similar al Paso 3 de "Cómo confirmar el código con Chrome Developer Tools".
- (Implementaciones que utilizan el código del servicio de identidad de Experience Cloud visitorAPI.js) Asegúrese de que el parámetro Sdid coincida con Supplemental Data ID en el filtro de Adobe Analytics.
- (Implementaciones que utilizan el Experience Platform Web SDK alloy.jscode) Asegúrese de que el valor del parámetro advertisingStitchID coincida con el parámetro Sdid enviado al Edge Network Experience Platform.
- Si el código no se está generando, asegúrese de que la cookie de Adobe Advertising se haya eliminado en la pestaña Application. Una vez eliminada, actualice la página y repita el proceso.

recommendation-more-help

fbbdcc36-f208-41e5-b715-a077abaec5c3