Formati degli annunci nativi personalizzati di tipo display e Open Measurement

Questa guida spiega come integrare i formati degli annunci nativi personalizzati con la misurazione aperta.

Prerequisiti

Prima di continuare, completa queste operazioni:

Integrazione

Se prevedi di utilizzare la misurazione aperta con formati degli annunci nativi personalizzati che non contengono un asset video, dovrai chiamare tu stesso le API Open Measurement.

Se utilizzi formati degli annunci nativi personalizzati con un asset video, non devi seguire questa guida. L'SDK Mobile Ads monitora la visibilità dell'asset video per tuo conto.

Carica un annuncio

Il caricamento di un annuncio è lo stesso, indipendentemente dal fatto che tu stia utilizzando la misurazione aperta o meno. Ecco un metodo che mostra come richiedere un annuncio nativo personalizzato:

Java

private void loadCustomNativeAd(Context context, ViewGroup nativeCustomFormatAdContainer) {

  AdLoader adLoader =
      new AdLoader.Builder(context, "AD_UNIT_ID")
          .forCustomFormatAd(
              "CUSTOM_TEMPLATE_ID",
              new NativeCustomFormatAd.OnCustomFormatAdLoadedListener() {
                @Override
                public void onCustomFormatAdLoaded(@NonNull NativeCustomFormatAd ad) {
                  // Show the ad first and then register your view and begin open measurement.
                  // Make sure to do this on the main thread.

                  // ...
                  // Show ad
                  // ...

                  startOpenMeasurement(ad, nativeCustomFormatAdContainer);
                }
              },
              new NativeCustomFormatAd.OnCustomClickListener() {
                @Override
                public void onCustomClick(NativeCustomFormatAd ad, String assetName) {
                  // Handle the click action
                }
              })
          .build();
  adLoader.loadAd(new AdRequest.Builder().build());
}

Kotlin

private fun loadCustomNativeAd(context: Context, nativeCustomFormatAdContainer: ViewGroup) {
  val adLoader =
    AdLoader.Builder(context, "AD_UNIT_ID")
      .forCustomFormatAd(
        "CUSTOM_TEMPLATE_ID",
        NativeCustomFormatAd.OnCustomFormatAdLoadedListener { ad ->
          // Show the ad first and then register your view and begin open measurement. Make sure
          // to do this on the main thread.

          // ...
          // Show ad
          // ...

          startOpenMeasurement(ad, nativeCustomFormatAdContainer)
        },
        NativeCustomFormatAd.OnCustomClickListener { ad, assetName ->
          // Handle the click action.
        },
      )
      .build()

  adLoader.loadAd(AdRequest.Builder().build())
}

Sostituisci AD_UNIT_ID e CUSTOM_TEMPLATE_ID con l'ID unità pubblicitaria e l'ID modello personalizzato.

Registra la visualizzazione e inizia la misurazione

Per attivare la misurazione aperta su un annuncio nativo personalizzato, visualizza prima l'annuncio, quindi registra la visualizzazione dell'annuncio personalizzato con l'oggetto DisplayOpenMeasurement associato all'annuncio nativo personalizzato. L'oggetto DisplayOpenMeasurement fornisce il metodo setView() per registrare la visualizzazione del container con la misurazione aperta.

Devi anche indicare esplicitamente all'SDK di iniziare a misurare l'annuncio. Per farlo, chiama il metodo start() sull'oggetto DisplayOpenMeasurement dell'annuncio nativo personalizzato. Il metodo start() deve essere chiamato dal thread principale e le chiamate successive non hanno alcun effetto.

Ecco che aspetto ha:

Java

private void startOpenMeasurement(
    NativeCustomFormatAd ad, ViewGroup nativeCustomFormatAdContainer) {
  DisplayOpenMeasurement displayOpenMeasurement = ad.getDisplayOpenMeasurement();
  if (displayOpenMeasurement != null) {
    displayOpenMeasurement.setView(nativeCustomFormatAdContainer);
    displayOpenMeasurement.start();
  }
}

Kotlin

private fun startOpenMeasurement(
  ad: NativeCustomFormatAd,
  nativeCustomFormatAdContainer: ViewGroup,
) {
  ad.getDisplayOpenMeasurement()?.let { displayOpenMeasurement ->
    displayOpenMeasurement.setView(nativeCustomFormatAdContainer)
    displayOpenMeasurement.start()
  }
}

Tieni presente che devi visualizzare l'annuncio prima di registrare la visualizzazione. La visualizzazione dell'annuncio è trattata in Formati degli annunci nativi personalizzati.

Il layout customTemplateAdFrame è il container dell'annuncio nativo personalizzato e deve contenere tutti gli asset all'interno del riquadro di delimitazione della visualizzazione.

Certificazione con l'IAB

Una volta rilasciata l'app, inizierai a ricevere i dati di misurazione, tuttavia, i dati non verranno certificati finché non completi la procedura di certificazione IAB.