通知

適用於具備進階合約且符合規定的 Google Ad Manager 360 發布商和合作夥伴。

串流資料記錄 (Alpha 版)

即時匯出 DAI 串流資料

這項功能為 Alpha 版，可能尚未開放您的聯播網使用。

本頁內容

有了動態廣告插播 (DAI) 的即時記錄，您就能近乎即時地匯出串流層級的資料，以便監控及排解放送問題。本文將會概略介紹記錄檔的傳送規格、特定欄位和已知問題。

傳送記錄檔

記錄檔會傳送至 Google Cloud 的發布商專屬儲存空間 bucket，約每 5 分鐘一次。

值區名稱為 gs://gdai-[NETWORK_CODE]

提示：如需存取 Google Cloud Storage bucket 的協助，請與帳戶團隊聯絡。請準備好共用從貴公司內部管理的 Google Workspace 群組，或是指派公司內能夠管理群組的使用者。

檔案名稱的格式如下：

[Log Type]_[Network Code]_[Stream Type]_[Content ID]_[YYYYMMDD]_[HHMMSS]_
[Random Number].gz

其中：

  • Log Type：可能是 DAIAdServerInteraction、DAIManifest 或 DAIServedBreak
  • Network Code：Ad Manager 聯播網代碼
  • Stream Type：可以是 VOD、Linear 或 PODSERVING
  • Content ID：隨選影片拼接的內容來源 ID；隨選影片廣告插播放送的 PODSERVING；直播的素材資源金鑰
  • YYMMDD, HHMMSS：產生記錄的時間 (世界標準時間)
  • Random Number：隨機號碼

檔案會以 GZip 格式壓縮，當中的資料遵循「逗號分隔值前後加上雙引號」的 RFC4180 標準。雖然 RFC4180 第 2 節的第 5 點提到「各欄位前後不一定要加上雙引號」，但請注意，記錄檔中的所有資料都會以雙引號括住。

檔案會在值區保留 7 天，之後就會移除。

注意：欄位可能會因新版本推出而有所變動。若有新欄位加入或舊欄位遭到移除，客戶一律應根據標頭剖析 CSV 檔案。

資訊清單放送記錄

這份記錄會提供影片串流放送情形的相關資訊。記錄包含以下欄位：

欄位** 說明
timestamp

INTEGER

 廣告請求的世界標準時間戳記 (以 UNIX 時間表示)
entry_id

STRING

 記錄項目的專屬 ID
系統目前有一項限制，也就是單一記錄項目可能重複出現。使用這個 ID 即可刪除重複項目。
stream_id

STRING

 指派給各個串流的專屬 ID (也稱為 SAM ID)
network_code

INTEGER

 發布商的聯播網代碼

dai_type

STRING

 DAI 類型：
  • DAI_TYPE_STITCHED
  • DAI_TYPE_PODSERVING
內容

STRING

 內容來源 ID 僅限 VOD 拼接記錄
vid

STRING

 影片 ID 僅限 VOD 記錄
asset_key

STRING

 直播的資產金鑰 僅限即時記錄

custom_asset_key

STRING

 發布商定義的直播資產金鑰 僅限即時廣告連播放送功能
manifest_type

STRING

 影片資訊清單類型：
  • MANIFEST_TYPE_HLS
  • MANIFEST_TYPE_DASH
stream_type

STRING

 串流類型：
  • STREAM_TYPE_VOD
  • STREAM_TYPE_LINEAR
request_type

STRING

 請求類型：
  • REQUEST_TYPE_STREAM_CREATE
  • REQUEST_TYPE_MASTER_PLAYLIST
  • REQUEST_TYPE_MEDIA_PLAYLIST
  • REQUEST_TYPE_MPD
  • REQUEST_TYPE_SUBTITLES
  • REQUEST_TYPE_INTERSTITIALS
  • REQUEST_TYPE_IFRAME_PLAYLIST
  • REQUEST_TYPE_AD_METADATA (ID3 events)
  • REQUEST_TYPE_SEGMENT_REDIRECT
  • REQUEST_TYPE_POD_ASSET_LIST
  • REQUEST_TYPE_POD_MULTIVARIANT
  • REQUEST_TYPE_POD_VARIANT
  • REQUEST_TYPE_POD_MPD
  • REQUEST_TYPE_POD_TIMING_METADATA
beaconing_type

STRING

 串流的廣告信標類型：
  • BEACONING_TYPE_SERVER_TRIGGERED：伺服器端
  • BEACONING_TYPE_CLIENT_TRIGGERED：用戶端 (IMA SDK)
  • BEACONING_TYPE_CLIENT_INITIATED_SERVER_TRIGGERED：用戶端 (DAI API，即將採用 IMA SDK)
http_method

STRING

 HTTP 要求中使用的方法
user_agent

STRING

 裝置的使用者代理程式
response_code

INTEGER

 HTTP 回應代碼
response_time

DOUBLE

 要求的延遲時間 (以秒為單位)

已放送的廣告插播記錄

