El seguimiento de desinstalación de Android utiliza los servicios de mensajería en la nube de Firebase. Firebase dejará de utilizar la API HTTP heredada el 22 de julio de 2024. Si sigues utilizando la API HTTP heredada, actualízala para utilizar la API HTTP V1 a través de la página de configuración de la aplicación Singular. Más información.
Singular le ofrece la opción de realizar un seguimiento de las desinstalaciones de aplicaciones, como otra forma de medir la calidad del tráfico que recibe a través de sus campañas de marketing. Esta función está disponible en la versión 7.x+ del SDK de Singular para Android y su activación requiere una actualización de la aplicación.
Notas:
- El seguimiento de desinstalaciones de Singular aprovecha los servicios de Google, pero utiliza una metodología diferente a la de Google. Google informa de las desinstalaciones directamente desde el sistema operativo del dispositivo. Como resultado, los números reportados por Google pueden diferir de los reportados por Singular.
- En Singular, las desinstalaciones se registran como eventos y, por lo tanto, no eliminan el vínculo de atribución de la fuente de instalación o reactivación de origen. Esto puede dar lugar a tasas de desinstalación superiores al 100%, ya que un usuario puede desinstalar una aplicación varias veces a lo largo de su vida.
Si el uso compartido restringido a dominios está habilitado para tu organización de Google, aplica el ID de organización singular a Valores permitidos:
- Acceso a las políticas de la organización
- En Google Cloud Console, accede a la página Políticas de la organización.
- Selecciona el recurso de la organización en el que deseas establecer la política.
- Busca y selecciona la restricción de uso compartido restringido de dominio de la lista.
- Haz clic en Administrar política.
Añade el ID de la organización a los valores permitidos
- En Valores de la política, seleccione Personalizado.
- Introduzca el ID del recurso de la organización en el formato:
is:principalSet://iam.googleapis.com/organizations/626787461583
Instrucciones de configuración
- Integrar Android SDK 7.x+: El seguimiento de desinstalación está disponible en Android SDK versión 7.x y superiores. Para obtener instrucciones sobre cómo actualizar su SDK, consulte nuestra guía de integración de Android SDK.
- Modifique AndroidManifest.xml: Consulte los detalles de la guía de seguimiento de desinstalación de Android SDK.
- En la página Singular Apps > App > Advanced Settings > Uninstall Tracking, introduzca el ID del proyecto.
Para crear y configurar su ID de proyecto
- Vaya a la Consola de Firebase Cloud Messenger
- Selecciona o crea un nuevo proyecto
- Navega a Visión General del Proyecto > Configuración del Proyecto, y copia tu ID de Proyecto. Este es el ID de proyecto que tendrás que introducir en tu página de Singular apps después de que el proyecto haya recibido los roles y permisos adecuados en los pasos siguientes.
- Habilite FCM Cloud Messaging para el proyecto navegando a Cloud Messaging y habilitando Firebase Cloud Messaging API (V1).
- Vaya a Cuentas de servicio > Gestionar permisos de cuentas de servicio.
- Asigne el rol y los permisos correctos para el proyecto
- Seleccione Roles en el menú de navegación de la izquierda
- Haga clic en Crear función e introduzca la siguiente información
Título Seguimiento de desinstalaciones singulares
ID: singular_uninstalls
Fase de lanzamiento de la función: Disponibilidad general - Haz clic en Añadir permisos y añade cloudmessaging.messages.create. Puedes encontrar esto rápidamente filtrando en Firebase Cloud Messaging API Admin.
- Haga clic en Crear para terminar de crear el rol
-
Asignar Singular al rol
- Seleccione IAM en el menú de navegación de la izquierda
- En la pestaña Permisos, haga clic en Conceder acceso
- En Add principals > New principals, escriba:
singular-uninstall-tracking@singular-uninstall-tracking.iam.gserviceaccount.com
- En Asignar funciones, seleccione"Seguimiento de desinstalación de Singular" creado en los pasos anteriores.
La configuración final debe coincidir:
- Haga clic en Guardar
Para configurar el seguimiento de la desinstalación en Android:
- Integre Android SDK 7.x+: El seguimiento de desinstalación está disponible en Android SDK versión 7.x y superior. Para obtener instrucciones sobre cómo actualizar su SDK, consulte nuestra guía de integración de Android SDK.
- Modifique AndroidManifest.xml: Consulte los detalles de la guía de seguimiento de desinstalación de Android SDK.
-
Añada su ID de remitente y clave de servidor: Singular requiere un número de proyecto de Google y una clave de servidor para habilitar el seguimiento de desinstalación. Para recuperar estos valores
- En Firebase, seleccione Ir a la consola y seleccione el proyecto.
-
Seleccione el icono de engranaje y vaya a Configuración del proyecto > Mensajería en la nube.
- En su cuenta Singular, vaya a Configuración > Aplicaciones, busque la aplicación para la que desea realizar un seguimiento de las desinstalaciones y seleccione Editar.
-
En Seguimiento de desinstalaciones, añada el Número de proyecto (ID de remitente en Firebase) y la Clave de servidor.
-
Configure FCM en su aplicación de la siguiente manera:
- En la consola Firebase, cree un proyecto Firebase.
- En el panel del proyecto, selecciona Añadir Firebase a tu app Android.
-
Introduce el ID del paquete de la aplicación Android.
- Descarga el archivo de configuración (google-services.json) y cópialo en el módulo app del proyecto Android.
- En el archivo build.gradle del proyecto (><project>/build.gradle>), añade lo siguiente:
buildscript {
dependencies {
// Add this line or latest version
classpath 'com.google.gms:google-services:3.1.0'
}
} - En el archivo build.gradle a nivel de aplicación (><project>/<app-module>/build.gradle>), añade lo siguiente:
// Add to the bottom of the file
apply plugin: 'com.google.gms.google-services' - Sincroniza el proyecto.
- En el código de Android, crea el siguiente servicio:
El método onTokenRefresh obtiene un token FCM que se necesita para enviar notificaciones.public class FCMService extends FirebaseInstanceIdService {
@Override
public void onTokenRefresh() {
super.onTokenRefresh();
//now we will have the token
String token = FirebaseInstanceId.getInstance().getToken();
}
} - Añade el servicio al archivo de manifiesto de Android:
<service android:name=".FCMService">
<intent-filter>
<action android:name="com.google.firebase.INSTANCE_ID_EVENT"/
</intent-filter>
</service>
Singular hará ahora un seguimiento de las desinstalaciones de los usuarios que tengan la versión actualizada de tu aplicación.
Probar la notificación
Puede probar la notificación utilizando la consola proporcionando un token FCM: