Prueba la integración

Sugerir ediciones

Antes de comenzar

Para completar con éxito las pruebas de este documento, debes:

Probar la integración del SDK para Android

La prueba consiste en:

  1. Simular un clic en un anuncio y una conversión.
  2. Inspeccionar los datos de conversión de la instalación.

Simulate a conversion

Simula a un usuario haciendo clic en un anuncio e instalando la aplicación.

Paso 1: Simular el clic en el anuncio
Simula un clic en un anuncio mediante un enlace de atribución. Estructura el enlace de atribución de la siguiente manera:

https://app.appsflyer.com/<app_id>?pid=<media_source>
&advertising_id=<registered_device_gaid>

Donde:

  • app_id es tu ID de aplicación de AppsFlyer.
  • pid es la fuente de medios a la que se debe atribuir la instalación.
  • advertising_id es el ID de publicidad de Google (GAID) del dispositivo registrado.

The advertising_id es un parámetro necesario para atribuir mediante la coincidencia de ID. Si se omite, la atribución se producirá probabilísticamente.

Por ejemplo, si el ID de tu aplicación es com.my.app, el enlace de atribución podría tener este aspecto:

https://app.appsflyer.com/com.my.app?pid=devtest&c=test1

o, con GAID:

https://app.appsflyer.com/com.my.app?pid=devtest&c=test1&advertising_id=********-****-****-****-************

👍

Consejo

A menudo, las pruebas que utilizan enlaces de atribución se realizan más de una vez. Es por eso que se recomienda usar uno de los parámetros de atribución para la "versión" de tus pruebas, lo que hace que sea más fácil entender qué enlace desencadenó qué conversión.

En el ejemplo anterior, el valor de c is test1. En pruebas consecutivas, incrementa el valor de c to test2, test3, y así sucesivamente.

Paso 2: Instalar la aplicación
Habilita el modo de depuración e instala la aplicación en un dispositivo de prueba registrado.

Paso 3: Ejecutar la prueba
Continúa para inspeccionar los datos de conversión.

Inspect conversion data

Después de simular una conversión, sigue estos pasos para inspeccionar los datos de conversión de la instalación.

Paso 1: Recuperar el UID de instalación
Una vez instalada la aplicación, busca en los registros de depuración conversions.appsflyer

Paso 2: Inspeccionar los datos de conversión
Ve a la API de prueba de los datos de conversión y rellena los campos obligatorios:

  1. app-id: tu ID de aplicación
  2. device_id: pega el valor de uid del paso 1.
  3. af_request_epoch_ms - Marca de tiempo epoch actual. Puedes conseguirla aquí
  4. The af_sig se crea concatenando los valores de los siguientes campos:
    Concatena el valor de af_request_epoch_ms con device_id and app_id, separados por un carácter invisible \u2063.
    (P. ej.: 1661969117203 1591184059153-1591377216180180185 com.zzkko)

El HMAC se genera utilizando SHA256 y utiliza la clave de desarrollador como clave secreta de la firma. Para recuperar la clave de desarrollador, en el panel de AppsFlyer, ve a Configuración > Configuración de la aplicación.

Aquí encontrarás una calculadora HMAC para ayudarte en el cálculo de este token.

Luego, haz clic en ¡Probar! para ejecutar la prueba.

Resultado esperado
Una respuesta de 200 que contiene los datos de conversión de la instalación (truncados para la legibilidad):

{
  ...
  "campaign": "test1",
  ...
  "media_source": "devtest",
  ...
  "af_status": "Non-organic"
  ...
}

📘

Nota

La instalación puede tardar hasta 30 minutos en aparecer en el panel de control.

Resolución de problemas de la integración del SDK para Android

La instalación siempre se atribuye como orgánica

Situación
Estás realizando pruebas de atribución mediante enlaces de atribución. Implementaste el agente de escucha de conversión del SDK, pero el registro siempre muestra que la instalación es orgánica. Además, no hay ninguna instalación no orgánica registrada en el panel de control.

Causas posibles

  1. Su clave de desarrollador es incorrecta: si especifica una clave de desarrollador incorrecta, no se podrá atribuir la instalación.
  2. El enlace de atribución que usas es incorrecto. Consulta nuestra guía sobre enlaces de atribución.
  3. Asegúrate de que el dispositivo que usas para la prueba esté registrado.
  4. Hay un canal inadecuado definido en el manifiesto.

La instalación no se detecta o no se atribuye

Situación
Estás probando la atribución de instalaciones, pero el registro no muestra ningún dato sobre la instalación, p. ej., tipo, primer inicio, etc.

Causas posibles

  1. Asegúrate de que los métodos start and init se llaman en la clase Application class.
  2. Asegúrate de que el dispositivo que usas para la prueba esté registrado.