這份記錄會提供有關向 DAI 用戶端放送的廣告插播資訊。請參閱「已放送的廣告插播記錄結構」，進一步瞭解記錄檔中的資訊顯示方式和示例。

欄位** 說明
timestamp
INTEGER		 廣告請求的世界標準時間戳記 (以 UNIX 時間表示)
entry_id
STRING

記錄項目的專屬 ID 

系統目前有一項限制，也就是單一記錄項目可能重複出現。使用這個 ID 即可刪除重複項目。
stream_id
STRING		 指派給各個串流的專屬 ID (也稱為 SAM ID)
network_code
STRING		 發布商的聯播網代碼

dai_type

STRING

 DAI 類型：
  • DAI_TYPE_STITCHED
  • DAI_TYPE_PODSERVING
內容
STRING		 內容來源 ID 僅限 VOD 拼接記錄
vid
STRING		 影片 ID 僅限 VOD 記錄
asset_key
STRING		 直播的資產金鑰 僅限即時記錄

custom_asset_key

STRING

 發布商定義的直播資產金鑰 僅限即時廣告連播放送功能
break_id
STRING

已放送的廣告插播 ID


如果是隨選影片，則為 VMAP 廣告插播 ID。例如：「preroll-1」、「midroll-2」
如果是直播，則為 DAI 指派給此廣告插播的序號。例如：「0000000001」、「0000000024」
expected_break_duration
DOUBLE		 DAI 根據預期的廣告插播時間長度，要求的廣告時間長度。僅限即時記錄
actual_break_duration
DOUBLE		 DAI 填入內容的時間長度，也就是廣告插播 (包括廣告、字卡和基本內容) 的總時間長度。僅限即時記錄
ads_duration
DOUBLE		 廣告媒體在廣告插播中放送的時間長度。如果是隨選影片，這欄也會標示廣告插播的實際時間長度。
slate_duration
DOUBLE		 字卡媒體在廣告插播中放送的時間長度。僅限即時記錄
ads_status
STRING		 廣告插播中的廣告插入狀態。詳情請參閱「已放送的廣告插播記錄結構」。
slate_status
STRING		 廣告插播中的字卡插入狀態。詳情請參閱「已放送的廣告插播記錄結構」。僅限即時記錄
complete
BOOLEAN		 廣告連播是否已放送完畢。如果是 HTTP 即時串流，這表示 DAI 已插入 cue-in 標記，標示廣告連播已結束；如果是 DASH 串流，則表示廣告時段已結束。Live stitched logs only

已放送的廣告插播記錄結構

DAI 已放送的廣告插播記錄會提供資訊，說明 DAI 如何向用戶端放送廣告插播。下方的廣告狀態和字卡狀態表格，列出了不同廣告拼接情境的 DAI 記錄資訊。請參閱這篇文章，進一步瞭解即時串流的已放送廣告插播記錄。

廣告狀態

以下列出各種廣告狀態及其代表的意義。

廣告狀態 說明
ADS_STATUS_INSERTED 廣告插入成功。
ADS_STATUS_DROPPED_UNKNOWN 廣告連播因不明原因而遭捨棄。
ADS_STATUS_ALL_ADS_MISSING 廣告連播中的所有廣告均遺失，因此已捨棄廣告連播。
ADS_STATUS_TOO_MANY_MIDROLLS 廣告伺服器傳回的片中廣告連播數量超過可插入的廣告插播數量，因此已捨棄廣告連播。僅限 VOD 記錄
ADS_STATUS_OUT_OF_WINDOW 提出廣告請求時，廣告插播的時間點已部分或完全超出拼接時段，因此會拼接基本內容，而非廣告。僅限即時記錄
ADS_STATUS_DISABLED 串流的廣告功能已停用。僅限即時記錄
ADS_STATUS_DROPPED_FOR_PREROLL

片中廣告連播遭到捨棄，因為片頭廣告插播尚未結束。僅限即時記錄
ADS_STATUS_EXPIRED 廣告連播已過期，因為廣告請求未及時完成，無法拼接到內容中。僅限即時記錄
ADS_STATUS_HOLIDAY 廣告連播遭到捨棄，因為廣告休播尚未結束。僅限即時記錄
ADS_STATUS_DROPPED_SLATE_UNAVAILABLE 廣告因字卡發生錯誤而遭到捨棄。詳情請參閱字卡狀態。僅限即時記錄

ADS_STATUS_INTERNAL_ERROR

DAI 在請求或拼接廣告時發生錯誤。

ADS_STATUS_INVALID_POD_REQUEST

廣告連播遭到捨棄，因為廣告連播請求無效。

ADS_STATUS_DROPPED_FOR_MIDROLL

請求的片頭廣告插播時間點與片中廣告插播時間點重疊。

ADS_STATUS_DROPPED_EXCEEDS_MAX_POD_FILLER_DURATION

需要的廣告連播補白廣告過多 (放送的廣告不足)。

ADS_STATUS_DROPPED_BREAK_DURATION_TOO_SHORT

廣告插播時間過短，無法請求廣告。

ADS_STATUS_DROPPED_STREAM_CREATED_AFTER_BREAK

串流在廣告插播結束後才建立。

