Implementazione con AMP

AMP è un framework HTML open-source che fornisce un modo semplice per creare pagine web a caricamento rapido e fluido.

Poiché Adobe Analytics utilizza una libreria JavaScript per compilare e inviare una richiesta di immagine, sono necessarie delle regolazioni nell’implementazione per inviare i dati agli Adobi sulle pagine utilizzando AMP.

Determinare quale metodo implementare Adobe Analytics sulle pagine utilizzando AMP

Adobe ha creato due metodi per implementare Adobe Analytics sulle pagine utilizzando AMP. Entrambi utilizzano il <amp-analytics> HTML. Consulta amp-analytics per ulteriori informazioni, consulta la documentazione di AMP.

Nella tabella seguente vengono confrontati i due metodi seguenti:

Valuta i pro e i contro in modo da poter scegliere il metodo di implementazione migliore per la tua organizzazione.

Metodo 1: utilizzare <amp-analytics> tag con "adobeanalytics" modello

Il "adobeanalytics" il modello di tracciamento utilizza <amp-analytics> Tag HTML per creare direttamente una richiesta di tracciamento. Puoi specificare richieste di hit che si attivano su eventi di pagina specifici, come quando la pagina diventa visibile o si fa clic su di essa. È possibile personalizzare gli eventi di clic per applicarli a determinati ID o classi di elementi specificando un selettore. Puoi caricare il modello aggiungendo type="adobeanalytics" al tag amp-analytics.

Nell’esempio di codice seguente sono definiti due trigger: pageLoad e click. Il pageLoad viene attivato quando il documento diventa visibile e include pageName come definito nella vars sezione. Il secondo trigger click si attiva quando si fa clic su un pulsante. Il eVar1 è impostata per questo evento con il valore button clicked.

<amp-analytics type="adobeanalytics">
  <script type="application/json">
    {
      "requests": {
        "myClick": "${click}&v1=${eVar1}",
      },
      "vars": {
        "host": "example.data.adobedc.net",
        "reportSuites": "reportSuiteID1,reportSuiteID2",
        "pageName": "Adobe Analytics Using amp-analytics tag"
      },
      "triggers": {
        "pageLoad": {
          "on": "visible",
          "request": "pageview"
        },
        "click": {
          "on": "click",
          "selector": "button",
          "request": "myClick",
          "vars": {
            "eVar1": "button clicked"
          }
        }
      }
    }
  </script>
</amp-analytics>

Il <amp-analytics> Il tag supporta le sostituzioni di variabili in modo che AMP possa fornire valori di dati riconosciuti. Consulta variabili supportate in amp-analytics su GitHub per ulteriori informazioni.

Adobe identifica i visitatori utilizzando una funzione AMP integrata e imposta il cookie adobe_amp_id. Questo ID visitatore è univoco rispetto a qualsiasi altro ID impostato da Adobe Analytics. Un visitatore univoco diverso viene conteggiato per ogni CDN da cui un visitatore recupera il contenuto, il che può gonfiare il conteggio dei visitatori univoci. L’utilizzo di una suite di rapporti separata per le pagine AMP è vivamente consigliato a causa del modo in cui AMP identifica i visitatori univoci. Servizio Adobe Experience Cloud ID non supportato.

Questa soluzione richiede che il server di tracciamento specificato in host La proprietà corrisponde al server di tracciamento sul sito principale, in modo che vengano rispettati i controlli esistenti dell'informativa sulla privacy. In caso contrario, crea un’informativa sulla privacy separata per le pagine che utilizzano AMP.

Metodo 2: utilizzare <amp-analytics> tag con "adobeanalytics_nativeConfig" modello

Il "adobeanalytics_nativeConfig" è più semplice da implementare, in quanto utilizza la stessa metodologia di assegnazione tag utilizzata nelle normali pagine web. Aggiungi quanto segue al tuo amp-analytics tag:

<amp-analytics type="adobeanalytics_nativeConfig">
  <script type="application/json">
    {
      "requests": {
        "base": "https://${host}",
        "iframeMessage": "${base}/stats.html?campaign=${queryParam(campaign)}&pageURL=${ampdocUrl}&ref=${documentReferrer}"
      },
      "vars": {
        "host": "example.data.adobedc.net"
      },
      "extraUrlParams": {
      "pageName": "Example AMP page",
      "v1": "eVar1 example value"
      }
    }
 </script>
</amp-analytics>

È inoltre necessaria una pagina HTML ospitata sui server web:

<html>
  <head>
    <title>Stats Example</title>
    <script language="JavaScript" type="text/javascript" src="VisitorAPI.js"></script>
    <script language="JavaScript" type="text/javascript" src="AppMeasurement.js"></script>
  </head>
  <body>
    <script>
      var v_orgId = "INSERT-ORG-ID-HERE";
      var s_account = "examplersid1,examplersid2";
      var s_trackingServer = "example.data.adobedc.net";
      var visitor = Visitor.getInstance(v_orgId);
      visitor.trackingServer = s_trackingServer;
      var s = s_gi(s_account);
      s.account = s_account;
      s.trackingServer = s_trackingServer;
      s.visitorNamespace = s_visitorNamespace;
      s.visitor = visitor;
      s.pageName = s.Util.getQueryParam("pageName");
      s.eVar1 = s.Util.getQueryParam("v1");
      s.campaign = s.Util.getQueryParam("campaign");
      s.pageURL = s.Util.getQueryParam("pageURL");
      s.referrer = s.Util.getQueryParam("ref");
      s.t();
    </script>
  </body>
</html>

Questo approccio invia i dati a una pagina web di utilità tramite i parametri della stringa di query aggiunti al iframeMessage parametro di richiesta. Questi parametri della stringa di query possono essere denominati come desideri, purché stats.html pagina è configurata per raccogliere i dati da essi.

Il "adobeanalytics_nativeConfig" Il modello aggiunge anche parametri di stringa di query basati sulle variabili elencate nella extraUrlParams sezione del <amp-analytics> tag. Nell’esempio precedente, il pageName e v1 I parametri di sono inclusi.

Utilizzando questo metodo, se un utente rinuncia al tracciamento sul sito principale, viene escluso anche dal tracciamento su tutti gli AMP. L'utilizzo di questa pagina dell'utilità consente inoltre ad AMP di supportare il servizio Adobe Experience Cloud ID. Non è necessaria una suite di rapporti separata.

Non è possibile utilizzare il tracciamento dei collegamenti e il tracciamento dei video con questo metodo. Il iframeMessage in AMP può essere caricato una sola volta per pagina, pertanto non puoi inviare altre richieste di immagini dopo il caricamento del frame. Questo metodo richiede inoltre più risorse di elaborazione da eseguire, il che può influire sulle prestazioni di scorrimento. Questo metodo non influisce sul tempo di caricamento della pagina, poiché tutte le risorse vengono caricate in modo asincrono.

Domande frequenti

Come posso distinguere i visitatori AMP dagli altri nei miei dati?

Per tutte le pagine AMP, il JavaScript Version la quota raccoglie un valore simile a AMP vX.X. Puoi anche impostare una dimensione personalizzata su "AMP" in modo da poter segmentare questi visitatori.

Come si confronta questo metodo di implementazione con gli articoli istantanei di Facebook?

Gli articoli istantanei di facebook supportano una soluzione simile a "adobeanalytics_nativeConfig" metodo. Il stats.html Questa pagina di questo metodo può soddisfare le tue esigenze di analisi sia per AMP che per FIA contemporaneamente. Per ulteriori informazioni sull'implementazione del tracciamento su FIA, vedi Articoli istantanei facebook.