簡介
Brightcove 提供廣告跟踪日誌,以幫助您從獲利角度了解支持 SSAI 的直播和視頻的表現,並解決任何問題。這些日誌包括對廣告服務器的請求:廣告請求、錯誤和跟踪事件。
日誌還允許您計算性能指標:
- 廣告請求:向廣告服務器請求廣告的次數。
- 觸發的廣告跟踪事件:從 BC SSAI 服務器觸發的信標事件數。它可以是每種類型的細分:
AdStart
,AdComplete
,AdfirstQuartile
,Admidpoint
,AdthirdQuartile
,AdcreativeView
- Ad Delivery Rate:成功的廣告請求總數/廣告請求總數的比率
設定
要啟用 SSAI 廣告跟踪日誌,您必須執行以下操作:
文件格式
日誌文件將根據此架構組織在您的 S3 存儲桶中:
/yyyy/MM/dd/HH/<random-string>/<delivery stream name>-<delivery stream version>-<year>-<month>-<day>-<hour>-<minute>-<second>-<uuid>
<random-string>
和</uuid>
,每批都會不同,日誌以5MB或300秒的數據為批次。不同會話和作業的日誌將混合在批次中。
示例路徑/文件
/2021/07/17/00/00HwB2cbPB2/prod-ssai-ad-tracking-4040098940001-1-2021-07-17-00-37-09-caeb9e2e-8b54-42f6-b4f7-cbddfc5090e6
示例日誌條目
下面是一些示例日誌條目。
示例日誌條目:有創造力的
示例日誌條目:廣告請求
示例日誌條目:會議摘要
示例日誌條目:印象
整批
上面的示例是單獨的條目。Brightcove 將匯總這些,用新行分隔,並將匯總的日誌寫入您的 S3 存儲桶。以下是完整日誌文件的示例。
示例完整日誌文件
日誌字段
公共領域
所有日誌類型共享這些字段。
欄位 | 類型 | 描述 |
---|---|---|
session_id |
串 | 會話 ID。每個觀眾都是獨一無二的。 |
summary_id |
串 | 會話摘要 ID。對於 VOD,與 SessionID 相同。對於直播,每個廣告時段的每個會話都是唯一的。 |
adbreak_id |
串 | 廣告插播 ID。每個廣告插播時間唯一 |
account_id |
串 | 視頻雲帳戶 ID。 |
live_account_id |
串 | 真實賬戶 ID。 |
video_id |
串 | 視訊雲端視訊 ID。 |
live_job_id |
串 | 實時作業 ID。 |
live_app_id |
串 | 實時 SSAI 應用程序 ID。 |
title_id |
串 | VOD 標題 ID。 |
kind |
串 | 此日誌的日誌種類。Creative , AdRequest , SessionSummary , 或者Impression . |
timestamp |
串 | 日誌的時間戳。編組為 RFC3339 格式。例如“2021-06-03T11:39:22.787Z”。 |
span_id |
unit64 | SpanID 是此日誌的跟踪 ID。 |
parent_span_id |
unit64 | ParentSpanID 引用父日誌的 SpanID。此值可用於跟踪 VAST 包裝器調用鏈。 |
error |
布林 | 如果存在與此日誌關聯的錯誤,則為真。其含義取決於日誌種類。 |
HTTP 字段
這些字段在用於向廣告提供商等外部服務發出的 HTTP 請求的日誌類型之間共享。
具有 HTTP 字段的日誌種類是:
欄位 | 類型 | 描述 |
---|---|---|
url |
串 | 請求網址。 |
request_headers |
地圖[字符串][]字符串 | 請求中發送的標頭。使用鍵的標題名稱和標題值的字符串列表進行映射。 |
response_headers |
地圖[字符串][]字符串 | 響應中收到的標頭。使用鍵的標題名稱和標題值的字符串列表進行映射。 |
status_code |
整數 | 響應狀態代碼。 |
duration |
整數64 | 以納秒為單位的請求持續時間。 |
SessionSummary 字段
包含會話的廣告插入摘要。
包括公共領域 .
欄位 | 類型 | 描述 |
---|---|---|
odur |
整數64 | 要插入的廣告的 OriginalDuration。值以納秒為單位。 |
rdur |
整數64 | RequestedDuration 可能與實時流中的 OriginalDuration 不同,具體取決於會話在廣告中斷期間連接的時間。例如session join 10s into 30s adbreak,Live會請求20s的廣告(odur=30,rdur=20)。值以納秒為單位。 |
sdur |
整數64 | SubstitutedDuration 是用廣告替換的實時塊的持續時間。此值可能與 OriginalDuration 不同,具體取決於從提供商返回的廣告的持續時間以及是否插入了 slate。 |
ad_count |
整數 | 插入的廣告數。 |
ads |
[] 廣告摘要 | 關於每個插入的廣告的摘要列表。 |
sls |
布林 | 如果廣告插播啟用了實時 SLS,則 SLS 為真。 |
client_only_tracking |
布林 | 如果廣告時段啟用了實時客戶端跟踪,則 ClientOnlyTracking 為真。 |
AdSummary 字段
欄位 | 類型 | 描述 |
---|---|---|
imps |
[] 印象總結 | |
fk |
串 | 此廣告的創意外鍵。 |
type |
串 | 廣告類型。例如前貼片廣告、中貼片廣告等。 |
cdur |
整數64 | CreativeDuration 是此廣告的持續時間。值以納秒為單位。 |
ImpressionSummary 字段
欄位 | 類型 | 描述 |
---|---|---|
type |
串 | 印象型。AdStart , AdComplete , AdFirstQuartile , AdMidpoint , 或者 . |
url |
串 | 將印象發送到的 URL。 |
AdRequest 字段
包含廣告提供商的 HTTP 請求和響應數據。
欄位 | 類型 | 描述 |
---|---|---|
provider |
串 | 廣告提供商類型。例如 vast3、vmap 等。 |
創新領域
包含有關來自廣告提供商的廣告創意的信息。
包括公共領域 .
欄位 | 類型 | 描述 |
---|---|---|
state |
串 |
請求時廣告素材的狀態。
VOD 的值:
|
fk |
串 | 創意的外鍵。 |
record_id |
串 | 由 VOD 使用。 |
source_url |
串 | 廣告素材的源網址。 |
印象字段
所有日誌類型共享這些字段。
欄位 | 類型 | 描述 |
---|---|---|
impression_type |
串 | 印象型。例如 AdStart、AdComplete 等。 |