Konfigurowanie adresu URL przejrzystości reklam

Adres URL przejrzystości reklam umożliwia dostosowanie ikony AdChoices wyświetlanej w niektórych reklamach. Domyślnie ikona ta jest wyświetlana użytkownikom w ramach funkcji przejrzystości i kontroli reklam (AT&C) renderowanej przez Google, która zawiera informacje takie jak reklamodawca i sama reklama.

Adres URL przejrzystości reklamy możesz uzyskać, wysyłając żądanie reklamy do pakietu SDK do reklam mobilnych Google i otrzymując odpowiedź z adresem URL przejrzystości reklamy. Gdy otrzymasz adres URL w aplikacji, możesz zintegrować spersonalizowaną ikonę, która będzie zgodna z projektem Twoich reklam i umożliwi Ci przedstawienie użytkownikom własnych informacji o przetwarzaniu danych i ich ochronie.

Na tej stronie dowiesz się, jak wysyłać żądania dotyczące adresu URL przejrzystości reklam, analizować go i weryfikować.

Wymagania wstępne

Zanim przejdziesz dalej, wykonaj te czynności:

  • Skonfiguruj reklamy natywne w aplikacji. Więcej informacji o reklamach natywnych znajdziesz w artykule Reklamy natywne.
  • Poproś o dostęp do tej funkcji na liście dozwolonych. Aby poprosić o dostęp, skontaktuj się z menedżerem konta.
    • Jeśli nie masz dostępu, odpowiedzi nie zwracają adresu URL przejrzystości reklamy, a domyślna ikona jest renderowana zgodnie z przeznaczeniem.

Poproś o adres URL

Aby GMA Next-Gen SDK zwróciło adres URL przejrzystości reklamy, dodaj do żądań reklam natywnych dodatkowy parametr żądania. Ten parametr sygnalizuje, że aplikacja jest gotowa do obsługi spersonalizowanej ikony.

W żądaniu musisz dodać klucz "ad_transparency_url_requested" z wartością "1" do pakietu dodatkowych informacji wysyłanych z żądaniem reklamy. Więcej informacji o dodatkach sieciowych znajdziesz w sekcji setGoogleExtrasBundle.

W tym przykładzie klucz i wartość są ustawione tak, aby wysłać żądanie adresu URL przejrzystości reklamy:

Java 

private void loadNativeAd() {
  // Create an extra parameter that signals your AT&C implementation.
  Bundle extras = new Bundle();
  extras.putString("ad_transparency_url_requested", "1");
  NativeAdRequest adRequest = new NativeAdRequest.Builder("AD_UNIT_ID", List.of(NativeAdType.NATIVE))
      .setGoogleExtrasBundle(extras)
      .build();
}

Kotlin 

private fun loadNativeAd() {
  // Create an extra parameter that signals your AT&C implementation
  val extras = Bundle()
  extras.putString("ad_transparency_url_requested", "1");
  val adRequest = NativeAdRequest.Builder("AD_UNIT_ID", listOf(NativeAd.NativeAdType.NATIVE))
    .setGoogleExtrasBundle(extras)
    .build()
}

Zastąp AD_UNIT_ID identyfikatorem jednostki reklamowej. Na przykład ca-app-pub-3940256099942544/2247696110 w przypadku reklam natywnych.

Analizowanie adresu URL

Po wysłaniu żądania adresu URL otrzymasz odpowiedź na żądanie reklamy z adresem URL informacji zapewniających przejrzystość reklamy w obiekcie informacji o odpowiedzi. Szczegółowe informacje o obiekcie informacji o odpowiedzi znajdziesz w sekcji Informacje o odpowiedzi.

Adres URL przejrzystości reklamy znajdziesz w dodatkowych informacjach wysyłanych z odpowiedzią na żądanie reklamy pod kluczem "ad_transparency_url". W tym przykładzie pobieramy adres URL przejrzystości reklamy z obiektu informacji o odpowiedzi:

Java 

nativeAd.getResponseInfo().getResponseExtras().getString("ad_transparency_url");

Kotlin 

nativeAd.getResponseInfo().responseExtras.getString("ad_transparency_url")

Sprawdź poprawność adresu URL

Aby przetestować i zweryfikować adres URL przejrzystości reklamy, sprawdź, czy w reklamie natywnej nie widzisz domyślnej ikony dostarczonej przez Google, ale swoją spersonalizowaną ikonę. Kliknij ikonę, aby wyświetlić środowisko AT&C.

Sprawdź też, czy w obiekcie informacji o odpowiedzi widzisz adres URL przejrzystości reklamy z odpowiedzi extras. Jeśli nie widzisz adresu URL przejrzystości reklamy, zamiast spersonalizowanej ikony wyświetli się domyślna ikona Google. Oto przykładowy adres URL przejrzystości reklam:

https://adssettings.google.com/whythisad?source=display&reasons=REASON_ID