JavaScript-Code für Analytics for Advertising
Nur Werbetreibende mit Advertising DSP
Bei Advertising DSP verfolgt die Analytics for Advertising-Integration Site-Interaktionen mit Ansichts- und Clickthrough. Clickthrough-Besuche werden vom Standard-Adobe Analytics-Code auf Ihren Web-Seiten verfolgt; der Analytics erfasst die AMO-ID- und EF-ID-Parameter in der Landingpage-URL und verfolgt sie in ihren jeweiligen reservierten eVars. Sie können Viewthrough-Besuche verfolgen, indem Sie ein JavaScript-Snippet auf Ihren Web-Seiten bereitstellen.
Bei der ersten Seitenansicht eines Besuchs auf der Website prüft der Adobe Advertising JavaScript-Code, ob der Besucher eine Anzeige bereits gesehen oder darauf geklickt hat. Wenn der/die Benutzende die Website zuvor über einen Clickthrough betreten hat oder keine Anzeige gesehen hat, wird der/die Besuchende ignoriert. Wenn der Besucher eine Anzeige gesehen hat und während des in Adobe Advertising festgelegten Klick-Lookback-Fensters nicht über einen Clickthrough auf die Website zugegriffen hat, verwendet der Adobe Advertising-JavaScript-Code entweder a) den Experience Cloud ID-Service, um eine zusätzliche ID zu generieren (SDID), oder b) die Adobe Experience Platform-Web SDK-generateRandomID-Methode, um eine StitchID zu generieren. Beide IDs werden verwendet, um Daten aus Adobe Advertising mit dem Adobe Analytics-Treffer des Besuchers zusammenzufügen. Adobe Analytics fragt dann in Adobe Advertising die AMO-ID und die EF-ID ab, die mit der Anzeigenbelichtung verbunden sind. Die AMO-ID und die EF-IDs werden dann in den entsprechenden eVars ausgefüllt. Diese Werte bleiben für einen bestimmten Zeitraum erhalten (standardmäßig 60 Tage).
Analytics sendet stündlich Traffic-Metriken (z. B. Seitenansichten, Besuche und Besuchszeit) sowie alle Analytics benutzerdefinierten oder Standardereignisse an Adobe Advertising. Dabei wird die EF-ID als Schlüssel verwendet. Diese Analytics Metriken laufen dann durch das Adobe Advertising-Attributionssystem, um die Konversionen mit dem Klick- und Belichtungsverlauf zu verbinden.
Bereitstellen des JavaScript-Codes
Die JavaScript-Bibliothek besteht aus zwei Zeilen, die es Analytics und Adobe Advertising ermöglichen, miteinander zu kommunizieren. If the Analytics for Advertising integration was completed during the Adobe Advertising implementation, then you should have already received this code with instructions on how to deploy it.
The code
Implementations that use the Experience Cloud Identity Service visitorAPI.js code
<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>
Implementations that use the Experience Platform Web SDK alloy.jscode
<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>
Where to place the code
The Analytics for Advertising JavaScript function must come after the Experience Cloud ID Service but before your Analytics App Measurement code. This ensures that the supplemental ID (SDID) or StitchID is included in your Analytics call.
Validating code deployment
You can perform validation using any packet sniffer type of tool (such as Charles, Fiddler, or Chrome Developer Tools) by comparing the values of the four IDs between the request going to Adobe Advertising and the request going to Analytics, as outlined below.
How to confirm the code with Chrome Developer Tools validate-js-chrome
-
Open Chrome Developer Tools and click the Network tab.
-
Load a website page that contains the Analytics for Advertising JavaScript.
-
Filter the Network tab by
lastand review two rows:
-
The first row is the call to the JavaScript library and is titled
last-event-tag-latest.min.js. -
The second row is the call sending the request to Adobe Advertising. It begins as follows:
_les_imsOrgId=[your_imsOrgId_here]&_les_url=[your_encoded_url]If you don’t see the call to Adobe Advertising, then it might not be the first page view of your visit. For testing purposes, you can remove the cookie so that the next call is the first page view for the corresponding visit:
- On the Application tab, find the
adcloudcookie, and verify that the cookie contains_les_v(last visit) with a value ofyand a UTC epoch timestamp that expires in 30 minutes.- Delete the
adcloudcookie and refresh the page.
- Delete the
-
-
(Implementations that use the Experience Cloud Identity Service
visitorAPI.jscode) Filter on/b/ssto see the Analytics hit.
-
(Implementations that use the Experience Platform Web SDK
alloy.jscode) Filter on/interactto verify that the request payload to the Edge Network containsadvertisingStitchID.
-
Vergleichen Sie die ID-Werte zwischen den beiden Treffern. Alle Werte sollten in Abfragezeichenfolgenparametern angegeben werden, mit Ausnahme der Report Suite-ID im Analytics-Treffer, bei der es sich um den URL-Pfad unmittelbar nach der
/b/ss/handelt.table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4 ID Analytics-Parameter Edge Network Adobe Advertising-Parameter Experience Cloud IMS Org mcorgid_les_imsOrgidZusatzdaten-ID sdid _les_sdidZuordnungs-ID stitchId advertisingStitchIDunter der_adcloudAnalytics Report Suite Der Wert nach /b/ss/_les_rsidExperience Cloud-Besucher-ID Mitte _les_midWenn die ID-Werte übereinstimmen, wird die JavaScript-Implementierung bestätigt. Adobe Advertising sendet dem Analytics alle Clickthrough- oder View-Through-Tracking-Details, sofern vorhanden.
Bestätigen des Codes mit Adobe Experience Platform Debugger
-
Öffnen Sie die Adobe Experience Platform Debugger auf Ihrer Homepage.
-
Wechseln Sie zur Registerkarte Network .
-
Klicken Sie in der Solutions Filter-Symbolleiste auf Adobe Advertising und Analytics Sie.
-
Suchen Sie in der Request URL - Hostname Parameterzeile nach
lasteventf-tm.everesttech.net. -
Überprüfen Sie in der Request - Parameters Zeile die generierten Signale, ähnlich wie in Schritt 3 unter " zum Bestätigen des Codes mit Chrome Developer Tools.
- (Implementierungen, die den
visitorAPI.js-Code des Experience Cloud Identity Services verwenden) Stellen Sie sicher, dass derSdidmit demSupplemental Data IDim Adobe Analytics-Filter übereinstimmt. - (Implementierungen, die den Experience Platform-Web SDK verwenden
alloy.jsCode) Stellen Sie sicher, dass der Wert desadvertisingStitchID-Parameters mit dem an Experience Platform Edge Network gesendetenSdidübereinstimmt. - Wenn der Code nicht generiert wird, überprüfen Sie, ob das Adobe Advertising-Cookie auf der Registerkarte “Application” entfernt wurde. Aktualisieren Sie die Seite nach dem Entfernen und wiederholen Sie den Vorgang.
- (Implementierungen, die den