Questo documento fornisce una panoramica su come misurare le campagne e le sorgenti di traffico con l'SDK di Google Analytics per Android v2.
Panoramica
La misurazione delle campagne in Google Analytics può aiutarti a migliorare il valore dei tuoi canali di marketing abilitando l'attribuzione delle campagne e delle sorgenti di traffico all'attività degli utenti nella tua applicazione.
Nell'SDK Google Analytics per Android sono disponibili diversi tipi di misurazione delle campagne:
- Misurazione delle campagne Google Play - Scopri quali campagne, siti web e app hanno indirizzato un utente alla pagina del Google Play Store della tua app per scaricarla.
- Misurazione delle campagne generali - Scopri quali campagne o sorgenti di traffico hanno lanciato l'app dopo averla installata.
- Misurazione dei referral : scopri quale sorgente di traffico di riferimento, ad esempio siti web o altre app, ha lanciato la tua app dopo l'installazione.
Le seguenti sezioni descrivono quando e come implementare ogni tipo di misurazione delle campagne nella tua app.
Misurazione delle campagne Google Play
La misurazione delle campagne di Google Play ti consente di sapere quali campagne e sorgenti di traffico spingono gli utenti a scaricare la tua app dal Google Play Store. Consigliamo a tutti gli sviluppatori di implementare la misurazione delle campagne del Google Play Store.
Come funziona la misurazione delle campagne di Google Play
La misurazione delle campagne del Google Play Store si basa sull'uso dei parametri della campagna per trasmettere le informazioni sulle campagne e sulle sorgenti di traffico alla tua app nel momento in cui questa viene scaricata dal Google Play Store.
Di seguito è riportata una descrizione end-to-end del funzionamento della misurazione delle campagne di Google Play:
- Un utente fa clic su un link da un annuncio, un sito web o un'app e lo reindirizza alla pagina del Google Play Store della tua app. Il link è codificato con Parametri campagna.
- Dopo che l'utente ha scaricato e installato la tua app, il Google Play Store trasmetterà un intent
INSTALL_REFERRER
sul dispositivo che include gli stessi parametri della campagna. - La tua app risponderà a questo intento utilizzando l'oggetto
BroadcastReceiver
fornito di seguito, leggendo i parametri della campagna e utilizzandoli per aggiornare le informazioni della campagna di Google Analytics.
L'implementazione della misurazione delle campagne di Google Play
Per implementare la misurazione delle campagne del Google Play Store:
1. Aggiungi un nuovo BroadcastRicevir al tuo file AndroidManifest.xml
Questo BroadcastReceiver
consente alla tua app di rispondere all'intent INSTALL_REFERRER
trasmesso dal Google Play Store quando viene installata l'app. Aggiungila al tuo file AndroidManifest.xml
come segue:
<!-- Used for install referral measurement--> <service android:name="com.google.analytics.tracking.android.CampaignTrackingService"/> <receiver android:name="com.google.analytics.tracking.android.CampaignTrackingReceiver" android:exported="true"> <intent-filter> <action android:name="com.android.vending.INSTALL_REFERRER" /> </intent-filter> </receiver>
2. Aggiungi i parametri delle campagne ai link del Google Play Store
I parametri della campagna vengono utilizzati per trasmettere all'implementazione di Google Analytics le informazioni sulla campagna o sulla sorgente di traffico che ha indirizzato un utente alla pagina del Google Play Store della tua app.
Per informazioni su come creare una stringa di parametri della campagna, utilizza lo Strumento di creazione URL di Google Play o consulta la sezione di riferimento Parametri campagna.
Dopo aver creato la stringa del parametro della campagna, aggiungila agli URL del Google Play Store come valore del parametro referrer
, come in questo
esempio:
https://play.google.com/store/apps/details?id=com.example.app &referrer=utm_source%3Dgoogle %26utm_medium%3Dcpc %26utm_term%3Drunning%252Bshoes %26utm_content%3DdisplayAd1 %26utm_campaign%3Dshoe%252Bcampaign
Il Google Play Store trasmetterà solo il valore del parametro referrer
all'implementazione di Google Analytics dell'app, perciò è importante assicurarsi che sia presente nei link del Google Play Store.
Misurazione di campagne generiche
La misurazione generica delle campagne può essere utilizzata per associare una campagna o una sorgente di traffico a un utente dopo che quest'ultimo ha già installato la tua app.
Ad esempio, se pubblichi una campagna a pagamento per raggiungere gli utenti esistenti che hanno già installato la tua app, puoi utilizzare la misurazione generale delle campagne per misurare quali lanci di app sono stati il risultato della campagna.
Implementazione della misurazione generale delle campagne
Per impostare i valori di una campagna generica, chiama setCampaign()
e trasmetti una stringa di parametro di campagna come argomento.
Un'implementazione tipica potrebbe chiamare setCampaign()
all'avvio dell'app e controllare l'intent che l'ha lanciata per verificare se sono presenti parametri della campagna validi:
public class SampleActivity extends Activity { @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); // Get the intent that started this Activity. Intent intent = this.getIntent(); Uri uri = intent.getData(); // Call setContext() here so that we can access EasyTracker // to update campaign information before calling activityStart(). EasyTracker.getInstance().setContext(this); if (intent.getData() != null) { EasyTracker.getTracker().setCampaign(uri.getPath()); } ... // The rest of your onCreate() code. } @Override public void onStart() { super.onStart(); EasyTracker.getInstance().activityStart(this); ... // The rest of your onStart() code. } @Override public void onStop() { super.onStop(); EasyTracker.getInstance().activityStop(this); ... // The rest of your onStop() code. } }
Misurazione dei referral
La misurazione dei referral è simile ad altri tipi di misurazione delle campagne in quanto consente di misurare una sorgente di riferimento che ha lanciato la tua app sul dispositivo di un utente. Tuttavia, la misurazione dei referral utilizza una stringa semplice come "google.com" o "myOtherApp", anziché una stringa di parametri della campagna.
Quando imposti una sorgente di riferimento, come "google.com", la dimensione sorgente è impostata su "google.com", mentre la dimensione Mezzo è implicitamente impostata su "referrer"
Come per la misurazione delle campagne, l'impostazione di una sorgente di riferimento genera per impostazione predefinita la chiamata di invio successiva per avviare una nuova sessione.
Nel seguente snippet di codice, supponiamo che tu abbia codificato tutti i link che aprono la tua app con i parametri della campagna di Google Analytics o con un semplice parametro referrer
che descrive la sorgente di riferimento. Se il parametro referrer
è presente in assenza di
altri parametri della campagna, le informazioni sulla campagna dell'utente vengono aggiornate con una nuova
origine di riferimento:
public class SampleActivity extends Activity { @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); // Get the intent that started this Activity. Intent intent = this.getIntent(); Uri uri = intent.getData(); // Call setContext() here so that we can access EasyTracker // to update campaign information before activityStart() is called. EasyTracker.getInstance().setContext(this); if (uri != null) { if(uri.getQueryParmeter("utm_source") != null) { // Use campaign parameters if avaialble. EasyTracker.getTracker().setCampaign(uri.getPath()); } else if (uri.getQueryParameter("referrer") != null) { // Otherwise, try to find a referrer parameter. EasyTracker.getTracker().setReferrer(uri.getQueryParameter("referrer")); } } } @Override public void onStart() { super.onStart(); EasyTracker.getInstance().activityStart(this); ... // The rest of your onStart() code. } @Override public void onStop() { super.onStop(); EasyTracker.getInstance().activityStop(this); ... // The rest of your onStop() code. } }
Problemi noti
- Il codice javadoc per
CampaignTrackingReceiver
utilizza un percorso della classe errato nel relativo esempio di utilizzo. Per informazioni sull'utilizzo corretto, consulta Implementazione della misurazione delle campagne di Google Play. - È possibile specificare una sola classe
BroadcastReceiver
per app. Se devi incorporare due o piùBroadcastReceivers
da SDK diversi, dovrai creare la tua classeBroadcastReceiver
che riceverà tutte le trasmissioni e chiamerà l'BroadcastReceivers
appropriato per ogni tipo di trasmissione. - Al momento, la misurazione delle campagne di Google Play non supporta le installazioni da web a dispositivo avviate dal Play Store sul web.
Parametri campagna
I parametri campagna vengono utilizzati per trasmettere informazioni sulle sorgenti di traffico e sulle campagne che indirizzano gli utenti alla tua app.
- Nella misurazione generale delle campagne, una stringa di parametri della campagna non codificata viene passata come argomento a
setCampaign()
. - Nella misurazione delle campagne di Google Play, un parametro
referrer
con una stringa di parametri della campagna codificata come valore viene aggiunto a tutti gli URL che rimandano alla pagina del Play Store della tua app.
Di seguito è riportato un esempio di stringa di campagna valida e non codificata che può essere utilizzata per la misurazione generale della campagna:
"utm_campaign=my_campaign&utm_source=google&utm_medium=cpc&utm_term=my_keyword&utm_content=ad_variation1"
La tabella seguente mostra l'elenco completo dei parametri disponibili per le campagne che possono essere utilizzati in Google Play o per la misurazione generica delle campagne.
Parametro | Descrizione | Esempi |
---|---|---|
utm_campaign |
Nome della campagna; utilizzato per l'analisi delle parole chiave al fine di identificare una specifica promozione di prodotti o una campagna strategica | utm_campaign=spring_sale |
utm_source |
Sorgente della campagna; utilizzata per identificare un motore di ricerca, una newsletter o un'altra sorgente | utm_source=google |
utm_medium |
Mezzo della campagna; utilizzato per identificare un mezzo come email o costo per clic (CPC) | utm_medium=cpc |
utm_term |
Termine della campagna; utilizzato con la ricerca a pagamento per fornire le parole chiave per gli annunci | utm_term=running+shoes |
utm_content |
Contenuti della campagna; utilizzati per i test A/B e gli annunci con targeting basato sui contenuti al fine di differenziare gli annunci o i link che puntano allo stesso URL |
utm_content=logolink
utm_content=textlink
|
gclid |
Parametro di tagging automatico di Google Ads; utilizzato per misurare Google Ads. Questo valore viene generato dinamicamente e non deve mai essere modificato. |
Strumento di creazione URL di Google Play
Utilizza lo Strumento di creazione URL di Google Play per generare URL per la misurazione delle campagne di Google Play.