Niestandardowe formaty reklam natywnych

Niestandardowe formaty reklam natywnych

Oprócz formatów natywnych zdefiniowanych przez system wydawcy korzystający z Ad Managera mogą tworzyć własne formaty reklam natywnych, definiując niestandardowe listy zasobów. Są to tak zwane niestandardowe formaty reklam natywnych, których można używać z zarezerwowanymi reklamami. Dzięki temu wydawcy mogą przekazywać do aplikacji dowolne uporządkowane dane. Te reklamy są reprezentowane przez obiekt NativeCustomFormatAd.

Wczytywanie niestandardowych formatów reklam natywnych

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

Tworzenie obiektu AdLoader

Podobnie jak w przypadku reklam natywnych niestandardowe formaty reklam natywnych są wczytywane za pomocą klasy AdLoader:

Java

AdLoader adLoader = new AdLoader.Builder(context, "/6499/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, "/6499/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 pod kątem żądań niestandardowych formatów reklam natywnych. Do metody trafiają 3 parametry:

  • Identyfikator niestandardowego formatu reklamy natywnej, do którego AdLoader ma zażądać. Z każdym niestandardowym formatem reklamy natywnej powiązany jest identyfikator. Wskazuje on format, do którego AdLoader ma wysyłać żądanie aplikacji.
  • Element OnCustomFormatAdLoadedListener do wywołania po pomyślnym wczytaniu reklamy.
  • Opcjonalny element OnCustomClickListener, który ma być wywoływany, gdy użytkownik kliknie reklamę. Więcej informacji na ten temat znajdziesz poniżej w sekcji „Obsługa kliknięć i wyświetleń”.

Jednostkę reklamową można skonfigurować do wyświetlania więcej niż 1 formatu kreacji, dlatego parametr forCustomFormatAd może być wywoływany wielokrotnie z unikalnymi identyfikatorami formatów, by przygotować program ładujący do więcej niż jednego możliwego niestandardowego formatu reklamy natywnej.

Identyfikator niestandardowego formatu reklamy natywnej

Identyfikator formatu używany do identyfikowania niestandardowego formatu reklamy natywnej znajdziesz w interfejsie Ad Managera w sekcji Natywna w menu Wyświetlanie:

Każdy identyfikator niestandardowego formatu reklamy natywnej pojawi się obok jego nazwy. Kliknij jedną z nazw, aby wyświetlić ekran ze szczegółowymi informacjami o polach formatu:

W tym miejscu można dodawać, edytować i usuwać poszczególne pola. Zapisz nazwę każdego zasobu. Nazwa to klucz służący do pobierania danych dla każdego zasobu podczas wyświetlania niestandardowego formatu reklamy natywnej.

Niestandardowe formaty reklam displayowych w sieci reklamowej

Niestandardowe formaty reklam natywnych różnią się od formatów zdefiniowanych w systemie tym, że wydawcy mogą definiować własną listę zasobów, z których składa się reklama. Dlatego proces wyświetlania formatów różni się od formatów zdefiniowanych przez system na kilka sposobów:

  1. Klasa NativeCustomFormatAd jest przeznaczona do obsługi dowolnych niestandardowych formatów reklam natywnych zdefiniowanych w usłudze Ad Manager, dlatego nie ma dla zasobów nazwy „getters”. Zamiast tego udostępniane są metody takie jak getText i getImage, które wykorzystują nazwę pola jako parametr.
  2. Nie ma dedykowanej klasy widoku reklamy, takiej jak NativeAdView, której można użyć w komponencie NativeCustomFormatAd. Możesz używać dowolnego układu, który będzie odpowiedni dla Twoich potrzeb.
  3. Nie ma dedykowanej klasy ViewGroup, więc nie musisz rejestrować żadnych widoków danych używanych do wyświetlania zasobów reklamy. Pozwala to zaoszczędzić kilka wierszy kodu przy wyświetlaniu reklamy, ale trzeba też wykonać kilka dodatkowych czynności, aby obsługiwać kliknięcia.

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.
    ...
}

Natywne reklamy wideo do niestandardowych formatów reklam natywnych

Podczas tworzenia formatu niestandardowego możesz dodać go do filmów.

