Envía notificaciones de conversión de SKAdNetwork a Google Analytics

En el siguiente artículo, se explican los pasos para enviar notificaciones de conversión de SKAdNetwork a Google Analytics con Measurement Protocol.

Paso 1: Registra las notificaciones de conversión de SKAdNetwork para las versiones de iOS relevantes

Consulta la documentación de Apple para obtener más información. En el caso de los clientes que usan el SDK de Google Analytics para Firebase, el SDK las registra automáticamente en nombre de la aplicación, por lo que puedes omitir este paso.

Paso 2: Asegúrate de recibir y decodificar las notificaciones de conversión de SKAdNetwork

Consulta la documentación de Apple para obtener más información. Si no configuraste un extremo de SKAdNetwork, deberás seguir los pasos de la documentación de Apple para hacerlo.

Nota: Actualmente, Google Analytics no se puede configurar como un extremo.

Si ya configuraste un extremo con un socio de atribución en aplicaciones (AAP) aprobado por Google o una solución interna, puedes ir al paso 3, que te guiará en el proceso de dirigir los resultados a Google Analytics usando el Protocolo de medición.

Paso 3: Dirige los resultados de las notificaciones de conversión a Google Analytics con el Measurement Protocol

Para ello, se debe usar el siguiente esquema (ejemplo de codelab) para enviar el evento personalizado campaign_details a Google Analytics a través del Protocolo de medición.

Implementación del Measurement Protocol de SKAdNetwork de Google Analytics

Todos los parámetros son obligatorios a menos que se especifiquen como opcionales.

Parámetros a nivel de solicitud

Parámetro	Más información
firebase_app_id: {gmp_app_id}	En Google Analytics, navega a Administrador > Flujos de datos > elige tu flujo > ID de aplicación de Firebase. Se debe establecer fuera de la carga útil.
api_secret: {api_secret}	Para crear un secreto nuevo, navega a Administrador > Flujos de datos > elige tu flujo > Measurement protocol > Crear en Google Analytics. Se debe establecer fuera de la carga útil.
timestamp_micros: {timestamp of received SKAN postback}	Opcional. Si se proporciona, debe corresponder a los últimos 2 días calendario más la fecha actual. De lo contrario, se usará la marca de tiempo de la recopilación. La ventana de eventos clave de Google Analytics para los eventos de adquisición es de 30 días. Es importante que envíes tus notificaciones de conversión lo antes posible para obtener informes más precisos.
app_instance_id: {...}	Obligatorio. Genera una cadena única de números aleatorios. Una vez que se utilicen estos datos en el modelado de conversiones, se descartará esta cadena de IDs específica por IDs de instancia de una aplicación real.

Evento de Google Analytics

Evento	Más información
campaign_details	Evento personalizado

Parámetros de Google Analytics (existentes)

Parámetro	Más información
fuente: {source}	Estos son parámetros que se usan en el etiquetado manual. Los informes de Google Analytics se estructuran con la agrupación de canales predeterminada de Google Analytics. Te sugerimos que la utilices como guía para categorizar cada parámetro. Envía estos parámetros para todas las notificaciones de conversión que no sean de Google. Por ejemplo: Notificación de conversión de Facebook: fuente: Facebook medio: cpc|cpm contenido: ad_version_name campaña: Campaña de primavera de Facebook de 22 ID de la campaña, según la notificación de conversión de SKAN Para las notificaciones de conversión de Google, decodificaremos las campañas según la integración de tu propiedad en Google Ads. Por lo tanto, los parámetros anteriores son opcionales para las notificaciones de conversión de Google. Debes asegurarte de que tu propiedad Google Analytics esté vinculada a tus cuentas publicitarias de Google Ads. Nota: Es importante enviar todas tus notificaciones de conversión de SKAdNetwork, no solo las que no son de Google, a Google Analytics.
medio: {medium}
término: {term}  opcional
contenido: {content} opcional
campaign_id: {campaign_id}	Valor de la notificación de conversión de SKAdNetwork
campaña: {campaign} opcional, pero sin ella, se mostrará como (not set)	En el caso de las campañas de Google Ads, decodificaremos el ID y proporcionaremos el nombre de la campaña en función de la vinculación son Google Analytics y Google Ads, y actualizaremos los parámetros fuente y medio. Si tus cuentas no están vinculadas, no decodificaremos los ID de las campañas de Google y usaremos los parámetros fuente y medio especificados. En el caso de las campañas que no son de Google Ads, puedes decodificar y proporcionar los nombres de las campañas. Si no los sabes, puedes copiar tu campaign_id de SKAdNetwork. Nota: Si no se proporciona, aparecerá como (not set).
source_platform: "apple_skan"	Importante: Debes especificar esta cadena exactamente, respetando el uso de mayúsculas y de _.
app_id: {app_id}	Valor de la notificación de conversión de SKAdNetwork Este sería el ID de tu paquete de aplicación.
transaction_id: {transaction_id}	Valor de la notificación de conversión de SKAdNetwork

