AMP
IT
English Deutsch Français العربية Español Indonesia 日本語 한국어 Português Русский Türkçe 中文 Polski Tiếng việt

Integrazione di strumenti di analisi in AMP

Informazioni generali

Utilizzando strumenti di tipo software come servizi (software-as-a-service) per editori per analizzare al meglio i loro flussi di traffico e di visitatori, potresti avere l'esigenza di integrare il tuo servizio in amp-analytics. Ciò consentirà ai tuoi clienti di visualizzare i flussi di traffico per le loro pagine AMP HTML.

Per iniziare

Prima di poter aggiungere i tuoi servizi e strumenti di analisi al sistema runtime di AMP HTML, dovrai:

  • Individuare i tipi di variabili e richieste di cui avrai bisogno in un documento AMP HTML per il tuo servizio di analisi.
  • Determinare se la funzione di plug-in per invio in batch è necessaria per costruire l'URL finale in caso di utilizzo dell'invio in batch di richieste.
  • Identificare gli eventi che determinano l'invio di richieste di analisi da parte di pagine che sono pertinenti per il tuo servizio.
  • Valutare se e in che modo tracciare gli utenti in contesti AMP proprietari e di terzi.
  • Determinare come il pannello di controllo del tuo strumento di analisi gestisce il traffico AMP.
  • Individuare eventuali funzionalità mancanti in amp-analytics e richieste di file per le funzionalità necessarie.
  • AMP Analytics invia le sue variabili a un endpoint preconfigurato. Se non si dispone già di un endpoint esistente, si può consultare questo esempio su come realizzarne uno.
  • Per tutti i tipi di trasporto tranne iframe, le variabili vengono inviate come parametri della stringa di query in una richiesta HTTPS.
  • Per il tipo di trasporto iframe, viene creato un iframe e le variabili vengono inviate tramite window.postMessage. In questo caso, il messaggio non deve essere un URL. Questa opzione è disponibile solo per i fornitori accreditati MRC.
  • Considerare come l'integrazione con amp-analytics può influire sulle informative adottate (in particolare quella sulla privacy) o sui contratti in essere.

Aggiunta della propria configurazione al sistema di runtime AMP HTML

  1. Creare una segnalazione Intent-to-Implement che dichiara l'aggiunta della configurazione del proprio servizio di analisi al sistema runtime di AMP HTML. Assicurarsi di includere cc @ ampproject / wg-analytics nella descrizione.
  2. Sviluppare una patch che implementa quanto segue:
  3. Un nuovo file json di configurazione ${vendorName}.json nella cartella dei fornitori, che include le opzioni suddette oltre a quelle predefinite, quali:
    1. "vars": {} per ulteriori variabili predefinite.
    2. "requests": {} per le richieste che verranno utilizzate dal servizio.
    3. "optout": se necessario. Al momento non abbiamo un buon sistema di annullamento delle sottoscrizioni, quindi ti chiediamo di aiutarci a progettarne uno che funzioni bene per i tuoi servizi.
    4. "warningMessage": se necessario. Visualizzare le informazioni e gli avvisi del fornitore (quali avvisi di elementi deprecati o di migrazione) nella console.
  4. Se si utilizza il trasporto iframe, aggiungere anche una nuova riga a ANALYTICS_IFRAME_TRANSPORT_CONFIG in iframe-transport-vendors.js contenente "*vendor-name*": "*url*"
  5. Un esempio è disponibile nei riferimenti examples/analytics-vendors.amp.html.
  6. Un test nel file extensions/amp-analytics/0.1/test/vendor-requests.json.
  7. Aggiungere il proprio servizio di analisi all'elenco dei fornitori supportati nel file extensions/amp-analytics/0.1/analytics-vendors-list.md. Includere tipo, descrizione e collegamenti alla documentazione di utilizzo.
  8. Verificare se è richiesto un nuovo plug-in di invio in batch. Consultare le istruzioni Aggiungi plug-in di invio in batch.
  9. Testare il nuovo esempio inserito in examples/analytics-vendors.amp.html per assicurarsi che i risultati funzionino come previsto. Ad esempio, verificare che i dati necessari vengono raccolti e visualizzati nel pannello di controllo dello strumento di analisi.
  10. Inviare una richiesta pull con questa patch, facendo riferimento alla segnalazione Intent-to-Implement.
  11. Aggiornare la documentazione di utilizzo del servizio e informarne i clienti.
  12. Si consiglia di mantenere un test di integrazione al di fuori dell'archivio AMP.

Gestione dei tag

I servizi di gestione dei tag hanno due opzioni per l'integrazione con AMP Analytics:

  • Approccio endpoint: agire da endpoint aggiuntivo per amp-analytics e condurre la gestione del marketing nel backend.
  • Approccio di configurazione: condurre la gestione dei tag tramite un file di configurazione JSON generato dinamicamente, univoco per ciascun editore.

L'approccio endpoint è uguale all'approccio standard descritto nella sezione precedente. L'approccio di configurazione consiste nel creare una configurazione univoca per amp-analytics specifica per ciascun editore, che include tutti i loro pacchetti di strumenti di analisi compatibili. Ciascun editore deve includere la configurazione utilizzando una sintassi simile a questa:

<amp-analytics
config="https://my-awesome-tag-manager.example.com/user-id.json"

> </amp-analytics>
>

Per adottare questo approccio, consultare la documentazione per l'integrazione dei servizi degli editori con AMP Analytics.

Altre risorse