Eventi nell'app senza codice

Gli eventi nell'app senza codice, introdotti nella versione 4.34, ti consentono di utilizzare Gestione eventi per aggiungere o rimuovere gli eventi nell'app senza implementare il codice o rilasciare una nuova versione dell'app.

Android

Requisiti

Devi avere uno dei seguenti elementi:

Consulta la Guida introduttiva ad App Events per Android per installare l'ultima versione dell'SDK per Android, la Guida all'aggiornamento per eseguire l'aggiornamento all'ultima versione dell'SDK o, se è stata installata la versione 4.34-4.37, aggiungi il Marketing Kit aprendo <your_app> | Gradle Scripts | build.gradle (Module: app) e aggiungendo quanto segue alla sezione dependencies{}.

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

Non dimenticare di ricreare il progetto.

Implementazione della funzione Eventi nell'app senza codice

Attiva l'evento di debug senza codice aggiungendo le seguenti righe in AndroidManifest.xml:

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

Aggiunta degli eventi nell'app

Accedi a Gestione eventi per aggiungere senza codice gli eventi nell'app che desideri monitorare.

  1. In Gestione eventi clicca su Aggiungi una nuova origine dei dati e seleziona App Events nel menu a discesa.
  2. Clicca su Usa il nostro strumento per la configurazione degli eventi senza codice e seleziona l'app alla quale desideri aggiungere eventi.
  3. Scegli la piattaforma cliccando su Avvia configurazione.
  4. Se si tratta della tua prima visita del flusso senza codice, verrà visualizzato un breve tutorial. Dopo il tutorial, apri una nuova sessione della tua app sul dispositivo mobile.
  5. Agita il telefono fino alla visualizzazione della versione dell'app.
  6. Clicca su un elemento qualsiasi per aggiungere un evento nell'app. Accedi a diverse pagine della tua app per selezionare gli elementi.
  7. Clicca su Salva nel menu a comparsa o su Annulla per non aggiungere l'evento.
  8. Dopo aver aggiunto tutti gli eventi, clicca su Controlla e termina.
  9. Clicca su Testa gli eventi o su Salva ed esci.

Nota: potrebbero essere necessari fino a 30 minuti prima della visualizzazione degli eventi in Gestione eventi.

Verifica dell'integrazione

Accedi allo Strumento di assistenza sulle inserzioni per le app.

  • Seleziona un'app e clicca su Invia.
  • Scorri verso il basso fino alla sezione Strumenti per sviluppatori e clicca su Testa gli eventi nell'app.
  • Se la tua app sta inviando eventi fb_codeless_debug, gli eventi di test selezionati saranno elencati nella tabella.

Nota: funziona solo con l'SDK di Facebook v4.35 e versioni successive.

iOS

Requisiti

  • SDK di Facebook per iOS completo dalla versione 4.34 alla versione 7.1.1
  • SDK di Facebook per iOS Core dalla versione 4.38 alla versione 7.1.1
  • SDK di Facebook per iOS Core dalla versione 4.34-4.37 alla versione 7.1.1 e Marketing Kit

Limitazioni

  • Questa funzione non è disponibile per la versione 8.0.0 o versioni successive. Scopri di più.

Consulta la Guida introduttiva ad App Events per iOS per installare l'ultima versione dell'SDK per iOS, la Guida all'aggiornamento per eseguire l'aggiornamento all'ultima versione dell'SDK oppure, se è stata installata solo la versione 4.34-4.37 dell'SDK Core, aggiungi il Marketing Kit aggiungendo quanto segue al Podfile.

pod 'FBSDKMarketingKit' 

Non dimenticare di eseguire pod update e poi pod install --repo-update.

Implementazione della funzione Eventi nell'app senza codice

Attiva la registrazione degli eventi di debug senza codice aprendo .plist dell'app come codice in Xcode e aggiungi il seguente XML al dizionario delle proprietà:

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

Aggiunta degli eventi nell'app

App Store Connect per iOS 14

Gli eventi raccolti e inviati a Facebook dalla tua app potrebbero richiedere la divulgazione di questi tipi di dati nel questionario App Store Connect. È tua responsabilità assicurarti che ciò sia adeguatamente indicato nell'informativa sulla privacy della tua app. Consulta l'articolo Dettagli sulla privacy dell'App Store di Apple per maggiori informazioni sui tipi di dati che dovrai divulgare.

