Reklamy towarzyszące

Ten przewodnik jest przeznaczony dla wydawców zainteresowanych dodaniem reklam towarzyszących do implementacji IMA Android.

Wymagania wstępne

• Aplikacja na Androida ze zintegrowanym pakietem IMA SDK. Jeśli nie masz jeszcze aplikacji ze zintegrowanym pakietem SDK, zapoznaj się z przykładem BasicExample.
• Tag reklamy skonfigurowany tak, by zwracać reklamę towarzyszącą.
  • Jeśli potrzebujesz próbki, przeczytaj odpowiedzi na najczęstsze pytania.

Przydatne podkłady

Jeśli musisz jeszcze zaimplementować pakiet IMA SDK w swojej aplikacji, przeczytaj nasz przewodnik dla początkujących.

Dodaj reklamy towarzyszące do swojej aplikacji

Utwórz grupę widoków, aby wyświetlać reklamę towarzyszącą

Zanim poprosisz o kreację towarzyszącą, musisz utworzyć dla niej pokój w swoim układzie. W pliku XML układu dodaj element ViewGroup. W tym przykładzie korzystamy z elementu LinearLayout. W późniejszym kroku podasz odwołanie do tego elementu do obiektu AdDisplayContainer. Jeśli integrujesz się z aplikacją BasicExample, dodaj ten adres do activity_my.xml pod nagłówkiem com.google.android.exoplayer2.ui.PlayerView.

activity_my.xml

<LinearLayout
  android:id="@+id/companionAdSlot"
  android:layout_width="match_parent"
  android:layout_height="250dp"
  android:layout_gravity="center_horizontal"
  android:gravity="center"
  android:orientation="vertical"
  android:textAlignment="center" />

Utwórz CompanionAdSlot

Następnym krokiem jest utworzenie obiektu CompanionAdSlot, który zostanie dodany do obiektu ArrayList<CompanionAdSlot>. AdDisplayContainer pobiera listę boksów reklam towarzyszących, aby umożliwić Ci wyświetlanie wielu reklam towarzyszących naraz. Aby utworzyć CompanionAdSlot, musisz utworzyć instancję ImaSdkFactory.

  ImaSdkFactory sdkFactory = ImaSdkFactory.getInstance();
  ViewGroup companionViewGroup = (ViewGroup) findViewById(R.id.companionAdSlot);

  CompanionAdSlot companionAdSlot = sdkFactory.createCompanionAdSlot();
  companionAdSlot.setContainer(companionViewGroup);
  companionAdSlot.setSize(300, 250);
  ArrayList<CompanionAdSlot> companionAdSlots = new ArrayList<CompanionAdSlot>();
  companionAdSlots.add(companionAdSlot);

Utwórz boks reklamy towarzyszącej dla każdego rozmiaru reklamy towarzyszącej, który chcesz wyświetlać w aplikacji. Pakiet IMA SDK wypełnia boks reklamy towarzyszącej wszelkimi reklamami towarzyszącymi z odpowiedzi VAST, które mają wymiary odpowiadające wysokości i szerokości widoku. Pakiet IMA SDK obsługuje też reklamy towarzyszące o rozmiarze elastycznym. Po utworzeniu companionAdSlots trzeba je dodać do AdsLoader. Poniższe przykłady pokazują, jak to zrobić w zależności od tego, czy używasz IMA Android BasicExample, który korzysta z rozszerzenia Exoplayer-IMA, czy innych implementacji IMA, które nie korzystają z tego rozszerzenia.

BasicExample

adsLoader = new ImaAdsLoader.Builder(this).setCompanionAdSlots(companionAdSlots).build();

Inne implementacje

adsLoader.getAdDisplayContainer().setCompanionSlots(companionAdSlots);

To już wszystko. Twoja aplikacja wyświetla teraz reklamy towarzyszące.

Elastyczna reklama towarzysząca w sieci reklamowej

IMA obsługuje teraz elastyczne reklamy towarzyszące. Rozmiar takich reklam towarzyszących może zmieniać się w zależności od rozmiaru boksu reklamowego. Zapełniają 100% szerokości widoku elementu nadrzędnego, a potem zmieniają wysokość, by pasowały do zawartości kreacji towarzyszącej. Aby je ustawić, użyj rozmiaru kreacji towarzyszącej Fluid w usłudze Ad Manager. Na ilustracji poniżej zobaczysz, gdzie ustawić tę wartość.

Aktualizowanie aplikacji na Androida na potrzeby płynnych kreacji towarzyszących

Możesz zadeklarować elastyczny boks towarzyszący, aktualizując metodę CompanionAdSlot.setSize(), tak aby przyjmowała CompanionAdSlot.FLUID_SIZE jako oba parametry.

  ImaSdkFactory sdkFactory = ImaSdkFactory.getInstance();
  ViewGroup companionViewGroup = (ViewGroup) findViewById(R.id.companionAdSlot);

  CompanionAdSlot companionAdSlot = sdkFactory.createCompanionAdSlot();
  companionAdSlot.setContainer(companionViewGroup);
  companionAdSlot.setSize(CompanionAdSlot.FLUID_SIZE, CompanionAdSlot.FLUID_SIZE);
  ArrayList<CompanionAdSlot> companionAdSlots = new ArrayList<CompanionAdSlot>();
  companionAdSlots.add(companionAdSlot);

Najczęstsze pytania

Mimo wykonania instrukcji z przewodnika nie widzę reklam towarzyszących. Co mam zrobić?

Najpierw sprawdź, czy tag naprawdę zwraca kreacje towarzyszące. Aby to zrobić, otwórz ten tag w przeglądarce i wyszukaj tag CompanionAds. W takim przypadku sprawdź, czy rozmiar zwracanej kreacji towarzyszącej jest taki sam jak wymiary przesyłane do obiektu CompanionAdSlot.

Jak będzie wyglądać boks reklamy towarzyszącej, gdy postępujemy zgodnie z tym przewodnikiem?

Poniższy obraz został utworzony na podstawie podstawowego przykładu , a powyższy film jest odtwarzany z reklamą towarzyszącą poniżej.