Uporządkowane dane – wersja 3.1 – Reklama w YouTube
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Informacje o formacie znajdziesz w sekcji Omówienie.
Pole
Wymagane
Typ
Z możliwością zapisu
Opis
Identyfikator reklamy
Wymagane tylko podczas edytowania istniejących reklam
liczba całkowita
Nie
Liczbowy identyfikator reklamy w grupie reklam. Jeśli pozostawisz to pole puste, utworzymy nową reklamę z unikalnym identyfikatorem.
Identyfikator grupy reklam
Tak
liczba całkowita
Nie
Liczbowy identyfikator nadrzędnej grupy reklam. Możesz podać identyfikator niestandardowy (np. „ext[custom ad group ID]”) grupy reklam, którą tworzysz jednocześnie z tą reklamą.
Nazwa
Tak
ciąg znaków
Tak
Nazwa pozycji.
Stan
Tak
ciąg znaków
Tak
Ustawienie stanu dla wpisu.
Aktywne
Wstrzymano
Usunięto
Identyfikator filmu
Tak
ciąg znaków
Tak
Identyfikator filmu w YouTube
Wyświetlany URL reklamy In-Stream
Tak w przypadku reklam In-Stream
ciąg znaków
Tak
Wyświetlany adres URL reklamy
Adres URL strony docelowej w in-stream
Tak w przypadku reklam In-Stream
ciąg znaków
Tak
Adres URL strony docelowej reklamy
Tag śledzenia kliknięć w filmie
Nie
ciąg znaków
Tak
URL tagu śledzenia kliknięć reklamy
Parametry niestandardowe w strumieniu
Nie
ciąg znaków, lista list
Tak
Parametry niestandardowe linku monitorującego kliknięcia. Format = (name1; value1;); (name2; value2;); itd.
Miniatura filmu w ramach reklamy wideo Discovery
Tak w przypadku reklam wideo Discovery
ciąg znaków
Tak
miniaturę filmu, którą chcesz używać w reklamach wideo Discovery.
0
1
2
3
Nagłówek reklamy wideo Discovery
Tak w przypadku reklam wideo Discovery
ciąg znaków
Tak
Tekst nagłówka reklamy Discovery
Opis filmu Discovery 1
Tak w przypadku reklam wideo Discovery
ciąg znaków
Tak
Tekst opisu 1 reklamy Discovery
Opis filmu Discovery 2
Tak w przypadku reklam wideo Discovery
ciąg znaków
Tak
Tekst opisu reklamy Discovery 2
Strona docelowa reklamy wideo Discovery
Tak w przypadku reklam wideo Discovery
ciąg znaków
Tak
Strona docelowa reklamy Discovery
Identyfikator aplikacji mobilnej
Tak w przypadku podtypu Instalacja aplikacji mobilnej
ciąg znaków
Tak
Aplikacja mobilna używana do wyświetlania reklam promujących instalacje aplikacji mobilnych. Format:com.google.android.gm lub 422689480
[null,null,["Ostatnia aktualizacja: 2025-07-25 UTC."],[[["\u003cp\u003eThis SDF version is outdated and users should transition to SDF v7 for continued use of structured data files.\u003c/p\u003e\n"],["\u003cp\u003eThis documentation is solely for referencing previously generated files and not for creating new ones.\u003c/p\u003e\n"],["\u003cp\u003eThe structured data file format includes fields for managing video and discovery ads, requiring specific details for each ad type.\u003c/p\u003e\n"],["\u003cp\u003eFields like 'Ad Id' and 'Ad Group Id' help manage ad relationships while 'Name' and 'Status' control ad identification and state.\u003c/p\u003e\n"],["\u003cp\u003eFor video ads, essential fields include 'Video Id', display and landing page URLs, and optional click trackers and custom parameters.\u003c/p\u003e\n"]]],[],null,["# Structured Data - v3.1 - YouTube Ad\n\n| This SDF version has been sunset. Users should migrate to SDF [v7.1](/display-video/api/structured-data-file/v7-1/Campaign) in order to continue using structured data files. Only use this documentation when referring to previously-generated files.\n\nSee the [overview](/display-video/api/structured-data-file/format) for an explanation of format.\n\n| Field | Required | Type | Writable | Description |\n|---------------------------------|-----------------------------------------|-----------------------|----------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Ad Id | Required only when editing existing Ads | integer | No | Numeric ID value of the ad group ad. If left blank a new Ad will be created and a unique ID will be assigned. |\n| Ad Group Id | Yes | integer | No | Numeric ID value of the parent ad group. You can specify a custom identifier (for example, \"ext\\[custom ad group ID\\]\") for an Ad Group that you are creating at the same time as this Ad. |\n| Name | Yes | string | Yes | The name of the entry. |\n| Status | Yes | string | Yes | The status setting for the entry. - Active - Paused - Deleted |\n| Video Id | Yes | string | Yes | The YouTube video ID |\n| In-stream Display URL | Yes for In-stream | string | Yes | The ad display URL |\n| In-stream Landing Page URL | Yes for In-stream | string | Yes | The ad landing page URL |\n| In-stream Click Tracker URL | No | string | Yes | The ad click tracker URL |\n| In-stream Custom Parameters | No | string, list of lists | Yes | The click tracker URL custom parameters. Format = (name1; value1;); (name2; value2;); etc. |\n| Video Discovery Video Thumbnail | Yes for Video Discovery | string | Yes | The video thumbnail to use for video discovery ads - 0 - 1 - 2 - 3 |\n| Video Discovery Headline | Yes for Video Discovery | string | Yes | The discovery ad headline text |\n| Video Discovery Description 1 | Yes for Video Discovery | string | Yes | The discovery ad description 1 text |\n| Video Discovery Description 2 | Yes for Video Discovery | string | Yes | The discovery ad description 2 text |\n| Video Discovery Landing Page | Yes for Video Discovery | string | Yes | The discovery ad landing page |\n| Mobile App Id | Yes for Mobile App Install subtype | string | Yes | The mobile app used for mobile app install ads. Format:com.google.android.gm or 422689480 |"]]