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:
- Medición de campañas de Google Play: Consulta las campañas, los sitios web y las apps que enviaron a los usuarios 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 tu app.
- Medición de referencias: Consulta qué fuente de tráfico de referencia (como sitios web y otras apps) inició tu 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 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:
- 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.
- 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. - 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ásBroadcastReceivers
de diferentes SDK, deberás crear tu propia claseBroadcastReceiver
, que recibirá todas las emisiones y llamará alBroadcastReceivers
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.