Zasób: AdBreak
Metadane przerwy na reklamę używane do podejmowania decyzji o reklamach w przerwie na reklamę podczas transmisji na żywo.
| Zapis JSON |
|---|
{ "name": string, "createTime": string, "expectedDuration": string, "customParams": string, "scte35CueOut": string, "podTemplateName": string, "breakState": enum ( |
| Pola | |
|---|---|
name |
Tylko dane wyjściowe. Nazwa zasobu przerwy na reklamę. To pole będzie miało format „networks/ network_code to kod sieci w usłudze Google Ad Manager, do której należą te treści. asset_key to klucz wydarzenia z transmisją na żywo w usłudze Google Ad Manager, w ramach którego utworzono przerwę na reklamę. adBreakId to klucz przerwy na reklamę. TYLKO DANE WYJŚCIOWE. |
createTime |
Tylko dane wyjściowe. Czas utworzenia przerwy na reklamę. Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: |
expectedDuration |
Wymagane. Oczekiwany czas trwania przerwy. Czas w sekundach z maksymalnie 9 miejscami po przecinku, zakończony literą „ |
customParams |
Opcjonalnie: Pary klucz-wartość, które mają być uwzględniane w żądaniach reklamy na potrzeby tej przerwy, używane w ramach kierowania według niestandardowych kryteriów w usłudze Ad Manager. Przykład: 'key1=value&key2=value2,value22' Wyofane: ustaw kierowanie według kryteriów niestandardowych, używając klucza „cust_params” w breakParams.ad_tag_params. |
scte35CueOut |
Opcjonalnie: Dane zakodowane w formacie Base-64 z sygnału SCTE-35. Mogą zawierać polecenie splice_insert() lub time_signal(). Przykłady: – z time_signal(): “/DA0AAAAAAAA///wBQb+cr0AUAAeAhxDVUVJSAAAjn/PAAGlmbAICAAAAAAsoKGKNAIAmsnRfg==” – ze splice_insert(): "/DAvAAAAAAAA///wFAVIAACPf+/+c2nALv4AUsz1AAAAAAAKAAhDVUVJAAABNWLbowo=" |
podTemplateName |
Opcjonalnie: Nazwa szablonu bloku reklamowego Google Ad Managera. Wycofane: ustaw nazwę szablonu bloku reklamowego, używając klucza „ptpln” w breakParams.ad_tag_params. |
breakState |
Tylko dane wyjściowe. Bieżący stan przerwy na reklamę. |
expectedStartTime |
Opcjonalnie: Oczekiwany czas rozpoczęcia przerwy na reklamę. Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: |
expireDuration |
Opcjonalnie: Przerwa na reklamę wygasa o godzinie expectedStartTime + expireDuration. Jeśli parametr expectedStartTime nie jest ustawiony, przerwa na reklamę wygaśnie po upływie czasu określonego w parametrze expireDuration od rozpoczęcia podejmowania decyzji. Wymaga włączenia planowania wielu przerw w transmisji na żywo. Domyślnie: 30 min, minimum: 5 min, maksimum: 6 godz. Czas w sekundach z maksymalnie 9 miejscami po przecinku, zakończony literą „ |
breakSequence |
Tylko dane wyjściowe. Identyfikator sekwencji reklam w trakcie filmu w przerwie na reklamę. Wiele przerw na reklamę może mieć tę samą wartość breakSequence, jeśli została ona wyraźnie określona w parametrze breakParams.ad_tag_params za pomocą klucza mridx. W ten sposób skutecznie połączysz 2 przerwy na reklamę w GAM. |
breakParams |
Opcjonalnie: Parametry przerwy, które mają być uwzględniane w żądaniach reklam dotyczących tej przerwy. |
matchParams |
Opcjonalnie: Używany w przypadku DAI z łączeniem, aby określić, jak przerwa na reklamę utworzona za pomocą interfejsu API jest dopasowywana do przerwy na reklamę w pliku manifestu. Wymaga włączenia planowania wielu przerw w transmisji na żywo. Gdy w pliku manifestu zostanie wykryta nowa przerwa, funkcja dopasowania zostanie uruchomiona w przypadku wszystkich przerw na reklamę w wydarzeniu, które mają stan breakState o wartości
Aby zapobiec przypadkowemu dopasowaniu wszystkich elementów (co mogłoby się zdarzyć, gdyby parametr matchParams był pusty, ale obecny), parametr matchParams nie może być pusty, jeśli jest ustawiony. Jeśli pole jest obecne w żądaniu, musi być ustawione co najmniej jedno z jego pól. Przerwy na reklamę są sprawdzane w tej kolejności: 1. Z matchParams, uporządkowane według rosnącego parametru expectedStartTime, rosnącego parametru createTime, przy czym przerwy na reklamę bez parametru expectedStartTime mają priorytet podczas sortowania. 2. Bez matchParams, uporządkowane według rosnącego parametru expectedStartTime, rosnącego parametru createTime, przy czym przerwy na reklamę bez parametru expectedStartTime mają priorytet podczas sortowania. Jeśli nie wszystkie oczekujące przerwy na reklamę pasują do siebie, DAI powróci do działania JIT. |
servedBreak |
Tylko dane wyjściowe. Odzwierciedla to rzeczywiste informacje o wyświetlonej przerwie na reklamę. Ustawiane tylko w przypadku przerw na reklamę o stanie |
adTag |
Opcjonalnie: Zastępuje domyślny tag reklamy zdarzenia w przypadku tej przerwy na reklamę. |
Metody |
|
|---|---|
|
Interfejs API do tworzenia przerwy na reklamę w transmisji na żywo. |
|
Interfejs API do wyświetlania listy przerw na reklamę podczas transmisji na żywo. |