DocumentazioneAnalyticsGuida a Streaming Media Collection

Parametri per gli annunci ad-parameters

Last update: Fri Oct 04 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:

Creato per:

  • Utente
  • Amministratore
  • Sviluppatore

Questo argomento presenta un elenco di dati di annunci video, inclusi i valori dei dati contestuali, che Adobe raccoglie tramite variabili della soluzione.

Descrizione dei dati della tabella:

  • Implementazione: informazioni sui valori e i requisiti di implementazione

    • Chiave: variabile, impostata manualmente nell’app o automaticamente dall’SDK di Adobe Media.
    • Obbligatorio: indica se il parametro è necessario per il tracciamento video di base.
    • Tipo: specifica il tipo di variabile da impostare, stringa o numero.
    • Inviato con: indica quando i dati vengono inviati. Avvia file multimediale è la chiamata di Analytics inviata all’avvio del file multimediale. Avvia annuncio è la chiamata di Analytics inviata all’avvio dell’annuncio e così via. Le chiamate di Chiusura sono le chiamate compilate di Analytics inviate direttamente dal server heartbeat a quello di Analytics al termine della sessione multimediale, oppure dell’annuncio, del capitolo, ecc. Le chiamate di chiusura non sono disponibili nelle chiamate dei pacchetti di rete.
    • Versione SDK min.: indica la versione SDK necessaria per accedere al parametro.
    • Valore di esempio: fornisce un esempio di utilizzo comune delle variabili.

  • Parametri di rete: mostra i valori trasferiti ai server di Adobe Analytics o Heartbeat. Questa colonna mostra i nomi dei parametri visualizzati nelle chiamate di rete generate dagli SDK di Adobe Media.

  • Reporting: informazioni su come visualizzare e analizzare i dati video.

    • Disponibile: indica se i dati sono disponibili nel reporting per impostazione predefinita (Sì) o richiede la configurazione personalizzata (Personalizzato)
    • Variabile riservata: indica se i dati vengono acquisiti come evento, eVar, prop o classificazione in una variabile riservata.
    • Nome del rapporto: nome del report Adobe Analytics per la variabile
    • Dati contestuali: nome dei dati contestuali di Adobe Analytics trasferiti al server di reporting e utilizzati nelle regole di elaborazione.
    • Feed di dati: nome della colonna per la variabile trovata nei feed di dati Clickstream o Live Stream
    • Audience Manager: nome delle caratteristiche trovato in Adobe Audience Manager
IMPORTANT
Non modificare i nomi delle classificazioni per le variabili elencate di seguito che sono
descritte in Variabile di generazione rapporti/riservata come “classificazione”.
Le classificazioni per i file multimediali vengono definite quando una suite di rapporti è abilitata per il tracciamento
degli elementi multimediali. Di tanto in tanto, Adobe aggiunge nuove proprietà e, quando ciò si verifica,
i clienti devono riabilitare le suite di rapporti per accedere alle nuove proprietà dei contenuti multimediali
. Durante il processo di aggiornamento Adobe determina se
le classificazioni vengono abilitate verificando i nomi delle variabili. Se una di esse
manca, Adobe aggiunge di nuovo quelle mancanti.

Dati annuncio video ad-video-data

ID annuncio

Implementazione
Parametri di rete
Reporting
  • Chiave SDK:
    adId
  • Chiave API:
    media.ad.id
  • Obbligatorio:
    sì
  • Tipo:
    stringa
  • Inviato con:
    avvio annuncio, chiusura annuncio
  • Versione SDK min.: qualsiasi
  • Valore di esempio:
    “2125”
  • Descrizione:
    ID dell’annuncio. Qualsiasi combinazione di numeri interi e/o lettere
  • Adobe Analytics:
    (a.media.ad.
    name)
  • Heartbeat:
    (s:asset:ad_id)
  • Disponibile:
    sì
  • Variabile riservata:
    eVar
  • Scadenza:
    alla visita
  • Nome rapporto:
    annuncio
  • Dati contestuali:
    (a.media.ad.
    name)
  • Feed dati:
    videoad
  • Audience Manager:
    (c_contextdata.
    a.media.ad.name)
  • Percorso campo XDM:
    advertising.adAssetReference.@id
  • Percorso campo XDM per raccolta:
    mediaCollection.advertisingDetails.name
  • Percorso campo XDM per reporting:
    mediaReporting.advertisingDetails.name

