您可以配置播放器以跟蹤和分析視頻使用。
在激活視頻跟蹤(視頻心跳)之前,請確保您有以下幾點:
ADBMobileConfig.json | 重要提示:此JSON配置檔案名必須保留 ADBMobileConfig.json 。 無法更改此配置檔案的名稱和路徑。 此檔案的路徑必須為 <source root="">/AdobeMobile 。 |
AppMeasurement 跟蹤伺服器端點 | Adobe Analytics(以前為SiteCatalyst)後端集合終結點的URL。 |
視頻分析跟蹤伺服器終結點 | 視頻分析後端集合終結點的URL。 這是發送所有視頻心跳跟蹤呼叫的地方。 提示:訪問者跟蹤伺服器的URL與分析跟蹤伺服器的URL相同。 有關實施訪問者ID服務的資訊,請參見 實施ID服務 。 |
帳戶名 | 也稱為報告套件ID(RSID)。 |
Marketing Cloud組織ID | 實例化訪問者元件所需的字串值。 |
發佈者 | 這是發佈者ID,由客戶的Adobe代表提供給客戶。 提示:此ID不僅是帶有品牌/電視名稱的字串。 |
要在播放器中配置視頻跟蹤,請執行以下操作:
確認中的載入時間選項 ADBMobileConfig.json
資源檔案正確。
{
"version" : "1.1",
"analytics" : {
"rsids" : "adobedevelopment",
"server" : "10.131.129.149:3000",
"charset" : "UTF-8",
"ssl" : false,
"offlineEnabled" : false,
"lifecycleTimeout" : 5,
"batchLimit" : 50,
"privacyDefault" : "optedin",
"poi" : []
},
"marketingCloud": {
"org": "ADOBE PROVIDED VALUE"
},
"target" : {
"clientCode" : "",
"timeout" : 5
},
"audienceManager" : {
"server" : ""
}
}
此JSON格式的配置檔案與TVSDK捆綁為資源。 播放器僅在載入時讀取這些值,並且這些值在應用程式運行時保持不變。
要配置載入時間選項:
確認 ADBMobileConfig.json
檔案包含由Adobe提供的相應值。
確認此檔案位於 AdobeMobile
的子菜單。
此資料夾必須位於應用程式源樹的根中。
編譯並構建應用程式。
部署並運行捆綁的應用程式。
有關這些AppMeasurement設定的詳細資訊,請參見 Adobe Analytics視頻測量。
初始化和配置視頻心跳跟蹤元資料。
您可以停止視頻分析模組中流,並根據需要重新初始化它。 在重新初始化模組之前,請確保視頻分析元資料也更新為正確的內容元資料。 要重新建立元資料,請重複子步驟1和2。
建立視頻分析元資料的實例。
此實例包含啟用視頻心跳跟蹤所需的所有配置資訊。 例如:
- (PTVideoAnalyticsTrackingMetadata *)getVideoAnalyticsTrackingMetadata
{
PTVideoAnalyticsTrackingMetadata *vaTrackingMetadata =
[[[PTVideoAnalyticsTrackingMetadata alloc]
initWithTrackingServer:@"example.com"
publisher:@"sample-publisher"] autorelease];
// Set these to NO for production deployment.
vaTrackingMetadata.debugLogging = YES;
vaTrackingMetadata.quietMode = NO;
vaTrackingMetadata.channel = @"test-channel";
vaTrackingMetadata.videoName = @"myvideo";
vaTrackingMetadata.videoId = @"myvideoid";
vaTrackingMetadata.playerName = @"PSDK Player";
vaTrackingMetadata.enableChapterTracking = YES;
vaTrackingMetadata.useSSL = NO;
// use this API to override the default asset length -1 for live streams
vaTrackingMetadata.assetDuration = SAMPLE_ASSET_DURATION;
}
將視頻分析元資料添加到全局元資料實例。
準備好後,在媒體資源或媒體播放器項目上設定全局元資料實例:
- (PTMetadata *)createMetadata
{
PTMetadata *metadata = [[[PTMetadata alloc] init] autorelease];
[metadata setMetadata:[self getVideoAnalyticsTrackingMetadata]
forKey:PTVideoAnalyticsTrackingMetadataKey];
return metadata;
}
PTMetadata *metadata = [self createMetadata];
PTMediaPlayerItem *item =
[[[PTMediaPlayerItem alloc] initWithUrl:[[[NSURL alloc]
initWithString:@"media-url"] autorelease]
mediaId:@"media-id" metadata:metadata] autorelease];
初始化視頻分析跟蹤器。
建立媒體播放器實例後,必須建立視頻分析跟蹤器實例並提供對媒體播放器實例的引用。
始終為每個內容播放會話建立新的跟蹤器實例,並在分離媒體播放器實例後刪除以前的引用。
self.videoAnalyticsTracker =
[[[PTVideoAnalyticsTracker alloc] initWithMediaPlayer:self.player] autorelease];
銷毀視頻分析跟蹤器。
在開始新的內容播放會話之前,請銷毀視頻跟蹤器的先前實例。 收到內容完成事件(或通知)後,請等待幾分鐘,然後銷毀視頻跟蹤器實例。 立即銷毀實例可能會干擾視頻分析跟蹤程式發送視頻完成ping的能力。
self.videoAnalyticsTracker = nil;
手動將Live/Linear流標籤為完成。
如果您在一個即時流上有各種集數,則可以使用完整的API手動將集數標籤為完整。 這將結束當前視頻集的視頻跟蹤會話,並且您可以為下一集啟動新的跟蹤會話。
此API是可選的,不需要用於VOD視頻跟蹤。
if (self.videoAnalyticsTracker)
{
[self.videoAnalyticsTracker trackVideoComplete];
}