Wszystkie wywołania adBreak() muszą określać typ miejsca docelowego. Jest to ciąg tekstowy opisujący stan gry, w której ma się wyświetlać reklama. Czy gra się właśnie wczytuje? Czy gracz wstrzymał grę? A może udało mu się dotrzeć do punktu w grze, który może otrzymać nagrodę?
Dokładne typy, których używasz, są bardzo ważne. Może to mieć bezpośredni wpływ na rodzaj wyświetlanych reklam (pełnoekranowa lub z nagrodą). Może to jednak mieć także inne, mniej widoczne wpływ na zachowanie interfejsu API. Ważne jest, aby typ miejsca docelowego został określony we właściwy sposób. Dzięki temu interfejs API będzie działać optymalnie.
| Typ miejsca docelowego | Opis |
|---|---|
'preroll' |
Gra nie wczytała interfejsu i nie odtwarza dźwięku. W każdym wczytaniu strony może występować tylko jedno miejsce docelowe przed filmem. Przykład: gracz klika grę w katalogu gier. Wyświetla się obszar roboczy gry i przed wyrenderowaniem interfejsu lub włączeniem dźwięku w reklamie. Gracz może kliknąć reklamę lub zamknąć ją w momencie rozpoczęcia gry. |
'start' |
Gra się wczytała, interfejs jest widoczny, dźwięk jest włączony, gracz może wchodzić w interakcję z grą, ale gra się jeszcze nie rozpoczęła. Przykład: zobaczysz krótki ekran wczytywania i wyświetla się reklama pełnoekranowa. Gracz może kliknąć reklamę lub zamknąć ją, aby przejść do gry. UWAGA: działanie w polu preroll wymaga trochę więcej niż Ty, bo start. preroll czeka na zainicjowanie przez interfejs API i automatyczne wczytanie reklam. W przypadku pierwszej reklamy, która wyświetla się podczas wczytywania gry, należy użyć interfejsu preroll zamiast start. Pole start jest lepszym miejscem docelowym po wyrenderowaniu interfejsu, gdy gracz może wejść w interakcję z grą.Z gry start można też korzystać podczas ponownego uruchamiania gry – po wczytaniu strony może być wiele miejsc docelowych (start). Jeśli miejsce docelowe start jest pierwszym miejscem docelowym w grze (tzn. nie używasz miejsca docelowego preroll), może być konieczne ręczne przesłanie próśb o wczytanie reklam. |
'pause' |
Gracz wstrzymuje grę. Przykład: gracz wstrzymuje grę i wyświetla się reklama pełnoekranowa. Reklama pozostaje na ekranie do czasu, aż odtwarzacz ją zamknie. Gdy to zrobi, gra zostanie wstrzymana. Gracz może wtedy wznowić grę i kontynuować grę. |
'next' |
Gracz przechodzi na kolejny poziom. Przykład: gracz właśnie ukończył poziom. Użytkownik klika przycisk „Następny poziom...” wyświetla się reklama pełnoekranowa. Wyświetlą się, zamkną reklamę i przejdą na kolejny poziom. |
'browse' |
Gracz analizuje opcje spoza rozgrywki. Przykład: gracz chce zmienić styl swojej postaci. Kliknięcie przycisku „Opcje...” powoduje wyświetlenie reklamy pełnoekranowej. Użytkownik zobaczy reklamę, zamknie ją i przejdzie do edytora znaków. |
'reward' |
Gracz osiąga punkt, w którym może zostać zaproponowana nagroda. Przykład: gracz po prostu zginął i zakończył życie. Jeśli widzowie zobaczą reklamę, mogą otrzymać dodatkowe korzyści w tym miejscu. Interfejs Ad Placement API uruchamia kod, aby oferować nagrodę graczowi. Klika przycisk przycisku i ogląda całą reklamę wideo. Potem mogą zacząć nowe życie i grać dalej. |
Uwaga: ten typ miejsc docelowych to obszar aktywny.
Jeśli w grze masz miejsca docelowe, które nie pasują do żadnej z tych kategorii, poinformuj o tym swojego menedżera konta Google, a wykorzystamy je, aby z czasem ulepszyć te kategorie.