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
La medición de campañas en Google Analytics puede ayudarte a mejorar el valor de tus canales de distribución, ya que habilita la atribución de campañas y fuentes de tráfico a la actividad del usuario en tu aplicación.
Hay varios tipos de medición de campañas disponibles en el SDK de Google Analytics para Android:
- Medición de campañas de Google Play: Puedes ver qué campañas, sitios web y apps refirieron a un usuario a la página de Google Play Store de tu app para descargarla.
- Medición de campañas generales: Consulta qué campañas o fuentes de tráfico lanzaron la app que se instaló.
- Medición de referencias: Puedes ver qué fuente de tráfico de referencia, como sitios web o alguna otra app, inició la app después de instalarla.
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 en Google Play Store.
Cómo funciona la medición de campañas de Google Play
Las mediciones de campañas de Google Play Store se basan en el uso de parámetros de campaña para pasar información de las campañas y las fuentes de tráfico a tu app en el momento en que se descarga de Google Play Store.
A continuación, se presenta una descripción completa del funcionamiento de la Medición de campañas de Google Play:
- Un usuario hace clic en un vínculo, desde un anuncio, un sitio web o una app, que lo dirige a la página de Google Play Store de tu app. El vínculo está etiquetado con Parámetros de la campaña.
- 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. - Luego, la app responderá a ese intent usando el objeto
BroadcastReceiver
que se proporciona a continuación, leyendo los parámetros de la campaña y usándolos para actualizar la información de la campaña de Google Analytics.
al implementar la medición de campañas en Google Play
Para implementar la medición de campañas en Google Play Store, sigue estos pasos:
1. Agrega un BroadcastReceiver nuevo al archivo AndroidManifest.xml
El siguiente BroadcastReceiver
permite que tu app responda al intent INSTALL_REFERRER
que transmite Google Play Store cuando se instala. 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. Agrega parámetros de campaña a tus vinculaciones de Google Play Store
Los parámetros de campaña se usan para pasar información sobre la campaña o la fuente de tráfico que refirió a un usuario a la página de Google Play Store de tu app a la implementación de Google Analytics de tu app.
Para obtener información sobre cómo crear una cadena de parámetro de campaña, usa el Creador de URLs de Google Play o consulta la sección de referencia Parámetros de la campaña.
Una vez que hayas creado la cadena de parámetro de tu campaña, agrégala a las URLs de
Google Play Store como el valor del parámetro referrer
, como 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 pasará el valor del parámetro referrer
a la implementación de Google Analytics de tu app, por lo que es importante
asegurarte de que esté presente en los vínculos de Google Play Store.
Medición de campañas generales
La medición general de campañas se puede usar para asociar una campaña o una fuente de tráfico con un usuario después de que ya haya instalado la app.
Por ejemplo, si publicas una campaña pagada para llegar a usuarios existentes que ya instalaron tu app, puedes usar la medición general de campañas para medir qué lanzamientos de apps fueron el resultado de esa campaña.
Implementa la medición general de campañas
Si deseas establecer los valores de una campaña general, llama a setCampaign()
y pasa una cadena de parámetro de campaña como argumento.
Una implementación típica podría llamar a setCampaign()
cuando se inicia la app y verificar el intent que la inició para ver si hay parámetros de campaña válidos 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 las referencias usa una cadena sencilla como "google.com" o "myOtherApp", en lugar de una cadena de parámetros de campaña.
Cuando configuras una fuente de referencia, como "google.com", la dimensión de la fuente se establece en "google.com", mientras que la dimensión del medio se establece implícitamente como "URL de referencia".
Al igual que con la medición de campañas, establecer una fuente de referencia hará que, de forma predeterminada, la siguiente llamada de envío inicie una nueva sesión.
En el siguiente fragmento de código, se da por sentado que etiquetaste los vínculos
que abrirían tu app con parámetros de campaña de Google Analytics
o con un parámetro referrer
simple que describe la fuente
de referencia. Si el parámetro referrer
está presente sin otros parámetros de campaña, la información de la campaña del usuario se actualiza con la 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 para
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 conocer el uso correcto. - Solo se puede especificar una clase
BroadcastReceiver
por app. Si necesitas incorporar dos o másBroadcastReceivers
de diferentes SDK, deberás crear tu propia claseBroadcastReceiver
que reciba todas las transmisiones y llame alBroadcastReceivers
adecuado para cada tipo de emisión. - Actualmente, la medición de campañas de Google Play no admite instalaciones de la Web a dispositivos iniciadas desde Play Store en la Web.
Parámetros de la campaña
Los parámetros de campaña se usan para pasar información sobre las fuentes de tráfico y las campañas que llevan usuarios a tu app.
- En general, en la medición de una campaña, se pasa una string de parámetro de campaña sin codificación como argumento a
setCampaign()
. - En las mediciones de campaña de Google Play, se agrega un parámetro
referrer
con una cadena de parámetro de campaña codificada como valor a cualquier URL que dirija a la página de Play Store de tu app.
El siguiente es un ejemplo de una cadena de campaña válida y sin codificación que podría usarse para la medición general de una 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 una lista completa de los parámetros de campaña disponibles que se pueden usar en Google Play o en la medición general de campañas.
Parámetro | Descripción | Ejemplos |
---|---|---|
utm_campaign |
Nombre de la campaña; se usa para el análisis de palabras clave para identificar la 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 usa para identificar un medio, como el correo electrónico o el costo por clic (CPC) | utm_medium=cpc |
utm_term |
Término de la campaña; se utiliza con la búsqueda pagada para proporcionar las palabras clave para los anuncios | utm_term=running+shoes |
utm_content |
Contenido de la campaña; se usa para pruebas A/B y anuncios segmentados por contenido para diferenciar 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 se debe modificar. |
Creador de URLs de Google Play
Usa el Creador de URLs de Google Play para generar URLs para la medición de campañas de Google Play.