Dodawanie obsługi reklam towarzyszących

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

Wymagania wstępne

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

Dodawanie reklam towarzyszących do aplikacji

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

Tworzenie obiektu 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żyto elementu LinearLayout. W późniejszym kroku przekażesz odwołanie do tego elementu do AdDisplayContainer.

Jeśli przeprowadzasz integrację z aplikacją BasicExample, dodaj to do pliku activity_my.xml poniżej 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

Utwórz CompanionAdSlot

Następnym krokiem jest utworzenie obiektu CompanionAdSlot, który jest następnie dodawany do instancji ArrayList<CompanionAdSlot>. Interfejs AdDisplayContainer pobiera listę boksów reklam towarzyszących, dzięki czemu możesz wyświetlać wiele reklam towarzyszących jednocześnie. 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 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 reklamami towarzyszącymi z odpowiedzi VAST, których wymiary odpowiadają wysokości i szerokości widoku. Pakiet IMA SDK obsługuje też elastyczne reklamy towarzyszące. Po utworzeniu companionAdSlots dodaj je do 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 tego 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 elastycznych reklam towarzyszących

IMA obsługuje elastyczne reklamy towarzyszące. Rozmiar tych reklam towarzyszących można zmieniać, aby dopasować go do rozmiaru boksu reklamowego. Wypełniają 100% szerokości widoku nadrzędnego, a następnie zmieniają wysokość, aby dopasować ją do treści reklamy towarzyszącej. Są one ustawiane za pomocą rozmiaru reklamy towarzyszącej Fluid w usłudze Ad Manager. Na obrazie poniżej pokazano, gdzie ustawić tę wartość.

Aktualizowanie aplikacji na Androida pod kątem płynnych reklam towarzyszących

Możesz zadeklarować elastyczny boks towarzyszący, 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ępuję zgodnie z instrukcjami, ale nie widzę reklam towarzyszących. Co mam zrobić?

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

Jak będzie wyglądać boks reklamy towarzyszącej, jeśli będę postępować zgodnie z tym przewodnikiem?

Poniższy obraz został utworzony na podstawie BasicExample i zawiera odtwarzany film u góry oraz reklamę towarzyszącą u dołu.