Show Menu
ARGOMENTI×

Implementazione con AMP

AMP è un framework HTML open-source che fornisce un modo semplice per creare pagine Web con caricamento rapido e uniforme.
Poiché Adobe Analytics utilizza una libreria JavaScript per compilare e inviare una richiesta di immagine, nell’implementazione sono necessarie delle regolazioni per inviare dati ad Adobe sulle pagine tramite AMP.

Determinare quale metodo implementare Adobe Analytics sulle pagine utilizzando AMP

Adobe ha creato due metodi per implementare Adobe Analytics sulle pagine tramite AMP. Entrambi utilizzano il tag <amp-analytics> HTML. Per ulteriori informazioni, consulta Tag di analisi amp su ampproject GitHub.
  • Utilizzate il modello "adobeanalytics" di tracciamento: Crea la richiesta di Analytics direttamente sulla pagina
  • Utilizzate il modello "analytics_nativeConfig" di tracciamento: Utilizza un iframe contenente lo stesso codice AppMeasurement distribuito nel sito normale
Nella tabella seguente vengono confrontati i due metodi seguenti:
Modello "adobeanalytics"
Modello "adobeanalytics_nativeConfig"
Conteggio visitatori/visite nella suite di rapporti esistente
Alta inflazione
Inflazione minima
Utilizzare una suite di rapporti separata
Consigliato
Non necessario
Visitatori nuovi e di ritorno
Non supportato
Supportate
Servizio ID visitatori
Non supportato
Supportate
Tracciamento di video e collegamenti
Supporto parziale
Non ancora supportato
Difficoltà di implementazione
Un po' difficile
Relativamente facile
Integrazioni Adobe Experience Cloud
Non supportato
Supporto parziale
Valutare i pro e i contro all'interno dell'organizzazione per determinare quale metodo utilizzare. Per un esempio di codice, consultate esempi mobile-web AMP sull'archivio GitHub di Adobe.
Non utilizzate sia i modelli "adobeanalytics" che "adobeanalytics_nativeConfig" i modelli sulla stessa pagina utilizzando AMP. Se tentate di farlo, potete generare errori nella console del browser e il doppio conteggio dei visitatori.

Metodo 1: Utilizzare il tag amp-analytics con il modello "adobeanalytics"

