Niestandardowe formaty reklam natywnych

Niestandardowe formaty reklam natywnych

Oprócz formatów natywnych zdefiniowanych w systemie wydawcy korzystający z Ad Managera mają do dyspozycji: tworzenia własnych formatów reklam natywnych przez zdefiniowanie niestandardowych list zasobów. Nazywamy je niestandardowymi formatami natywnych reklam i można ich używać w przypadku reklam zarezerwowanych. Dzięki temu wydawcy mogą przekazywać dowolne uporządkowane dane i aplikacjami. Te reklamy są reprezentowane przez NativeCustomFormatAd obiektu.

Wczytaj niestandardowe formaty reklam natywnych

Z tego przewodnika dowiesz się, jak wczytywać i wyświetlać niestandardowe formaty reklam natywnych.

Tworzenie AdLoader

Podobnie jak w przypadku reklam natywnych, niestandardowe formaty reklam natywnych są ładowane za pomocą klasy AdLoader:

Java

AdLoader adLoader = new AdLoader.Builder(context, "/21775744923/example/native")
    .forCustomFormatAd("10063170",
      new NativeCustomFormatAd.OnCustomFormatAdLoadedListener() {
          @Override
          public void onCustomFormatAdLoaded(NativeCustomFormatAd ad) {
              // Show the custom format and record an impression.
          }
      },
      new NativeCustomFormatAd.OnCustomClickListener() {
          @Override
          public void onCustomClick(NativeCustomFormatAd ad, String s) {
              // Handle the click action
          }
      })
    .withAdListener( ... )
    .withNativeAdOptions( ... )
    .build();

Kotlin

val adLoader = AdLoader.Builder(this, "/21775744923/example/native")
        .forCustomFormatAd("10063170",
            { ad ->
                // Show the custom format and record an impression.
            },
            { ad, s ->
            // Handle the click action
            })
        .withAdListener( ... )
        .withNativeAdOptions( ... )
        .build()

Metoda forCustomFormatAd konfiguruje AdLoader tak, aby żądały niestandardowe formatów reklam natywnych. Do metody są przekazywane 3 parametry:

  • Identyfikator niestandardowego formatu reklamy natywnej, którego AdLoader powinien zażądać. Z każdym niestandardowym formatem natywnej reklamy jest powiązany identyfikator. Ten wskazuje format, którego żąda aplikacja AdLoader.
  • An OnCustomFormatAdLoadedListener ma zostać wywołany po pomyślnym wczytaniu reklamy.
  • Parametr opcjonalny OnCustomClickListener ma być wywoływany, gdy użytkownik kliknie reklamę. Więcej informacji na ten temat zapoznaj się z sekcją „Obsługa kliknięć i wyświetleń” sekcji poniżej.

Ponieważ pojedyncza jednostka reklamowa może być skonfigurowana tak, aby wyświetlać więcej niż 1 format kreacji, funkcja forCustomFormatAd może być wywoływana wielokrotnie z użyciem unikalnych identyfikatorów formatów, aby przygotować ładowarkę reklam na więcej niż 1 możliwy format reklamy natywnej.

Identyfikator niestandardowego formatu reklamy natywnej

Identyfikator formatu używany do identyfikowania niestandardowego formatu reklamy natywnej może to być w interfejsie Ad Managera w sekcji Natywna w obszarze Wyświetlanie. menu:

Obok nazwy każdego niestandardowego formatu reklamy natywnej znajduje się jego identyfikator. Klikając jedną z opcji powoduje wyświetlenie ekranu ze szczegółowymi informacjami o formacie pola:

Tutaj możesz dodawać, edytować i usuwać poszczególne pola. Zwróć uwagę na Nazwa każdego z zasobów. Nazwa to klucz użyty do pobrania danych dla każdego komponentu podczas wyświetlania niestandardowego formatu reklamy natywnej.

Displayowe niestandardowe formaty reklam natywnych

Niestandardowe formaty reklam natywnych różnią się od formatów zdefiniowanych przez system tym, mogą tworzyć własne listy zasobów, utworzyć reklamę. Dlatego proces ich wyświetlania różni się od procedury można edytować na kilka sposobów:

  1. Klasa NativeCustomFormatAd jest przeznaczona do obsługi zdefiniowanych w usłudze Ad Manager, nie ma nazwy „getters” dla zasobów. Zamiast tego oferuje metody, takie jak getText czy getImage, które przyjmują nazwę pola jako parametr.
  2. Nie ma dedykowanej klasy wyświetlenia reklamy, takiej jak NativeAdView, której można użyć z NativeCustomFormatAd Możesz wykorzystać dowolny układ, związane z wrażeniami użytkownika.
  3. Nie ma specjalnych zajęć ViewGroup, więc nie musisz się rejestrować dowolny widok użyty do wyświetlenia komponentów reklamy. To pozwoli zaoszczędzić kilka wierszy podczas wyświetlania reklamy, ale oznacza też konieczność wykonania dodatkowych czynności ich późniejszej obsługi.

