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.