Integraciones de eventos

El objetivo de este documento es proporcionarte detalles sobre cómo activar datos de eventos de mParticle para AppsFlyer.

1. los clientes de mParticle deben integrar el kit de AppsFlyer en su aplicación. El SDK de mParticle inicializará el SDK de AppsFlyer y también reenviará todos los eventos del ciclo de vida necesarios al SDK de AppsFlyer.

2. Consulta los repositorios de GitHub de los SDK de iOS y Android para obtener información detallada sobre cómo configurar el kit de AppsFlyer con el SDK de mParticle en tu app.

Configura la integración de eventos de AppsFlyer

1. En el Dashboard de mParticle (https://app.mparticle.com), selecciona tu App (también llamada Workspace)

2. Haz clic en Directory en la navegación izquierda

3. Haz clic en el mosaico de AppsFlyer para ver los detalles de la integración, que incluyen información como Categorías, plataformas disponibles, versiones mínimas del SDK de mParticle (si las hay), tipos de datos, ID de usuario, ID de dispositivo, eventos disponibles y configuraciones disponibles.

4. Haz clic en Add AppsFlyer to Setup.

Se abre la ventana Add to Setup:

5. Selecciona el tipo de integración de eventos de salida y haz clic en Add to Setup para abrir la pantalla de configuración de eventos, donde puedes continuar con el proceso de configuración.

6. Introduce los ajustes de configuración de AppsFlyer y haz clic en Save:

• Nombre de la configuración
• Usa la misma configuración para desarrollo y producción
• Dev Key
• La configuración que acabas de crear se muestra en el grupo predeterminado de AppsFlyer

El siguiente paso es establecer una conexión entre tus plataformas de entrada y la configuración del evento de salida de AppsFlyer.

7. Haz clic en Connections.

8. Selecciona la entrada (iOS en este ejemplo) y luego haz clic en Connect Output.

9. Selecciona el mosaico de AppsFlyer y luego selecciona la configuración de AppsFlyer creada anteriormente.

10. Introduce los ajustes de conexión de AppsFlyer:
ID de la App de Apple (introduce solo el número y no el prefijo ID. Por ejemplo, si el ID de tu App es id123456789, introduce 123456789)

11. Haz clic en Agregar conexión.

AppsFlyer se muestra ahora como una salida conectada. Es posible que haya más opciones disponibles, como asignaciones personalizadas. Consulta la documentación de mParticle para obtener más información.

Integraciones de feeds

Esta sección te ayuda a entender cómo conectar un feed de datos de AppsFlyer a mParticle.

Puedes encontrar información general sobre la integración de AppsFlyer en https://docs.mparticle.com/integrations/appsflyer/feed/.

1. En el Dashboard de mParticle (https://app.mparticle.com), selecciona tu app (también llamada Workspace)

2. Haz clic en Directory desde la navegación de la izquierda

3. Haz clic en el mosaico de AppsFlyer para mostrar los detalles de la integración, que proporcionan información sobre la integración.

4. Haz clic en Añadir AppsFlyer a Setup.

5. Selecciona el tipo de integración del feed de entrada y haz clic en Agregar a Setup.

Ahora se te dirigirá a la pantalla de Setup, donde podrás continuar con el proceso de configuración.

6. Introduce la configuración de AppsFlyer y haz clic en Create:

• Nombre de la configuración
• Actuar como aplicación

7. Completa la configuración en el Dashboard de AppsFlyer con la información de autenticación proporcionada.

Enlaces profundos diferidos

AppsFlyer te permite acceder a los datos de atribución de los usuarios en tiempo real directamente en el nivel del SDK. Te permite personalizar la página de aterrizaje que ve el usuario la primera vez que abre una aplicación recién instalada. Esto se denomina comúnmente enlaces profundos "diferidos".

Para obtener más información sobre Deferred deep linking, haz clic aquí.

Los datos de conversión de AppsFlyer contienen un parámetro llamado is_First_Launch. El valor de is_First_Launch es "true" solo en los primeros lanzamientos, y "false" en todos los lanzamientos posteriores. Puedes usar este parámetro para determinar en cada lanzamiento si la app debe aplicar deferred deep linking al usuario o no.

af_dp → $deeplink_path

$deeplink_path=product/Banana-Pet-Costume/dd67268672b345e491656c871af8aa29

AttributionListener myListener = new AttributionListener() {
  @Override
  public void onResult(@NonNull AttributionResult attributionResult) {
   if (attributionResult.getServiceProviderId() == MParticle.ServiceProviders.APPSFLYER) {
    JSONObject attributionParams = attributionResult.getParameters();
    if (attributionParams != null && attributionParams.has(AppsFlyerKit.INSTALL_CONVERSION_RESULT)) {
     Log.d("Conversion result", attributionParams.toString());
    } else if (attributionParams != null && attributionParams.has(AppsFlyerKit.APP_OPEN_ATTRIBUTION_RESULT)) {
     Log.d("App open result", attributionParams.toString());
    }
   }
  }

  @Override
  public void onError(@NonNull AttributionError attributionError) {
   Log.d("Attribution Data Error", attributionError.toString());
  }
 };

 MParticleOptions options = MParticleOptions.builder(this)
  .credentials("replaceWithAPIKey", "replace-withAPISecret")
  .attributionListener(myListener)
  .build();

 MParticle.start(options);

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
 MParticleOptions *options = [MParticleOptions optionsWithKey:@"<>" secret:@"<>"];
 options.onAttributionComplete = ^void (MPAttributionResult *_Nullable attributionResult, NSError * _Nullable error) {
  if (error) {
   NSLog(@"La obtención de atribución para kitCode=%@ ha fallado con el error=%@", error.userInfo[mParticleKitInstanceKey], error);
   return;
  }
  NSLog(@"La obtención de atribución para kitCode=%@ se ha completado con linkInfo: %@", attributionResult.kitCode, attributionResult.linkInfo);
 }
 [[MParticle sharedInstance] startWithOptions:options];
 return YES;
}

Casos de uso de AppsFlyer/mparticle

Gestión de indicadores de usuario

AppsFlyer también te permite mostrar contenido personalizado o enviar a los usuarios existentes a ubicaciones específicas de la aplicación DESPUÉS del lanzamiento inicial. Cuando se aplica Deep Linking a usuarios existentes dentro de la aplicación, la aplicación se abre desde el método onOpenAttribution, que devuelve los datos de la URL de referencia.

 if let conversionData = params?[MPKitAppsFlyerConversionResultKey] as? [AnyHashable: Any], !alreadyLoggedAppsflyerConversionData {
   logAppsflyerConversionData(conversionData: conversionData)
   alreadyLoggedAppsflyerConversionData = true
   if let onelinkURL = (conversionData["af_dp"] as? String).flatMap(URL.init) {
    UIApplication.appDelegate._linkController.handle(onelinkURL, source: .appsflyer)
   }
  } else if let appOpenData = params?[MPKitAppsFlyerAppOpenResultKey] as? [AnyHashable: Any] {
   logAppsflyerAppOpenData(appOpenData: appOpenData as? [String: Any])
  }

AppsFlyer usa UserDefaults en iOS y Shared Preferences en Android para indicar si el usuario está abriendo la aplicación por primera vez y debe ser redirigido a la página correspondiente, o si la aplicación ya se ha abierto y el usuario ya ha sido dirigido a esa página. Para ello, el valor alreadyLoggedAppsflyerConversionData se lee y se escribe en UserDefaults/ SharedPreferences, para que no se tenga en cuenta el valor af_dp en el primer inicio.

Para obtener más información sobre cómo mostrar contenido personalizado en Deep Linking, haz clic aquí.

Activación de la medición de desinstalación de AppsFlyer en mParticle

La medición de desinstalación de AppsFlyer no se activa automáticamente con el kit SDK de mParticle-AppsFlyer. Para medir las desinstalaciones de la aplicación, llama directamente a los métodos de AppsFlyer siguiendo la documentación sobre la medición de desinstalación de AppsFlyer.

Para implementar la medición de desinstalación en iOS o Android:

• Llama directamente a los métodos de AppsFlyer siguiendo nuestra documentación sobre la medición de desinstalación 

This article was translated automatically and may contain errors. The English version is the most accurate - use the language selector below to switch.