Oto przykładowa funkcja, która wyświetla NativeCustomFormatAd:

Java

public void displayCustomFormatAd (ViewGroup parent,
                                     NativeCustomFormatAd customFormatAd) {
    // Inflate a layout and add it to the parent ViewGroup.
    LayoutInflater inflater = (LayoutInflater) parent.getContext()
            .getSystemService(Context.LAYOUT_INFLATER_SERVICE);
    View adView = inflater.inflate(R.layout.custom_format_ad, parent);

    // Locate the TextView that will hold the value for "Headline" and
    // set its text.
    TextView myHeadlineView = (TextView) adView.findViewById(R.id.headline);
    myHeadlineView.setText(customFormatAd.getText("Headline"));

    // Locate the ImageView that will hold the value for "MainImage" and
    // set its drawable.
    Button myMainImageView = (ImageView) adView.findViewById(R.id.main_image);
    myMainImageView.setImageDrawable(
            customFormatAd.getImage("MainImage").getDrawable());

    ...
    // Continue locating views and displaying assets until finished.
    ...
}

Kotlin

public fun displayCustomFormatAd (parent: ViewGroup,
                                customFormatAd: NativeCustomFormatAd) {
    val adView = layoutInflater
            .inflate(R.layout.ad_simple_custom_format, null)

    val myHeadlineView = adView.findViewById<TextView>(R.id.headline)
    myHeadlineView.setText(customFormatAd.getText("Headline"));

    // Locate the ImageView that will hold the value for "MainImage" and
    // set its drawable.
    val myMainImageView = adView.findViewById(R.id.main_image);
    myMainImageView.setImageDrawable(
            customFormatAd.getImage("MainImage").drawable);

    ...
    // Continue locating views and displaying assets until finished.
    ...
}

Renderowanie ikony Informacja

W ramach przepisów aktu o usługach cyfrowych (DSA): reklamy z rezerwacji wyświetlane w Europejskim Obszarze Gospodarczym (EOG) wymagają podania atrybutu Ikona Informacja i link do strony „O tej reklamie” w Google. Wdrażając niestandardowe reklamy natywne, odpowiadasz za renderowanie Ikona Informacja. Zalecamy renderowanie i ustawienie kliknięcia detektor ikony Informacja podczas renderowania głównych zasobów reklamy.

W przykładzie poniżej założono, że element <ImageView /> został zdefiniowany w w hierarchii widoków z logo Informacja.

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android">
    <ImageView
        android:id="@+id/adChoices"
        android:layout_width="15dp"
        android:layout_height="15dp"
        android:adjustViewBounds="true"
        android:contentDescription="AdChoices icon." />
</LinearLayout>

W poniższych przykładach widać ikonę Informacja skonfigurować odpowiednie zachowanie kliknięć.

Java

private AdSimpleCustomTemplateBinding customTemplateBinding;

private void populateAdView(final NativeCustomFormatAd nativeCustomFormatAd) {
  // Render the AdChoices icon.
  String adChoicesKey = NativeAdAssetNames.ASSET_ADCHOICES_CONTAINER_VIEW;
  NativeAd.Image adChoicesAsset = nativeCustomFormatAd.getImage(adChoicesKey);
  if (adChoicesAsset == null) {
    customTemplateBinding.adChoices.setVisibility(View.GONE);
  } else {
    customTemplateBinding.adChoices.setVisibility(View.VISIBLE);
    customTemplateBinding.adChoices.setImageDrawable(adChoicesAsset.getDrawable());

    // Enable clicks on AdChoices.
    customTemplateBinding.adChoices.setOnClickListener(
        new View.OnClickListener() {
          @Override
          public void onClick(View v) {
            nativeCustomFormatAd.performClick(adChoicesKey);
          }
        });
  }
  ...
}

Kotlin

private lateinit var customTemplateBinding: AdSimpleCustomTemplateBinding

