Reklamy towarzyszące

Ten przewodnik jest przeznaczony dla wydawców zainteresowanych dodawaniem reklam towarzyszących do na potrzeby implementacji reklam IMA w Androidzie.

Wymagania wstępne

• Aplikacja na Androida ze zintegrowanym pakietem IMA SDK. Zapoznaj się z BasicExample, jeśli nie masz jeszcze aplikacji ze zintegrowanym pakietem SDK;
• Tag reklamy skonfigurowany tak, by zwracać reklamę towarzyszącą.
  • Jeśli potrzebujesz próbki, zapoznaj się z najczęstszymi pytaniami.

Przydatne materiały

Jeśli nadal musisz wdrożyć w aplikacji pakiet IMA SDK, zapoznaj się z artykułem Pobierz Uruchomiony przewodnik

Dodawanie reklam towarzyszących do aplikacji

Utwórz grupę widoków, by wyświetlić element towarzyszący

Zanim poprosisz o kreację towarzyszącą, musisz utworzyć dla niej pokój w układ. W pliku XML układu dodaj element ViewGroup. w tym W przykładzie użyto LinearLayout. W jednym z późniejszych kroków prześlesz odniesienie do tego elementu w AdDisplayContainer. Jeśli w aplikacji BasicExample, dodaj to do activity_my.xml poniżej sekcji 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 boks reklamowy towarzyszącego

Następnym krokiem jest utworzenie obiektu CompanionAdSlot, który jest a potem dodano do: ArrayList<CompanionAdSlot>. AdDisplayContainer pobiera listę boksów reklam towarzyszących, dzięki czemu możesz wyświetlanie wielu reklam towarzyszących jednocześnie. Musisz utworzyć instancję ImaSdkFactory, aby utworzyć CompanionAdSlot.

  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 kreacji towarzyszącej, którą chcesz wyświetlać w aplikacji. Pakiet IMA SDK wypełnia boks reklamy towarzyszącej reklamami towarzyszącymi z odpowiedzi VAST, która mieć wymiary pasujące do wysokości i szerokości widoku. Pakiet IMA SDK pozwala też korzystać z pakietu elastycznych kreacji towarzyszących. Po utworzeniu companionAdSlots trzeba je dodać do AdsLoader W przykładach poniżej pokazujemy, jak to zrobić w zależności od tego, czy używają IMA Android BasicExample, który korzysta z rozszerzenie Exoplayer-IMA, lub inne implementacje IMA, które nie korzystają z rozszerzenia.

BasicExample

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

Inne implementacje

adsLoader.getAdDisplayContainer().setCompanionSlots(companionAdSlots);

To już wszystko. Aplikacja wyświetla teraz aplikację towarzyszącą reklam.

Wyświetlanie elastycznych reklam towarzyszących

IMA obsługuje teraz elastyczne reklamy towarzyszące. Te reklamy towarzyszące mogą zmieniać rozmiar, dopasowując się do rozmiaru reklamy gniazdo. Wypełniają one 100% szerokości widoku nadrzędnego, a następnie zmieniają wysokość, aby dopasować ją do obrazu towarzyszącego treści. Są one ustawiane przy użyciu Fluid rozmiaru kreacji towarzyszącej w usłudze Ad Manager. Zobacz na poniższej ilustracji, gdzie ustawić tę wartość.

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

Elastyczny boks towarzyszący możesz zadeklarować, aktualizując CompanionAdSlot.setSize() metoda pobierania CompanionAdSlot.FLUID_SIZE .

  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

Zgodnie z instrukcją nie widzę reklam towarzyszących. Co mam zrobić?

Najpierw sprawdź, czy Twój tag naprawdę zwraca kreacje towarzyszące. Do zrobienia otwórz tag w przeglądarce i poszukaj tagu CompanionAds. Jeśli zobaczysz komunikat i upewnij się, że rozmiar zwracanego elementu towarzyszącego jest taki sam jako wymiarów przesyłanych do parametru CompanionAdSlot. .

Jak będzie wyglądać mój boks reklamy towarzyszącej, jeśli zastosujesz się do tego przewodnika?

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