Facebook Ads

Con la integración de Facebook Ads, puedes consultar fácilmente las estadísticas de tu app en Meta Analytics. Adapty envía eventos a Meta Ads Manager, lo que te permite crear audiencias similares basadas en suscripciones para obtener mejores resultados. Así puedes ver con precisión cuánto dinero generan tus anuncios a partir de las suscripciones.

La integración entre Adapty y Facebook Ads funciona de la siguiente manera: Adapty envía a Facebook Ads todos los eventos de suscripción que hayas configurado en tu integración. Esta integración es útil para evaluar la efectividad de tus campañas publicitarias.

Configurar la integración

Conectar Adapty con Facebook Ads

Para integrar Facebook Ads y analizar las métricas de tu app, puedes configurar la integración con Meta Analytics. Al enviar eventos al Meta Ads Manager, puedes crear audiencias similares basadas en eventos de suscripción como las renovaciones. Para configurar esta integración, ve a Integrations > Facebook Ads en el Adapty Dashboard y proporciona las credenciales requeridas.

1. Para encontrar el App ID, abre la página de tu app en App Store Connect, ve a la página App Information en la sección General y busca el Apple ID en la parte inferior izquierda de la pantalla.
2. Necesitas una aplicación en la plataforma Meta for Developers. Inicia sesión en tu app y accede a la configuración avanzada. Encontrarás el App ID en la cabecera.

3. Desactiva el seguimiento del lado del cliente en la configuración de tu Meta SDK para evitar el doble conteo de ingresos en Meta Ads Manager. Puedes encontrar este ajuste en tu Meta Developer Console en App Settings > Advanced Settings. Establece Log in-app events automatically en “No”. Esto garantizará que los eventos de ingresos solo se registren a través de la integración de Adapty.

   Para rastrear eventos de instalación y uso, deberás activar el Meta SDK en tu código. Puedes encontrar los detalles de implementación en la documentación del Meta SDK para tu plataforma:

   • iOS SDK
   • Android SDK
   • Unity SDK

También puedes usar esta integración con apps Android. Si configuras la configuración del Android SDK en App Settings, con introducir el Facebook App ID es suficiente.

Configurar eventos y etiquetas

Adapty mapea sus eventos de compra a los eventos estándar de Meta, que Meta puede usar para optimizar campañas: StartTrial, Subscribe y fb_mobile_purchase, el evento de compra de Meta. Subscription started, Subscription renewed, Trial started y Trial converted envían un evento de Meta por cada nombre seleccionado en el campo del evento, y todos los nombres están seleccionados por defecto. Un inicio de prueba, por ejemplo, llega a Meta como tres eventos. Para enviar menos, elimina nombres del campo.

Meta no tiene un evento estándar para el resto de eventos, por lo que Adapty los envía como eventos personalizados con sus nombres de Adapty. Para ajustar el nombre a tu convención, cámbialo en el campo del evento.

Trial still active y Subscription still active son eventos sintéticos: Adapty los envía a Meta mediante un temporizador, y solo si el período de prueba o la suscripción siguen activos cuando el temporizador expira. No llevan ingresos asociados, por lo que Meta no los contabiliza en el valor de compra. Ambos están desactivados por defecto. Para enviarlos, actívalos y configura el retraso.

Conectar tu app con Facebook Ads

Si sigues los pasos anteriores, Facebook recibirá automáticamente los datos de suscripción desde Adapty.

Tras los cambios en el IDFA en iOS 14.5, recomendamos que solicites el facebookAnonymousId del usuario a Facebook. De este modo, si el IDFA del usuario no está disponible, la integración seguirá funcionando. Sigue la guía para establecer atributos de usuario iOS, Android, React Native, Flutter y Unity para configurar este parámetro.

do {
    try await Adapty.setIntegrationIdentifier(
        key: "facebook_anonymous_id", 
        value: AppEvents.shared.anonymousID
    )
} catch {
    // handle the error
}

Adapty.setIntegrationIdentifier(
    "facebook_anonymous_id",
    AppEventsLogger.getAnonymousAppDeviceGUID(context)
) { error ->
    if (error != null) {
        // handle the error
    }
}

try {
  const anonymousId = await AppEventsLogger.getAnonymousID();

  await adapty.setIntegrationIdentifier("facebook_anonymous_id", anonymousId);
} catch (error) {
  // handle `AdaptyError`
}

There is no official SDK for Flutter

anonymousID is not available in the official SDK
https://github.com/facebook/facebook-sdk-for-unity/issues/676

Estructura del evento

Adapty envía eventos a Facebook Ads (Meta) a través de la Graph API. Cada evento tiene la siguiente estructura:

{
  "event": "CUSTOM_APP_EVENTS",
  "app_user_id": "user_12345",
  "advertiser_id": "00000000-0000-0000-0000-000000000000",
  "advertiser_tracking_enabled": 1,
  "application_tracking_enabled": 1,
  "custom_events": "[{\"_eventName\":\"Subscribe\",\"_logTime\":1709294400,\"fb_num_items\":1,\"fb_content_type\":\"in_app\",\"fb_content_id\":\"yearly.premium.6999\",\"fb_currency\":\"USD\",\"fb_order_id\":\"GPA.3383...\",\"fb_transaction_id\":\"GPA.3383...\",\"_valueToSum\":9.99}]",
  "extinfo": "[\"i2\",\"com.example.app\",\"1.0.0\",\"100\",\"17.0.1\",\"iPhone14,3\",\"en_US\",\"GMT+3\",\"\",0,0,0,0,0,0,\"GMT+3\"]",
  "anon_id": "facebook_anon_id_123"
}

Donde:

El parámetro custom_events es un array codificado en JSON con un objeto por cada evento de Meta al que se asigna el evento de Adapty. Solo StartTrial, Subscribe y fb_mobile_purchase incluyen fb_content_id, fb_content_type, fb_num_items y fb_transaction_id. Cada objeto contiene:

Solución de problemas

access_level_updated aparece como fallido en el Event Feed

access_level_updated es un evento exclusivo de webhooks. Adapty nunca lo envía a esta integración. Sin embargo, Adapty registra un resultado para cada integración habilitada, y un evento no compatible se muestra como un error.