Primeros pasos con los eventos de la app en iOS

En esta guía, te mostramos cómo agregar eventos a tu app nueva o preexistente, para lo cual debes integrar el SDK de Facebook y, luego, registrar estos eventos.

Antes de empezar

Necesitarás lo siguiente:

• Una cuenta de desarrollador de Facebook
• Una cuenta publicitaria de Facebook
• Un portfolio comercial de Facebook (si no tienes uno, crea uno nuevo)
• Una app de Facebook

Paso 1: Configurar tu app de Facebook

Ve al panel de apps, haz clic en Mis apps y crea una nueva app si todavía no tienes una. Ve a Configuración > Aspectos básicos para visualizar el panel de detalles de la app con tu identificador de la app, tu clave secreta de la app y otra información acerca de tu app.

Desplázate hasta la parte inferior de la página y haz clic en Agregar plataforma. Elige iOS, agrega los detalles de tu app y guarda los cambios.

Configura la app para que admita publicidad incorporando la siguiente información:

• Dominios de la app: proporciona la URL de la App Store de Apple de la app.
• URL de la política de privacidad: proporciona una URL de la Política de privacidad. Obligatorio para que la app sea pública.
• URL de las condiciones del servicio: proporciona una URL de las Condiciones del servicio.
• Plataforma: desplázate hasta la parte inferior del panel de configuración para agregar la plataforma de iOS.

Para obtener más información sobre cómo agregar información a tu app (por ejemplo, un ícono o una categoría), visita la documentación sobre el desarrollo de apps.

Paso 2: Vincular tus portfolios publicitarios y comerciales

Para poner anuncios en circulación y medir las instalaciones en el administrador de anuncios, asocia al menos una cuenta publicitaria y un portfolio comercial a tu app.

1. En el panel de apps, haz clic en Configuración > Opciones avanzadas.
2. En Identificadores de cuentas publicitarias autorizadas, agrega los identificadores de tus cuentas. Puedes obtener estos identificadores en el administrador de anuncios.
3. En el panel Cuentas publicitarias, haz clic en Empezar y sigue las instrucciones para conectar la app a un negocio.

Paso 3: Configurar el entorno de desarrollo

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

1. En Xcode, haz clic en File > Add Packages....
2. En el campo de búsqueda que aparece, ingresa la URL del repositorio: https://github.com/facebook/facebook-ios-sdk.
3. En Dependency Rule, selecciona Up to Next Major Version e ingresa una versión reciente. La versión más reciente figura en https://github.com/facebook/facebook-ios-sdk/releases/
4. Selecciona las bibliotecas que utilizarás y los destinos adonde quieres agregar dichas bibliotecas.
5. Haz clic en Add Package para completar la configuración.

Paso 4: Registrar y configurar tu app en Facebook

1. En el panel de apps, en Configuración de la app > Básica, desplázate hacia abajo y haz clic en + Agregar plataforma.
2. Desplázate hacia abajo hasta la tarjeta iOS y agrega el identificador del paquete. Encuentra el identificador del paquete en el destino de la app para iOS del proyecto de Xcode. Puedes actualizar el identificador del paquete en cualquier momento.

Paso 5: Configurar el proyecto

Paso 6: Conectar el delegado de la app y el delegado de escena

  
// AppDelegate.swift
import UIKit
import FBSDKCoreKit

@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 FBSDKCoreKit
  ...
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: Agregar eventos de la app

Hay tres maneras de hacer seguimiento de los eventos en tu app:

• Eventos registrados de forma automática: las instalaciones de la app, los inicios de la app y las compras en la app se registran de forma automática en el SDK de Facebook.
• Herramienta de eventos de la app sin código: utiliza esta herramienta para agregar eventos estándar sin agregar código a tu app.
• Eventos registrados de forma manual: agrega código a tu app para hacer un seguimiento de los eventos estándares y personalizados.

Eventos registrados de forma automática

Eventos de compra en la app registrados automáticamente

Apple proporciona cuatro tipos diferentes de compras en la app: consumibles, no consumibles, suscripción con renovación automática y suscripción sin renovación automática. Si implementas las compras en la app con StoreKit 1, registraremos automáticamente cada uno de esos tipos de compras en la app. Si implementas las compras en la app con StoreKit 2, registraremos automáticamente los no consumibles, las suscripciones con renovación automática y las suscripciones sin renovación automática. Si quieres registrar automáticamente también los consumibles, deberás agregar la clave SKIncludeConsumableInAppPurchaseHistory en tu Info.plist:

<key>SKIncludeConsumableInAppPurchaseHistory</key>

<true/>

En StoreKit 1, registraremos automáticamente un evento cuando el usuario compre correctamente un producto, devuelva un producto o intente comprar un producto pero falle el proceso de compra. En StoreKit 2, registraremos automáticamente un evento cuando el usuario compre un producto o devuelva un producto. Si quieres registrar también los casos en que una compra falla en StoreKit 2, proporcionamos una API manual a la que debes llamar. Puedes llamar a esta API durante el proceso de compra en StoreKit 2 de la siguiente manera:

do {
   let result = try await product.purchase()
   switch result {
   case .success(let verificationResult):
       // Handle success case
   case .pending:
       // Handle pending case
   default:
       AppEvents.shared.logFailedStoreKit2Purchase(product.id)
   }
} catch {
   AppEvents.shared.logFailedStoreKit2Purchase(product.id)
}

Obtener consentimiento del dispositivo

A partir de iOS 14.5, tendrás que configurar AdvertiserTrackingEnabled y registrar cada vez que le des permiso a un dispositivo para compartir datos con Facebook.

Si el dispositivo proporciona consentimiento, configura Settings.shared.isAdvertiserTrackingEnabled = true.

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

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

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

Eventos registrados de forma manual

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

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

Parámetros de eventos

Meta creó un conjunto de parámetros de eventos útiles para incluirlos con eventos estándar o con tus eventos personalizados. Asimismo, puedes usar tus propios parámetros.

Si quieres usar eventos de la app para medir las conversiones de anuncios dinámicos, configura el parámetro fb_content_id para que sea el valor del identificador del producto usado en el anuncio dinámico asociado.

Estos parámetros predefinidos ofrecen información orientativa acerca de los patrones de registro comunes y pueden tener un formato más legible en los informes y otras interfaces de usuario. Registra el conjunto de parámetros cuyos desgloses quieras ver. La descripción recomendada es únicamente orientativa. Puedes usar los parámetros para cualquier aspecto que sea relevante en tu app.

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

Paso 8: Probar tus eventos

Con el asistente para anuncios sobre apps, puedes probar los eventos de la app a fin de asegurarte de que tu app envíe eventos a Facebook.

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

Más información

• Guía de prácticas recomendadas: descubre una amplia variedad de ejemplos de apps y cómo cada una administra los eventos.
• Preguntas frecuentes: consulta las preguntas frecuentes.
• Curso de Meta Blueprint: Configurar el SDK y eventos de la app para iOS
• Curso de Meta Blueprint: Usar eventos de la app para segmentar, optimizar y medir

Ejemplos de apps

Creamos algunos ejemplos de distintos tipos de apps para que te resulte más fácil ver cómo puedes usar eventos de la app. Las apps de ejemplo ofrecen un desglose por pantallas de los diferentes eventos y parámetros que se pueden recopilar. Al final de cada sección hay una tabla en la que se enumeran los eventos y los parámetros recomendados para cada app. Además, si es necesario, puedes crear tus propios eventos y parámetros.