Per iniziare

Questa guida spiega come utilizzare il componente aggiuntivo per gli annunci nativi per implementare gli annunci nativi AdMob in un'app Unity, nonché alcuni aspetti importanti da considerare durante la procedura.

Gli annunci nativi si adattano al formato e alla funzione dell'esperienza utente in cui vengono posizionati. Inoltre, si adattano al design visivo dell'app in cui sono posizionati. Il formato degli annunci nativi di AdMob consente ai publisher di pubblicare annunci perfettamente integrati con i contenuti. Puoi utilizzare questa tecnologia per implementare rendering altamente personalizzati che sfruttano al meglio il codice nativo nelle app Unity.

Gli annunci nativi vengono mostrati utilizzando gli stessi tipi di GameObjects con cui stai già creando le tue app e possono essere formattati in modo da adattarsi al design visivo dell'esperienza utente in cui si trovano. Quando viene caricato un annuncio nativo, la tua app riceve un oggetto nativo contenente i relativi asset, che vengono visualizzati dall'app Unity anziché dall'SDK.

Prerequisiti

  • Plug-in Unity Google Mobile Ads versione 7.0.0 o successive.
  • Completa la Guida introduttiva.
  • Scarica e installa il componente aggiuntivo per gli annunci nativi.

Caricare i formati degli annunci nativi

Gli annunci nativi vengono caricati tramite la classe AdLoader, che ha la propria classe AdLoader.Builder per personalizzarli durante la creazione. Il metodo ForNativeAd() configura AdLoader per gestire gli annunci nativi.

private void RequestNativeAd() {
    AdLoader adLoader = new AdLoader.Builder(INSERT_AD_UNIT_HERE)
        .ForNativeAd()
        .Build();
}

Registrati per gli eventi correlati agli annunci AdLoader

Per ricevere una notifica quando un annuncio nativo viene caricato correttamente o non viene caricato, aggiungi i delegati alla classe AdLoader per gli eventi elencati di seguito.

OnNativeAdLoaded

Viene invocato quando un annuncio nativo viene caricato correttamente. Per accedere all'annuncio caricato è necessario avere un delegato per questo evento.

OnAdFailedToLoad

Viene invocato quando non riesce a caricare un annuncio nativo.

Carica l'annuncio

Una volta terminata la creazione di un AdLoader, chiama il relativo metodo LoadAd() per richiedere un annuncio:

adLoader.LoadAd(new AdRequest.Builder().Build());

Creare la richiesta di annuncio

Lo snippet di codice riportato di seguito mostra come creare un AdLoader configurato per richiedere annunci nativi, imposta delegati per i caricamenti di annunci riusciti e non riusciti ed effettua una richiesta di annuncio.

private void RequestNativeAd() {
    AdLoader adLoader = new AdLoader.Builder(INSERT_AD_UNIT_HERE)
        .ForNativeAd()
        .Build();
    adLoader.OnNativeAdLoaded += this.HandleNativeAdLoaded;
    adLoader.OnAdFailedToLoad += this.HandleAdFailedToLoad;
    adLoader.LoadAd(new AdRequest.Builder().Build());
}

Gestire i caricamenti degli annunci non riusciti

L'evento OnAdFailedToLoad è di tipo EventHandle<AdFailedToLoadEventArgs>. Di seguito è riportato l'analisi del motivo di un errore di caricamento dell'annuncio da questo evento.

private void RequestNativeAd() {
    ...
    adLoader.OnAdFailedToLoad += this.HandleNativeAdFailedToLoad;
}

private void HandleNativeAdFailedToLoad(object sender, AdFailedToLoadEventArgs args) {
    Debug.Log("Native ad failed to load: " + args.Message);
}

Mostrare un annuncio nativo

Quando viene caricato un annuncio nativo, viene invocato l'evento relativo all'annuncio per il formato dell'annuncio corrispondente. È quindi responsabilità della tua app mostrare l'annuncio, anche se non necessariamente deve farlo immediatamente.

Gestire il carico degli annunci

L'evento OnNativeAdLoaded è di tipo EventHandler<NativeAdEventArgs>. L'annuncio, incapsulato in un oggetto NativeAd, può essere recuperato da NativeAdEventArgs come mostrato di seguito:

private NativeAd nativeAd;
...
private void HandleNativeAdLoaded(object sender, NativeAdEventArgs args) {
    Debug.Log("Native ad loaded.");
    this.nativeAd = args.nativeAd;
}

Recuperare gli asset annuncio nativi

Una volta caricati gli annunci, è possibile accedere ai relativi asset come mostrato di seguito. Gli asset grafici vengono restituiti come oggetti Texture2D e gli asset di testo come oggetti string.

