Konfigurowanie bezpośredniego dostępu do Ad Exchange

Wybierz platformę: Android iOS Android (starsza wersja)

Pakiet SDK do reklam mobilnych Google umożliwia zarabianie na aplikacjach za pomocą usługi Ad Exchange property. Z tego przewodnika dowiesz się, jak skonfigurować aplikacje pod kątem wszystkich formatów reklam obsługiwanych przez Ad Exchange.

Wymagania wstępne

Konfigurowanie aplikacji pod kątem dostępu do Ad Exchange

Dodaj identyfikator aplikacji Ad Managera (określony w interfejsie Ad Managera UI) do pliku AndroidManifest.xml aplikacji za pomocą tagu <meta-data> z atrybutem android:name="com.google.android.gms.ads.APPLICATION_ID". W polu android:value wpisz identyfikator aplikacji Ad Managera w cudzysłowie.

<manifest>
    <application>
        <!-- Sample Ad Manager app ID: ca-app-pub-3940256099942544~3347511713 -->
        <meta-data
            android:name="com.google.android.gms.ads.APPLICATION_ID"
            android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
    </application>
</manifest>

Pamiętaj też, że jeśli nie dodasz tagu <meta-data> w sposób opisany powyżej, aplikacja ulegnie awarii i wyświetli się komunikat:

Missing application ID.

Następnie możesz zainicjować pakiet SDK do reklam mobilnych Google i wybrać format reklamy do wyświetlenia. W dalszej części tego przewodnika zaimplementujemy format banera, aby pokazać, jak wczytać reklamę z Ad Exchange. Te same kroki można zastosować w przypadku wszystkich formatów reklam obsługiwanych przez pakiet SDK do reklam mobilnych Google.

Wczytywanie reklamy z Ad Exchange

Zamiast identyfikatora jednostki reklamowej możesz użyć kodu usługi internetowej Ad Exchange z ukośnikiem na końcu. Na przykład ca-mb-app-pub-5629679302779023/.

Poniższy przykład pokazuje, jak dodać kod usługi internetowej Ad Exchange do żądania reklamy banerowej:

Kotlin 

val adRequest = BannerAdRequest.Builder("ca-mb-app-pub-5629679302779023/", AdSize.BANNER).build()

BannerAd.load(
  adRequest,
  object : AdLoadCallback<BannerAd> {
    override fun onAdLoaded(ad: BannerAd) {
      bannerAd = ad
      activity?.runOnUiThread {
        binding.bannerViewContainer.addView(ad.getView(requireActivity()))
      }
    }
  }
)

Java 

BannerAdRequest adRequest = new BannerAdRequest.Builder("ca-mb-app-pub-5629679302779023/",
    AdSize.BANNER).build();

BannerAd.load(
    adRequest,
    new AdLoadCallback<BannerAd>() {
      @Override
      public void onAdLoaded(@NonNull BannerAd ad) {
        bannerAd = ad;
        runOnUiThread(
            () -> binding.bannerViewContainer.addView(ad.getView(MainActivity.this)));
      }
    });

Pamiętaj, że jeśli nie dodasz ukośnika na końcu kodu usługi internetowej Ad Exchange, żądanie reklamy zakończy się błędem z komunikatem:

Invalid Request. Cannot determine request type. Is your ad unit id correct?

Możesz też przekonwertować kod usługi internetowej Ad Exchange na jednostkę reklamową. Następnie użyj interfejsu Ad Managera, aby wygenerować tag Ad Exchange i skopiować go do aplikacji. Wygenerowany tag powinien zawierać kod usługi internetowej Ad Exchange, a następnie identyfikatory jednostek reklamowych podrzędnych bez ukośnika na końcu, np. ca-mb-app-pub-5629679302779023/banner.

To wszystko. Twoja aplikacja jest już gotowa do wczytywania i wyświetlania reklam banerowych z Ad Exchange.

Oprócz tego możesz użyć usługi internetowej Ad Exchange, aby wczytywać i wyświetlać inne formaty reklam z Ad Exchange. W tym celu postępuj zgodnie z odpowiednimi przewodnikami:

Dodawanie cen minimalnych (dotyczy tylko zatwierdzonych wydawców z Europy)

Możesz przesłać prośbę dotyczącą funkcji „Ceny minimalne”.

Po zatwierdzeniu możesz uwzględnić w żądaniu reklamy cenę minimalną publiczną lub prywatną, używając odpowiednio parametrów pubf i pvtf. W poniższym przykładzie kodu zastąp „123” cenami minimalnymi w częściach milionowych i walucie domyślnej sieci. Przykład zastosowania części milionowych: jeśli walutą domyślną jest USD, „6000000” to równowartość 6,00 USD.

Kotlin

val extras = Bundle();
// Public floor parameter.
extras.putString("pubf", "123");
// Private floor parameter.
extras.putString("pvtf", "123");

val request = AdRequest.Builder("ca-mb-app-pub-5629679302779023/")
    .setGoogleExtrasBundle(extras)
    .build();

Java 

Bundle extras = new Bundle();
// Public floor parameter.
extras.putString("pubf", "123");
// Private floor parameter.
extras.putString("pvtf", "123");

AdRequest request = new AdRequest.Builder("ca-mb-app-pub-5629679302779023/")
    .setGoogleExtrasBundle(extras)
    .build();