AdSense dla gier (AFG)

Krótki przewodnik techniczny (AFG)

Przewodnik dla początkujących przeznaczony dla inżynierów, którzy korzystają z pakietu Google IMA HTML5 SDK do wyświetlania reklam w grach internetowych w formacie HTML5 za pomocą AdSense dla gier.

Krótkie omówienie

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. 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ą obejmować zamknięcie konta.

Żądanie i renderowanie reklam poprzez pakiet IMA HTML5 SDK polega na skonfigurowaniu żądania reklamy, wczytaniu wynikowej reklamy i wyświetleniu jej we właściwym czasie. Testy można przeprowadzać, korzystając z domyślnych identyfikatorów wydawców ca-games-pub-4968145218643279. Przed wdrożeniem reklam w witrynie należy przedstawić menedżerowi konta przykład zastosowanej integracji kodu.

Opcje integracji

Prosta integracja

Najprostszą metodą integracji AdSense dla gier z grami HTML5 jest skorzystanie z opcji prostej integracji. To rozwiązanie, które można szybko wdrożyć, oferuje wszystkie funkcje i formaty reklam dostępne 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ść, taką jak niektóre funkcje dostępne w usłudze Google Ad Manager, ale jest również bardziej złożona.

Z poniższego opisu dowiesz się, jak zacząć korzystać z pakietu IMA HTML5 SDK przy opcji zaawansowanej integracji.

Pierwsze kroki z pakietem IMA HTML5 SDK – zaawansowana integracja

Aby zacząć korzystać z opcji zaawansowanej integracji, musisz zintegrować pakiet IMA HTML5 SDK z 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 by reklamy były poprawnie wyświetlane 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ą powszechnie używane do określania docelowych miejsc reklam w treści gry. Możesz na przykład namierzyć zdarzenie COMPLETE, aby dowiedzieć się, kiedy reklama skończy się odtwarzać, a następnie wyświetlić użytkownikowi treść gry. Pełna lista zdarzeń reklamowych jest dostępna w przewodniku po interfejsie API.

    Nazwa zdarzenia Tekst
    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.

Czy to było pomocne?
Jak możemy ją poprawić?