Krótki przewodnik techniczny (AFG)

Z tego przewodnika dowiesz się, jak zintegrować pakiet IMA HTML5 SDK firmy Google z grami internetowymi HTML5, aby wyświetlać w nich reklamy za pomocą AdSense.

Omówienie konfiguracji technicznej

AdSense dla gier funkcjonuje na podstawie pakietu Interactive Media Ads Software Development Kit (IMA HTML5 SDK) firmy Google. Umożliwia on kodowanie żądań reklam AdSense za pomocą języka JavaScript, aby lepiej dopasowywać treści i reklamy.

Uwaga: usługi te podlegają Warunkom korzystania z AdSense, Zasadom programu AdSense i szczegółowym wskazówkom dotyczącym korzystania z naszych usług. Pamiętaj, że niezamierzone kliknięcia będące efektem zbyt natarczywej lub nieprawidłowej implementacji spowodują podjęcie stosownych działań, które mogą doprowadzić nawet do zamknięcia konta.

Aby wysyłać żądania i renderować reklamy za pomocą pakietu IMA HTML5 SDK, skonfiguruj żądanie reklamy, wczytaj wynikową reklamę i wyświetl ją we właściwym czasie. Przetestuj integrację za pomocą domyślnego identyfikatora wydawcy ca-games-pub-4968145218643279.

Pamiętaj, że przed wdrożeniem reklam w witrynie musisz przedstawić menedżerowi konta przykład zastosowanej integracji kodu.

Dostępne są 2 opcje integracji: prosta i zaawansowana.

Prosta integracja

Prosta integracja to najłatwiejszy sposób integracji AdSense dla gier z grami HTML5. Stanowi ona szybkie rozwiązanie wdrożeniowe, które udostępnia wszystkie funkcje i formaty reklam występujące w AdSense dla gier.

Jeśli jesteś wydawcą i chcesz skorzystać z opcji prostej integracji, zgłoś zainteresowanie.

Zaawansowana integracja

Wydawcy, którzy potrzebują bardziej zaawansowanej i niestandardowej integracji, powinni wdrożyć w grze HTML5 pełny pakiet IMA HTML5 SDK. Ta opcja zapewnia dodatkową elastyczność, np. niektóre funkcje dostępne w usłudze Google Ad Manager, ale jest też bardziej złożona.

Rozpoczęcie zaawansowanej integracji

Na początek zintegruj pakiet IMA HTML5 SDK ze swoją grą.

1. Skonfiguruj integrację pakietu IMA HTML5 SDK

   Aby zintegrować pakiet IMA HTML5 SDK z grą, wykonaj instrukcje podane w witrynie Google Developers. Znajdziesz tam informacje o pierwszych krokach wraz z przykładowym kodem do pobrania oraz pełny przewodnik po interfejsie API.

2. Skonfiguruj kontener reklam (AdDisplayContainer)

   Pakiet IMA HTML5 SDK jest przeznaczony zarówno dla wydawców wideo, jak i gier, dlatego obiekt AdDisplayContainer można skonfigurować na wiele sposobów.

   Podczas konfigurowania obiektu AdDisplayContainer do stosowania z AdSense dla gier po prostu przekaż odwołanie do elementu div zawierającego reklamę.

   Przykład:

   var adDisplayContainer = new google.ima.AdDisplayContainer(document.getElementById('adContainer'));

3. Skonfiguruj żądanie reklamy (AdsRequest)

   Podczas tworzenia obiektu AdsRequest musisz zadbać o właściwą konfigurację odpowiednich parametrów i usług, tak aby reklamy były prawidłowo zwracane i renderowane.

   Przykład:

   // Żądanie reklam AdSense dla gier.
var adsRequest = new google.ima.AdsRequest();
 
// Konfigurowanie tagu reklamy AdSense dla gier
adsRequest.adTagUrl = 'https://googleads.g.doubleclick.net/pagead/ads?ad_type=video_image_text&client=ca-games-pub-4968145218643279&videoad_start_delay=0&description_url=http%3A%2F%2Fwww.google.com&max_ad_duration=20000&adtest=on';
 
// Wymuszanie renderowania reklam graficznych/tekstowych w interfejsie pełnego boksu reklamowego
adsRequest.forceNonLinearFullSlot = true;
 
// Określanie liniowych i nieliniowych rozmiarów boksów.
adsRequest.linearAdSlotWidth = {szerokość_Twojej_gry};
adsRequest.linearAdSlotHeight = {wysokość_Twojej_gry};
adsRequest.nonLinearAdSlotWidth = {szerokość_Twojej_gry};
adsRequest.nonLinearAdSlotHeight = {wysokość_Twojej_gry};

4. Zidentyfikuj odpowiednie zdarzenia i utwórz wywołania zwrotne

   Wychwycenie zdarzeń uruchamianych w pakiecie IMA SDK pozwoli Ci określić, kiedy przestać wyświetlać reklamę i pozwolić użytkownikom kontynuować grę.

   Poniżej znajdują się niektóre zdarzenia reklamowe, które są zwykle używane do określania w treści gry docelowych miejsc reklam. Możesz np. wychwycić zdarzenie COMPLETE, aby dowiedzieć się, kiedy reklama skończy się odtwarzać, a potem wyświetlić użytkownikowi treść gry. Pełna lista zdarzeń reklamowych jest dostępna w przewodniku po interfejsie API.

   Nazwa zdarzenia	Opis
   AdEvent.Type.CLICK	Uruchamiane po kliknięciu reklamy.
   AdEvent.Type.COMPLETE	Uruchamiane po zakończeniu odtwarzania reklamy.
   AdEvent.Type.LOADED	Uruchamiane, gdy są dostępne dane o reklamie.
   AdEvent.Type.SKIPPED	Uruchamiane, gdy użytkownik pominie reklamę.
   AdEvent.Type.START	Uruchamiane, gdy reklama zacznie się odtwarzać.
   AdEvent.Type.USER_CLOSE	Uruchamiane, gdy reklama zostanie zamknięta przez użytkownika.
   AdErrorEvent.Type.AD_ERROR	Uruchamiane, gdy wystąpi błąd reklamy. Istnieje wiele różnych rodzajów błędów reklamy, np. niewczytanie zasobu medialnego reklamy lub zwracanie pustych reklam w odpowiedzi na żądania reklamy. Lista możliwych błędów jest dostępna w przewodniku po interfejsie API.