Medición de la campaña: SDK de Android v2 (heredado)

En este documento, se proporciona una descripción general de cómo medir campañas y fuentes de tráfico con el SDK de Google Analytics para Android v2.

Descripción general

Medir las campañas en Google Analytics puede ayudarte a mejorar el valor de tus canales de marketing, ya que habilita la atribución de las campañas y las fuentes de tráfico a la actividad del usuario dentro de tu aplicación.

Hay varios tipos de medición de campañas disponibles en el SDK de Google Analytics para Android:

En las siguientes secciones, se describirá cuándo y cómo implementar cada tipo de medición de campaña en tu app.

Medición de campañas de Google Play

La medición de campañas de Google Play te permite ver qué campañas y fuentes de tráfico envían a los usuarios a descargar tu app desde Google Play Store. Recomendamos que todos los desarrolladores implementen la medición de campañas de Google Play Store.

Cómo funciona la medición de campañas de Google Play

La Medición de campañas de Google Play Store se basa en el uso de Parámetros de la campaña para pasar información sobre la fuente del tráfico y la campaña a tu app en el momento en que se descarga desde Google Play Store.

La siguiente es una descripción de extremo a extremo del funcionamiento de la medición de campañas de Google Play:

  1. Un usuario hace clic en un vínculo, desde un anuncio, un sitio web o una app, que lo lleva a la página de Google Play Store de tu app. El vínculo se etiqueta con Parámetros de campaña.
  2. Después de que el usuario descargue e instale tu app, Google Play Store transmitirá un intent INSTALL_REFERRER en el dispositivo que incluya esos mismos parámetros de campaña.
  3. La app responderá a ese intent y usará el objeto BroadcastReceiver que se proporciona a continuación para leer los parámetros de la campaña y usarlos para actualizar la información de la campaña en Google Analytics.

Implementación de la medición de campañas de Google Play

Para implementar la medición de campañas de Google Play Store, haz lo siguiente:

1. Agrega un nuevo BroadcastReceiver a tu archivo AndroidManifest.xml

El siguiente elemento BroadcastReceiver permite que tu app responda al intent INSTALL_REFERRER transmitido por Google Play Store cuando se instala tu app. Agrégala a tu archivo AndroidManifest.xml de la siguiente manera:

<!-- 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. Agregue parámetros de campaña a sus vínculos de Google Play Store

Los parámetros de la campaña se usan para pasar información sobre la campaña o la fuente de tráfico que dirigió al usuario a la página de Google Play Store de tu app en la implementación de Google Analytics de tu app.

Para obtener información sobre cómo crear una string de parámetro de campaña, usa el Creador de URL de Google Play o consulta la sección de referencia Parámetros de campaña.

Una vez que hayas creado la string de parámetro de tu campaña, agrégala a las URL de Google Play Store como el valor del parámetro referrer, como se muestra en este ejemplo:

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

Google Play Store solo transmitirá el valor del parámetro referrer a la implementación de Google Analytics de tu app, por lo que es importante que se asegure de que esté presente en tus vínculos de Google Play Store.

Medición de las campañas generales

La medición general de la campaña se puede usar para asociar una campaña o una fuente de tráfico con un usuario una vez que ya instaló tu app.

Por ejemplo, si estuvieras publicando una campaña pagada para llegar a los usuarios existentes que ya instalaron tu app, podrías usar la medición general de la campaña a fin de medir qué lanzamientos de apps fueron el resultado de esa campaña.

Cómo implementar la medición general de la campaña

Para establecer los valores de una campaña general, llama a setCampaign() y pasa una string de parámetro de campaña como argumento.

Una implementación típica puede llamar a setCampaign() cuando se inicie la app y verificar el intent que la inició para ver si hay parámetros válidos de la campaña presentes:

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.
  }
}

Medición de referencias

La medición de referencias es similar a otros tipos de medición de campañas, ya que te permite medir una fuente de referencia que inició tu app en el dispositivo de un usuario. Sin embargo, la medición de referencia usa una string simple como "google.com" o "myOtherApp" en lugar de una string de parámetros de campaña.

Cuando estableces una fuente de referencia, como &google;com, la dimensión fuente se establece en &google;com, mientras que la dimensión media se establece de forma implícita en &referrer;

Al igual que con la medición de campañas, configurar una fuente de referencia hará que, de forma predeterminada, la próxima llamada de envío inicie una sesión nueva.

En el siguiente fragmento de código, suponemos que etiquetaste cualquier vínculo que abriría tu app con los parámetros de la campaña de Google Analytics o con un parámetro referrer simple que describa la fuente de referencia. Si el parámetro referrer está presente en ausencia de otros parámetros de la campaña, la información de la campaña del usuario se actualiza con una nueva fuente de referencia:

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.
  }
}

Problemas conocidos

  • El javadoc de CampaignTrackingReceiver usa una ruta de clase incorrecta en su ejemplo de uso. Consulta Cómo implementar la medición de campañas de Google Play para ver el uso correcto.
  • Solo se puede especificar una clase BroadcastReceiver por app. Si necesitas incorporar dos o más BroadcastReceivers de diferentes SDK, deberás crear tu propia clase BroadcastReceiver, que recibirá todas las emisiones y llamará al BroadcastReceivers adecuado para cada tipo de transmisión.
  • Actualmente, la Medición de campañas de Google Play no admite instalaciones que se inician en la Web desde Play Store.

Parámetros de campaña

Los parámetros de la campaña se usan para pasar información sobre las fuentes de tráfico y las campañas que atraen usuarios a tu app.

  • En la medición general de la campaña, se pasa una string de parámetro de campaña sin codificación como un argumento a setCampaign().
  • En Medición de campaña de Google Play, se agrega un parámetro referrer con una string de parámetro de campaña codificada como su valor a cualquier URL que dirija a la página de Play Store de tu app.

El siguiente es un ejemplo de una string de campaña válida y sin codificación que podría usarse para la medición general de la campaña:

"utm_campaign=my_campaign&utm_source=google&utm_medium=cpc&utm_term=my_keyword&utm_content=ad_variation1"

En la siguiente tabla, se muestra la lista completa de los parámetros de campaña disponibles que se pueden usar en Google Play o en la medición general de la campaña.

Parámetro Descripción Ejemplos
utm_campaign Nombre de la campaña; se usa para el análisis de palabras clave a fin de identificar una promoción de un producto específico o una campaña estratégica utm_campaign=spring_sale
utm_source Fuente de la campaña: Se usa para identificar un motor de búsqueda, un boletín informativo o cualquier otra fuente. utm_source=google
utm_medium Medio de la campaña; se utiliza para identificar un medio, como el correo electrónico o el costo por clic (CPC) utm_medium=cpc
utm_term Término de campaña; se utiliza con la búsqueda pagada para proporcionar las palabras clave de los anuncios utm_term=running+shoes
utm_content Contenido de la campaña: Se usa para pruebas A/B y anuncios orientados por contenido a fin de diferenciar los anuncios o vínculos que dirigen a la misma URL utm_content=logolink
utm_content=textlink
gclid Parámetro de etiquetado automático de Google Ads; se usa para medir Google Ads. Este valor se genera de forma dinámica y nunca debe modificarse.

Creador de URL de Google Play

Usa el Creador de URL de Google Play a fin de generar URL para la medición de campaña de Google Play.