Parametry wymagane w przypadku aplikacji

W przypadku opartego na tagach rozwiązania Video Solutions do obsługi żądań z Ad Exchange wdrażanie bez użycia pakietu IMA SDK jest w wersji beta i może być niedostępne w Twojej sieci. Aby dowiedzieć się więcej, skontaktuj się ze swoim menedżerem konta.

Poniżej znajdziesz podzbiór parametrów adresu URL tagu reklamy VAST. Te parametry są wymagane w przypadku opartych na tagach rozwiązań Video Solutions dla aplikacji, gdy pakiet IMA SDK nie jest zintegrowany.

Zobacz listę parametrów wymaganych w przypadku stron internetowych lub parametrów zalecanych w przypadku zautomatyzowanych rozwiązań do generowania przychodu.

Przejdź do konkretnego parametru na liście

an correlator description_url env gdfp_req idtype

is_lat iu msid output pvid pvid_s

rdid sz unviewed_position_start url wta

 

Parametr	Szczegóły
correlator (Korelator)	Parametr korelatora może mieć wartość zmienną, która jest używana przez różne żądania pochodzące z tego samego wyświetlenia strony. Ten parametr służy do stosowania wykluczeń konkurencji, także w środowiskach nieobsługujących plików cookie. Jeśli używasz pakietu IMA SDK, wartość korelatora jest ustawiana automatycznie. Jeśli odtwarzacz próbuje określić tę wartość, pakiet SDK zastępuje ją i ustawia własną wartość. Jeśli nie używasz pakietu IMA SDK, ustaw tę wartość na prawdziwie losową całkowitą liczbę dodatnią. Nie może ona być wykorzystywana ponownie w wielu wyświetleniach strony. Przykład zastosowania correlator=4345645667 Wymaganie Wymagany w przypadku stron internetowych i aplikacji.  Zalecany w przypadku zautomatyzowanych rozwiązań do generowania przychodu.
description_url (Adres URL opisu)	Parametr adresu URL opisu może mieć wartość zmienną, która powinna opisywać film odtwarzany na stronie. Zwykle jest to strona z odtwarzaczem, ale może to być też strona z tekstem opisującym film. Wartość parametru description_url musi być zakodowana w postaci adresu URL w przypadku odtwarzaczy na stronach i urządzeń CTV/OTT, a niezakodowana w przypadku odtwarzaczy w aplikacjach mobilnych. Ten parametr nie jest ustawiany automatycznie przez pakiet IMA SDK. Należy go ustawić ręcznie. Przykład zastosowania Z zakodowanym adresem URL: description_url= https%3A%2F%2Fwww.sample.com%2Fgolf.html Bez kodowania: description_url= https://www.sample.com/golf.html Wymaganie  Wymagany w przypadku stron internetowych, aplikacji i Ad Exchange.  Zalecany w przypadku zautomatyzowanych rozwiązań do generowania przychodu.
env (Środowisko)	Parametr środowiska może mieć wartość stałą, która wskazuje, że żądanie jest typu In-Stream lub że pochodzi tylko z odtwarzacza wideo. Możliwe wartości to instream (do używania w przypadku reklam wideo i reklam audio) lub vp (do używania tylko w przypadku reklam wideo). Przykład zastosowania Reklamy wideo lub reklamy audio: env=instream Tylko reklamy wideo: env=vp Wymaganie  Wymagany w przypadku stron internetowych i aplikacji.
gdfp_req (Wskaźnik schematu Ad Managera)	Parametr wskaźnika schematu Ad Managera może mieć wartość stałą, która wskazuje, że użytkownik używa schematu Ad Managera. Przykład zastosowania gdfp_req=1 Wymaganie  Wymagany w przypadku stron internetowych i aplikacji.
iu (Jednostka reklamowa)	Parametr jednostki reklamowej może mieć wartość zmienną, która powinna być ustawiona na obecną jednostkę reklamową w formacie: /network_id/.../ad_unit Przykład zastosowania iu=/6062/videodemo Wymaganie  Wymagany w przypadku stron internetowych i aplikacji.
msid (Identyfikator aplikacji) an (Nazwa aplikacji)	Parametry identyfikatora aplikacji i nazwy aplikacji mogą mieć wartości zmienne, które należy stosować w żądaniach wysyłanych z aplikacji mobilnych i urządzeń CTV, ponieważ są wymagane przez większość automatycznych reklam wideo. Pakiet IMA SDK automatycznie wypełni oba parametry, ale muszą one zostać ręcznie określone w środowiskach innych niż SDK, m.in. w bezpośrednich wywołaniach VAST, lub przy użyciu biblioteki dostępu zautomatyzowanego (PAL) lub zasobów reklamowych uwierzytelnionych przez wydawcę (PAI). Nazwa aplikacji powinna być zrozumiała dla człowieka. W przypadku iOS i tvOS pakiet SDK nie ma dostępu do identyfikatora aplikacji. W takich przypadkach parametr msid nie jest wysyłany, a SDK wysyła pakiet aplikacji za pomocą parametru an. Przykład zastosowania msid=com.package.publisher&an=sample%20app Identyfikatory aplikacji w różnych sklepach z aplikacjami mają odmienne nazwy i formaty. Zobacz wskazówki IAB na temat identyfikowania aplikacji lub przykłady typowych unikalnych identyfikatorów. W przypadku platform, które nie mają sklepu z aplikacjami, IAB zaleca wydawcom korzystanie z takiego formatu identyfikatorów: com.publisher.deviceplatform. Wymaganie W przypadku aplikacji oba parametry są wymagane.  Zalecany w przypadku zautomatyzowanych rozwiązań do generowania przychodu.
output (Format wyjściowy reklamy)	Parametr formatu wyjściowego reklamy może mieć wartość stałą, która powinna być ustawiona na format wyjściowy reklamy. Parametr output=vast oznacza domyślną wersję VAST ustawioną w Twojej sieci. W wybranych tagach reklamy lub częściach witryny możesz żądać konkretnej wersji VAST lub VMAP. W przypadku VAST, jeśli Twój odtwarzacz wideo używa pakietu IMA SDK, parametr output żądania reklamy wideo zawsze będzie mieć ustawienie output=xml_vast4. Nie powoduje to żadnego zagrożenia dla niezawodności działania, ponieważ pakiet SDK jest zgodny ze wszystkimi starszymi wersjami VAST, z których mogą korzystać serwery reklamowe firm zewnętrznych. Parametr output=vmap zwraca domyślną wersję VMAP (np. VMAP 1), która jest włączona w Twojej sieci. Jeśli zwracasz VAST w ramach VMAP, możesz użyć xml_vmap1_vast3 lub xml_vmap1_vast4, aby określić wersję VAST, którą chcesz zwrócić. Przykład zastosowania Domyślne ustawienie VAST Twojej sieci: output=vast VAST 4: output=xml_vast4 Domyślne ustawienie VMAP Twojej sieci: output=vmap VMAP 1: output=xml_vmap1 VMAP 1 zwracające VAST 4: output=xml_vmap1_vast4 Wymaganie  Wymagany w przypadku stron internetowych i aplikacji.
pvid (Identyfikator zestawu aplikacji) pvid_s (Zakres zestawu aplikacji)	Wartości identyfikatora zestawu aplikacji są niezbędne do generowania przychodów, gdy użytkownicy urządzeń z Androidem rezygnują z personalizacji. Parametr pvid może mieć wartość zmienną ustawioną na identyfikator zestawu aplikacji na Androida, a parametr pvid_s może mieć wartość stałą, która reprezentuje zakres identyfikatora zestawu aplikacji (scope_app lub scope_developer). Pakiet IMA/PAL SDK przekazuje to pole automatycznie, ale wydawcy, którzy nie korzystają z tego pakietu, muszą wywołać SDK zestawu aplikacji i ręcznie przekazać te parametry w żądaniu reklamy. Zapoznaj się z dokumentacją dla deweloperów aplikacji na Androida dotyczącą pobierania identyfikatora zestawu aplikacji. Przykład zastosowania pvid=[AppSetID_value] pvid_s=scope_app Wymaganie  Wymagany w przypadku aplikacji.  Zalecany w przypadku zautomatyzowanych rozwiązań do generowania przychodu.
rdid idtype is_lat (Możliwe do zresetowania identyfikatory urządzeń)	Identyfikatory urządzeń możliwe do zresetowania mogą mieć wartości zmienne. W przypadku aplikacji wbudowanych (nie na stronach na komputerze czy w internecie mobilnym) pakiet SDK przekazuje do żądań strumieni możliwe do zresetowania identyfikatory urządzeń na potrzeby kierowania na użytkowników, zawierające parametry rdid, idtype i is_lat. W strumieniach SSB musisz je przekazywać jako parametry jawne, tak jak w przypadku żądania reklamy po stronie klienta. Dowiedz się więcej o identyfikatorach urządzeń. Prawie wszystkie automatyczne reklamy wideo wymagają tych wartości. Wraz z udostępnieniem systemu iOS 14.5 firma Apple wycofała sygnał LAT. Zamiast tego, aby określić, czy użytkownik wyraził zgodę na śledzenie w wersjach iOS, które obsługują App Tracking Transparency, Google polega na obecności identyfikatora IDFA o wartości innej niż zero. W związku z tym wymagany jest prawidłowy ciąg UserAgent wskazujący odpowiednią wersję systemu operacyjnego. Przykład zastosowania Zobacz szczegółowe przykłady identyfikatorów urządzeń możliwych do zresetowania. Wymaganie  Wymagany w przypadku aplikacji.  Zalecany w przypadku zautomatyzowanych rozwiązań do generowania przychodu.
sz (Rozmiar)	Parametr rozmiaru może mieć wartość zmienną, która powinna być ustawiona na rozmiar głównego boksu reklamowego wideo. Możesz podać wiele rozmiarów, rozdzielając je pionowymi kreskami (|). Nie dodawaj litery „v” na końcu rozmiaru. Przykład zastosowania sz=400x300 Wymaganie  Wymagany w przypadku stron internetowych i aplikacji. Ten parametr jest opcjonalny, jeśli wymagany jest tylko parametr ad_type=audio.
unviewed_position_start (Wyświetlenia opóźnione)	Parametr wyświetleń opóźnionych może mieć wartość stałą, aby wskazywać opóźnione wyświetlenia filmu. Przykład zastosowania unviewed_position_start=1 Wymaganie  Wymagany w przypadku stron internetowych i aplikacji.
url (Adres URL)	Parametr adresu URL może mieć wartość zmienną, która powinna być ustawiona na pełny adres URL, z którego jest wysłane żądanie reklamy. Ta wartość jest potrzebna, aby pomóc kupującym zidentyfikować i zrozumieć źródło żądania. Na ile to możliwe, powinna być ona wstawiana do żądania reklamy dynamicznie. W przypadku strony jest to adres URL strony zawierającej odtwarzacz. Jeśli używasz pakietu IMA SDK, wartość adresu URL jest ustawiana automatycznie. Jeśli odtwarzacz ustawia tę wartość, pakiet IMA SDK będzie ją uwzględniać. W przypadku aplikacji (na urządzeniu mobilnym lub CTV) wartość tę należy ustawić na adres URL, który najdokładniej odpowiada zasobom reklamowym wideo lub audio generującym przychody. Na przykład gdy użytkownik ogląda w aplikacji mobilnej film, który jest też dostępny pod odpowiednikiem adresu URL na komputery*. Wartość tego parametru powinna być zakodowana. Przykład zastosowania url=https%3A%2F%2Fwww.videoad.com%2Fgolf.html * Jeśli w przypadku aplikacji nie ma możliwości ustawienia tego parametru na zmienną wartość adresu URL, zalecamy skonfigurowanie go według tego wzoru: url=https%3A%2F%2F<app/bundleid>.adsenseformobileapps.com Wymaganie Wymagany w przypadku stron internetowych i aplikacji.  Zalecany w przypadku zautomatyzowanych rozwiązań do generowania przychodu.
wta (Dlaczego ta reklama?)	Parametr „Dlaczego ta reklama?” może mieć wartość stałą, która wskazuje, że odtwarzacz wideo obsługuje renderowanie „Dlaczego ta reklama?”. To pytanie jest obsługiwane automatycznie, gdy korzystasz z pakietu IMA SDK. Jeśli nie używasz pakietu IMA SDK, odtwarzacze muszą mieć zaimplementowaną obsługę elementów Icon i IconClickFallbackImage zgodnie ze standardem VAST organizacji IAB. Żądania reklam audio powinny wysyłać parametr wta=1, jeśli ikona Informacja podana w odpowiedzi VAST będzie renderowana w reklamach towarzyszących lub w inny sposób przekazywana użytkownikowi. Aby kwalifikować się do ruchu zarezerwowanego i ofert reklamowych Google w Europejskim Obszarze Gospodarczym, żądania reklam muszą wysyłać parametr wta=1 wskazujący, że w reklamie wideo lub w reklamach towarzyszących renderowana jest ikona informacyjna z odpowiedzi VAST (lub że jest ona przekazywana użytkownikowi w inny sposób) w przypadku wszystkich kreacji. Przykład zastosowania Obsługuje: wta=1 Nie obsługuje: wta=0 Wymaganie Wymagany w przypadku Ad Exchange. Wymagany w przypadku ruchu z EOG w witrynie i aplikacji  Zalecany w przypadku zautomatyzowanych rozwiązań do generowania przychodu.