Misurazione delle campagne - SDK per Android v2 (legacy)

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:

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:

  1. 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.
  2. 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.
  3. 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 classe BroadcastReceiver 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.