Configuración de la integración de postback de atribución de Google Analytics 4 (GA4)

Seguir
Avatar
Ghani Yusuf
Updated
Documento

Descripción

Singular admite la integración con Google Analytics 4 (GA4) como socio analítico externo.
Esta guía explica cómo configurar la medición de GA4 para su aplicación móvil utilizando Singular y garantizar que los parámetros necesarios se transfieran correctamente.

Singular reenvía automáticamente los datos de atribución de la campaña a GA4, mientras que las credenciales y los identificadores específicos deben configurarse en la interfaz de usuario y el SDK de Singular.

Información: Singular reenvía los datos de atribución a GA4 para su medición y generación de informes. Los análisis de productos, como los embudos y el análisis del comportamiento de los usuarios, deben seguir gestionándose directamente en GA4 o Firebase.

Parámetros enviados desde Singular a GA4

Singular reenvía automáticamente los siguientes parámetros a Google Analytics 4:

  • Nombre de la campaña

  • ID de la campaña

  • Fuente

  • Medio

  • Marca de tiempo

Información: Estos parámetros se rellenan automáticamente en función de los datos de atribución de Singular. No se requiere ninguna configuración adicional del SDK.

Configuración necesaria en la interfaz de usuario de configuración de socios de Singular

Los siguientes valores deben configurarse directamente en el panel de control de Singular para habilitar la medición de GA4.

Screenshot of Singular GA4 partner configuration

1. Secreto de API (api_secret)

El secreto de la API del protocolo de medición de GA4.

Dónde encontrarlo:

GA4 Admin → Data Streams → Select your stream → Measurement Protocol → Create API Secret

Importante: El secreto de API es necesario para que Singular envíe eventos a GA4 a través del protocolo de medición. Sin este valor, los eventos de GA4 no se registrarán.

2. ID de la aplicación Firebase (firebase_app_id)

El ID de la aplicación Firebase asociado a su aplicación móvil.

Dónde encontrarlo:

Firebase Console → Project Settings → General → Your Apps → App ID
Screenshot of Firebase App ID location

Nota: Asegúrate de que el firebase_app_id configurado en Singular coincida exactamente con la aplicación Firebase utilizada en tu compilación de producción. Una discrepancia impedirá que GA4 asocie eventos con tu aplicación.

Configuración necesaria en el SDK de Singular

3. ID de instancia de la aplicación (app_instance_id)

El app_instance_id es un identificador único para una instalación específica de su aplicación Firebase.

Requisitos:

  • Recupera el valor del SDK de Firebase

  • Páselo al SDK de Singular utilizando GLOBAL_PROPERTIES, tal y como se indica en esta guía

  • Utilice el nombre exacto de la propiedad: app_instance_id

Nota: El app_instance_id debe establecerse antes de inicializar el SDK de Singular. Establecer este valor después de la inicialización puede provocar que los eventos GA4 se pierdan o se atribuyan incorrectamente.

Ejemplo de implementación del SDK (Android – Kotlin)

Utilice propiedades globales para realizar un seguimiento de los identificadores específicos de la aplicación y del usuario a lo largo del ciclo de vida de la aplicación.

// Initialize the Singular SDK with app-level global properties val config = SingularConfig("SDK_KEY", "SDK_SECRET") .withGlobalProperty("app_instance_id", firebaseAppInstanceId, true) Singular.init(applicationContext, config)

// Set a third-party identifier on user login
fun onUserLogin(thirdPartyUserId: String) {
val success = Singular.setGlobalProperty(
"third_party_identifier",
thirdPartyUserId,
true
)
if (success) {
Log.d("Singular", "Third-party identifier set successfully")
}
}

// Clear the third-party identifier on user logout
fun onUserLogout() {
Singular.unsetGlobalProperty("third_party_identifier")
Log.d("Singular", "Third-party identifier cleared")
}

Consejo: Utilice setGlobalProperty para los identificadores que deben persistir entre sesiones. Llame siempre a unsetGlobalProperty cuando el identificador ya no sea válido, como por ejemplo al cerrar la sesión del usuario.

Validación y resolución de problemas

Una vez completada la configuración, valide su integración:

  1. Confirme que api_secret y firebase_app_id se han guardado correctamente en la interfaz de usuario de Singular.

  2. Compruebe que app_instance_id está configurado antes de la inicialización del SDK.

  3. Utilice GA4 DebugView o los informes en tiempo real para confirmar que se reciben los eventos.

  4. Revise los registros de la aplicación en busca de errores de inicialización del SDK de Singular.

Información: GA4 puede tardar varios minutos en mostrar los nuevos eventos. Utilice DebugView para una validación casi en tiempo real durante las pruebas.

Comentarios

Inicie sesión para dejar un comentario.