Codice JavaScript per Analytics for Advertising

Inserzionisti con solo Advertising DSP

Per Advertising DSP, l’integrazione di Analytics for Advertising tiene traccia delle interazioni del sito view-through e click-through. Le visite click-through vengono tracciate dal codice Adobe Analytics standard sulle tue pagine web; il codice Analytics acquisisce i parametri AMO ID e EF ID nell’URL della pagina di destinazione e li tiene traccia nelle rispettive eVars riservate. Puoi tenere traccia delle visite view-through distribuendo uno snippet di JavaScript nelle pagine Web.

Nella visualizzazione della prima pagina di una visita al sito, il codice JavaScript di Adobe Advertising controlla se il visitatore ha già visto o fatto clic su un annuncio. Se l’utente è già entrato nel sito tramite un click-through o non ha visto un annuncio, il visitatore viene ignorato. Se il visitatore ha visualizzato un annuncio e non è entrato nel sito tramite un click-through durante l’intervallo di lookback su clic impostato in Adobe Advertising, il codice JavaScript di Adobe Advertising a) utilizza il servizio Experience Cloud ID per generare un ID supplementare (SDID) oppure b) utilizza il metodo Adobe Experience Platform Web SDK generateRandomID per generare un StitchID. Entrambi gli ID vengono utilizzati per unire i dati da Adobe Advertising all’hit di Adobe Analytics del visitatore. Adobe Analytics quindi richiede ad Adobe Advertising l’AMO ID e l’EF ID associati all’esposizione dell’annuncio. AMO ID e EF ID vengono quindi compilati nei rispettivi eVars. Questi valori persistono per un periodo designato (per impostazione predefinita, 60 giorni).

Analytics invia metriche del traffico del sito (come visualizzazioni di pagina, visite e tempo trascorso) e qualsiasi evento standard o personalizzato Analytics ad Adobe Advertising ogni ora, utilizzando l’ID EF come chiave. Queste metriche Analytics vengono quindi eseguite tramite il sistema di attribuzione Adobe Advertising per collegare le conversioni alla cronologia di clic e di esposizione.

NOTE
La logica di tracciamento di Adobe Advertising JavaScript si trova sul lato Adobe e quindi non ha virtualmente alcun impatto sul tempo di caricamento della pagina.
Al contrario, la logica per il connettore dati DCM in Analytics (utilizzando Google Campaign Manager 360) per Advertising DSP si verifica sul lato client. L’unione lato client rallenta il caricamento della pagina e aumenta il rischio di perdita di dati. Ciò si verifica perché il JavaScript Analytics deve eseguire il ping di DoubleClick e attendere che DoubleClick restituisca gli ultimi dati di clic/impression a Analytics. Quando il team DSP configura il connettore dati DCM, è necessario specificare per quanto tempo si è disposti a ritardare la pagina.

Distribuzione del codice JavaScript

La libreria JavaScript è costituita da due righe che consentono a Analytics e Adobe Advertising di comunicare tra loro. 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.

Code placement

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

  1. Open Chrome Developer Tools and click the Network tab.

  2. Load a website page that contains the Analytics for Advertising JavaScript.

  3. Filter the Network tab by last and review two rows:

    Filtering on last

    • 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:

    1. On the Application tab, find the adcloud cookie, and verify that the cookie contains _les_v (last visit) with a value of y and a UTC epoch timestamp that expires in 30 minutes.
      1. Delete the adcloud cookie and refresh the page.
  4. (Implementations that use the Experience Cloud Identity Service visitorAPI.js code) Filter on /b/ss to see the Analytics hit.

    Filtering on /b/ss

  5. (Implementations that use the Experience Platform Web SDK alloy.jscode) Filter on /interact to verify that the request payload to the Edge Network contains advertisingStitchID.

    Filtro su /interact

  6. Confronta i valori ID tra i due risultati. Tutti i valori devono trovarsi nei parametri della stringa di query ad eccezione dell’ID suite di rapporti nell’hit di Analytics, che è il percorso URL immediatamente dopo /b/ss/.

    table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4
    ID Parametro di Analytics Edge Network Parametro Adobe Advertising
    Organizzazione Experience Cloud IMS mcorgid _les_imsOrgid
    ID dati supplementari sdid _les_sdid
    ID unione stitchId advertisingStitchID sotto la proprietà _adcloud
    Suite di rapporti di Analytics Il valore dopo /b/ss/ _les_rsid
    ID visitatore Experience Cloud mid _les_mid

    Se i valori ID corrispondono, viene confermata l’implementazione di JavaScript. Adobe Advertising invia al server Analytics qualsiasi dettaglio di tracciamento click-through o view-through, se presente.

Come confermare il codice con Adobe Experience Platform Debugger

  1. Apri the Adobe Experience Platform Debugger nella tua home page.

  2. Passa alla scheda Network.

  3. Nella barra degli strumenti di Solutions Filter, fare clic su Adobe Advertising e Analytics.

  4. Nella riga del parametro Request URL - Hostname, individuare lasteventf-tm.everesttech.net.

  5. Nella riga Request - Parameters, controlla i segnali generati, in modo simile al passaggio 3 in “Come confermare il codice con Chrome Developer Tools”.

    • (Implementazioni che utilizzano il codice visitorAPI.js del servizio Experience Cloud Identity) Verifica che il parametro Sdid corrisponda al Supplemental Data ID nel filtro di Adobe Analytics.
    • (Implementazioni che utilizzano il codice alloy.js di Experience Platform Web SDK) Verificare che il valore del parametro advertisingStitchID corrisponda al Sdid inviato all’Edge Network di Experience Platform.
    • Se il codice non viene generato, verificare che il cookie Adobe Advertising sia stato rimosso nella scheda Application. Una volta rimossa, aggiorna la pagina e ripeti la procedura.

    Controllo del codice JavaScript di Analytics for Advertising in Platform Cloud Debugger

recommendation-more-help
advertising-help-integrations