Medición de campañas: SDK para iOS

En este documento, se proporciona una descripción general de cómo medir campañas y fuentes de tráfico con la versión 3 del SDK de Google Analytics para iOS.

Descripción general

La medición de campañas en Google Analytics permite atribuir las campañas y las fuentes de tráfico a la actividad del usuario en tu aplicación. Las siguientes opciones están disponibles para la atribución de campañas y fuentes de tráfico en el SDK de Google Analytics para iOS:

Medición de campañas de instalaciones en iOS: Descubre qué campañas de otras apps dirigen a los usuarios a iTunes con el objetivo de descargar tu app para iOS.
Atribución de campaña general y fuente de tráfico: Consulta qué campañas o URLs de referencia lanzan 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.

Parámetros de 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.

La siguiente tabla contiene los parámetros de campaña disponibles que se pueden utilizar 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 del etiquetado automático de Google Ads; se usa para medir los anuncios. Este valor se genera de forma dinámica y nunca se debe modificar.

Atribución general de campaña y fuente de tráfico

Después de que se instala una app, puede iniciarse mediante referencias de campañas publicitarias, sitios web y otras apps. En esta situación, la referencia de fuentes de tráfico o campañas de marketing se puede atribuir a la actividad del usuario en sesiones posteriores si se configuran directamente los campos de la campaña en una herramienta de seguimiento.

La forma más sencilla de enviar datos de campaña es utilizar [GAIDictionaryBuilder setCampaignParametersFromUrl:urlString], donde urlString es una cadena que representa una URL que puede contener parámetros de campaña de Google Analytics. Ten en cuenta que, en los siguientes ejemplos, los datos de la campaña no se configuran directamente en la herramienta de seguimiento, ya que solo se deben enviar una vez:

/*
 * MyAppDelegate.m
 *
 * An example of how to implement campaign and referral attribution.
 * If no Google Analytics campaign parameters are set in the referring URL,
 * use the hostname as a referrer instead.
 */

