Pakiet Google IMA SDK – najczęstsze pytania

Dlaczego nie otrzymuję reklam z wybranych formatów?
Testowe tagi reklam są skonfigurowane tak, aby zawsze zwracać reklamy w odpowiedzi na prawidłowe żądania. Ma to ułatwić integrację i pozwala sprawdzić, w jaki sposób odtwarzacz wysyła i renderuje reklamy. Reklamy nie zawsze są jednak dostępne w każdym formacie dla witryny, konta lub jednostki reklamowej. Jeśli integracja tagu testowego działa poprawnie, ale nie dotyczy Twojego tagu, przyczyna może być następująca:
  • Wyświetlasz w swoim środowisku filmy w nieobsługiwanym formacie. Załóżmy, że na urządzeniu z iOS lub Androidem wyświetlasz tylko reklamy HTML5.
  • Jeśli korzystasz z Ad Managera, Twój identyfikator wydawcy może nie być obecnie kierowany na żadne reklamy. Sprawdź też, czy zostały zatwierdzone odpowiednie reklamy i kreacje w usłudze Ad Manager.
  • Jeśli korzystasz z AdSense, kryteria kierowania witryny lub strony testowej mogą nie zawierać żadnych aktywnych reklam. Najczęstszą przyczyną jest korzystanie z prywatnych, niezindeksowanych stron.
  • Jeśli korzystasz z zarządzania partnerami sieci w Ad Exchange, a usługa descriptionURL nie jest skonfigurowana albo nie znajduje się na liście domen należących do lub obsługiwanych przez Google, reklamy nie będą się wyświetlać.
  • Sprawdź progi minCPM zdefiniowane w Ad Exchange Wideo. Zbyt wysoki CPM może spowodować bardzo niski współczynnik wypełnienia. Aby to skorygować, usuń wartość minCPM lub parametr jednostki reklamowej z żądania reklamy (czyli nazwę boksu), aby sprawdzić, czy ma to wpływ na współczynnik wypełnienia.
Jak wygląda dobry descriptionUrl?
Aby treść działała jak najlepiej, treść strony, na którą wskazuje descriptionUrl, nie powinna być zbiorem słów lub wyrażeń, ale powinna składać się z 1–3 akapitów. Jedną z metod, które sprawdzały się w przeszłości, jest łączenie zawartości strony descriptionUrl z predefiniowanych bloków. Na przykład kilka zdań o treści, kilka zdań o ofercie witryny, a potem kilka wstępnie zdefiniowanych fragmentów powiązanych z każdym kanałem AdSense (np. „Rozrywka” lub „Sport”). W rezultacie z każdym materiałem jest powiązana inna descriptionUrl, która zawiera zarówno informacje ogólne (np. deskryptory gatunku), jak i konkretne informacje (treści bezpośrednio).

Kod HTML metadanych powinien być prosty, na przykład:

<html>
  <head>
    <title>Domain.com - Your tag line here!</title>
  </head>
  <body>
    <h1>Descriptions</h1>
    <h2>About this Content</h2>
      <p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. ...</p>
    <h2>About Domain.com</h2>
      <p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. ...</p>
  </body>
</html>
Dlaczego widzę błąd „Odpowiedź reklamy nie zawiera prawidłowego typu reklamy”?
Ten błąd występuje zazwyczaj wtedy, gdy w danym okresie nie były kierowane żadne reklamy na określony adres publisherId. Stan ten może się zmieniać w ciągu dnia lub nawet w ciągu kilku dni od rozpoczęcia i zakończenia kampanii. Sprawdź, czy reklama, na którą chcesz kierować reklamy, nie straciła ważności i czy jej kryteria kierowania są prawidłowe. O ile żądania reklam są prawidłowo żądane, odbierane i renderowane za pomocą testu publisherId, możesz mieć pewność, że reklamy te wyświetlają się poprawnie, gdy są dostępne publisherId, gdy są dostępne.
Czy masz tag reklamy wideo Ad Managera, którego mogę użyć do testów?
Przykładowe tagi są dostępne na stronie przykładowe tagi.
Czy parametry adSlotWidth i adSlotHeight powinny być takie same jak sz w tagu reklamy Ad Managera?
Niekoniecznie. Właściwości adSlotWidth i adSlotHeight muszą być ustawione na szerokość lub wysokość odtwarzacza lub obszaru, w którym mają się pojawiać reklamy. Są one używane przez AdSense do określania, które reklamy pasują do danego miejsca. Para klucz-wartość sz w tagu reklamy Ad Managera to parametr kierowania, który nie zawsze musi wpływać na wyświetlaną kreację (więcej informacji znajdziesz poniżej).
Tag reklamy w wersji demonstracyjnej wygląda świetnie, ale po przejściu na nowy tag nie pojawia się żadna reklama.
Sprawdź, czy w żądanym tagu reklamy coś jest trafikowane. Najłatwiej jest to sprawdzić, używając ruchu HTTP. Jeśli w bloku kotwicy HTML zostanie zwrócony obraz szary piksel 1 x 1, musisz sprawdzić kierowanie w usłudze Ad Manager.
Chcę prosić o reklamy za pomocą tego samego tagu więcej niż raz, ale w pierwszej kolejności Jak rozwiązać ten problem?
Gdy zażądasz reklam więcej niż raz, musisz poinformować serwer reklam, że są to prawidłowe żądania, a nie przypadkowe duplikaty. Pakiet SDK udostępnia to 2 szybkie wywołania interfejsu API:
  1. Wywołaj destroy() w instancji AdsManager. Zapobiega to odtwarzaniu reklam po filmie podczas wykonywania poniższego wywołania do funkcji contentComplete(). Gdy wykonasz kolejną prośbę, otrzymasz nowe AdsManager.
  2. Wywołaj contentComplete() w swojej instancji AdsLoader. Spowoduje to zresetowanie pakietu SDK tak, aby nowe żądanie reklamy nie sprawiało wrażenia duplikatu poprzedniej.
