Pakiety IMA SDK ułatwiają integrację reklam multimedialnych z witrynami i aplikacjami. Pakiety IMA SDK mogą wysyłać żądania reklam do dowolnego serwera reklam zgodnego z VAST i zarządzać odtwarzaniem reklam w aplikacjach. Za pomocą pakietów IMA DAI SDK aplikacje wysyłają żądanie strumienia reklamy i treści wideo – VOD lub treści na żywo. Pakiet SDK zwraca wtedy połączony strumień wideo, dzięki czemu nie musisz zarządzać przełączaniem między reklamą a treściami wideo w aplikacji.
Wybierz interesujące Cię rozwiązanie DAI
Wyświetlanie bloków reklamowych w ramach dynamicznego wstawiania reklam
Ten przewodnik zawiera informacje o integrowaniu pakietu IMA DAI SDK z aplikacją odtwarzacza wideo. Jeśli chcesz wyświetlić gotową przykładową integrację lub ją prześledzić, pobierz z GitHubu PodServingExample.
Omówienie IMA DAI
Implementacja IMA DAI obejmuje 4 główne komponenty pakietu SDK, co pokazano w tym przewodniku:
IMAAdDisplayContainer– obiekt kontenera, który znajduje się nad elementem odtwarzania wideo i zawiera elementy interfejsu reklam.IMAAdsLoader– obiekt, który wysyła żądania strumieni i obsługuje zdarzenia wywoływane przez obiekty odpowiedzi na żądanie strumienia. Należy utworzyć tylko jeden moduł wczytywania reklam, który można ponownie wykorzystywać przez cały okres działania aplikacji.IMAStreamRequest–IMAPodVODStreamRequestlubIMAPodStreamRequest.IMAStreamManager– Obiekt, który obsługuje strumienie dynamicznego wstawiania reklam i interakcje z backendem DAI. Menedżer strumienia obsługuje też pingi śledzące i przesyła zdarzenia strumienia i reklamy do wydawcy.
Aby odtwarzać strumienie z reklamami w formie zasobników, zaimplementuj niestandardowy moduł obsługi VTP. Ten niestandardowy moduł obsługi VTP wysyła identyfikator strumienia do partnera technicznego ds. wideo (VTP) wraz z wszelkimi innymi informacjami, których potrzebuje on do zwrócenia manifestu strumienia zawierającego zarówno treści, jak i połączone reklamy. Dostawca platformy VTP podaje instrukcje dotyczące implementacji niestandardowego modułu obsługi VTP.
Wymagania wstępne
Zanim zaczniesz, musisz mieć:
- Xcode 13 lub nowszy
- Metoda instalacji pakietu IMA SDK:
- Swift Package Manager (zalecane)
- CocoaPods
- Kopia do pobrania pakietu IMA SDK na iOS
Parametry są też potrzebne do wysyłania żądań strumienia z pakietu IMA SDK.
| Parametry transmisji na żywo | |
|---|---|
| Kod sieci |
Kod sieci na koncie Ad Managera 360. |
| Niestandardowy klucz pliku |
Niestandardowy klucz zasobu, który identyfikuje zdarzenie wyświetlania zasobów w usłudze Ad Manager 360. Tworzy go manipulator plików manifestu lub zewnętrzny partner ds. wyświetlania bloków reklamowych. |
| Parametry strumienia VOD | |
| Kod sieci |
Kod sieci na koncie Ad Managera 360. |
Tworzenie nowego projektu Xcode
W Xcode utwórz nowy projekt iOS w Objective-C o nazwie „PodServingExample”.
Dodawanie pakietu IMA DAI SDK do projektu w Xcode
Aby zainstalować pakiet IMA SDK, wybierz preferowaną metodę.
Zalecane: instalowanie pakietu SDK za pomocą menedżera pakietów Swift
Pakiet SDK do wyświetlania interaktywnych reklam medialnych obsługuje Swift Package Manager od wersji 3.18.4. Aby zaimportować pakiet Swift, wykonaj te czynności.
W Xcode zainstaluj pakiet Swift IMA DAI SDK: kliknij kolejno File > Add Packages (Plik > Dodaj pakiety).
W wyświetlonym wierszu polecenia wyszukaj repozytorium pakietu IMA DAI SDK Swift Package w GitHubie:
https://github.com/googleads/swift-package-manager-google-interactive-media-ads-iosWybierz wersję pakietu IMA DAI SDK Swift Package, której chcesz używać. W przypadku nowych projektów użyj opcji Do następnej wersji głównej.
Gdy skończysz, Xcode przetworzy zależności pakietu i pobierze je w tle. Więcej informacji o dodawaniu zależności pakietów znajdziesz w artykule Apple.
Instalowanie pakietu IMA DAI SDK za pomocą CocoaPods
CocoaPods to menedżer zależności dla projektów Xcode, który służy do instalowania pakietu IMA DAI SDK. Więcej informacji o instalowaniu i używaniu CocoaPods znajdziesz w dokumentacji CocoaPods. Po zainstalowaniu CocoaPods wykonaj te instrukcje, aby zainstalować pakiet IMA DAI SDK:
W tym samym katalogu, w którym znajduje się plik PodServingExample.xcodeproj, utwórz plik tekstowy o nazwie Podfile i dodaj tę konfigurację:
W katalogu zawierającym plik Podfile uruchom:
pod install --repo-update
Ręczne pobieranie i instalowanie pakietu SDK
Jeśli nie chcesz używać menedżera pakietów Swift, pobierz i ręcznie dodaj do projektu pakiet IMA SDK.
Tworzenie prostego odtwarzacza wideo
Zaimplementuj odtwarzacz wideo w głównym kontrolerze widoku; umieść odtwarzacz AV w widoku interfejsu. Pakiet IMA SDK używa widoku interfejsu do wyświetlania elementów interfejsu reklamy.
Objective-C
Swift
Zainicjuj moduł wczytywania reklam.
Zaimportuj pakiet IMA SDK do kontrolera widoku i zaimplementuj protokoły
IMAAdsLoaderDelegate
i
IMAStreamManagerDelegate
do obsługi zdarzeń modułu wczytywania reklam i menedżera strumienia.
Dodaj te prywatne właściwości, aby przechowywać kluczowe komponenty pakietu IMA SDK:
IMAAdsLoader– zarządza żądaniami strumieniowania przez cały okres działania aplikacji.IMAAdDisplayContainer– obsługuje wstawianie elementów interfejsu użytkownika reklam i zarządzanie nimi.IMAAVPlayerVideoDisplay– komunikuje się między pakietem IMA SDK a odtwarzaczem multimediów i obsługuje metadane czasowe.IMAStreamManager– zarządza odtwarzaniem strumienia i uruchamia zdarzenia związane z reklamami.
Po wczytaniu widoku zainicjuj moduł wczytywania reklam, kontener wyświetlania reklam i wyświetlanie wideo.
Objective-C
Swift
Tworzenie żądania strumienia
Gdy użytkownik naciśnie przycisk odtwarzania, wyślij nowe żądanie strumienia.
Użyj klasy
IMAPodStreamRequest
w przypadku transmisji na żywo. W przypadku strumieni VOD użyj klasy IMAPodVODStreamRequest.
Żądanie strumienia wymaga parametrów strumienia, a także odwołania do kontenera wyświetlania reklam i wyświetlania wideo.
Objective-C
Swift
Nasłuchiwanie zdarzeń wczytywania strumienia
Klasa IMAAdsLoader wywołuje metody IMAAdsLoaderDelegate po udanej inicjalizacji lub niepowodzeniu żądania strumienia.
W metodzie delegata adsLoadedWithData ustaw IMAStreamManagerDelegate.
Przekaż identyfikator strumienia do niestandardowego modułu obsługi VTP i pobierz adres URL manifestu strumienia. W przypadku transmisji na żywo wczytaj adres URL pliku manifestu do wyświetlacza wideo i rozpocznij odtwarzanie. W przypadku strumieni VOD przekaż adres URL pliku manifestu do metody loadThirdPartyStream menedżera strumieni. Ta metoda wysyła do Ad Managera 360 żądanie danych o zdarzeniach związanych z reklamami, a następnie wczytuje adres URL pliku manifestu i rozpoczyna odtwarzanie.
W metodzie delegata
failedWithErrorData
zapisz błąd w dzienniku. Opcjonalnie możesz odtworzyć strumień zapasowy. Zobacz sprawdzone metody DAI.
Objective-C
Swift
Wdrażanie niestandardowego modułu obsługi VTP
Niestandardowy moduł obsługi VTP wysyła identyfikator strumienia widza do Twojego partnera technicznego ds. wideo (VTP) wraz z wszelkimi innymi informacjami, których VTP potrzebuje do zwrócenia manifestu strumienia zawierającego zarówno treści, jak i połączone reklamy. Platforma VTP zawiera szczegółowe instrukcje dotyczące implementacji niestandardowego modułu obsługi VTP.
Na przykład szablon VTP może zawierać adres URL szablonu manifestu z makrem [[STREAMID]]. W tym przykładzie moduł obsługi wstawia identyfikator strumienia w miejsce makra i zwraca wynikowy adres URL pliku manifestu.
Objective-C
Swift
Nasłuchiwanie zdarzeń reklamowych
IMAStreamManager wywołuje metody IMAStreamManagerDelegate, aby przekazywać zdarzenia strumieniowe i błędy do aplikacji.
W tym przykładzie zaloguj w konsoli główne zdarzenia reklamy:
Objective-C
Swift
Zwalnianie miejsca na komponenty IMA DAI
Aby zatrzymać odtwarzanie strumienia, zatrzymać śledzenie reklam i zwolnić wszystkie załadowane komponenty strumienia, wywołaj funkcję IMAStreamManager.destroy().
Uruchom aplikację. Jeśli się to uda, za pomocą pakietu IMA SDK poproś o strumienie Google DAI i je odtwórz. Więcej informacji o zaawansowanych funkcjach pakietu SDK znajdziesz w innych przewodnikach na pasku bocznym po lewej stronie lub w przykładach na GitHubie.