private bool nativeAdLoaded;
private NativeAd nativeAd;

void Update() {
    ...

    if (this.nativeAdLoaded) {
        this.nativeAdLoaded = false;
        // Get Texture2D for the icon asset of native ad.
        Texture2D iconTexture = this.nativeAd.GetIconTexture();

        // Get string for headline asset of native ad.
        string headline = this.nativeAd.GetHeadlineText();
    }
}

private void HandleNativeAdLoaded(object sender, NativeAdEventArgs args) {
    Debug.Log("Native ad loaded.");
    this.nativeAd = args.nativeAd;
    this.nativeAdLoaded = true;
}

Tieni presente che agli asset annuncio si deve accedere solo nel thread principale, ad esempio dal metodo Update() di uno script Unity. Tieni inoltre presente che la presenza dei seguenti asset non è sempre garantita e devono essere controllati prima di essere visualizzati:

  • GetStarRating()
  • GetStore()
  • GetPrice()
  • GetAdvertiser()
  • GetIconTexture()

Asset Scegli Tu!

È obbligatorio mostrare l'asset annuncio Scegli Tu! nell'ambito dell'annuncio nativo. Inoltre, è importante che l'asset annuncio Scegli Tu! sia facilmente visibile, quindi scegli le immagini e i colori di sfondo in modo appropriato.

Registra GameObjects per l'asset annuncio

Devi registrare il GameObject affinché l'asset annuncio venga visualizzato nella tua app Unity. Se la registrazione va a buon fine, il metodo utilizzato per registrare il GameObject restituisce un bool. Per un List<GameObject>, il metodo restituisce un int che indica il numero di GameObject registrati correttamente.

Se la registrazione di un asset annuncio non va a buon fine, le impressioni e i clic sull'annuncio nativo corrispondente non verranno riconosciuti.

if (!this.nativeAd.RegisterIconImageGameObject(icon))
{
    // Handle failure to register the icon ad asset.
}

Il GameObject registrato per un asset annuncio deve avere un componente Collider concavo rappresentativo delle dimensioni e della forma del GameObject. Se gli oggetti GameObject registrati negli asset annuncio mancano di componenti Collider o ne hanno uno configurato in modo errato, gli annunci nativi non funzioneranno correttamente.

Nello snippet di codice riportato di seguito, a GameObject viene aggiunto un BoxCollider che utilizza un TextMesh per visualizzare l'asset annuncio del titolo di un annuncio nativo. Una volta collegato il BoxCollider al GameObject, verrà ridimensionato automaticamente per adattarsi al testo del componente TextMesh.

// Create GameObject that will display the headline ad asset.
GameObject headline = new GameObject();
headline.AddComponent<TextMesh>();
headline.GetComponent<TextMesh>().characterSize = 0.5 f;
headline.GetComponent<TextMesh>().anchor = TextAnchor.MiddleCenter;
headline.GetComponent<TextMesh>().color = Color.black;

// Get string of the headline asset.
string headlineText = this.nativeAd.GetHeadlineText();
headline.GetComponent<TextMesh>().text = headlineText;

// Add box collider to the GameObject which will automatically scale.
headline.AddComponent<BoxCollider>();

Demo

Il seguente codice mostra come recuperare l'asset icona di un annuncio nativo caricato correttamente, visualizzare l'asset annuncio icona impostando la trama di un Quad e registrare il GameObject da utilizzare per visualizzare l'asset. Questa procedura di recupero dell'asset annuncio e di registrazione nella classe di annunci nativi deve essere ripetuta per ciascuno degli asset visualizzati dall'app.

private GameObject icon;
private bool nativeAdLoaded;
private NativeAd nativeAd;
...
void Update() {
    ...

    if (this.nativeAdLoaded) {
        this.nativeAdLoaded = false;
        // Get Texture2D for icon asset of native ad.
        Texture2D iconTexture = this.nativeAd.GetIconTexture();

        icon = GameObject.CreatePrimitive(PrimitiveType.Quad);
        icon.transform.position = new Vector3(1, 1, 1);
        icon.transform.localScale = new Vector3(1, 1, 1);
        icon.GetComponent<Renderer>().material.mainTexture = iconTexture;

        // Register GameObject that will display icon asset of native ad.
        if (!this.nativeAd.RegisterIconImageGameObject(icon))
        {
            // Handle failure to register ad asset.
        }
    }
}
...

private void HandleNativeAdLoaded(object sender, NativeAdEventArgs args) {
    Debug.Log("Native ad loaded.");
    this.nativeAd = args.nativeAd;
    this.nativeAdLoaded = true;
}