如要瞭解格式，請參閱總覽。
| 欄位 | 必填 | 類型 | 可寫入 | 說明 |
|---|---|---|---|---|
| 廣告 ID | 只有在編輯現有廣告時才需要 | 整數 | 否 | 廣告群組廣告的數字 ID 值。如果留空，系統會建立新廣告並指派專屬 ID。 |
| 廣告群組 ID | 是 | 整數 | 否 | 父項廣告群組的數字 ID 值。如果您在建立這個廣告的同時也建立了一個廣告群組，可以為該廣告群組指定自訂 ID (例如「ext<自訂廣告群組 ID>」)。 |
| 廣告群組名稱 | 否 | 字串 | 否 | 廣告群組名稱 |
| 名稱 | 是 | 字串 | 是 | 項目的名稱。 |
| 狀態 | 是 | 字串 | 是 | 項目的狀態設定。
|
| 廣告類型 | YouTube 和需求開發廣告的必填資訊 | 字串 | 是 | 廣告的廣告格式。 串流內和動態內影片廣告是以單次收視出價為銷售依據的 YouTube 影片廣告類型。串場廣告是長度不超過 6 秒的 YouTube 影片廣告，以千次曝光出價為依據銷售。不可略過的影片廣告是長度介於 6 到 15 秒的 YouTube 串流內廣告，以千次曝光出價為依據銷售。YouTube 音訊廣告是 YouTube 音訊廣告，回應式影片廣告是 YouTube 廣告類型，可放送多種格式。如果影片夠短，有效觸及廣告就會以 YouTube 串場廣告的形式放送，否則會以 YouTube 串流內廣告的形式放送。需求開發影片廣告會以多種格式放送，包括但不限於 YouTube。需求開發圖像廣告會顯示圖片，需求開發輪轉廣告會顯示資訊卡。需求開發產品廣告會顯示產品。 請選取下列其中一個值：
|
| 影片 ID | YouTube 和需求開發影片廣告的必要條件 | 字串 | 是 | YouTube 影片 ID |
| 顯示網址 | 串流內廣告和串場廣告適用 | 字串 | 是 | 廣告顯示網址 |
| 到達網頁網址 | 串流內廣告、串場廣告和需求開發廣告的必要條件 | 字串 | 是 | 廣告到達網頁網址 |
| DCM 追蹤 - 刊登位置 ID | 只有在更新 DCM 追蹤廣告時才需要提供 | 整數 | 是 | 對應追蹤廣告的 DCM 刊登位置數值 ID 值。 如要移除 DCM 追蹤廣告，請將「DCM 追蹤 - 刊登位置 ID」、「DCM 追蹤 - 廣告 ID」和「DCM 追蹤 - 廣告素材 ID」這三個欄位留空。 |
| DCM 追蹤 - 廣告 ID | 只有在更新 DCM 追蹤廣告時才需要提供 | 整數 | 是 | 對應追蹤廣告的 DCM 廣告數值 ID 值。如要移除 DCM 追蹤廣告，請將「DCM 追蹤 - 刊登位置 ID」、「DCM 追蹤 - 廣告 ID」和「DCM 追蹤 - 廣告素材 ID」這三個欄位留空。 |
| DCM 追蹤 - 廣告素材 ID | 只有在更新 DCM 追蹤廣告時才需要提供 | 整數 | 是 | 相應追蹤廣告的廣告素材數值 ID 值。如要移除 DCM 追蹤廣告，請將「DCM 追蹤 - 刊登位置 ID」、「DCM 追蹤 - 廣告 ID」和「DCM 追蹤 - 廣告素材 ID」這三個欄位留空。 |
| 點擊追蹤程式網址 | 否 | 字串 | 是 | 廣告點擊追蹤程式網址 |
| 點擊追蹤程式網址參數 | 否 | 字串、清單清單 | 是 | 點擊追蹤程式網址自訂參數。格式 = (名稱 1; 值 1;); (名稱 2; 值 2;); 等等。 |
| 行動號召 | 如果父項委刊項是 YouTube 影片行動委刊項、「廣告標題」不為空白，或「廣告類型」是「需求開發影片」、「需求開發圖像」、「需求開發輪播」，則為必填 | 字串 | 是 | 行動號召按鈕的標籤 (最多 10 個半形字元，1 行)。 |
| 廣告標題 | 需求開發廣告的必要條件 | 字串 | 是 | 行動號召重疊廣告的廣告標題 (1 行，最多 15 個半形字元)。 |
| 顯示網址路徑 1 | 否 | 字串 | 是 | 顯示網址路徑 1 |
| 顯示網址路徑 2 | 否 | 字串 | 是 | 顯示網址路徑 2 |
| 動態內影片縮圖 | 動態內影片廣告：是 | 字串 | 是 | 影片探索廣告使用的影片縮圖
|
| 動態內影片廣告標題 | 動態內影片和需求開發廣告的必要條件 | 字串 | 是 | 探索或回應式廣告的廣告標題文字，或是需求開發廣告的長廣告標題。 |
| 說明 1 | 動態內影片和需求開發廣告的必要條件 | 字串 | 是 | 探索廣告說明 1 文字或回應式廣告說明 |
| 說明 2 | 動態內影片廣告的必要條件 | 字串 | 是 | 探索廣告說明 2 文字 |
| 動態內影片到達網頁 | 動態內影片廣告：是 | 字串 | 是 | 探索廣告到達網頁 |
| 行動到達網頁網址 | 否 | 字串 | 是 | 行動裝置適用的廣告到達網頁網址 |
| 商家名稱 | 需求開發廣告的必要條件 | 字串 | 是 | 宣傳的商家名稱 |
| 到達網頁網址尾碼 | 否 | 字串 | 是 | 到達網頁網址的尾碼 |
| 標誌素材資源 ID | 需求開發廣告的必要條件 | 字串、清單 | 是 | 標誌的資產 ID 清單。這份清單會依遞增數字順序產生。 |
| 行銷圖片素材資源 ID | 當「廣告類型」為「需求開發圖像」時，此為必填欄位 | 字串、清單 | 是 | 行銷圖片的資產 ID 清單。這份清單會依遞增順序產生。 |
| 需求開發資訊卡 | 當「廣告類型」為「需求開發輪轉廣告」時，此為必填欄位 | 字串、清單清單 | 是 | 這會定義資訊卡清單，格式如下： (最終到達網址、最終行動版網址、標題、行動號召文字、行銷圖片素材資源 ID、其他行銷素材資源 ID 等)。 例如：(google.com; mobile.google.com; Headline; Click Here; 10020; 20020; 30020)。每個行銷素材資源都必須有專屬的長寬比。如果廣告中的某張資訊卡使用正方形行銷圖片，則該廣告中的所有資訊卡都必須使用正方形行銷圖片 (其他長寬比也適用此規定)。 |
| 隨播橫幅廣告素材資源 ID | 否 | 字串、清單 | 是 | 隨播橫幅的資產 ID 清單。這份清單會依遞增數字順序產生。這項功能支援影片成效、需求開發影片、串流內、串場和不可略過廣告。清單格式 = 100; 200; |