Parámetros nuevos obligatorios

Nota: Estos parámetros nuevos se pueden configurar en la interfaz de usuario de Google Analytics. Sin embargo, no es obligatorio. Si deseas ver informes de dimensiones personalizadas específicas en función de estos parámetros, deberán registrarse en Google Analytics.

Parámetro	Más información
versión: {version}	Valor de la notificación de conversión de SKAdNetwork
conversion_value: {conversion_value}	Valor de la notificación de conversión de SKAdNetwork
fidelity_type: {fidelity_type}	Valor de la notificación de conversión de SKAdNetwork
attribution_signature: {attribution_signature}	Valor de la notificación de conversión de SKAdNetwork Nota: Esta es una función de seguridad. Las notificaciones de conversión de SKAdNetwork se firman de manera criptográfica.
redownload: {redownload}	Valor de la notificación de conversión de SKAdNetwork
source_app_id: {source_app_id}	Valor de la notificación de conversión de SKAdNetwork Nota: Este es el ID de la aplicación en la que se hizo clic en el anuncio que generó la instalación.
did_win: {did_win}	Valor de la notificación de conversión de SKAdNetwork Nota: Los anunciantes solo reciben notificaciones de conversión ganadoras, mientras que las AdTechs recibirán sus notificaciones de conversión ganadoras y notificaciones de conversión de segundo lugar y de asistencia.
ad_network_id: {ad_network_id} Donde {ad_network_id} representa el valor de la notificación de conversión.	Valor de la notificación de conversión de SKAdNetwork Muestra la red de publicidad que mostró tu anuncio. Esta información también será útil para la dimensión de tráfico "fuente".

 

Paso 4: Verifica que se reciban los hits de Marketing Platform

Los eventos campaign_details no se muestran directamente en Google Analytics. En cambio, las notificaciones de conversión SKAdNetwork se convierten en eventos y se integran en informes de eventos y eventos clave first_open. Para su segmentación, debes agregar la plataforma de origen de la dimensión (plataforma de origen = SKAN).

Si deseas confirmar que se están enviando los hits, te recomendamos que registres los eventos de prueba. Para ello, debes duplicar los eventos campaign_details con un nombre de evento diferente (es decir, campaign_details_skan_test). Luego, puedes verificar que los eventos de prueba aparezcan en el informe en tiempo real de Google Analytics. Si registras el evento y los parámetros de prueba, estos aparecerán en los informes ad hoc y en tiempo real.

Notas:

• Si deseas que todas tus notificaciones de conversión de SKAdNetwork se muestren en los informes, además de enviar cada una como un evento campaign.details, debes registrar el evento y los parámetros duplicados como se mencionó anteriormente. Si decides hacer esto, las notificaciones de conversión de SKAdNetwork deben seguir enviándose con el evento campaign.details. De lo contrario, Google Analytics no las reconocerá ni podrá realizar el modelado de conversiones para mejorar tus informes de first_open de iOS. 
• Las notificaciones de conversión de SKAdNetwork se deben enviar en un plazo de 4 días después de recibirlas para que Google Analytics las aproveche en el modelado de conversiones y la creación de informes.

Obtén más información sobre los pasos generales de verificación.