private fun populateAdView(nativeCustomFormatAd: NativeCustomFormatAd) {
  // Render the AdChoices icon.
  val adChoicesKey = NativeAdAssetNames.ASSET_ADCHOICES_CONTAINER_VIEW
  val adChoicesAsset = nativeCustomFormatAd.getImage(adChoicesKey)
  if (adChoicesAsset == null) {
    customTemplateBinding.adChoices.visibility = View.GONE
  } else {
    customTemplateBinding.adChoices.setImageDrawable(adChoicesAsset.drawable)
    customTemplateBinding.adChoices.visibility = View.VISIBLE

    // Enable clicks on AdChoices.
    customTemplateBinding.adChoices.setOnClickListener {
      nativeCustomFormatAd.performClick(adChoicesKey)
    }
  }
  ...
}

Natywne kreacje wideo na potrzeby niestandardowych formatów reklam natywnych

Podczas tworzenia formatu niestandardowego możesz określić, czy ma on być odpowiedni do wyświetlania reklam wideo.

W implementacji aplikacji możesz użyć opcji NativeCustomFormatAd.getMediaContent() w celu pobrania treści multimedialnych. Następnie zadzwoń pod numer setMediaContent() aby ustawić treści multimedialne w widoku multimediów. w widoku multimediów. Jeśli reklama nie zawiera treści wideo, utwórz alternatywne plany wyświetlania reklama bez filmu.

W przykładzie poniżej sprawdzisz, czy reklama zawiera treść wideo i wyświetla obraz zamiast filmu, jeśli nie jest dostępny:

Java

// Called when a custom native ad loads.
@Override
public void onCustomFormatAdLoaded(final NativeCustomFormatAd ad) {

  MediaContent mediaContent = ad.getMediaContent();

  // Assumes you have a FrameLayout in your view hierarchy with the id media_placeholder.
  FrameLayout mediaPlaceholder = (FrameLayout) findViewById(R.id.media_placeholder);

  // Apps can check the MediaContent's hasVideoContent property to determine if the
  // NativeCustomFormatAd has a video asset.
  if (mediaContent != null && mediaContent.hasVideoContent()) {
    MediaView mediaView = new MediaView(mediaPlaceholder.getContext());
    mediaView.setMediaContent(mediaContent);
    mediaPlaceholder.addView(mediaView);

    // Create a new VideoLifecycleCallbacks object and pass it to the VideoController. The
    // VideoController will call methods on this object when events occur in the video
    // lifecycle.
    VideoController vc = mediaContent.getVideoController();
    vc.setVideoLifecycleCallbacks(
        new VideoController.VideoLifecycleCallbacks() {
          @Override
          public void onVideoEnd() {
            // Publishers should allow native ads to complete video playback before
            // refreshing or replacing them with another ad in the same UI location.
            super.onVideoEnd();
          }
        });
  } else {
    ImageView mainImage = new ImageView(this);
    mainImage.setAdjustViewBounds(true);
    mainImage.setImageDrawable(ad.getImage("MainImage").getDrawable());
    mediaPlaceholder.addView(mainImage);
    mainImage.setOnClickListener(
        new View.OnClickListener() {
          @Override
          public void onClick(View view) {
            ad.performClick("MainImage");
          }
        });
  }
}

Kotlin

// Called when a custom native ad loads.
NativeCustomFormatAd.OnCustomFormatAdLoadedListener { ad ->

  val mediaContent = ad.mediaContent

  // Apps can check the MediaContent's hasVideoContent property to determine if the
  // NativeCustomFormatAd has a video asset.
  if (mediaContent != null && mediaContent.hasVideoContent()) {
    val mediaView = MediaView(mediaPlaceholder.getContest())
    mediaView.mediaContent = mediaContent

    val videoController = mediaContent.videoController

    // Create a new VideoLifecycleCallbacks object and pass it to the VideoController. The
    // VideoController will call methods on this object when events occur in the video
    // lifecycle.
    if (videoController != null) {
      videoController.videoLifecycleCallbacks =
        object : VideoController.VideoLifecycleCallbacks() {
          override fun onVideoEnd() {
            // Publishers should allow native ads to complete video playback before refreshing
            // or replacing them with another ad in the same UI location.
            super.onVideoEnd()
          }
        }
    }
  } else {
    val mainImage = ImageView(this)
    mainImage.adjustViewBounds = true
    mainImage.setImageDrawable(ad.getImage("MainImage")?.drawable)

    mainImage.setOnClickListener { ad.performClick("MainImage") }
    customTemplateBinding.simplecustomMediaPlaceholder.addView(mainImage)
  }
}

W sekcji MediaContent znajdziesz więcej informacji o tym, dostosować wygląd reklam wideo w niestandardowej reklamie natywnej.