Posizione annuncio in pod

Implementazione
Parametri di rete
Reporting
  • Chiave SDK:
    position
  • Chiave API:
    media.ad.podPosition
  • Obbligatorio:
    sì
  • Tipo:
    numero
  • Inviato con:
    avvio annuncio, chiusura annuncio
  • Versione SDK min.: qualsiasi
  • Valore di esempio.
    1
  • Descrizione:
    la posizione (indice) dell’annuncio all’interno dell’interruzione pubblicitaria principale. Il primo annuncio ha indice 0, il secondo 1 e così via.
  • Adobe Analytics:
    (a.media.ad.
    podPosition)
  • Heartbeat:
    (s:asset:pod_position)
  • Disponibile:
    sì
  • Variabile riservata:
    eVar
  • Scadenza:
    all’hit
  • Nome rapporto:
    posizione annuncio nel pod
  • Dati contestuali:
    (a.media.ad.
    podPosition)
  • Feed dati:
    videoadinpod
  • Audience Manager:
    (c_contextdata.
    a.media.ad.podPosition)
  • Percorso campo XDM:
    advertising.adAssetViewDetails.index
  • Percorso campo XDM per raccolta:
    mediaCollection.advertisingDetails.podPosition
  • Percorso campo XDM per reporting:
    mediaReporting.advertisingDetails.podPosition

Lunghezza annuncio

Implementazione
Parametri di rete
Reporting
  • Chiave SDK:
    length
  • Chiave API:
    media.ad.length
  • Obbligatorio:
    sì
  • Tipo:
    numero
  • Inviato con:
    avvio annuncio, chiusura annuncio
  • Versione SDK min.: 1.5.1
  • Valore di esempio:
    “15”
  • Descrizione:
    lunghezza dell’annuncio video in secondi.
  • Adobe Analytics:
    (a.media.ad.
    length)
  • Heartbeat:
    (l:asset:ad_length)
  • Disponibile:
    sì
  • Variabile riservata:
    eVar e classificazione
  • Scadenza:
    all’hit
  • Nome rapporto:
    lunghezza annuncio e lunghezza annuncio (variabile)
  • Dati contestuali:
    (a.media.ad.
    length)
  • Feed dati:
    videoadlength
  • Audience Manager:
    (c_contextdata.
    a.media.ad.length)
  • Percorso campo XDM:
    advertising.adAssetReference.
    xmpDM:duration
  • Percorso campo XDM per raccolta:
    mediaCollection.advertisingDetails.length
  • Percorso campo XDM per reporting:
    mediaReporting.advertisingDetails.length

Nome del lettore dell’annuncio

Implementazione
Parametri di rete
Reporting
  • Chiave SDK:
    playerName
  • Chiave API:
    media.ad.playerName
  • Obbligatorio:
    sì
  • Tipo:
    stringa
  • Inviato con:
    avvio annuncio, chiusura annuncio
  • Versione SDK min.: qualsiasi
  • Valore di esempio:
    “ruota libera”
  • Descrizione:
    nome del lettore responsabile del rendering dell’annuncio.
  • Adobe Analytics:
    (a.media.ad.
    playerName)
  • Heartbeat:
    (s:sp:player_name)
  • Disponibile:
    sì
  • Variabile riservata:
    eVar
  • Scadenza:
    all’hit
  • Nome rapporto:
    nome del lettore dell’annuncio
  • Dati contestuali:
    (a.media.ad.
    playerName)
  • Feed dati:
    videoadplayername
  • Audience Manager:
    (c_contextdata.
    a.media.ad.playerName)
  • Percorso campo XDM:
    advertising.adAssetViewDetails.playerName
  • Percorso campo XDM per raccolta:
    mediaCollection.advertisingDetails.
    playerName
  • Percorso campo XDM per reporting:
    mediaReporting.advertisingDetails.
    playerName

Nome interruzione annuncio