// For iOS 9.0 and later
- (BOOL)application:(UIApplication *)app openURL:(nonnull NSURL *)url
            options:(nonnull NSDictionary<NSString *,id> *)options {

// For iOS versions prior to 9.0
//- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url
//  sourceApplication:(NSString *)sourceApplication annotation:(id)annotation {

  NSString *urlString = [url absoluteString];

  id<GAITracker> tracker = [[GAI sharedInstance] trackerWithName:@"tracker"
                                                      trackingId:@"UA-XXXX-Y"];

  // setCampaignParametersFromUrl: parses Google Analytics campaign ("UTM")
  // parameters from a string url into a Map that can be set on a Tracker.
  GAIDictionaryBuilder *hitParams = [[GAIDictionaryBuilder alloc] init];

  // Set campaign data on the map, not the tracker directly because it only
  // needs to be sent once.
  [hitParams setCampaignParametersFromUrl:urlString];

  // Campaign source is the only required campaign field. If previous call
  // did not set a campaign source, use the hostname as a referrer instead.
  if(![hitParams get:kGAICampaignSource] && [url host].length !=0) {
    // Set campaign data on the map, not the tracker.
    [hitParams set:@"referrer" forKey:kGAICampaignMedium];
    [hitParams set:[url host] forKey:kGAICampaignSource];
  }

  NSDictionary *hitParamsDict = [hitParams build];

  // A screen name is required for a screen view.
  [tracker set:kGAIScreenName value:@"screen name"];

  // Previous V3 SDK versions.
  // [tracker send:[[[GAIDictionaryBuilder createAppView] setAll:hitParamsDict] build]];

  // SDK Version 3.08 and up.
  [tracker send:[[[GAIDictionaryBuilder createScreenView] setAll:hitParamsDict] build]];

Como alternativa, si tienes información de la campaña en un formato que no es el de los parámetros de la campaña de Google Analytics, puedes establecerla en un NSDictionary y enviarla de forma manual:

// Assumes at least one tracker has already been initialized.
id<GAITracker> tracker = [[GAI sharedInstance] defaultTracker];

// Note that it's not necessary to set kGAICampaignKeyword for this email campaign.
NSDictionary *campaignData = [NSDictionary dictionaryWithObjectsAndKeys:
    @"email", kGAICampaignSource,
    @"email_marketing", kGAICampaignMedium,
    @"summer_campaign", kGAICampaignName,
    @"email_variation1", kGAICampaignContent, nil];

// A screen name is required for a screen view.
[tracker set:kGAIScreenName value:@"screen name"];

// Note that the campaign data is set on the Dictionary, not the tracker.
// Previous V3 SDK versions.
// [tracker send:[[[GAIDictionaryBuilder createAppView] setAll:campaignData] build]];

// SDK Version 3.08 and up.
[tracker send:[[[GAIDictionaryBuilder createScreenView] setAll:campaignData] build]];

Medición de campañas de instalación de iOS

Google Analytics ofrece compatibilidad lista para usar con la medición de campañas de instalaciones de iOS para redes populares y brinda la capacidad de generar tus propias URLs personalizadas para cualquier red adicional.

Para habilitar la medición de campañas de instalaciones de iOS, usa el Creador de URLs de seguimiento de campañas de iOS que se encuentra a continuación para generar URLs de destino para tus anuncios que dirigen a los usuarios a la App Store. Para que funcione el seguimiento de campañas de iOS, debes haber implementado Google Analytics en tu app para iOS y habilitar la recopilación de IDFA, así como hacer el seguimiento de una o más visitas a una pantalla o eventos en la app. También deberás agregar un framework adicional a tu app si deseas usar la medición automática de campañas de instalación de iAd.

Diagnóstico de autoservicio para el seguimiento de conversiones de iOS

Si no ves conversiones para tus campañas de iOS, sigue estos pasos para solucionar el problema:

Confirma que esté habilitado el seguimiento de campañas para iOS
Confirma las coincidencias del ID de aplicación
Confirma que el SDK de Google Analytics envíe el IDFA
Consulta el informe de datos demográficos para confirmar que se está enviando el IDFA.
Asegúrese de que las URLs de seguimiento de las campañas para iOS sean correctas

Paso 1: Confirma que esté habilitado el seguimiento de campañas para iOS

Sigue estos pasos para confirmar que el seguimiento de campañas para iOS esté habilitado para la propiedad de destino:

Haga clic en la pestaña Administrador.
Selecciona la propiedad y haz clic en Configuración de la propiedad.
Asegúrate de que la opción Seguimiento de campañas de iOS esté ACTIVADA.

Nota: Si el seguimiento de campañas de iOS no está activado, Google Analytics no atribuirá datos de campañas de iOS a los datos de app.

Paso 2: Confirma que el ID de aplicación coincida

Para atribuir correctamente una campaña con datos de aplicación, la URL de seguimiento de la campaña para iOS y la implementación de seguimiento de tu app deben usar el mismo ID de app. Para determinar el ID de la app de una app de la que estás haciendo un seguimiento actualmente, crea un informe personalizado en la interfaz web de Google Analytics con ID de la app como dimensión y Sesiones como métrica.

Cuando crees una URL de seguimiento de la campaña para iOS de clics, usa el ID de app que aparece en el informe personalizado.

crear informe personalizado

Paso 3: Confirma que el SDK de Google Analytics envíe el IDFA

Google Analytics usa el Identificador del anunciante (IDFA) como una de las claves para unir los clics desde dispositivos móviles con los hits de Google Analytics. Asegúrate de que ocurra lo siguiente:

Tu app usa la versión 3.10 o posterior del SDK de Google Analytics para iOS.
Si usas la descarga del SDK independiente, haz lo siguiente:
- Como parte de la versión de Google Analytics para iOS, tu app está vinculada con libAdIdAccess.a.
- Tu app está vinculada con AdSupport.framework.
Si usas CocoaPods para instalar y administrar dependencias, agrega el Cocoapod GoogleIDFASupport al Podfile:
```
pod 'GoogleIDFASupport'
```
Habilitaste la recopilación de IDFA en cada rastreador:
```
tracker.allowIDFACollection = YES;
```
Si es posible, usa una aplicación de proxy de depuración para ver las solicitudes HTTP y confirmar que se incluye el IDFA.

Paso 4: Revisa el informe de datos demográficos para confirmar que se envía el IDFA

Google Analytics usa el IDFA para generar los informes demográficos. En Google Analytics, haz clic en la pestaña Informes y, luego, en Público > Datos demográficos > Descripción general para verificar si ves datos demográficos. Si lo hace, el IDFA se envía correctamente.

informe personalizado

Paso 5: Asegúrate de que las URLs de seguimiento de las campañas para iOS sean correctas

Usa el Creador de URLs de seguimiento para campañas de iOS a fin de verificar que las URLs de seguimiento de la campaña para iOS sean correctas.

Cuando selecciones la opción Personalizado para la red de publicidad, asegúrate de consultar también con esa red para confirmar que sea compatible con el seguimiento de ID de dispositivos individuales mediante URL de redireccionamiento. De lo contrario, no verás ningún dato en los informes de Google Analytics.

Creador de URLs de seguimiento de campañas para iOS

Usa la siguiente herramienta para generar URLs que te permitan medir la fuente de las instalaciones de aplicaciones para iOS.

Importante: Las URLs de seguimiento de Google AdMob requieren un parámetro &hash=md5. La herramienta Creador de URLs para iOS agrega este parámetro automáticamente. Si creas tus URLs de forma manual, debes agregar este parámetro para que el seguimiento de instalaciones de AdMob para iOS funcione correctamente. Si eliges redes de publicidad distintas de AdMob, el parámetro &hash=md5 no es obligatorio.