Wymagane i zalecane parametry w przypadku automatyzacji

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ą stosowane w przypadku opartych na tagach rozwiązań do wyświetlania reklam wideo w ramach automatyzacji, gdy brak integracji z pakietem IMA SDK.

Zobacz listę parametrów wymaganych i zalecanych w przypadku stron internetowych lub parametrów wymaganych w przypadku aplikacji.

Przejdź do konkretnego parametru na liście

an description_url hl idtype is_lat

msid plcmt pp rdid sid url

vpa vpmute vpos wta

 

Parametr	Szczegóły
hl (Język)	Parametr języka może mieć wartość stałą, która służy do wysyłania żądań reklamy w danym języku oraz do wybierania języka reklam i renderowania reklam wideo w alokacji dynamicznej do Wideo Ad Exchange lub Wideo AdSense. Wartość parametru może być dowolnym kodem ISO 639-1 (dwuliterowym) lub ISO 639-2 (trzyliterowym). Zobacz listę prawidłowych kodów. Brak określenia tego parametru spowoduje, że przyjmie on domyślnie dowolny język wybrany w Ad Exchange do kierowania reklam według języka. Przykład zastosowania hl=it Wymaganie  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.
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.
plcmt (Miejsce docelowe)	Parametr miejsca docelowego może mieć wartość stałą, która wskazuje, czy zasoby reklamowe In-Stream są zadeklarowane jako In-Stream czy treści towarzyszące, zgodnie ze wskazówkami podanymi w specyfikacji IAB. W przypadku żądań reklam innych niż In-Stream pole jest wypełniane automatycznie na podstawie zadeklarowanego formatu zasobów reklamowych i ta wartość zastąpi wszelkie deklaracje dotyczące ich typu (In-Stream lub treści towarzyszące). Przykład zastosowania Żądanie dotyczące In-Stream: plcmt=1 Żądanie dotyczące treści towarzyszących: plcmt=2 Wymaganie   Wymagany w przypadku stron internetowych i zautomatyzowanych rozwiązań do generowania przychodu.
pp (Profil kreacji)	Parametr profilu kreacji może mieć wartość zmienną decydującą o tym, które kreacje kwalifikują się do wyświetlenia na podstawie konfiguracji określonej w profilu kreacji wideo i audio. Przykład zastosowania pp=creative_profile Wymaganie  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.
sid (Identyfikator sesji)	Parametr identyfikatora sesji może mieć wartość zmienną w postaci identyfikatora reklamowego zapewniającego ochronę prywatności, który służy wyłącznie do ograniczenia liczby wyświetleń. Identyfikator sesji jest obsługiwany w przypadku żądań reklam wideo typu In-Stream pochodzących z urządzeń CTV oraz zasobów reklamowych wideo typu In-Stream pochodzących z urządzeń z aplikacjami mobilnymi. Obecnie nie jest on obsługiwany w przeglądarce. Zgodnie z wytycznymi IAB dotyczącymi identyfikatorów reklamowych ten parametr musi mieć format UUID. Dowiedz się więcej o możliwych do zresetowania identyfikatorach urządzeń na potrzeby kierowania na użytkowników. Aby zrezygnować z przekazywania identyfikatora sesji, ustaw parametr sid=0. Przykład zastosowania 123e4567-e89b-12d3-a456-426614174000 Wymaganie  Zalecany w przypadku zautomatyzowanych rozwiązań do generowania przychodu.
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.
vpa (Automatyczne odtworzenie wideo)	Parametr zalecany w wytycznych MRC dotyczących pomiarów wideo Parametr automatycznego odtworzenia wideo może mieć wartość stałą, która wskazuje, czy treść wideo w reklamie ma być odtwarzana automatycznie, czy po kliknięciu. Możliwe wartości to click, jeśli wymagane jest działanie użytkownika, lub auto, jeśli reklama wideo ma być odtwarzana automatycznie. Tego parametru nie należy ustawiać, jeśli jest nieznany. Przykład zastosowania Autoodtwarzanie: vpa=auto Po kliknięciu: vpa=click Wymaganie  Zalecany w przypadku zautomatyzowanych rozwiązań do generowania przychodu.
vpmute (Wyciszone odtwarzanie wideo)	Parametr zalecany w wytycznych MRC dotyczących pomiarów wideo Parametr wyciszonego odtwarzania wideo może mieć wartość stałą, która wskazuje, czy odtwarzanie reklamy ma się rozpocząć, gdy odtwarzacz wideo jest wyciszony. Przykład zastosowania Wyciszenie: vpmute=1 Wyciszenie wyłączone: vpmute=0 Wymaganie   Wymagany w przypadku stron internetowych i zautomatyzowanych rozwiązań do generowania przychodu.
vpos (Pozycja wideo)	Parametr pozycji wideo może mieć wartość stałą, która wskazuje, czy żądanie reklamy jest wysyłane z reklamy przed filmem, w trakcie filmu, czy po filmie. Przykład zastosowania Reklama przed filmem: vpos=preroll Reklama w trakcie filmu: vpos=midroll Reklama po filmie: vpos=postroll Wymaganie  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.