Attributi metadati standard std-metadata-attributes

Questa pagina si propone di fornire un elenco completo degli attributi di metadati che il servizio di monitoraggio della concorrenza può elaborare e che possono essere utilizzati come base per i criteri che possono essere implementati. Gli attributi di metadati standard possono essere classificati come segue:

  • Attributi inclusi per progettazione (inviati in ogni chiamata di inizializzazione della sessione, in quanto sono richiesti nel percorso URL). Senza questi valori non è possibile eseguire chiamate valide.
  • Attributi dei metadati: valori che devono essere trasmessi come dati del modulo durante la chiamata di inizializzazione della sessione (nel caso in cui i criteri di back-end richiedano i relativi valori).

Attributi richiesti per progettazione attr-req-by-design

L'API di monitoraggio della concorrenza forza i client a inviare i seguenti valori come parte di qualsiasi chiamata di inizializzazione valida: chiamate di avvio sessione.

Nome campo
Esempio di valore
Dove utilizzarlo
Ottenuto da
applicationId
75b4-431b-adb2-eb6b9e546013
Intestazione di autorizzazione
Ticket Zendesk all'integrazione
mvpdName
Sample_MVPD
Percorso URI
Autenticazione di Adobe Pass dall’endpoint di configurazione quando l’utente seleziona il MVPD
accountId
12345
Percorso URI
Metadati upstreamUserID di autenticazione Adobe Pass dopo l'accesso utente Metadati utente upstreamUserID - Autenticazione Adobe Pass

Attributi metadati metadata-attr

I campi nella tabella seguente possono essere utilizzati dai programmatori e dagli MVPD per creare criteri che verranno implementati nel monitoraggio della concorrenza.

Con API v2.0, se uno di questi attributi è richiesto dai criteri definiti, un tentativo di inizio sessione senza tale attributo genererà una richiesta 400 non valida.

