Dodawanie obsługi reklam towarzyszących

Ten przewodnik jest przeznaczony dla wydawców, którzy chcą dodać reklamy towarzyszące do implementacji pakietu IMA SDK na Androida.

Wymagania wstępne

• Aplikacja na Androida z zintegrowanym pakietem IMA SDK. Jeśli nie masz jeszcze aplikacji z zintegrowanym pakietem SDK, zapoznaj się z przykładem BasicExample. Jeśli potrzebujesz pomocy przy implementacji pakietu IMA SDK w aplikacji, przeczytaj artykuł Konfigurowanie pakietu IMA SDK.
• Tag reklamy skonfigurowany tak, aby zwracał reklamę towarzyszącą. Jeśli potrzebujesz przykładu, zapoznaj się z naszymi najczęstszymi pytaniami.

Dodawanie reklam towarzyszących do aplikacji

Postępuj zgodnie z instrukcjami, aby dodać boks reklamowy na reklamę towarzyszącą i wyświetlać reklamy towarzyszące w aplikacji.

Tworzenie elementu ViewGroup do wyświetlania reklamy towarzyszącej

Zanim poprosisz o reklamę towarzyszącą, musisz utworzyć dla niej miejsce w układzie. W pliku XML układu dodaj element ViewGroup. W tym przykładzie używamy elementu LinearLayout. W dalszym kroku przekażesz odwołanie do tego elementu do elementu AdDisplayContainer.

Jeśli integrujesz się z aplikacją BasicExample, dodaj ten kod do activity_my.xml pliku poniżej elementu videoPlayerContainer.

<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" />
companion_ad_slot_snippet.xml

Tworzenie elementu CompanionAdSlot

Następnym krokiem jest utworzenie obiektu CompanionAdSlot, który jest następnie dodawany do instancji ArrayList<CompanionAdSlot>. Interfejs AdDisplayContainer przyjmuje listę boksów reklamowych na reklamy towarzyszące, dzięki czemu możesz wyświetlać jednocześnie kilka reklam towarzyszących. Aby utworzyć obiekt CompanionAdSlot, musisz utworzyć instancję klasy ImaSdkFactory.

public void createCompanionAdSlot(ViewGroup companionViewGroup) {
  ImaSdkFactory sdkFactory = ImaSdkFactory.getInstance();
  CompanionAdSlot companionAdSlot = sdkFactory.createCompanionAdSlot(companionViewGroup);
  companionAdSlot.setSize(300, 250);
  ArrayList<CompanionAdSlot> companionAdSlots = new ArrayList<CompanionAdSlot>();
  companionAdSlots.add(companionAdSlot);
}
CompanionAdSnippets.java

Utwórz boks reklamowy na reklamę towarzyszącą dla każdego rozmiaru reklamy towarzyszącej, którą chcesz wyświetlać w aplikacji. Pakiet IMA SDK wypełnia boks reklamowy na reklamę towarzyszącą dowolnymi reklamami towarzyszącymi z odpowiedzi VAST, których wymiary odpowiadają wysokości i szerokości widoku. Pakiet IMA SDK obsługuje też reklamy towarzyszące o elastycznych rozmiarach. Gdy utworzysz element companionAdSlots, dodaj go do elementu AdsLoader. Poniższe przykłady pokazują, jak to zrobić, w zależności od tego, czy używasz rozszerzenia Exoplayer-IMA, czy innych implementacji IMA, które nie korzystają z rozszerzenia.

public void setCompanionAdSlotExoPlayer(
    Context context, ArrayList<CompanionAdSlot> companionAdSlots) {
  ImaAdsLoader adsLoader =
      new ImaAdsLoader.Builder(context).setCompanionAdSlots(companionAdSlots).build();
}
CompanionAdSnippets.java

public void setCompanionAdSlot(
    AdDisplayContainer adDisplayContainer, ArrayList<CompanionAdSlot> companionAdSlots) {
  adDisplayContainer.setCompanionSlots(companionAdSlots);
}
CompanionAdSnippets.java

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

Wyświetlanie reklam towarzyszących o elastycznych rozmiarach

Pakiet IMA SDK obsługuje reklamy towarzyszące o elastycznych rozmiarach. Te reklamy towarzyszące mogą zmieniać rozmiar, aby dopasować się do rozmiaru boksu reklamowego. Zajmują 100% szerokości widoku nadrzędnego, a następnie zmieniają wysokość, aby dopasować się do treści reklamy towarzyszącej. Ustawia się je za pomocą rozmiaru reklamy towarzyszącej Fluid w usłudze Ad Manager. Na ilustracji poniżej zobaczysz, gdzie ustawić tę wartość.

Aktualizowanie aplikacji na Androida pod kątem reklam towarzyszących o elastycznych rozmiarach

Możesz zadeklarować boks reklamowy na reklamę towarzyszącą o elastycznych rozmiarach, aktualizując metodę CompanionAdSlot.setSize() tak, aby przyjmowała CompanionAdSlot.FLUID_SIZE jako oba parametry.

companionAdSlot.setSize(CompanionAdSlot.FLUID_SIZE, CompanionAdSlot.FLUID_SIZE);
CompanionAdSnippets.java

Najczęstsze pytania

Postępowałem(-am) zgodnie z instrukcjami, ale nie widzę reklam towarzyszących. Co mam zrobić?

Najpierw sprawdź, czy tag rzeczywiście zwraca reklamy towarzyszące. Aby to zrobić, otwórz tag w przeglądarce i poszukaj tagu <CompanionAds>. Jeśli go znajdziesz, sprawdź, czy rozmiar zwracanej reklamy towarzyszącej jest taki sam jak wymiary przekazywane do obiektu CompanionAdSlot.

Jak będzie wyglądał boks reklamowy na reklamę towarzyszącą, gdy będę postępować zgodnie z tym przewodnikiem?

Obraz poniżej został utworzony na podstawie przykładu BasicExample . Na górze odtwarzany jest film, a pod nim wyświetla się reklama towarzysząca.