W implementacji aplikacji możesz użyć adresu NativeCustomFormatAd.getMediaContent(), aby uzyskać treści multimedialne. Następnie wywołaj setMediaContent(), aby ustawić treści multimedialne w widoku multimediów na widok multimediów. Jeśli reklama nie zawiera treści wideo, utwórz alternatywny plan, by wyświetlać reklamę bez filmu.

W podanym niżej przykładzie sprawdzamy, czy reklama zawiera treści wideo, i jeśli reklama wideo jest niedostępna, wyświetla się w jej miejscu obraz:

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)
  }
}

Więcej informacji o dostosowywaniu jakości wideo w niestandardowej reklamie natywnej znajdziesz w sekcji MediaContent.

Pobierz przykład renderowania niestandardowego w usłudze Ad Manager, aby zobaczyć przykład działania natywnej reklamy wideo w praktyce.

Kliknięcia i wyświetlenia niestandardowego formatu reklamy natywnej

W przypadku niestandardowych formatów reklam natywnych aplikacja odpowiada za rejestrowanie wyświetleń i raportowanie zdarzeń kliknięć za pomocą pakietu SDK do reklam mobilnych Google.

Rejestrowanie wyświetleń

Aby zarejestrować wyświetlenie reklamy w formacie niestandardowym, wywołaj metodę recordImpression w odpowiednim elemencie NativeCustomFormatAd:

myCustomFormatAd.recordImpression();

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

Zgłoś kliknięcia

Aby poinformować pakiet SDK o kliknięciu wyświetlenia zasobu, wywołaj metodę performClick w odpowiednim elemencie NativeCustomFormatAd i przekaż nazwę klikniętego zasobu. Jeśli na przykład masz zasób w formacie niestandardowym o nazwie „Obraz główny” i chcesz zgłosić kliknięcie odpowiadającego mu zasobu ImageView, kod będzie wyglądać tak:

myCustomFormatAd.performClick("MainImage");

Pamiętaj, że nie musisz wywoływać tej metody w przypadku każdego widoku danych powiązanego z Twoją reklamą. Jeśli masz inne pole o nazwie „Caption”, które ma być wyświetlane, ale użytkownik nie klika ani nie klika go, aplikacja nie musi wywoływać funkcji performClick, aby wyświetlić ten zasób.

Reagowanie na niestandardowe działania kliknięć

Gdy użytkownik kliknie reklamę w niestandardowym formacie, pakiet SDK może odpowiedzieć na 3 sposoby w tej kolejności:

  1. Wywołaj funkcję OnCustomClickListener z komponentu AdLoader, jeśli została podana.
  2. W przypadku każdego adresu URL precyzyjnych linków w reklamie znajdź narzędzie do rozpoznawania treści i uruchom pierwszy, który rozwiązuje ten problem.
  3. Otwórz przeglądarkę i przejdź do tradycyjnego docelowego adresu URL reklamy.

Metoda forCustomFormatAd akceptuje OnCustomClickListener. Jeśli przekażesz obiekt detektora, pakiet SDK wywoła metodę onCustomClick i nie podejmie dalszych działań. Jeśli jednak przekażesz jako detektor wartość null, pakiet SDK użyje precyzyjnego linku lub docelowych adresów URL zarejestrowanych w reklamie.

Dzięki niestandardowym detektorom kliknięć aplikacja może zdecydować, jakie działanie w odpowiedzi na kliknięcie powinno podjąć odpowiednie działanie – może to być aktualizacja interfejsu, uruchomienie nowego działania czy samo zarejestrowanie kliknięcia. Oto przykład, który rejestruje po prostu miejsce kliknięcia:

Java

AdLoader adLoader = new AdLoader.Builder(context, "/6499/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, "/6499/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ęć. W końcu aplikacja informowała pakiet SDK, że wystąpiło kliknięcie. Dlaczego więc powinien on wycofać i zgłosić to do aplikacji?

Ten przepływ informacji jest przydatny z kilku powodów, ale przede wszystkim pozwala pakietowi SDK zachować kontrolę nad reakcją na kliknięcie. Może automatycznie wysyłać pingi do linków monitorujących firm zewnętrznych, które zostały ustawione na potrzeby kreacji, i wykonywać inne zadania w tle bez konieczności używania dodatkowego kodu.