Entità
Nome attributo
Tipo di dati
Descrizione
Riferimento esterno (EIDR, OATC)
Esempio di valore
Regole di convalida
Media Company
programmerName
stringa
Nome del programmatore
ProgrammatoreX
Risorsa
channel
stringa
Canale TV
ChannelY
assetId
stringa
Il titolo "descrittivo" o leggibile da leggere per questo contenuto
Riferimento campi dati EIDR 2.0
Ben-Hur
tipo
enumerazione
Valore che descrive il tipo generale di contenuto rappresentato da TveItem. I valori enumerati includono: trasmissione di filmEpisodio nonBroadcastEpisodio musicaVideo awardsMostra clip concerto conferenza newsEvento sportivotrailer evento
Esercitazione consigliata feed metadati OATC
broadcastEpisode
Il campo deve corrispondere a uno degli elementi nell’enumerazione
contentType
stringa
Questo campo determina se il contenuto richiesto è live o VOD
N/D
live, vod
live o vod
genere
stringa
Genere del contenuto riprodotto in streaming. Descrive il tipo di programmazione generale
Feed metadati OATC consigliato Esercitazione
Commedia
Tipo di genere valido
durata
numero
Durata dell'elemento multimediale in secondi
Esercitazione consigliata feed metadati OATC
1800
sequenza numerica
Dispositivo/browser
deviceId
stringa
L’identificatore univoco del dispositivo.
Proprietà di Device Atlas
2b6f0cc904d137be2e1730235f5664094b831186
deviceName
stringa
Il nome descrittivo del dispositivo.
Joe’s iPad
marketingName
stringa
Il nome marketing (o il nome descrittivo del cliente) di un dispositivo
Proprietà di Device Atlas
iPhone 6s
nome marketing valido
mobileDevice
booleano
True se il dispositivo è destinato all'uso in movimento
Proprietà di Device Atlas
true, false
true, false
deviceModel
stringa
Il nome del modello del dispositivo, del browser o di un altro componente
Proprietà di Device Atlas
tablet, telefono, xbox. set-top box
nome del modello di dispositivo valido
osName
stringa
Sistema operativo in esecuzione sul dispositivo
Atlante dispositivo - Valori proprietà predefiniti del sistema operativo
Android, Windows 10, OS X, Linux, Altro Nota: per visualizzare i valori delle proprietà è necessario aver effettuato l’accesso con un nome utente e una password in Device Atlas
il valore previsto è uno dei valori delle proprietà predefinite di Device Atlas
browserName
stringa
Il nome o il tipo di browser sul dispositivo
Atlante dispositivo - Valori proprietà predefiniti browser
Nome o tipo del browser sul dispositivo. Nota: per visualizzare i valori delle proprietà, devi aver effettuato l’accesso con un nome utente e una password in Device Atlas
il valore previsto è uno dei valori delle proprietà predefinite di Device Atlas
browserVersion
stringa
Versione del browser sul dispositivo
Proprietà di Device Atlas
Versione del browser sul dispositivo
Applicazione
applicationName
stringa
Nome dell’applicazione leggibile dal consumatore o di facile utilizzo
N/D
Applicazione_Esempio
applicationId
stringa
L’ID applicazione che identifica in modo univoco un’applicazione client.
N/D
de305d54-75b4-431b-adb2-eb6b9e546013
applicationPlatform
stringa
Piattaforma nativa dell’applicazione
N/D
ios, android
applicationVersion
stringa
Questo valore può essere utilizzato a scopo di analisi
N/D
1,0, 2,0
Oggetto
accountId
stringa
ID account dell'oggetto di monitoraggio della concorrenza (nell'ambito di MVPD)
N/D
account test
contractType
stringa
premium, base. I clienti possono aggiungere questo elemento come metadati personalizzati e utilizzarlo nei propri realm.
N/D
premium, base
Utente
name
stringa
Alcuni MVPD forniscono informazioni relative all’utente specifico che riproduce il contenuto.
N/D
hba
booleano
Identifica se l’utente tenta di avviare il flusso dalla propria posizione principale
N/D
true, false
true o false
Posizione
continente
stringa
Il continente da cui proviene l’ID dispositivo che invia la richiesta di riproduzione
N/D
Nord America
nome continente valido
paese
stringa
Il paese da cui proviene l’ID dispositivo che invia la richiesta di riproduzione
N/D
Stati Uniti
nome paese valido
stato
stringa
Stato da cui proviene il deviceID che invia la richiesta di riproduzione
N/D
CA
nome stato valido
città
stringa
Città da cui proviene il deviceID che invia la richiesta di riproduzione
N/D
Cupertino
nome città valido
zipcode
numero
Il codice zip da cui proviene il deviceID che invia la richiesta di riproduzione
N/D
95014
zipcode valido
Flusso
streamId
stringa
Generato dal servizio CM, non sotto il controllo del cliente. Viene utilizzato in modo implicito quando vengono definite regole di tipo maxstream.
N/D
N/D
N/D
streamCDN
stringa
indica la rete CDN da cui è stato recuperato il flusso
N/D
N/D
N/D

Esempi di utilizzo degli attributi di metadati per la creazione di criteri examples-metadata-attr

I campi di metadati standard possono essere utilizzati per definire criteri lato server in base ai loro valori di campo:

  • È possibile configurare un criterio per applicarlo solo a valori di campo specifici (ad esempio, un criterio iOS dedicato: dove osType è iOS)

  • È possibile limitare il numero di valori distinti per un determinato campo. Alcuni esempi sono i seguenti:

    • non più di X dispositivi distinti: HAVING DISTINCT COUNT(deviceId) <= 2
    • non più di X codici zip distinti: HAVING DISTINCT COUNT(zipcode) <= 3
  • Puoi limitare il numero di flussi attivi per valore di campo. Alcuni esempi sono i seguenti:

    • non più di X flussi attivi per un singolo tipo di dispositivo: GROUP BY deviceType HAVING COUNT(streamId) <= 3
    • non più di X flussi attivi per flussi di contenuto live: SELECT COUNT(streamId) AS streamCount WHERE contentType='live' HAVING streamCount <= 3

Contatta il team di monitoraggio della concorrenza creando un ticket in Zendesk e indica i criteri che desideri implementare.

Di seguito sono riportati ulteriori esempi di criteri e manuali di integrazione:

recommendation-more-help
42139a1e-84f9-43e7-9581-d6e1d65973da