Implementazione
Parametri di rete
Reporting
  • Chiave SDK:
    name
  • Chiave API:
    media.ad.podFriendlyName
  • Obbligatorio:
    SDK: sì; API: no.
  • Tipo:
    stringa
  • Inviato con:
    avvio annuncio, chiusura annuncio
  • Versione SDK min.: qualsiasi
  • Valore di esempio:
    “pre-roll”
  • Descrizione:
    il nome descrittivo dell’interruzione annuncio.
  • Adobe Analytics:
    (a.media.ad.
    podFriendlyName)
  • Heartbeat:
    (s:asset:pod_name)
  • Disponibile:
    Sì
  • Variabile riservata:
    classificazione
  • Nome rapporto:
    nome pod
  • Dati contestuali:
    (a.media.ad.
    podFriendlyName)
  • Feed dati:
    N/D
  • Audience Manager:
    (c_contextdata.
    a.media.ad.podFriendlyName)
  • Percorso campo XDM:
    advertising.adAssetViewDetails.
    adBreak.dc:title
  • Percorso campo XDM per raccolta:
    mediaCollection.advertisingPodDetails.
    friendlyName
  • Percorso campo XDM per reporting:
    mediaReporting.advertisingPodDetails.
    friendlyName

Indice di interruzione annuncio

Implementazione
Parametri di rete
Reporting
  • Chiave SDK:
    position
  • Chiave API:
    media.ad.podIndex
  • Obbligatorio:
    sì
  • Tipo:
    numero
  • Inviato con:
  • Versione SDK min.: qualsiasi
  • Valore di esempio:
    1
  • Descrizione:
    l’indice dell’interruzione dell’annuncio all’interno del contenuto a partire da 1. Questa proprietà viene utilizzata solo da Media SDK per generare l’ID pod.
  • Adobe Analytics:
  • Heartbeat:
  • Disponibile:
    no
  • Variabile riservata:
    N/D
  • Nome report:
    N/D
  • Dati contestuali:
  • Feed dati:
    N/D
  • Audience Manager:
  • Percorso campo XDM:
    advertising.adAssetViewDetails.index
  • Percorso campo XDM per raccolta:
    mediaCollection.advertisingPodDetails.index

Posizione interruzione annuncio

Implementazione
Parametri di rete
Reporting
  • Chiave SDK:
    startTime
  • Chiave API:
    media.ad.podSecond
  • Obbligatorio:
    sì
  • Tipo:
    numero
  • Inviato con:
    avvio annuncio, chiusura annuncio
  • Versione SDK min.: qualsiasi
  • Valore di esempio:
    90
  • Descrizione:
    offset dell’interruzione dell’annuncio all’interno del contenuto, in secondi.
  • Adobe Analytics:
    (a.media.ad.
    podSecond)
  • Heartbeat:
    (l:asset:pod_offset)
  • Disponibile:
    Sì
  • Variabile riservata:
    classificazione
  • Nome rapporto:
    posizione pod
  • Dati contestuali:
    (a.media.ad.
    podSecond)
  • Feed dati:
    N/D
  • Audience Manager:
    (c_contextdata.
    a.media.ad.podSecond)
  • Percorso campo XDM:
    advertising.adAssetViewDetails.adBreak.
    offset
  • Percorso campo XDM per raccolta:
    mediaCollection.advertisingPodDetails.
    offset
  • Percorso campo XDM per reporting:
    mediaReporting.advertisingPodDetails.
    offset

ID interruzione annuncio

Implementazione
Parametri di rete
Reporting
  • Chiave SDK:
    impostata automaticamente
  • Chiave API:
    N/D
  • Obbligatorio:
    sì
  • Tipo:
    stringa
  • Inviato con:
    avvio annuncio, chiusura annuncio
  • Versione SDK min.: qualsiasi
  • Valore di esempio:
    c4a577424c84067899b807c76722d495_1
  • Adobe Analytics:
    (a.media.ad.
    pod)
  • Heartbeat:
    (s:asset:pod_id)
  • Disponibile:
    sì
  • Variabile riservata:
    eVar
  • Scadenza:
    all’hit
  • Nome rapporto:
    pod annuncio
  • Dati contestuali:
    (a.media.ad.
    pod)
  • Feed dati:
    videoadpod
  • Audience Manager:
  • Percorso campo XDM:
    advertising.adAssetViewDetails.adBreak.@id
  • Percorso campo XDM per reporting:
    mediaReporting.advertisingPodDetails.
    ID

