Puoi configurare il lettore per il tracciamento e l’analisi dell’utilizzo dei video.
Prima di attivare il tracciamento video (heartbeat video), assicurati di disporre dei seguenti elementi:
ADBMobileConfig.json | Importante: il nome del file di configurazione JSON deve rimanere ADBMobileConfig.json . Impossibile modificare il nome e il percorso del file di configurazione. Il percorso di questo file deve essere <source root="">/AdobeMobile . |
AppMeasurement endpoint del server di tracciamento | URL dell’endpoint di raccolta back-end Adobe Analytics (precedentemente SiteCatalyst). |
Endpoint del server di tracciamento di Video Analytics | URL dell’endpoint della raccolta back-end di analisi video. Qui vengono inviate tutte le chiamate di tracciamento heartbeat video. Suggerimento: l'URL del server di tracciamento dei visitatori corrisponde all'URL del server di tracciamento di Analytics. Per informazioni sull'implementazione del servizio ID visitatori, vedi Implementazione del servizio ID . |
Nome account | Noto anche come ID suite di rapporti (RSID). |
ID organizzazione Marketing Cloud | Valore stringa necessario per creare un’istanza del componente Visitatore. |
Editore | Questo è l’ID dell’editore, fornito ai clienti dal loro rappresentante Adobe. Suggerimento: questo ID non è solo una stringa con il nome del brand/televisore. |
Per configurare il tracciamento video nel lettore:
Conferma che le opzioni di caricamento nel ADBMobileConfig.json
il file di risorse è corretto.
{
"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" : ""
}
}
Questo file di configurazione in formato JSON è incluso come risorsa con TVSDK. Il lettore legge questi valori solo al momento del caricamento e i valori rimangono costanti durante l’esecuzione dell’applicazione.
Per configurare le opzioni del tempo di caricamento:
Confermare che ADBMobileConfig.json
contiene i valori appropriati forniti da Adobe.
Conferma che il file si trovi in AdobeMobile
cartella.
Questa cartella deve trovarsi nella radice della struttura di origine dell'applicazione.
Compila e genera l’applicazione.
Distribuire ed eseguire l'applicazione in bundle.
Per ulteriori informazioni su queste impostazioni AppMeasurement, vedi Misurazione dei video in Adobe Analytics.
Inizializza e configura i metadati di tracciamento heartbeat video.
Puoi arrestare il modulo di analisi video nel flusso intermedio e reinizializzarlo, se necessario. Prima di reinizializzare il modulo, accertati che anche i metadati di analisi video siano aggiornati ai metadati di contenuto corretti. Per ricreare i metadati, ripeti i passaggi secondari 1 e 2.
Crea un’istanza dei metadati di Video Analytics.
Questa istanza contiene tutte le informazioni di configurazione necessarie per abilitare il tracciamento heartbeat video. Ad esempio:
- (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;
}
Aggiungi i metadati di Video Analytics all’istanza di metadati globale.
Quando sei pronto, imposta l’istanza dei metadati globali sulla risorsa multimediale o sull’elemento del lettore multimediale:
- (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];
Inizializza il tracker di Video Analytics.
Dopo aver creato un’istanza del lettore multimediale, devi creare un’istanza di tracciamento di Video Analytics e fornire un riferimento a tale istanza.
Crea sempre una nuova istanza di tracciamento per ogni sessione di riproduzione del contenuto e rimuovi il riferimento precedente dopo aver scollegato l’istanza del lettore multimediale.
self.videoAnalyticsTracker =
[[[PTVideoAnalyticsTracker alloc] initWithMediaPlayer:self.player] autorelease];
Distruggi il tracker di Video Analytics.
Prima di iniziare una nuova sessione di riproduzione del contenuto, elimina l’istanza precedente del tracciatore video. Dopo aver ricevuto l’evento di completamento del contenuto (o la notifica), attendi alcuni minuti prima di eliminare l’istanza di tracciamento video. Distruggere immediatamente l’istanza potrebbe interferire con la capacità del tracciatore di Video Analytics di inviare un ping video completo.
self.videoAnalyticsTracker = nil;
Contrassegna manualmente il flusso live/lineare come completato.
Se hai diversi episodi su un flusso live, puoi contrassegnare manualmente un episodio come completo utilizzando l’API completa. In questo modo si termina la sessione di tracciamento video per l’episodio video corrente e si può avviare una nuova sessione di tracciamento per l’episodio successivo.
Questa API è facoltativa e non è necessaria per il tracciamento video VOD.
if (self.videoAnalyticsTracker)
{
[self.videoAnalyticsTracker trackVideoComplete];
}