Recibo un código de error 404 al registrar una instalación o evento.

Situación
Está probando eventos in-app para ver si están atribuidos a la fuente de medios correcta. Sin embargo, el registro muestra el código de respuesta 404 para la instalación y cuando envía los eventos in-app. Ni la instalación ni los eventos in-app aparecen en el panel de control.

Causas posibles
Un código de respuesta 404 indica que el ID de aplicación es incorrecto. Asegúrate de que el ID de aplicación en el parámetro applicationId del build.gradle sea el mismo que figura en su panel de control.

Los ingresos no se registran correctamente.

Situación
Está probando eventos in-app con ingresos. Los eventos aparecen en el panel de control, pero los ingresos no se registran.

Causas posibles
El parámetro de ingresos no tiene el formato correcto. NO altere el formato del valor de ingresos de ninguna manera. No debe contener comas, signos de moneda ni texto. Por ejemplo, un evento generador de ingresos debería ser similar a 1234.56.

El registro muestra el mensaje "AppsFlyer's SDK cannot send any event without providing DevKey" cuando pruebo eventos in-app

Situación
Está intentando ver eventos in-app en el registro. Cuando activa eventos, el registro solo muestra el mensaje "AppsFlyer's SDK cannot send any event without providing DevKey" (El SDK de AppsFlyer no puede enviar ningún evento sin proporcionar la clave de desarrollador).

Causas posibles
Llamas al método start sin transmitir la clave de desarrollador como parámetro. Transmite la clave de desarrollador al método.

El registro muestra el mensaje "Not sending data yet, waiting for dev key" cuando pruebo eventos in-app

Situación
Está intentando probar eventos in-app en el registro. Cuando activa eventos, el registro solo muestra el mensaje "Not sending data yet, waiting for dev key" (Aún no se envían los datos, en espera de la clave de desarrollador).

Causas posibles
Llamas al método init y transmites la clave de desarrollador como una cadena vacía. Transmite la clave de desarrollador al método.

Recibo un código de respuesta 400 cuando pruebo eventos in-app

Situación
Estás intentando probar eventos in-app. Cuando activas eventos, ves un error 400 en los registros.

Causas posibles
Esto puede indicar un problema con la clave de desarrollador. Verifique que la clave de desarrollador sea la correcta. Además, asegúrese de que la clave de desarrollador contenga solo caracteres alfanuméricos.

El registro muestra el mensaje "WARNING: Google Play Services is missing"

Situación
El registro Logcat muestra el mensaje "WARNING: Google Play Services is missing" (ADVERTENCIA: no se encuentra Google Play Services).

Causas posibles
Faltan las dependencias de Google Play Services en la aplicación. Esto podría impedir que el SDK recopile el GAID, lo que podría causar problemas con la atribución.

Agrega las siguientes dependencias a nivel de aplicación build.gradle file:

implementation 'com.google.android.gms:play-services-base:15.0.1'
implementation 'com.google.android.gms:play-services-ads:15.0.1'

Recibo el código de respuesta 400 cuando registro instalaciones o eventos.

Situación
Estás intentando probar las instalaciones y otros eventos de conversión en el registro. Cuando activas estos eventos, ves la respuesta 403 (prohibido) en los registros.

Causas posibles
This might be because you have the Zero package, which does not include attribution data; only data on clicks and impressions. To start receiving attribution data, learn more about the different AppsFlyer packages, and update as needed. You can also contact our customer engagement team at [email protected] if you have questions about our packages.

Crear una aplicación de depuración de Android

OPCIONAL
Puedes utilizar las variantes de compilación de Android Studio para configurar una aplicación de depuración fácil de usar con fines de prueba.

Todas las pruebas se pueden realizar tanto para aplicaciones de producción como de depuración.

Paso 1: Configurar el tipo de compilación debug de Gradle
En tu archivo build.gradle del nivel de aplicación, configura debug como tipo de compilación y establece applicationIdSuffix al nombre de la aplicación de prueba (en este caso, .debug).

android {
    // ...
    buildTypes {
        // Prevents a signing error when building the production app
        release {
            signingConfig signingConfigs.debug
        } 
        debug {
            applicationIdSuffix ".debug"
        }
    }
}

Paso 2: Agregar una nueva aplicación a AppsFlyer
Usa el nombre de paquete resultante como el ID de aplicación al agregar la aplicación al panel de control de AppsFlyer, o pídele a un miembro del equipo con acceso al panel de control que lo agregue.

Por ejemplo, si tienes una aplicación con el nombre de paquete com.your.app y usas la configuración de Gradle anterior, el nombre de la aplicación de prueba será com.your.app.debug. Incluye este nombre como el ID de aplicación al agregar la aplicación a AppsFlyer.

Actualizado hace 4 meses