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ść.
![Obraz przedstawiający ustawienia reklamy towarzyszącej w usłudze Ad Manager. Wyróżnia opcję rozmiarów kreacji towarzyszących.](https://developers.google.cn/static/interactive-media-ads/images/ad_manager_fluid_companion.png?authuser=9&hl=pl)
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.