ADS_STATUS_DROPPED_MEDIA_ANALYSIS_UNAVAILABLE

缺少或無法取得廣告拼接所需的內容串流資訊。

ADS_STATUS_NO_ADS_AVAILABLE_BEFORE_DEADLINE

在請求時限內，沒有可用的廣告。

插入畫面狀態

以下列出各種字卡狀態及其代表的意義。

插入畫面狀態 說明
SLATE_STATUS_INSERTED 已成功插入字卡。
SLATE_STATUS_SKIPPED 因即時串流設定 (已停用，空白時略過) 而略過插入字卡。
SLATE_STATUS_DROPPED_UNKNOWN 因不明原因，字卡未在這個廣告插播中插入。
SLATE_STATUS_MINIMUM_INSERTED 廣告插播的其餘部分與基本內容拼接，並加入少量字卡填補廣告和內容之間的空白。
SLATE_STATUS_INTERNAL_ERROR 因內部錯誤，字卡未在這個廣告插播中插入。

廣告伺服器互動記錄

這份記錄會提供說明資訊，解釋系統如何與廣告伺服器互動以取得廣告。請參閱「廣告伺服器互動記錄結構」，進一步瞭解記錄檔中的資訊顯示方式和示例。

欄位** 說明
timestamp

INTEGER

 廣告請求的世界標準時間戳記 (以 UNIX 時間表示)
entry_id

STRING

 記錄項目的專屬 ID
系統目前有一項限制，也就是單一記錄項目可能重複出現。使用這個 ID 即可刪除重複項目。
stream_id

STRING

 指派給各個串流的專屬 ID (也稱為 SAM ID)
network_code

INTEGER

 Ad Manager 聯播網代碼

dai_type

STRING

 DAI 類型：
  • DAI_TYPE_STITCHED
  • DAI_TYPE_PODSERVING
內容

STRING

 內容來源 ID 僅限 VOD 拼接記錄
vid

STRING

 影片 ID 僅限 VOD 記錄
asset_key

STRING

 直播的資產金鑰 僅限即時記錄

custom_asset_key

STRING

 發布商定義的直播資產金鑰 僅限即時廣告連播放送功能
pod_id

INTEGER

 廣告插播 ID：
  • 如果是隨選影片，則為 VMAP 的廣告插播 ID
  • 如果是直播活動，則為廣告插播序號
ad_server_host_name

STRING

 廣告伺服器的網域名稱
response_time

DOUBLE

 要求的延遲時間 (以秒為單位)
response_type

STRING

 回應類型：
  • VAST
  • VMAP
  • UNKNOWN：若收到無效回應或回應逾時，就會設為此值
response_code

INTEGER

HTTP 回應代碼
row_type

STRING

 記錄檔項目類型：
  • PRIMARY_REQUEST
  • AD_POD
  • WRAPPER
  • INLINE

請參閱包含各種記錄檔案類型的 VMAP 回應範例。
vast_error_code

STRING

 VAST 錯誤代碼
prefetch_stage

STRING

 預先擷取階段 (若已啟用預先擷取功能) 僅限即時記錄
ad_position

STRING

 獲選廣告在廣告連播中的位置
  • 所選廣告的起始值為 1
  • 如果是未使用的廣告百匯廣告和捨棄的廣告，則此欄位為空白
ad_id

STRING

 廣告 ID *
ad_system

STRING

 廣告系統 *
ad_title

STRING

 廣告標題 *
creative_id

STRING

 廣告素材 ID *
creative_ad_id

STRING

 廣告素材的廣告 ID *
universal_ad_id_registry

STRING

 通用廣告 ID 登錄設定 *
universal_ad_id_value

STRING

 通用廣告 ID 值 *
creative_duration

DOUBLE

 廣告素材的時間長度

mezzanine_uri

STRING

Mezzanine URI *

除了 RFC3986 中指定為未保留的字元外，URI 中的所有字元都會逸出。

media_uri

STRING

在 MediaFiles 節點中找到的第一個元素 *

除了 RFC3986 中指定為未保留的字元外，URI 中的所有字元都會逸出。

break_start_uri

STRING

用於追蹤廣告插播開始時間的追蹤元素。這項資料來自 VMAP 回應。

除了 RFC3986 中指定為未保留的字元外，URI 中的所有字元都會逸出。

google_video_id

STRING

 與這則廣告相關聯的廣告素材專屬 ID。

  * 這些值取自 VAST

** 如果不適用於特定資料列，部分欄位可能會留空

這對您有幫助嗎？

我們應如何改進呢？

還有其他問題嗎？

嘗試以下步驟：

到產品討論社群發問 向社群成員尋求答案
與我們聯絡 進一步說明相關資訊，我們會盡力協助您
true
立即運用個人化提示，開闢收益來源！

前往 Google Ad Manager 的最佳化提示頁面，查看有助全力提升收益的個人化建議。

立即解鎖

搜尋
清除搜尋內容
關閉搜尋
Google 應用程式
主選單
5567525134987841273
true
搜尋說明中心
false
true
true
true
true
true
148
false
false
false
false