Accedi a Gestione eventi per aggiungere senza codice gli eventi nell'app che desideri monitorare.

  1. In Gestione eventi clicca su Aggiungi origine dei dati e seleziona App Events nel menu a discesa.
  2. Clicca su Usa il nostro strumento per la configurazione degli eventi senza codice e seleziona l'app alla quale desideri aggiungere eventi.
  3. Scegli la piattaforma cliccando su Avvia configurazione.
  4. Se si tratta della tua prima visita del flusso senza codice, verrà visualizzato un breve tutorial. Dopo il tutorial, apri una nuova sessione della tua app sul dispositivo mobile.
  5. Agita il telefono fino alla visualizzazione della versione dell'app.
  6. Clicca su un elemento qualsiasi per aggiungere un evento nell'app. Accedi a diverse pagine della tua app per selezionare gli elementi.
  7. Clicca su Salva nel menu a comparsa o su Annulla per non aggiungere l'evento.
  8. Dopo aver aggiunto tutti gli eventi, clicca su Controlla e termina.
  9. Clicca su Testa gli eventi o su Salva ed esci.

Nota: potrebbero essere necessari fino a 30 minuti prima della visualizzazione degli eventi in Gestione eventi.

Verifica dell'integrazione

Accedi allo Strumento di assistenza sulle inserzioni per le app.

  • Seleziona un'app e clicca su Invia.
  • Nella parte inferiore, seleziona App Events Tester (Tester di eventi nell'app).
  • Se la tua app sta inviando eventi fb_codeless_debug, saranno elencati nella tabella.

Unity

Richiediamo l'SDK per Unity di Facebook v4.34 o versioni successive.

Consulta la Guida introduttiva all'SDK per Unity di Facebook per installare l'ultima versione dell'SDK per Unity di Facebook e segui le impostazioni specifiche della piattaforma per iOS per Unity o Android per Unity.

Abilitazione degli eventi nell'app senza codice

Per attivare questa opzione, in Unity Editor seleziona Facebook | Edit Settings e in seguito seleziona Auto Logging App Events:

Aggiunta di App Events

A questo punto, puoi aggiungere App Events con Gestione eventi:

  1. In Add Data Source, seleziona App Events.

  2. Clicca su User our codeless event setup tool

  3. Seleziona l'app alla quale desideri aggiungere gli eventi.

  4. Clicca su Start Setup per selezionare la piattaforma. Se si tratta della tua prima visita del flusso senza codice, verrà visualizzato un breve tutorial.

  5. Dopo il tutorial, apri una nuova sessione della tua app sul dispositivo mobile.

  6. Agita il dispositivo mobile fino alla visualizzazione della versione dell'app.

  7. Clicca su un elemento qualsiasi dell'app per aggiungere un evento nell'app. Accedi a diverse pagine della tua app per selezionare gli elementi.

  8. In Unity Editor, clicca su Save per aggiungere l'evento.

  9. Dopo aver aggiunto tutti gli eventi, clicca su Review and Finish.

  10. Clicca su Test Events o Save and Exit.

Potrebbero essere necessari fino a 30 minuti perché gli eventi vengano visualizzati in Gestione eventi. Ripeti questi passaggi per ogni piattaforma, come iOS o Android, supportata dal tuo gioco.

Verifica dell'integrazione

Accedi allo Strumento di assistenza sulle inserzioni per le app.

  • In Select an App, clicca su Submit.

  • Scegli App Events Tester.

  • Se la tua app invia eventi fb_codeless_debug, questi vengono visualizzati nella tabella.

FAQ

GENERALE

1. Come posso verificare che la funzione senza codice sia integrata correttamente?

Pochi minuti dopo aver lanciato la tua app sul tuo dispositivo per il test, visualizzerai gli eventi con il nome fb_codeless_debug in Gestione eventi.

2. Come disattivo la funzione senza codice?

Per disattivare la registrazione degli eventi nell'app senza codice, utilizza lo strumento per la configurazione degli eventi senza codice e rimuovi tutti gli eventi.


Android

1. Cosa faccio se visualizzo il seguente errore di compilazione?
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.
Aggiungi quanto segue all'elemento manifest nel file AndroidManifest.xml:
<manifest>
  ...
  xmlns:tools="http://schemas.android.com/tools"
  ...
</manifest>
Aggiungi quanto segue all'elemento activity:
<activity>
  ...
  tools:replace="android:theme"
  ...
</activity>

iOS

1. Cosa faccio se visualizzo il seguente avvertimento?
[!] Unable to find a specification for FBSDKMarketingKit
Esegui pod update e poi pod install --repo-update.