Eventos de la aplicación sin código

Los eventos de la aplicación sin código, que se introdujeron en la versión 4.34, permiten usar el Administrador de eventos para añadir o eliminar eventos de la aplicación sin implementar código ni lanzar una versión nueva de la aplicación.

Android

Requisitos

Debes disponer de una de las siguientes opciones:

Consulta la guía de introducción a los eventos de la aplicación para Android para instalar la versión más reciente del SDK de Facebook para Android o la guía de actualización para actualizar el SDK a la versión más reciente. En caso de que hayas instalado la versión 4.34-4.37, añade el kit de marketing; para ello, abre <your_app> | Gradle Scripts | build.gradle (Module: app) (<tu_aplicación> | Scripts de Gradle | build.gradle [Módulo: aplicación]) y añade lo siguiente a la sección dependencies{}.

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

No olvides volver a crear el proyecto.

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

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

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

Añadir eventos de la aplicación

Accede al Administrador de eventos para añadir, sin necesidad de código, eventos de la aplicación de los que quieras hacer un seguimiento.

En el Administrador de eventos, haz clic en Añadir nuevo origen de datos y selecciona Eventos de la aplicación en el menú desplegable.
Haz clic en Usar la herramienta de configuración de eventos sin código y, después, selecciona la aplicación a la que quieras añadir eventos.
Para elegir la plataforma, haz clic en Iniciar configuración.
Si es la primera vez que realizas el proceso sin código, verás un breve tutorial. Tras el tutorial, abre una nueva sesión de la aplicación en un dispositivo móvil.
Sacude el teléfono hasta que aparezca una versión de la aplicación.
Haz clic en cualquier elemento para añadir un evento de la aplicación. Navega a distintas páginas de la aplicación para seleccionar elementos en la aplicación.
Haz clic en Guardar en el menú emergente o en “Cancelar” para no añadir el evento.
Cuando hayas añadido todos los eventos, haz clic en Revisar y finalizar.
Haz clic en Probar eventos o en “Guardar y salir”.

Nota: Puede que los eventos tarden hasta 30 minutos en aparecen en el Administrador de eventos.

Verificar la integración

Accede al asistente para anuncios sobre aplicaciones.

Selecciona una aplicación y haz clic en Enviar.
Desplázate hacia abajo hasta la sección Herramientas para desarrolladores y haz clic en Probar eventos de la aplicación.
Si la aplicación envía eventos fb_codeless_debug, los eventos de prueba que hayas seleccionado se mostrarán en la tabla.

Nota: Solo funciona para la versión 4.35 y posteriores del SDK de Facebook.

iOS

Requisitos

SDK de Facebook para iOS (versión completa de la 4.34 a la 7.1.1)
SDK de Facebook para iOS (versión básica de la 4.38 a la 7.1.1)
SDK de Facebook para iOS (versión básica de la 4.34-4.37 a la 7.1.1) y el kit de marketing

Limitaciones

Esta función no está disponible para la versión 8.0.0 o posteriores. Más información.

Visita la guía de introducción a los eventos de la aplicación para iOS para instalar la versión más reciente del SDK para iOS o la guía de actualización para actualizar el SDK a la versión más reciente. En caso de que solo hayas instalado la versión 4.34-4.37 del SDK básico, añade lo siguiente al archivo Podfile a fin de añadir el kit de marketing.

pod 'FBSDKMarketingKit'

No te olvides de ejecutar pod update y, a continuación, pod install --repo-update.

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

Para activar el registro de eventos de depuración sin código, abre el archivo .plist de la aplicación como código en Xcode y añade el XML siguiente al diccionario de propiedades:

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

Añadir eventos de la aplicación

App Store Connect para iOS 14

Es posible que los eventos que tu aplicación recopila y envía a Facebook te exijan que reveles estos tipos de datos en el cuestionario de App Store Connect. Eres responsable de garantizar que esta información quede reflejada en la Política de privacidad de la aplicación. Consulta el artículo Detalles sobre la privacidad de Apple App Store para obtener más información sobre los tipos de datos que deberás revelar.

