您可以設定播放器以追蹤和分析視訊使用情況。
在啟用視訊追蹤(視訊心率)之前,請確定您擁有下列專案:
ADBMobileConfig.json | 重要:此JSON設定檔案名稱必須保留 ADBMobileConfig.json . 無法變更此設定檔的名稱和路徑。 此檔案的路徑必須為 <source root="">/AdobeMobile . |
AppMeasurement 追蹤伺服器端點 | Adobe Analytics (先前稱為SiteCatalyst)後端收集端點的URL。 |
Video Analytics追蹤伺服器端點 | 視訊分析後端集合端點的URL。 這是傳送所有視訊心率追蹤呼叫的位置。 提示:訪客追蹤伺服器的URL與Analytics追蹤伺服器的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中測量視訊.
初始化和設定視訊心率追蹤中繼資料。
您可以停止視訊分析模組midstream,並視需要再次將其重新初始化。 在重新初始化模組之前,請確定視訊分析中繼資料也更新為正確的內容中繼資料。 若要重新建立中繼資料,請重複子步驟1和2。
建立Video Analytics中繼資料的例項。
此例項包含啟用視訊心率追蹤所需的所有設定資訊。 例如:
- (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;
}
將Video Analytics中繼資料新增至全域中繼資料例項。
準備就緒後,請在媒體資源或媒體播放器專案上設定全域中繼資料例項:
- (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];
初始化Video Analytics追蹤器
建立媒體播放器例項後,您必須建立Video Analytics追蹤器例項,並提供媒體播放器例項的參考。
請一律為每個內容播放工作階段建立新的追蹤器例項,並在您分離媒體播放器例項後移除先前的參照。
self.videoAnalyticsTracker =
[[[PTVideoAnalyticsTracker alloc] initWithMediaPlayer:self.player] autorelease];
銷毀Video Analytics追蹤器。
開始新的內容播放工作階段之前,請先摧毀視訊追蹤器的上一個例項。 收到內容完成事件(或通知)後,請稍候幾分鐘再摧毀視訊追蹤器例項。 立即摧毀執行個體可能會干擾Video Analytics追蹤器傳送視訊完成Ping的功能。
self.videoAnalyticsTracker = nil;
手動將即時/線性資料流標示為完成。
如果您在一個即時資料流上有各種集數,您可以使用完整的API手動將集數標示為完成。 這會結束目前影片的視訊追蹤工作階段,而且您可以為下一集開始新的追蹤工作階段。
此API為選用專案,VOD視訊追蹤不需要此API。
if (self.videoAnalyticsTracker)
{
[self.videoAnalyticsTracker trackVideoComplete];
}