Il modello di "adobeanalytics" tracciamento utilizza il tag <amp-analytics> HTML per creare direttamente una richiesta di tracciamento. Potete specificare le richieste di hit da attivare su eventi di pagina specifici, ad esempio quando la pagina diventa visibile o su un clic. Gli eventi di clic possono essere personalizzati per essere applicati ad alcuni ID di elementi o classi specificando un selettore. Potete caricare il modello aggiungendo type="adobeanalytics" al tag amp-analytics.
Nell'esempio di codice seguente sono definiti due attivatori: pageLoad e click . L' pageLoad attivatore viene attivato quando il documento diventa visibile e include la pageName variabile come definita nella vars sezione. Il secondo trigger click viene attivato quando si fa clic su un pulsante. eVar1 è impostato per questo evento con il valore button clicked .
<amp-analytics type="adobeanalytics">
  <script type="application/json">
    {
      "requests": {
        "myClick": "${click}&v1=${eVar1}",
      },
      "vars": {
        "host": "example.sc.omtrdc.net",
        "reportSuites": "reportSuiteID",
        "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>

Nell' click attivatore, potete specificare un selettore in modo che ogni volta che si fa clic sullo specifico elemento DOM (in questo caso, su un pulsante), la buttonClick richiesta venga attivata e impostata automaticamente per indicare l'hit come una chiamata di tracciamento del collegamento.
Inoltre, amp-analytics supporta una serie di sostituzioni variabili in modo che AMP possa fornire valori di dati di cui è a conoscenza. Per ulteriori informazioni, vedi le variabili supportate nelle analisi di ampli su GitHub.
Le richieste di immagini inviate ad Adobe con questo metodo non includono i dati per molti rapporti predefiniti (ad esempio, browser, dimensioni dello schermo o referente). Se desiderate includere queste informazioni negli hit, accertatevi che siano incluse come parte della stringa di query della richiesta di immagine. Per ulteriori informazioni, vedi Parametri query di raccolta dati.
Adobe identifica i visitatori utilizzando una funzione AMP integrata e imposta il cookie adobe_amp_id . Questo ID visitatore è univoco per qualsiasi altro ID impostato da Adobe Analytics (ad esempio, il s_vi cookie). Il servizio Adobe Experience Cloud ID non è supportato utilizzando questo metodo di implementazione.
AMP utilizza CDN per distribuire contenuti. È strutturata per contare un visitatore univoco diverso per ogni CDN da cui un visitatore recupera il contenuto, il che può aumentare il numero di visitatori univoci.
È consigliabile utilizzare una suite di rapporti distinta per le pagine AMP, in quanto AMP identifica i visitatori univoci.
Questa soluzione richiede che il server di tracciamento specificato nella host proprietà corrisponda al server di tracciamento sul sito principale, in modo da rispettare i controlli dell'informativa sulla privacy esistenti. In caso contrario, create un'informativa sulla privacy separata per le pagine utilizzando AMP.

Metodo 2: Utilizzare il tag amp-analytics con il modello "adobeanalytics_nativeConfig"

Il "adobeanalytics_nativeConfig" tag è più semplice da implementare, in quanto utilizza la stessa metodologia di tag utilizzata sulle pagine Web normali. Aggiungi quanto segue al 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.sc.omtrdc.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 = "examplersid";
      var s_trackingServer = "example.sc.omtrdc.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 parametro iframeMessage request. Questi parametri di stringa di query possono essere denominati come preferite, purché la stats.html pagina sia configurata per la raccolta dei dati da tali parametri.
Il "adobeanalytics_nativeConfig" modello aggiunge anche parametri di stringa di query basati sulle variabili elencate nella extraUrlParams sezione del tag amp-analytics. Nell'esempio precedente, i pageName parametri e v1 .
La stats.html pagina deve essere ospitata in un sottodominio separato dal dominio in cui è ospitato l’AMP stesso. Il framework AMP non consente iframe dello stesso sottodominio in cui esiste la pagina AMP stessa. Ad esempio, se l’AMP è ospitato in amp.example.com , ospita la stats.html pagina in un sottodominio separato, ad esempio ampmetrics.example.com .
Utilizzando questo metodo, se un utente rinuncia al tracciamento sul sito principale, viene escluso anche il tracciamento su tutti gli AMP. Utilizzando questa pagina di utilità, AMP può anche supportare il servizio Adobe Experience Cloud ID. Non è richiesta una suite di rapporti separata.
Con questo metodo non è possibile utilizzare il tracciamento dei collegamenti e il tracciamento video. Il iframeMessage tag in AMP può essere caricato solo una volta per pagina, pertanto non potete inviare altre richieste di immagini dopo il caricamento del frame. Questo metodo richiede inoltre ulteriori risorse di elaborazione da eseguire, che possono avere un impatto 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

Il tracciamento video è disponibile per entrambi i metodi?
No. Lo standard AMP supporta solo attivatori per "visible", "click" e "timer". Non supporta ancora attivazioni esplicite per il tracciamento video che il amp-analytics tag può ascoltare. Inoltre, il "adobeanalytics_nativeConfig" modello può essere caricato solo una volta, pertanto non è possibile effettuare richieste di immagini successive al caricamento di una pagina.
Come posso distinguere i visitatori AMP da altri nei miei dati?
Per tutte le pagine AMP, la JavaScript Version dimensione raccoglie un valore simile a AMP vX.X . Potete anche impostare una dimensione personalizzata su 'AMP' in modo da segmentare i visitatori.
In che modo questo metodo di implementazione è paragonabile agli articoli istantanei di Facebook?
Gli articoli istantanei di Facebook supportano una soluzione simile al "adobeanalytics_nativeConfig" metodo. La stats.html pagina per questo metodo può soddisfare le esigenze di analisi sia per AMP che per FIA simultaneamente. Per ulteriori informazioni sull'implementazione del tracciamento su FIA, consulta Articoli istantanei di Facebook.