Guida introduttiva ad App Events su iOS

Questa guida mostra come aggiungere App Events alla tua app nuova o esistente integrando l'SDK di Facebook e registrando gli eventi.

Prima di iniziare

Ecco cosa ti servirà:

• Un account sviluppatore di Facebook
• Un account pubblicitario Facebook
• Un portfolio business Facebook (crea un nuovo portfolio business se non ne possiedi ancora uno)
• Un'app Facebook

Passaggio 1: configurazione dell'app Facebook

Vai alla Dashboard gestione app, clicca su Le mie app e crea una nuova app se non ne hai ancora una. Accedi a Impostazioni > Di base per visualizzare la scheda Dettagli dell'app contenente l'ID app, la chiave segreta e altre informazioni sulla tua app.

Scorri fino al fondo della pagina, quindi clicca su Aggiungi piattaforma. Scegli iOS, aggiungi i dettagli dell'app e salva le modifiche.

Configura l'app per la pubblicità aggiungendo i seguenti dettagli:

• Domini app: fornisci l'URL dell'App Store Apple della tua app.
• URL dell'Informativa sulla privacy: indica l'URL che punta all'Informativa sulla privacy. Obbligatorio per rendere pubblica la tua app.
• URL delle Condizioni d'uso: indica l'URL che punta alle Condizioni d'uso.
• Piattaforma: scorri fino alla fine della scheda Impostazioni per aggiungere la piattaforma iOS.

Per scoprire di più sulla procedura per aggiungere dettagli all'app, come un'icona o una categoria, visita la documentazione relativa allo sviluppo di app.

Passaggio 2: collegamento dei tuoi portfolio pubblicitari e business

Per pubblicare annunci e misurare le installazioni in Gestione inserzioni, associa almeno un account pubblicitario e un portfolio business alla tua app.

1. Nella Dashboard gestione app, fai clic su Impostazioni > Avanzate.
2. In ID account pubblicitari autorizzati, aggiungi gli ID dei tuoi account pubblicitari. Puoi ottenere gli ID dei tuoi account pubblicitari da Gestione inserzioni.
3. Nella scheda Account pubblicitari, clicca su Inizia e segui le istruzioni per collegare l'app a un account business.

Passaggio 3: configurazione dell'ambiente di sviluppo

La procedura seguente utilizza Swift Package Manager per configurare l'ambiente di sviluppo in Xcode.

1. In Xcode, clicca su File > Add Packages... (File > Aggiungi pacchetti...).
2. Nel campo di ricerca visualizzato, immetti l'URL del repository: https://github.com/facebook/facebook-ios-sdk.
3. In Dependency Rule (Regola di dipendenza), seleziona Up to Next Major Version (Fino alla successiva versione principale) e inserisci una versione recente. La versione più recente è riportata nel sito web https://github.com/facebook/facebook-ios-sdk/releases/
4. Scegli le librerie che hai intenzione di utilizzare e i target a cui desideri aggiungerle.
5. Clicca su Add Package (Aggiungi pacchetto) per il completamento della configurazione.

Passaggio 4: registrazione e configurazione dell'app con Facebook

Aggiungi l'identificativo del bundle e abilita la funzione Accesso singolo per la tua app.

Passaggio 5: configurazione del progetto

Passaggio 6: collegamento di app delegate e scene delegate

    
// 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]
    )
}

Passaggio 7: aggiunta di App Events

Esistono tre modi per monitorare gli eventi nell'app:

• Eventi registrati automaticamente: gli eventi di installazione e avvio dell'app e gli acquisti in-app vengono registrati automaticamente con l'SDK di Facebook.
• Strumento per la configurazione di App Events senza codice: usa questo strumento per aggiungere eventi standard senza aggiungere codice alla tua app.
• Eventi registrati manualmente: aggiungi codice alla tua app per monitorare gli eventi standard e personalizzati.

Eventi registrati automaticamente

Acquisizione del consenso del dispositivo

A partire da iOS 14.5, dovrai impostare isAdvertiserTrackingEnabled e registrare ogni volta che concedi a un dispositivo l'autorizzazione per la condivisione dei dati con Facebook.

Se un dispositivo fornisce il consenso, imposta Settings.shared.isAdvertiserTrackingEnabled = true.

Se il dispositivo non acconsente al monitoraggio, imposta Settings.shared.isAdvertiserTrackingEnabled = false.

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

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

Registrare manualmente gli eventi

Per registrare un evento personalizzato, passa il nome dell'evento come AppEvents.Name.

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

Parametri degli eventi

Facebook ha creato un insieme di utili parametri degli eventi per l'inclusione con eventi standard o con i tuoi eventi personalizzati. Puoi anche fornire i tuoi parametri.

Questi parametri predefiniti sono destinati a fornire una guida sugli schemi di registrazione comuni e potrebbero avere una forma più leggibile nei report e in altre interfacce utente. Registra la serie di parametri di cui desideri vedere i dettagli. La descrizione consigliata è fornita unicamente a scopo orientativo: puoi usare questi parametri per qualsiasi elemento applicabile alla tua app.

I parametri sono passati tramite un dizionario, in cui la chiave contiene il nome del parametro come AppEvents.ParameterName e il valore deve essere String o un numero (Int, Double ecc.).

Passaggio 8: test degli eventi

Lo Strumento di assistenza per le inserzioni sulle app ti consente di testare gli eventi nella tua app per verificarne l'invio a Facebook.

1. Apri lo Strumento di assistenza sulle inserzioni per le app.
2. In Seleziona un'app, scegli la tua app e seleziona Invia.
3. Scorri fino in fondo e scegli Testa evento.
4. Avvia la tua app e invia un evento. L'evento dovrebbe essere visualizzato sulla pagina.

Per saperne di più

• Guida alle best practice: puoi consultare un'ampia varietà di app di esempio e vedere come ciascuna gestisce gli eventi nell'app.
• FAQ: consulta le domande frequenti.
• Corso Meta Blueprint: Configurazione dell'SDK e degli eventi nell'app per iOS
• Corso Meta Blueprint: Utilizzo degli eventi nell'app per targetizzare, ottimizzare e misurare

Esempi di app

Abbiamo creato alcuni esempi per diversi tipi di app in modo che tu possa vedere più facilmente come è possibile utilizzare gli eventi nell'app. Ciascuno degli esempi di app fornisce tutti i dettagli dei diversi eventi e dei parametri che possono essere acquisiti. Alla fine di ogni sezione è presente una tabella che elenca gli eventi consigliati e i parametri per ciascuna app. Se necessario, puoi creare eventi e parametri personali.