Añadir soporte para enlaces profundos

Losenlaces profundos son URL que dirigen a los usuarios a contenidos específicos dentro de una aplicación. Cuando un usuario toca un enlace profundo en un dispositivo en el que ya está instalada la aplicación, ésta se abre directamente en la página del producto o la experiencia deseada. Los enlaces de seguimiento singulares admiten tanto la vinculación profunda como la vinculación profunda diferida. Para obtener más información, consulte nuestras Preguntas frecuentes sobre enlaces profundos y Preguntas frecuentes sobre enlaces singulares.

Requisitos

1. Para habilitar los enlaces profundos en su aplicación, asegúrese de cumplir los requisitos previos de Singular Links.

2. Implemente el controlador de enlaces singulares

   Singular Link Handler proporciona un mecanismo de devolución de llamada para recuperar los parámetros de enlace profundo (_dl), enlace profundo diferido (_ddl) y passthrough (_p ) de un enlace de seguimiento Singular. Estos parámetros se pasan cuando se abre la aplicación (si ya está instalada) o después de instalarla.

   ---

Actualice el objeto SingularConfig

Añada la llamada de retorno SingularLinkHandler al objeto SingularConfig durante la inicialización del SDK para gestionar los datos entrantes del enlace profundo y del enlace profundo diferido.

private void initSingularSDK() {
    SingularConfig config = new SingularConfig("SDK KEY", "SDK SECRET")
            .withSingularLink(getIntent(), new SingularLinkHandler() {
                @Override
                public void onResolved(SingularLinkParams params) {
                    String deeplink = params.getDeeplink();
                    String passthrough = params.getPassthrough();
                    boolean isDeferred = params.isDeferred();
                    Log.d("SingularLink", "Deeplink: " + (deeplink != null ? deeplink : "null"));
                    Log.d("SingularLink", "Passthrough: " + (passthrough != null ? passthrough : "null"));
                    Log.d("SingularLink", "Is Deferred: " + isDeferred);
                }
            });
    try {
        Singular.init(getApplicationContext(), config);
        Log.d("Singular", "SDK initialized successfully");
    } catch (Exception e) {
        Log.e("Singular", "SDK initialization failed: " + e.getMessage());
    }
}

private fun initSingularSDK() {
    val config = SingularConfig("SDK KEY", "SDK SECRET")
        .withSingularLink(intent) { params ->
            val deeplink = params.deeplink
            val passthrough = params.passthrough
            val isDeferred = params.isDeferred

            Log.d("SingularLink", "Deeplink: ${deeplink ?: "null"}")
            Log.d("SingularLink", "Passthrough: ${passthrough ?: "null"}")
            Log.d("SingularLink", "Is Deferred: $isDeferred")
        }

    try {
        Singular.init(applicationContext, config)
        Log.d("Singular", "SDK initialized successfully")
    } catch (e: Exception) {
        Log.e("Singular", "SDK initialization failed: ${e.message}")
    }
}

Notas sobre el comportamiento de SingularLinkHandler:

• En una instalación nueva, no hay ninguna URL abierta cuando se inicia la aplicación. Por lo tanto, Singular debe completar la atribución al último punto de contacto y determinar si el enlace de seguimiento contenía un valor Deep Link o Deferred Deep Link (DDL ) configurado. Este proceso tiene lugar cuando Singular SDK envía la primera sesión a los servidores de Singular. Si procede, el valor del enlace profundo se devuelve al SingularLinkHandler del SDK y se presenta en el parámetro "deeplink".

  Para probar este escenario

  1. Desinstale la aplicación del dispositivo (si está instalada).
  2. Restablezca su ID de publicidad de Google (GAID).
  3. Haz clic en el enlace de seguimiento Singular desde el dispositivo. Asegúrate de que el enlace de seguimiento Singular está configurado con un valor de enlace profundo.
  4. Instala y abre la aplicación.

  Consejo profesional: Cuando pruebes enlaces profundos o enlaces profundos diferidos en una versión de desarrollo de tu aplicación con un nombre de paquete diferente (por ejemplo, com.example.dev en lugar de com.example.prod), asegúrate de que el enlace de seguimiento esté configurado específicamente para el nombre de paquete de la aplicación de desarrollo, no para el de la aplicación de producción. Además, después de hacer clic en el enlace de prueba en su dispositivo, instale la compilación de desarrollo directamente en el dispositivo de prueba (por ejemplo, a través de Android Studio o un APK) en lugar de descargar la aplicación de producción de la tienda de aplicaciones.

  La atribución debería completarse correctamente y el valor DDL se pasará a la aplicación.

• Si se incluye un parámetro passthrough (_p) en el enlace de seguimiento, el parámetro de transferencia de SingularLinkHandler contendrá los datos correspondientes. Esto es útil para capturar datos adicionales del clic en la aplicación.
• Para capturar todos los parámetros de consulta de la URL del enlace de seguimiento, añada el parámetro _forward_params=2 al enlace de seguimiento. Todos los parámetros de consulta se incluirán en el parámetro deeplink de SingularLinkHandler.
• Si la aplicación ya está instalada, al hacer clic en un enlace Singular se abrirá la aplicación. Para ello, Singular utiliza la tecnología Android App Links. El sistema operativo Android proporcionará una URL abierta que contendrá todo el enlace de seguimiento de Singular. Durante la inicialización del SDK, el SDK de Singular analizará Android Intent, extraerá los valores deeplink y passthrough y los devolverá a través de SingularLinkHandler.