Nome annuncio

Implementazione
Parametri di rete
Reporting
  • Chiave SDK:
    name
  • Chiave API:
    media.ad.name
  • Obbligatorio:
    no
  • Tipo:
    stringa
  • Inviato con:
    avvio annuncio, chiusura annuncio
  • Versione SDK min.: 1.5.1
  • Valore di esempio:
    “Ford F-150”
  • Descrizione:
    nome descrittivo dell’annuncio. Nella generazione rapporti, “Nome annuncio” è la classificazione e “Nome annuncio (variabile)” è l’eVar.
  • Adobe Analytics:
    (a.media.ad.
    friendlyName)
  • Heartbeat:
    (s:asset:ad_name)
  • Disponibile:
    sì
  • Variabile riservata:
    eVar e classificazione
  • Scadenza:
    all’hit
  • Nome rapporto:
    nome annuncio e nome annuncio (variabile)
  • Dati contestuali:
    (a.media.ad.
    friendlyName)
  • Feed dati:
    N/D
  • Audience Manager:
    (c_contextdata.
    a.media.ad.friendlyName)
  • Percorso campo XDM:
    advertising.adAssetReference.dc:title
  • Percorso campo XDM per raccolta:
    mediaCollection.advertisingDetails.friendlyName
  • Percorso campo XDM per reporting:
    mediaReporting.advertisingDetails.friendlyName

Metadati annuncio standard standard-ad-metadata

Inserzionista

Implementazione
Parametri di rete
Reporting
  • Chiave SDK:
    INSERZIONISTA
  • Chiave API:
    media.ad.advertiser
  • Obbligatorio:
    no
  • Tipo:
    stringa
  • Inviato con:
    avvio annuncio, chiusura annuncio
  • Versione SDK min.: 1.5.7
  • Valore di esempio:
  • Descrizione:
    azienda/marchio il cui prodotto è presentato nell’annuncio.
  • Adobe Analytics:
    (a.media.ad.
    advertiser)
  • Heartbeat:
    (s:meta:
    a.media.ad.advertiser)
  • Disponibile:
    sì
  • Variabile riservata:
    eVar
  • Scadenza:
    all’hit
  • Nome rapporto:
    Inserzionista
  • Dati contestuali:
    (a.media.ad.
    advertiser)
  • Feed dati:
    videoinserzionista
  • Audience Manager:
    (c_contextdata.
    a.media.ad.advertiser)
  • Percorso campo XDM:
    advertising.adAssetReference.advertiser
  • Percorso campo XDM per raccolta:
    mediaCollection.advertisingDetails.advertiser
  • Percorso campo XDM per reporting:
    mediaReporting.advertisingDetails.advertiser

ID campagna

Implementazione
Parametri di rete
Reporting
  • Chiave SDK:
    CAMPAIGN_ID
  • Chiave API:
    media.ad.campaignId
  • Obbligatorio:
    no
  • Tipo:
    stringa
  • Inviato con:
    avvio annuncio, chiusura annuncio
  • Versione SDK min.: 1.5.7
  • Valore di esempio:
    intero o nome (stringa).
  • Descrizione:
    ID della campagna pubblicitaria.
  • Adobe Analytics:
    (a.media.ad.
    campaign)
  • Heartbeat:
    (s:meta:
    a.media.ad.campaign)
  • Disponibile:
    sì
  • Variabile riservata:
    eVar
  • Scadenza:
    all’hit
  • Nome rapporto:
    ID campagna
  • Dati contestuali:
    (a.media.ad.
    campaign)
  • Feed dati:
    videocampaign
  • Audience Manager:
    (c_contextdata.
    a.media.ad.campaign)
  • Percorso campo XDM:
    advertising.adAssetReference.campaign
  • Percorso campo XDM per raccolta:
    mediaCollection.advertisingDetails.
    campaignID
  • Percorso campo XDM per reporting:
    mediaReporting.advertisingDetails.
    campaignID

ID creatività

