Introducción a los eventos de la aplicación (iOS)

En esta guía se muestra cómo añadir eventos de la aplicación a una aplicación nueva o existente mediante la integración del SDK de Facebook y el registro de dichos eventos.

Antes de empezar

Necesitarás lo siguiente:

• Una cuenta de desarrollador de Facebook
• Una cuenta publicitaria de Facebook
• Una cuenta de Facebook para empresas (crea una nueva cuenta empresarial si todavía no tienes una)
• Una aplicación de Facebook

Paso 1: Configurar la aplicación de Facebook

Accede al panel de aplicaciones, haz clic en Mis aplicaciones y crea una nueva aplicación si aún no tienes ninguna. Navega a Configuración > Básica para ver la ventana Detalles de la aplicación, en la que encontrarás el identificador de la aplicación, la clave secreta de la aplicación y otra información.

Desplázate hasta la parte inferior de la página y haz clic en Añadir plataforma. Elige iOS, añade los detalles de la aplicación y guarda los cambios.

Con el fin de configurar tu aplicación para la publicidad, añade los siguientes detalles:

• Dominios de la aplicación: proporciona la URL de Apple App Store de tu aplicación.
• URL de la Política de privacidad: proporciona una URL de la Política de privacidad. Es obligatoria para poder publicar tu aplicación.
• URL de las Condiciones del servicio: proporciona una URL de las Condiciones del servicio.
• Plataforma: desplázate al final de la ventana “Configuración” para añadir la plataforma iOS.

Para obtener más información sobre la adición de detalles a la aplicación, como un icono o una categoría, consulta los documentos de desarrollo de aplicaciones.

Paso 2: Vincular la cuenta publicitaria y la cuenta empresarial

Para poner anuncios en circulación y medir las descargas en el Administrador de anuncios, asocia como mínimo una cuenta publicitaria y una cuenta empresarial a la aplicación.

1. En el panel de aplicaciones, haz clic en Configuración > Opciones avanzadas.
2. En el campo Identificadores de cuentas publicitarias autorizadas, añade los identificadores de tus cuentas publicitarias. Puedes obtener los identificadores de las cuentas publicitarias en el Administrador de anuncios.
3. En la ventana Cuentas publicitarias, haz clic en Empezar y sigue las instrucciones para conectar la aplicación a una empresa.

Paso 3: Configurar el entorno de desarrollo

En el procedimiento siguiente se utiliza el administrador de paquetes Swift para configurar el entorno de desarrollo en Xcode.

1. En Xcode, haz clic en File > Add Packages… (Archivo > Añadir paquetes…).
2. En el campo de búsqueda que aparece, escribe la URL del repositorio: https://github.com/facebook/facebook-ios-sdk.
3. En Dependency Rule (Regla de dependencia), selecciona Up to Next Major Version (Hasta la siguiente versión principal) e introduce una versión reciente. La versión más actual se indica en https://github.com/facebook/facebook-ios-sdk/releases/
4. Elige las bibliotecas que pretendes utilizar y los destinos a los que quieres añadir dichas bibliotecas.
5. Haz clic en Add Package (Añadir paquete) para finalizar la configuración.

Paso 4: Registrar y configurar la aplicación para que funcione con Facebook

Añade el identificador de paquete y activa el inicio de sesión único para tu aplicación.

Paso 5: Configurar el proyecto

Paso 6: Conectar el delegado de la aplicación y de la escena

    
// AppDelegate.swift
import UIKit
import FacebookCore

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {    
    func application(
        _ application: UIApplication,
        didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
    ) -> Bool {          
        ApplicationDelegate.shared.application(
            application,
            didFinishLaunchingWithOptions: launchOptions
        )

        return true
    }
          
    func application(
        _ app: UIApplication,
        open url: URL,
        options: [UIApplication.OpenURLOptionsKey : Any] = [:]
    ) -> Bool {
        ApplicationDelegate.shared.application(
            app,
            open: url,
            sourceApplication: options[UIApplication.OpenURLOptionsKey.sourceApplication] as? String,
            annotation: options[UIApplication.OpenURLOptionsKey.annotation]
        )
    }  
}