Pobierz Renderowanie niestandardowe w usłudze Ad Manager przykład dla przykładowej reklamy natywnej wideo w praktyce.

Kliknięcia i wyświetlenia niestandardowego formatu reklamy natywnej

W przypadku niestandardowych formatów reklam natywnych aplikacja jest odpowiedzialna za rejestrowanie wyświetleń i zgłaszanie zdarzeń kliknięcia do pakietu SDK do reklam mobilnych Google.

Rejestruj wyświetlenia

Aby zarejestrować wyświetlenie reklamy w formacie niestandardowym, wywołaj funkcję recordImpression w odpowiedniej NativeCustomFormatAd:

myCustomFormatAd.recordImpression();

Jeśli Twoja aplikacja przypadkowo wywoła metodę dwukrotnie w przypadku tej samej reklamy, SDK automatycznie uniemożliwi zarejestrowanie zduplikowanego wyświetlenia w ramach pojedynczego żądania.

Kliknięcia raportu

Aby zgłosić pakiet SDK, że wystąpiło kliknięcie w widoku zasobu, wywołaj metodę performClick w odpowiedniej NativeCustomFormatAd i przekaż nazwa zasobu, który został kliknięty. Jeśli np. masz zasób w formacie niestandardowym o nazwie „MainImage” i chcesz zgłaszać kliknięcia na ImageView odpowiadające temu zasobowi, Twój kod będzie wyglądać tak:

myCustomFormatAd.performClick("MainImage");

Pamiętaj, że nie musisz wywoływać tej metody dla każdego widoku danych powiązanego z przez zainteresowanego klienta. Jeśli masz inne pole o nazwie „Podpis” który miał być wyświetlanych, ale nieklikniętych przez użytkownika, aplikacja nie musi wywołaj performClick dla widoku danego zasobu.

Reagowanie na niestandardowe kliknięcia

Po kliknięciu reklamy w formacie niestandardowym następuje 3 możliwości: odpowiedzi z pakietu SDK, próbowano w następującej kolejności:

  1. Wywołaj funkcję OnCustomClickListener z metody AdLoader, jeśli została podana.
  2. W przypadku każdego adresu URL precyzyjnego linku reklamy spróbuj znaleźć usługę przetwarzania treści i uruchom pierwszą, która się rozwiąże.
  3. Otwórz przeglądarkę i przejdź do tradycyjnego docelowego adresu URL reklamy.

Metoda forCustomFormatAd akceptuje OnCustomClickListener. Jeśli przekazują obiekt odbiornika, pakiet SDK zamiast tego wywołuje metodę onCustomClick. i nie podejmie żadnych dalszych działań. Jeśli jednak jako detektor przekażesz wartość null, SDK wraca do precyzyjnego linku lub docelowego adresu URL zarejestrowanego w reklama.

Detektory kliknięć niestandardowych pozwalają aplikacji wybrać najlepsze działanie odpowiedź na kliknięcie, np. aktualizacja interfejsu, uruchomienie nowego działania rejestrując tylko kliknięcie. Oto przykład, który po prostu rejestruje kliknięcie miejsce:

Java

AdLoader adLoader = new AdLoader.Builder(context, "/21775744923/example/native")
    .forCustomFormatAd("10063170",
      new NativeCustomFormatAd.OnCustomFormatAdLoadedListener() {
        // Display the ad.
      },
      new NativeCustomFormatAd.OnCustomClickListener() {
          @Override
          public void onCustomClick(NativeCustomFormatAd ad, String assetName) {
            Log.i("MyApp", "A custom click just happened for " + assetName + "!");
          }
      }).build();

Kotlin

val adLoader = AdLoader.Builder(this, "/21775744923/example/native")
    .forCustomFormatAd("10063170",
        { ad ->
            // Display the ad.
        },
        { ad, assetName ->
                Log.i("MyApp", "A custom click just happened for $assetName!")
    }).build()

Na początku może się wydawać dziwne, że istnieją niestandardowe detektory kliknięć. Ostatecznie, Aplikacja właśnie poinformowała SDK o kliknięciu, więc dlaczego pakiet SDK i zgłosić to w aplikacji?

Ten przepływ informacji jest przydatny z kilku powodów, ale najważniejszym jest to, że pozwala pakietowi SDK zachować kontrolę nad odpowiedzią na kliknięcie. Może wysyłać pingi do zewnętrznych linków monitorujących, które zostały ustawione i wykonywać inne zadania w tle, bez żadnych za dodatkowe pola.