Implementazione
Parametri di rete
Reporting
  • Chiave SDK:
    CREATIVE_ID
  • Chiave API:
    media.ad.creativeId
  • Obbligatorio:
    no
  • Tipo:
    stringa
  • Inviato con:
    avvio annuncio, chiusura annuncio
  • Versione SDK min.: 1.5.7
  • Valore di esempio:
    intero o nome (stringa).
  • Descrizione:
    ID della creatività dell’annuncio.
  • Adobe Analytics:
    (a.media.ad.
    creative)
  • Heartbeat:
    (s:meta:
    a.media.ad.creative)
  • Disponibile:
    sì
  • Variabile riservata:
    eVar
  • Scadenza:
    all’hit
  • Nome rapporto:
    ID creatività
  • Dati contestuali:
    (a.media.ad.
    creative)
  • Feed dati:
    adclassificationcreative
  • Audience Manager:
    (c_contextdata.
    a.media.ad.creative)
  • Percorso campo XDM:
    advertising.adAssetReference.creativeID
  • Percorso campo XDM per raccolta:
    mediaCollection.advertisingDetails.creativeID
  • Percorso campo XDM per reporting:
    mediaReporting.advertisingDetails.creativeID

ID sito

Implementazione
Parametri di rete
Reporting
  • Chiave SDK:
    SITE_ID
  • Chiave API:
    media.ad.siteId
  • Obbligatorio:
    no
  • Tipo:
    stringa
  • Inviato con:
    avvio annuncio, chiusura annuncio
  • Versione SDK min.: 1.5.7
  • Valore di esempio:
  • Descrizione:
    ID del sito dell’annuncio.
  • Adobe Analytics:
    (a.media.ad.
    site)
  • Heartbeat:
    (s:meta:
    a.media.ad.site)
  • Disponibile:
    Usa regola di elaborazione personalizzata
  • Variabile riservata:
    eVar
  • Scadenza:
    all’hit
  • Nome rapporto:
    personalizzato
  • Dati contestuali:
    (a.media.ad.
    site)
  • Feed dati:
    N/D
  • Audience Manager:
    (c_contextdata.
    a.media.ad.site)
  • Percorso campo XDM:
    advertising.adAssetReference.siteID
  • Percorso campo XDM per raccolta:
    mediaCollection.advertisingDetails.siteID
  • Percorso campo XDM per reporting:
    mediaReporting.advertisingDetails.siteID

URL creatività

Implementazione
Parametri di rete
Reporting
  • Chiave SDK:
    CREATIVE_URL
  • Chiave API:
    media.ad.creativeURL
  • Obbligatorio:
    no
  • Tipo:
    stringa
  • Inviato con:
    avvio annuncio, chiusura annuncio
  • Versione SDK min.: 1.5.7
  • Valore di esempio:
  • Descrizione:
    URL della creatività dell’annuncio.
  • Adobe Analytics:
    (a.media.ad.
    creativeURL)
  • Heartbeat:
    (s:meta:<c/ode> a.media.ad.creativeURL) ``
  • Disponibile:
    Usa regola di elaborazione personalizzata
  • Variabile riservata:
    eVar
  • Scadenza:
    all’hit
  • Nome rapporto:
    personalizzato
  • Dati contestuali:
    (a.media.ad.
    creativeURL)
  • Feed dati:
    N/D
  • Audience Manager:
    (c_contextdata.
    a.media.ad.creativeURL)
  • Percorso campo XDM:
    advertising.adAssetReference.creativeURL
  • Percorso campo XDM per raccolta:
    mediaCollection.advertisingDetails.
    creativeURL
  • Percorso campo XDM per reporting:
    mediaReporting.advertisingDetails.
    creativeURL

ID posizionamento

Implementazione
Parametri di rete
Reporting
  • Chiave SDK:
    PLACEMENT_ID
  • Chiave API:
    media.ad.placementId
  • Obbligatorio:
    no
  • Tipo:
    stringa
  • Inviato con:
    avvio annuncio, chiusura annuncio
  • Versione SDK min.: 1.5.7
  • Valore di esempio:
  • Descrizione:
    ID posizionamento dell’annuncio.
  • Adobe Analytics:
    (a.media.ad.
    placement)
  • Heartbeat:
    (s:meta:
    a.media.ad.placement)
  • Disponibile:
    Usa regola di elaborazione personalizzata
  • Variabile riservata:
    eVar
  • Scadenza:
    all’hit
  • Nome rapporto:
    personalizzato
  • Dati contestuali:
    (a.media.ad.
    placement)
  • Feed dati:
    N/D
  • Audience Manager:
    (c_contextdata.
    a.media.ad.placement)
  • Percorso campo XDM:
    advertising.adAssetReference.placementID
  • Percorso campo XDM per raccolta:
    mediaCollection.advertisingDetails.
    placementID
  • Percorso campo XDM per reporting:
    mediaReporting.advertisingDetails.
    placementID