Po wykonaniu 2 powyższych wywołań możesz wywołać metodę requestAds() w swoim wystąpieniu AdsLoader, aby uzyskać kolejny zestaw reklam do odtworzenia w nowym filmie.
Jak wysłać żądanie reklamy AdSense lub całego boksu reklamowego przy użyciu pakietu IMA SDK?

Aby wysyłać żądania reklam AdSense za pomocą pakietu SDK, musisz najpierw uzyskać tag reklamy AdSense. Więcej informacji na ten temat znajdziesz na stronie AdSense dla wideo. Po utworzeniu tagu musisz wykonać te czynności, by utworzyć nakładkę lub żądanie reklamy na cały boks:

Nakładki reklamowe
  1. W AdsRequest ustaw tryb widoku na NORMAL.
  2. W tagu reklamy dodaj parametr overlay=1.
Reklamy zajmujące cały boks reklamowy
  1. W AdsRequest ustaw tryb widoku na FULLSCREEN.
  2. W tagu reklamy dodaj parametr overlay=0.
Po kliknięciu reklamy pojawia się błąd „Nieprawidłowy docelowy URL” Co może być tego przyczyną?
Najczęstszą przyczyną tego błędu jest nieprawidłowy docelowy URL ze zmianą znaczenia. Jeśli zobaczysz ten błąd, sprawdź, czy w odpowiedzi VAST zawiera on odpowiednią zmianę znaczenia.
Dlaczego widzę błąd „Dokument VAST jest pusty”?
Ten błąd występuje, gdy tag reklamy zwraca pusty dokument VAST, który wskazuje, że reklama nie została prawidłowo wyświetlona. Skontaktuj się z menedżerem konta lub przedstawicielem serwera reklam, by dowiedzieć się, dlaczego Twój tag reklamy nie działa.
Czy mogę zmienić rozmiar/tekst pola Pomiń reklamę lub innych elementów interfejsu?
Pakiety IMA SDK nie obsługują zmiany układu, rozmiaru ani zawartości elementów interfejsu. Więcej informacji o elementach interfejsu znajdziesz w artykule AdsManager.uiElements.
Czy w pakiecie SDK HTML5 są obsługiwane natywne opcje wideo?
Nie. Pakiet HTML5 SDK nie obsługuje natywnych elementów sterujących.
W implementacji HTML5 wyświetla się komunikat „Nie udało się wykonać odtwarzania” w „HTMLMediaElement”: interfejs API może zostać zainicjowany tylko przez gest użytkownika. Jak rozwiązać ten problem?
Na urządzeniach mobilnych musisz wywołać metodę adDisplayContainer.initialize() w wyniku działania użytkownika (np. kliknięcia). Jeśli widzisz ten błąd, prawdopodobnie wywołujesz go w kontekście nieinicjowanym przez użytkownika. Pamiętaj, że musi to być bezpośrednie działanie użytkownika. Jeśli na przykład w trakcie odtwarzania filmu zareagujesz na zdarzenie „tap”, a następnie wywołasz zdarzenie initialize() odtwarzacza wideo, SDK zwróci ten błąd. W wyniku samego zdarzenia kliknięcia musisz wywołać initialize().
Co zrobić, gdy klawiatura skupia się na kliknięciach reklam?
Jeśli używasz w odtwarzaczu elementów sterujących klawiaturą, możesz zauważyć, że po kliknięciu adDisplayContainer nie będą już działać. Wynika to z tego, że po kliknięciu reklamy następuje przełączenie zaznaczenia klawiatury na element iframe IMA. Aby przenieść zaznaczenie na odtwarzacz treści, użyj zdarzenia CLICK, aby przenieść je z powrotem do wybranego kontenera. Więcej informacji znajdziesz w tym fragmencie kodu: 
adsManager.addEventListener(
      google.ima.AdEvent.Type.CLICK,
      function(){
        window.focus();
        // Or another method to return focus to the desired container.
      });