// SceneDelegate.swift
import FacebookCore
  ...
func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) {
    guard let url = URLContexts.first?.url else {
        return
    }

    ApplicationDelegate.shared.application(
        UIApplication.shared,
        open: url,
        sourceApplication: nil,
        annotation: [UIApplication.OpenURLOptionsKey.annotation]
    )
}

Paso 7: Añadir eventos de la aplicación

Existen tres maneras de realizar un seguimiento de los eventos en la aplicación:

• Eventos registrados automáticamente: las descargas y los inicios de la aplicación, así como las compras realizadas en ella, se registran automáticamente con el SDK de Facebook.
• Herramienta de eventos de la aplicación sin código: usa esta herramienta para añadir eventos estándar sin añadir código a la aplicación.
• Eventos registrados manualmente: añade código a la aplicación para realizar un seguimiento de los eventos estándar y personalizados.

Eventos registrados automáticamente

Obtener el consentimiento del dispositivo

A partir de iOS 14.5, deberás establecer isAdvertiserTrackingEnabled y añadir un registro cada vez que concedas permiso a un dispositivo para compartir datos con Facebook.

Si un dispositivo proporciona consentimiento, establece Settings.shared.isAdvertiserTrackingEnabled = true.

Si un dispositivo no permite el seguimiento, establece Settings.shared.isAdvertiserTrackingEnabled = false.

<key>FacebookAutoLogAppEventsEnabled</key>
<false/>

<key>FacebookAdvertiserIDCollectionEnabled</key>
<false/>

Registrar eventos manualmente

Para registrar un evento personalizado, simplemente pasa el nombre del evento como AppEvents.Name:

AppEvents.shared.logEvent(AppEvents.Name("battledAnOrc"))

Parámetros de eventos

Facebook ha creado un conjunto de parámetros de eventos útiles para incluirlos con los eventos estándar o con tus eventos personalizados. También puedes proporcionar tus propios parámetros.

Estos parámetros predefinidos están pensados como guía para patrones de registro comunes y pueden mostrarse de forma más legible en informes y otras interfaces de usuario. Registra el conjunto de parámetros que te interesa ver desglosados. Las descripciones recomendadas de estos parámetros son solo orientativas; puedes usarlos para lo que consideres conveniente en la aplicación.

Los parámetros se pasan mediante un diccionario en el que la clave incluye el nombre del parámetro como AppEvents.ParameterName y el valor debe ser de tipo String o un número (Int, Double, etc.).

Paso 8: Probar los eventos

Con el asistente para anuncios sobre aplicaciones, puedes probar los eventos de la aplicación en tu aplicación para asegurarte de que esta los envía a Facebook.

1. Abre el asistente para anuncios sobre aplicaciones.
2. En Seleccionar una aplicación, elige la aplicación y haz clic en Enviar.
3. Desplázate hasta la parte inferior y elige Probar evento.
4. Inicia la aplicación y envía un evento, que debería aparecer en la página.

Más información

• Guía de prácticas recomendadas: descubre una gran variedad de aplicaciones de ejemplo y cómo gestiona cada una de ellas los eventos de la aplicación.
• Preguntas frecuentes: consulta nuestras preguntas frecuentes.
• Curso de Meta Blueprint: Configure the SDK and App Events for iOS
• Curso de Meta Blueprint: Usa eventos de la app para la segmentación, optimización y medición

Aplicaciones de ejemplo

Hemos creado algunos ejemplos para distintos tipos de aplicaciones con el fin de que puedas ver fácilmente cómo se pueden usar los eventos de la aplicación. Cada una de las aplicaciones de ejemplo ofrece un desglose por pantallas de los distintos eventos y parámetros que se pueden recopilar. Al final de cada sección, se incluye una tabla con los eventos y parámetros recomendados para cada aplicación. Si es preciso, puedes crear tus propios eventos y parámetros.