Primi passi con Android

Audience Network ora si basa esclusivamente sulle offerte

Ora Audience Network utilizza esclusivamente le offerte per il riempimento delle inserzioni nelle app iOS e Android. Per monetizzare con Audience Network, dovrai spostare le app dalla distribuzione a cascata alle offerte.

Leggi di più sul nostro post sul blog di Audience Network.

Audience Network di Meta ti consente di monetizzare le tue app Android con le inserzioni di Facebook. Questa guida ti illustrerà tutti i passaggi per l'integrazione dell'SDK.

Prerequisiti

Assicurati di aver installato Android Studio.

Consulta le FAQ per la versione minima del sistema operativo supportata dall'SDK di Audience Network.

Passaggio 1: creazione di un nuovo progetto

Passaggio 2: inclusione dell'SDK

Passaggio 3: modalità di errore integrazione (opzionale)

Passaggio 1: creazione di un nuovo progetto

Se hai già un progetto in cui desideri integrare Audience Network, puoi saltare questo passaggio.

Avvia Android Studio e seleziona "Start a new Android Studio Project" (Avvia un nuovo progetto Android Studio).



Assegna un nome al progetto e indica il dominio dell'azienda.
Il nome del pacchetto corrisponde all'identificativo, se decidi di caricare l'app su Google Play Store.



Imposta la versione minima di Android SDK. Audience Network richiede l'API 15 o versioni successive, ma per
questi esempi useremo l'API 21.



Aggiungi un'attività vuota al progetto.



Assegna un nome all'attività iniziale e clicca su Finish (Fine).

Passaggio 2: inclusione dell'SDK

L'SDK di Audience Network fa parte dell'SDK di Facebook. Segui questi passaggi per scaricarlo e includerlo nel tuo progetto:

Utilizzo di Gradle



Aggiungi l'istruzione di compilazione seguente al build.gradle a livello dell'app (non al progetto) per utilizzare la versione più recente dell'SDK di Audience Network:

dependencies {
compile 'com.facebook.android:audience-network-sdk:6.+'
}

In caso di problemi nella risoluzione dell'SDK di Audience Network, assicurati di aver sincronizzato il file Gradle e prova a riavviare Android Studio.

Installazione manuale (procedura non consigliata)

Se usi Intellij IDEA o Eclipse, scarica ed estrai l'SDK di Audience Network per Android. Nella cartella AudienceNetwork/bin, copia il file AudienceNetwork.aar e posizionalo nella cartella /libs del tuo progetto. Crea la directory se non ne esiste una. Successivamente, aggiungi le righe seguenti al build.gradle dell'app:

repositories {
flatDir {
dirs 'libs'
}
}

dependencies {
...
compile(name: 'AudienceNetwork', ext: 'aar')
}

Se usi AudienceNetwork.jar per il tuo progetto, nella cartella AudienceNetwork/bin, rinomina il file AudienceNetwork.aar in AudienceNetwork.zip, estrai il file classes.jar e rinominalo in AudienceNetwork.jar, quindi sposta il file AudienceNetwork.jar nella cartella /libs del tuo progetto. Crea la directory se non ne esiste una. Assicurati che l'interfaccia utente dell'IDE rifletta questo cambiamento. Se usi Intellij IDEA o Eclipse, clicca con il tasto destro sul file libs/AudienceNetwork.jar e seleziona "Add as Library" (Aggiungi come libreria).

Sebbene non sia obbligatorio, ti consigliamo di configurare il tuo progetto affinché funzioni con i servizi Google Play come indicato qui. In questo modo, l'SDK di Audience Network potrà recuperare l'ID pubblicitario in modo più efficiente.

Passaggio 3: modalità di errore integrazione (opzionale)

Quando si integra l'SDK di Audience Network, l'impostazione della modalità di errore integrazione può essere usata per verificare che l'integrazione funzioni come previsto. Nello specifico, questo metodo consente di controllare il comportamento dell'SDK quando utilizzato in modo errato.

  • INTEGRATION_ERROR_CRASH_DEBUG_MODE: l'app si arresterà in maniera improvvisa se la tua build ha FLAG_DEBUGGABLE di Android. In caso contrario, sarà utilizzato INTEGRATION_ERROR_CALLBACK_MODE (procedura consigliata durante il test).
  • INTEGRATION_ERROR_CALLBACK_MODE: l'app chiamerà la callback AdListener.onError(Ad, AdError) se viene individuato un errore di integrazione.
// Example for setting the SDK to crash when in debug mode
AdSettings.setIntegrationErrorMode(INTEGRATION_ERROR_CRASH_DEBUG_MODE);

Passaggi successivi