Wywołanie adConfig() przekazuje bieżącą konfigurację gry do interfejsu Ad Placement API. Interfejs Ad Placement API może używać tych informacji do dostosowywania sposobu wstępnego wczytywania reklam i filtrowania typów reklam, o które wysyła żądania, tak aby były one odpowiednie (np. reklamy wideo wymagające dźwięku).
Podpis funkcji:
adConfig({
preloadAdBreaks: 'on|auto', // Ad preloading strategy
sound: 'on|off' // This game has sound
onReady: () => {}, // Called when API has initialised and adBreak() is ready
});
Parametry adConfig
Nazwa | Typ | Opis |
---|---|---|
sound |
ciąg znaków | (OPCJONALNIE) Czy gra odtwarza obecnie dźwięk. Wartości: – on (domyślna) – off Ten wywołanie określa, czy gra ma dźwięk i czy był on włączony (tzn. nie był wyciszony) przed wywołaniem funkcji adBreak() . Pomaga to interfejsowi Ad Placement API wybrać odpowiedni rodzaj reklamy do Twojej gry.Wywołuj tę funkcję, gdy tylko zmieni się stan dźwięku w grze, ponieważ interfejs Ad Placement API może potrzebować nowych kreacji, a to da mu maksymalną ilość czasu na ich pobranie. Wartość domyślna to dźwięk włączony. Dlatego większość gier będzie musiała wywołać funkcję adConfig() , gdy zacznie deklarować, że ma włączony dźwięk. |
preloadAdBreaks |
ciąg znaków | (OPCJONALNIE) Czy reklamy mają być zawsze wstępnie wczytywane przed pierwszym wywołaniem funkcji adBreak() . Wartości:- on - auto (domyślnie)Domyślna wartość auto pozostawia decyzję interfejsowi Ad Placement API. Wartość preloadAdBreaks można ustawić tylko raz za pomocą funkcji adConfig() , a dalsze wartości przekazywane do funkcji preloadAdBreaks nie mają żadnego wpływu.Ustawienie wartości preloadAdBreaks po pierwszym wywołaniu funkcji adBreak() nie ma żadnego wpływu. |
onReady |
ciąg znaków | (OPCJONALNIE) Wywoływana, gdy interfejs API zostanie zainicjowany i zakończy wstępne wczytywanie reklam (jeśli zostało ono przez Ciebie zażądane za pomocą parametru preloadAdBreaks powyżej). |