Accede al Administrador de eventos para añadir, sin necesidad de código, eventos de la aplicación de los que quieras hacer un seguimiento.

En el Administrador de eventos, haz clic en Añadir origen de datos y selecciona Eventos de la aplicación en el menú desplegable.
Haz clic en Usar la herramienta de configuración de eventos sin código y, después, selecciona la aplicación a la que quieras añadir eventos.
Para elegir la plataforma, haz clic en Iniciar configuración.
Si es la primera vez que realizas el proceso sin código, verás un breve tutorial. Tras el tutorial, abre una nueva sesión de la aplicación en un dispositivo móvil.
Sacude el teléfono hasta que aparezca una versión de la aplicación.
Haz clic en cualquier elemento para añadir un evento de la aplicación. Navega a distintas páginas de la aplicación para seleccionar elementos en la aplicación.
Haz clic en Guardar en el menú emergente o en “Cancelar” para no añadir el evento.
Cuando hayas añadido todos los eventos, haz clic en Revisar y finalizar.
Haz clic en Probar eventos o en “Guardar y salir”.

Nota: Puede que los eventos tarden hasta 30 minutos en aparecen en el Administrador de eventos.

Verificar la integración

Accede al asistente para anuncios sobre aplicaciones.

Selecciona una aplicación y haz clic en Enviar.
Ve a la parte inferior y elige Evaluador de eventos de la aplicación.
Si la aplicación envía eventos fb_codeless_debug, se mostrarán en la tabla.

Unity

Exigimos la versión 4.34 o posteriores del SDK de Facebook para Unity.

Consulta el documento de introducción al SDK de Facebook para Unity para instalar la versión más reciente del SDK de Facebook para Unity y sigue la configuración específica de la plataforma para iOS en Unity o Android en Unity.

Activar eventos de la aplicación sin código

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

Añadir eventos de la aplicación

En este momento, puedes añadir eventos de la aplicación con el Administrador de eventos:

En Add Data Source, selecciona App Events.
Haz clic en User our codeless event setup tool.
Selecciona la aplicación a la que quieres añadir los eventos.
Haz clic en Start Setup para seleccionar la plataforma. Si es la primera vez que realizas el proceso sin código, verás un breve tutorial.
Tras el tutorial, abre una nueva sesión de la aplicación en un dispositivo móvil.
Sacude el dispositivo móvil hasta que aparezca una versión de la aplicación.
Haz clic en cualquier elemento de la aplicación para añadir un evento de la aplicación. Navega a distintas páginas de la aplicación para seleccionar elementos en la aplicación.
En Unity Editor, haz clic en Save para añadir el evento.
Cuando hayas añadido todos los eventos, haz clic en Review and Finish.
Haz clic en Test Events o Save and Exit.

Puede que los eventos tarden hasta 30 minutos en aparecen en el Administrador de eventos. Repite estos pasos para cada plataforma que admita el juego (como iOS o Android).

Verificar la integración

Accede al asistente para anuncios sobre aplicaciones.

En Select an App, haz clic en Submit.
Elige App Events Tester.
Si la aplicación envía eventos fb_codeless_debug, se mostrarán en la tabla.

Preguntas frecuentes

GENERALES

1. ¿Cómo puedo comprobar si la función sin código se ha integrado correctamente?

Unos minutos después de iniciar la aplicación en el dispositivo de prueba, verás eventos con el nombre fb_codeless_debug en el Administrador de eventos.

2. ¿Cómo se desactiva la función sin código?

Para desactivar la función de registro de eventos de la aplicación sin código, utiliza 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 compilación?

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.

Añade lo siguiente al elemento manifest del archivo AndroidManifest.xml:

<manifest>
  ...
  xmlns:tools="http://schemas.android.com/tools"
  ...
</manifest>

Añade 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, a continuación, pod install --repo-update.