Metriche annuncio ad-metrics

Avvio annuncio

Implementazione
Parametri di rete
Reporting
  • Chiave SDK:
    impostata automaticamente
  • Chiave API:
    N/D
  • Obbligatorio:
    sì
  • Tipo:
    stringa
  • Inviato con:
    avvio annuncio
  • Versione SDK min.: qualsiasi
  • Valore di esempio:
    TRUE
  • Descrizione:
    numero di avvii degli annunci video.
  • Adobe Analytics:
    (a.media.ad.
    view)
  • Heartbeat:
    (s:event:type=start)
    (s:asset:type=ad) ``
  • Disponibile:
    Sì
  • Variabile riservata:
    evento
  • Nome rapporto:
    avvio annuncio
  • Feed dati:
    N/D
  • Dati contestuali:
    (a.media.ad.
    view)
  • Audience Manager:
    (c_contextdata.
    a.media.ad.view)
  • Percorso campo XDM:
    advertising.starts.value > 0 => “TRUE”
  • Percorso campo XDM per reporting:
    mediaReporting.advertisingDetails.isStarted

Annuncio completato

Implementazione
Parametri di rete
Reporting
  • Chiave SDK:
    impostata automaticamente
  • Chiave API:
    N/D
  • Obbligatorio:
    sì
  • Tipo:
    stringa
  • Inviato con:
    chiusura annuncio
  • Versione SDK min.: qualsiasi
  • Valore di esempio:
    TRUE
  • Descrizione:
    numero di annunci video completati.
  • Adobe Analytics:
    (a.media.ad.
    complete)
  • Heartbeat:
    (s:event:type=complete)
    (s:asset:type=ad)
  • Disponibile:
    Sì
  • Variabile riservata:
    evento
  • Nome rapporto:
    completamento annuncio
  • Feed dati:
    N/D
  • Dati contestuali:
    (a.media.ad.
    complete)
  • Audience Manager:
    (c_contextdata.
    a.media.ad.complete)
  • Percorso campo XDM:
    advertising.completes.value > 0 => “TRUE”
  • Percorso campo XDM per reporting:
    mediaReporting.advertisingDetails.
    isCompleted

Tempo trascorso dell’annuncio

Implementazione
Parametri di rete
Reporting
  • Chiave SDK:
    impostata automaticamente
  • Chiave API:
    N/D
  • Obbligatorio:
    sì
  • Tipo:
    stringa
  • Inviato con:
    chiusura annuncio
  • Versione SDK min.: qualsiasi
  • Valore di esempio:
    15
  • Descrizione:
    la quantità totale di tempo, in secondi, trascorsa a guardare l’annuncio (ovvero, il numero di secondi riprodotti). Il valore verrà visualizzato nel formato ora (HH:MM:SS) in Analysis Workspace e Reports & Analytics. In Feed dati, Data Warehouse e API di reporting i valori verranno visualizzati in secondi.
    Data di rilascio: 13/09/18
  • Adobe Analytics:
    (a.media.ad.
    timePlayed)
  • Heartbeat:
  • Disponibile:
    sì
  • Variabile riservata:
    evento
  • Nome rapporto:
    tempo trascorso dell’annuncio
  • Feed dati:
    N/D
  • Dati contestuali:
    (a.media.ad.
    timePlayed)
  • Audience Manager:
    (c_contextdata.
    a.media.ad.timePlayed)
  • Percorso campo XDM:
    advertising.timePlayed.value
  • Percorso campo XDM per reporting:
    mediaReporting.advertisingDetails.
    timePlayed

API createAdObject:

API createAdBreakObject:

API MediaHeartbeatConfig:

recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb