Eventos de la app sin código

Los eventos de la app sin código, una función introducida en la versión 4.34, permiten usar el administrador de eventos para agregar o eliminar eventos de la app sin implementar código ni lanzar una nueva versión.

Android

Requisitos

Debes contar con alguno de los siguientes:

Consulta la Guía de primeros pasos de los eventos de la app para Android a fin de instalar la versión más reciente del SDK de Facebook para Android, la Guía de actualización para actualizar el SDK a la versión más reciente o, si ya instalaste la versión 4.34 a 4.37, abre <your_app> | Gradle Scripts | build.gradle (Module: app) y agrega lo siguiente a la sección dependencies{} para agregar el kit de marketing.

implementation 'com.facebook.android:facebook-marketing:[4,5)' 

No olvides volver a compilar tu proyecto.

Implementar la función de eventos de la app sin código

Para activar el evento de depuración sin código, agrega las siguientes líneas en AndroidManifest.xml:

<meta-data
    android:name="com.facebook.sdk.CodelessDebugLogEnabled"
    android:value="true" />

Agregar eventos de la app

Ve al administrador de eventos para agregar sin código los eventos de la app que quieras someter a seguimiento.

  1. En el administrador de eventos, haz clic en Agregar nuevo origen de datos y selecciona Eventos de la app en el menú desplegable.
  2. Haz clic en Usar nuestra herramienta de configuración de eventos sin código y selecciona la aplicación a la cual quieres agregar eventos.
  3. Elige una plataforma. Para ello, haz clic en Iniciar configuración.
  4. Si esta es la primera vez que visitas el proceso sin código, encontrarás un tutorial breve. Después del tutorial, abre una nueva sesión de la app en tu dispositivo móvil.
  5. Agita el teléfono hasta que aparezca una versión de la app.
  6. Haz clic en cualquier elemento para agregar un evento de la app. Ve a diferentes páginas de la app para seleccionar elementos.
  7. Haz clic en Guardar en el menú emergente. Si no quieres agregar el evento, haz clic en "Cancelar".
  8. Cuando hayas agregado todos los eventos, haz clic en Revisar y finalizar.
  9. Haz clic en Eventos de prueba o en "Guardar y salir".

Nota: Es posible que los eventos demoren hasta 30 minutos en aparecer en el administrador.

Verificar la integración

Ve al asistente para anuncios sobre apps.

  • Selecciona una app y haz clic en Enviar.
  • Desplázate hasta la sección Herramientas para desarrolladores y haz clic en Probar eventos de la app.
  • Si tu app envía eventos fb_codeless_debug, los eventos de prueba seleccionados aparecerán en la tabla.

Nota: Funciona únicamente con la versión 4.35 del SDK de Facebook y versiones posteriores.

iOS

Requisitos

  • SDK de Facebook para iOS versión 4.34 a 7.1.1
  • SDK principal de Facebook para iOS versión 4.38 a 7.1.1
  • SDK principal de Facebook para iOS versión 4.34-4.37 a 7.1.1 y el kit de marketing

Limitaciones

Consulta la Guía de primeros pasos de los eventos de la app para iOS a fin de instalar la versión más reciente del SDK para iOS, la Guía de actualización para actualizar el SDK a la versión más reciente o, si instalaste únicamente la versión 4.34 a 4.37 del SDK, agrega lo siguiente a tu Podfile para incluir el kit de marketing.

pod 'FBSDKMarketingKit' 

No olvides ejecutar pod update y, después, pod install --repo-update.

Implementar la función de eventos de la app sin código

Activa el registro de eventos de depuración sin código. Para ello, abre el .plist de la app como código en Xcode y agrega el siguiente XML al diccionario de propiedades:

<key>FacebookCodelessDebugLogEnabled</key>
<true/>

Agregar eventos de la app

Conexión de App Store para iOS 14

Es posible que los eventos que tu app recopila y envía a Facebook requieran que divulgues esos tipos de datos en el cuestionario de App Store Connect. Es tu responsabilidad asegurarte de que esto se vea reflejado en la Política de privacidad de tu app. Visita el artículo Detalles de privacidad de la App Store de Apple para obtener información sobre los tipos de datos que tendrás que divulgar.

Ve al administrador de eventos para agregar sin código los eventos de la app que quieras someter a seguimiento.

  1. En el administrador de eventos, haz clic en Agregar origen de datos y selecciona Eventos de la app en el menú desplegable.
  2. Haz clic en Usar nuestra herramienta de configuración de eventos sin código y selecciona la app a la cual quieres agregar eventos.
  3. Elige una plataforma. Para ello, haz clic en Iniciar configuración.
  4. Si esta es la primera vez que visitas el proceso sin código, encontrarás un tutorial breve. Después del tutorial, abre una nueva sesión de la app en tu dispositivo móvil.
  5. Agita el teléfono hasta que aparezca una versión de la app.
  6. Haz clic en cualquier elemento para agregar un evento de la app. Ve a diferentes páginas de la app para seleccionar elementos.
  7. Haz clic en Guardar en el menú emergente. Si no quieres agregar el evento, haz clic en "Cancelar".
  8. Cuando hayas agregado todos los eventos, haz clic en Revisar y finalizar.
  9. Haz clic en Eventos de prueba o en "Guardar y salir".

Nota: Es posible que los eventos demoren hasta 30 minutos en aparecer en el administrador.

Verificar la integración

Ve al asistente para anuncios sobre apps.

  • Selecciona una app y haz clic en Enviar.
  • Ve a la parte inferior y elige Prueba de eventos de la app.
  • Si tu app envía eventos fb_codeless_debug, se enumeran en la tabla.

Unity

Solicitamos el SDK de Facebook para versión 4.34 o posterior.

Consulta la Guía de primeros pasos del SDK de Facebook para Unity a fin de instalar la versión más reciente de este SDK y sigue la configuración específica de la plataforma para Unity iOS o Unity Android.

Activar eventos de la app sin código

Para activar esta opción, en Unity Editor, selecciona Facebook | Edit Settings, y, luego, Auto Logging App Events:

Agregar eventos de la app

Ya puedes agregar eventos de la app con el administrador de eventos:

  1. En Add Data Source, selecciona App Events.

  2. Haz clic en User our codeless event setup tool.

  3. Selecciona la app a la que quieras agregar eventos.

  4. Haz clic en Start Setup para seleccionar tu plataforma. Si esta es la primera vez que visitas el proceso sin código, encontrarás un tutorial breve.

  5. Después del tutorial, abre una nueva sesión de la app en tu dispositivo móvil.

  6. Agita el dispositivo móvil hasta que aparezca una versión de tu app.

  7. Haz clic en algún elemento de la app para agregar un evento. Ve a diferentes páginas de la app para seleccionar elementos.

  8. En Unity Editor, haz clic en Save para agregar el evento.

  9. Después de agregar todos los eventos, haz clic en Review and Finish.

  10. Haz clic en Test Events o Save and Exit.

Es posible que los eventos demoren hasta 30 minutos en aparecer en el administrador de eventos. Repite estos pasos en cada plataforma, como iOS o Android, que tu juego admita.

Verificar la integración

Ve al asistente para anuncios sobre apps.

  • En Select an App, haz clic en Submit.

  • Elige App Events Tester.

  • Si tu app envía eventos fb_codeless_debug, estos aparecen en la tabla.

Preguntas frecuentes

GENERAL

1. ¿Cómo puedo comprobar si la función sin código está correctamente integrada?

Unos minutos después de lanzar tu app en el dispositivo de prueba, verás eventos con el nombre fb_codeless_debug en el administrador de eventos.

2. ¿Cómo desactivo la función de eventos de la app sin código?

Para desactivar los eventos de la app sin código, usa la herramienta de configuración de eventos sin código y elimina todos los eventos.


Android

1. ¿Qué hago si veo el siguiente error de desarrollo?
Android SDK build Error:Execution failed for task ':app:processDebugManifest'.> Manifest merger failed : 
Attribute activity#com.facebook.FacebookActivity@theme value=(@android:style/Theme.Translucent.NoTitleBar) 
from AndroidManifest.xml:69:13-72is also present at [com.facebook.android:facebook-android-sdk:4.16.0] 
AndroidManifest.xml:32:13-63 value=(@style/com_facebook_activity_theme).Suggestion: add
'tools:replace="android:theme"' to <activity> element at AndroidManifest.xml:66:9-70:47 to override.
Agrega lo siguiente al elemento manifest en tu archivo AndroidManifest.xml:
<manifest>
  ...
  xmlns:tools="http://schemas.android.com/tools"
  ...
</manifest>
Y agrega lo siguiente al elemento activity:
<activity>
  ...
  tools:replace="android:theme"
  ...
</activity>

iOS

1. ¿Qué hago si veo la siguiente advertencia?
[!] Unable to find a specification for FBSDKMarketingKit
Ejecuta pod update y, luego, pod install --repo-update.