DokumentationAnalyticsAnvändarhandbok om Media Analytics

Annonsparametrar ad-parameters

Last update: Fri Mar 08 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Skapat för:

  • User
  • Admin
  • Developer

I det här avsnittet presenteras en lista med videoannonsdata, inklusive kontextdatavärden, som Adobe samlar in via lösningsvariabler.

Beskrivning av tabelldata:

  • Implementering: Information om genomförandevärden och krav

    • Nyckel - Variabel, ange antingen manuellt i appen eller automatiskt med Adobe Media SDK.
    • Obligatoriskt - Anger om parametern krävs för grundläggande videospårning.
    • Typ - Anger vilken typ av variabel som ska anges, strängen eller talet.
    • Skickat med - Anger när data skickas: Mediestart är det analysanrop som skickas vid mediestart, Annonsstart är det analysanrop som skickas vid annonsstart och så vidare, Stäng anrop är de kompilerade analysanrop som skickas direkt från hjärtslagservern till analysservern i slutet av mediesessionen eller slutet av annonsen, kapitlet osv. Stäng anrop är inte tillgängliga i nätverkspaketanrop.
    • Min. SDK-version - Anger vilken SDK-version du behöver för att komma åt parametern.
    • Exempelvärde - Visar exempel på vanlig variabelanvändning.

  • Nätverksparametrar: Visar de värden som skickas till Adobe Analytics- eller pulsslagservrar. I den här kolumnen visas namnen på de parametrar som visas i nätverksanrop som genereras av Adobe Media SDK:er.

  • Rapportering: Information om hur du visar och analyserar videodata.

    • Tillgänglig - Anger om data är tillgängliga i rapporter som standard (Ja), eller kräver anpassad installation (Egen)
    • Reserverad variabel - Anger om data fångas in som en händelse, eVar, prop eller klassificering i en reserverad variabel.
    • Rapportnamn - Namn på Adobe Analytics-rapport för variabel
    • Kontextdata - Namnet på de Adobe Analytics-kontextdata som skickas till rapportservern och som används i bearbetningsregler.
    • Datafeed - Kolumnnamn för variabeln som hittades i dataflödena Clickstream eller Live Stream
    • Audience Manager - Trait name found in Adobe Audience Manager
IMPORTANT
Ändra inte klassificeringsnamnen för de variabler som listas nedan
beskrivs under Rapportering/Reserverad variabel som"klassificering".
Medieklassificeringarna definieras när en rapportserie aktiveras för media
spårning. emellanåt lägger Adobe till nya egenskaper och när detta inträffar,
kunderna måste återaktivera sina rapporteringsprogram för att få tillgång till nya medier
egenskaper. Under uppdateringsprocessen avgör Adobe om
klassificeringar aktiveras genom att namnen på variablerna kontrolleras. Om något av
om de saknas lägger Adobe till de saknade igen.

Lägg till videodata ad-video-data

Annons-ID

Implementering
Nätverksparametrar
Rapportering
  • SDK-nyckel:
    adId
  • API-nyckel:
    media.ad.id
  • Obligatoriskt:
    Ja
  • Typ:
    string
  • Skickat med:
    Annonsstart, annonsstängning
  • Min. SDK-version: Alla
  • Exempelvärde:
    2125"
  • Beskrivning:
    ID för annonsen. (Valfritt heltal och/eller bokstavskombination)
  • Adobe Analytics:
    (a.media.ad.
    namn)
  • Hjärtslag:
    (s:asset:ad_id)
  • Tillgängligt:
    Ja
  • Reserverad variabel:
    eVar
  • Förfallodatum:
    Vid besök
  • Rapportnamn:
    Annons
  • Kontextdata:
    (a.media.ad.
    namn)
  • Datafeed:
    video
  • Audience Manager:
    (c_contextdata.
    a.media.ad.name)
  • Sökväg till XDM-fält:
    advertising.adAssetReference.@id
  • Sökväg till XDM-samlingsfält:
    mediaCollection.advertisingDetails.name
  • Sökväg till Reporting XDM-fält:
    mediaReporting.advertisingDetails.name

Lägg till i rutposition

Implementering
Nätverksparametrar
Rapportering
  • SDK-nyckel:
    position
  • API-nyckel:
    media.ad.podPosition
  • Obligatoriskt:
    Ja
  • Typ:
    tal
  • Skickat med:
    Annonsstart, annonsstängning
  • Min. SDK-version: Alla
  • Exempelvärde:
    1
  • Beskrivning:
    Platsen (index) för annonsen inuti den överordnade annonsbrytningen. Den första annonsen har index 0, den andra annonsen har index 1, osv.
  • Adobe Analytics:
    (a.media.ad.
    podPosition)
  • Hjärtslag:
    (s:asset:pod_position)
  • Tillgängligt:
    Ja
  • Reserverad variabel:
    eVar
  • Förfallodatum:
    Vid TRIT
  • Rapportnamn:
    Lägg till i rutposition
  • Kontextdata:
    (a.media.ad.
    podPosition)
  • Datafeed:
    videoadinpod
  • Audience Manager:
    (c_contextdata.
    a.media.ad.podPosition
  • Sökväg till XDM-fält:
    advertising.adAssetViewDetails.index
  • Sökväg till XDM-samlingsfält:
    mediaCollection.advertisingDetails.index
  • Sökväg till Reporting XDM-fält:
    mediaReporting.advertisingDetails.index

Annonslängd

Implementering
Nätverksparametrar
Rapportering
  • SDK-nyckel:
    length
  • API-nyckel:
    media.ad.length
  • Obligatoriskt:
    Ja
  • Typ:
    tal
  • Skickat med:
    Annonsstart, annonsstängning
  • Min. SDK-version: 1.5.1
  • Exempelvärde:
    "15"
  • Beskrivning:
    Längd på videoannonsen i sekunder.
  • Adobe Analytics:
    (a.media.ad.
    längd)
  • Hjärtslag:
    (l:asset:ad_length)
  • Tillgängligt:
    Ja
  • Reserverad variabel:
    eVar och klassificering
  • Förfallodatum:
    Vid TRIT
  • Rapportnamn:
    Annonslängd och annonslängd (variabel)
  • Kontextdata:
    (a.media.ad.
    längd)
  • Datafeed:
    videoadlength
  • Audience Manager:
    (c_contextdata.
    a.media.ad.length)
  • Sökväg till XDM-fält:
    advertising.adAssetReference.
    xmpDM:duration
  • Sökväg till XDM-samlingsfält:
    mediaCollection.advertisingDetails.length
  • Sökväg till Reporting XDM-fält:
    mediaReporting.advertisingDetails.length

Namn på annonsspelaren

Implementering
Nätverksparametrar
Rapportering
  • SDK-nyckel:
    playerName
  • API-nyckel:
    media.ad.playerName
  • Obligatoriskt:
    Ja
  • Typ:
    string
  • Skickat med:
    Annonsstart, annonsstängning
  • Min. SDK-version: Alla
  • Exempelvärde:
    "Freewheel"
  • Beskrivning:
    Namnet på spelaren som ansvarar för att återge annonsen.
  • Adobe Analytics:
    (a.media.ad.
    playerName)
  • Hjärtslag:
    (s:sp:player_name)
  • Tillgängligt:
    Ja
  • Reserverad variabel:
    eVar
  • Förfallodatum:
    Vid TRIT
  • Rapportnamn:
    Namn på annonsspelaren
  • Kontextdata:
    (a.media.ad.
    playerName)
  • Datafeed:
    videoadplayername
  • Audience Manager:
    (c_contextdata.
    a.media.ad.playerName)
  • Sökväg till XDM-fält:
    advertising.adAssetViewDetails.playerName
  • Sökväg till XDM-samlingsfält:
    mediaCollection.advertisingDetails.
    playerName
  • Sökväg till Reporting XDM-fält:
    mediaReporting.advertisingDetails.
    playerName

Namn på annonsbrytning

Implementering
Nätverksparametrar
Rapportering
  • SDK-nyckel:
    name
  • API-nyckel:
    media.ad.podEgetNamn
  • Obligatoriskt:
    SDK: Ja; API: Nej.
  • Typ:
    string
  • Skickat med:
    Annonsstart, annonsstängning
  • Min. SDK-version: Alla
  • Exempelvärde:
    "pre-roll"
  • Beskrivning:
    Ad Breaks egna namn.
  • Adobe Analytics:
    (a.media.ad.
    podFriendlyName)
  • Hjärtslag:
    (s:asset:pod_name)
  • Tillgängligt:
    Ja
  • Reserverad variabel:
    Klassificering
  • Rapportnamn:
    Pod Name
  • Kontextdata:
    (a.media.ad.
    podFriendlyName)
  • Datafeed:
    Ej tillämpligt
  • Audience Manager:
    (c_contextdata.
    a.media.ad.podFriendlyName)
  • Sökväg till XDM-fält:
    advertising.adAssetViewDetails.
    adBreak.dc:title
  • Sökväg till XDM-samlingsfält:
    mediaCollection.advertisingPodDetails.
    friendlyName
  • Sökväg till Reporting XDM-fält:
    mediaReporting.advertisingPodDetails.
    friendlyName

Annonsbrytningsindex

Implementering
Nätverksparametrar
Rapportering
  • SDK-nyckel:
    position
  • API-nyckel:
    media.ad.podPosition
  • Obligatoriskt:
    Ja
  • Typ:
    tal
  • Skickat med:
  • Min. SDK-version: Alla
  • Exempelvärde:
    1
  • Beskrivning:
    Indexvärdet för annonsbrytningen inuti innehållet med början på 1. Den här egenskapen används endast av Media SDK för att generera Pod ID.
  • Adobe Analytics:
  • Hjärtslag:
  • Tillgängligt:
    Nej
  • Reserverad variabel:
    Ej tillämpligt
  • Rapportnamn:
    Ej tillämpligt
  • Kontextdata:
  • Datafeed:
    Ej tillämpligt
  • Audience Manager:
  • Sökväg till XDM-fält:
    advertising.adAssetViewDetails.index
  • Sökväg till XDM-samlingsfält:
    mediaCollection.advertisingPodDetails.index

Annonsbrytningsposition

Implementering
Nätverksparametrar
Rapportering
  • SDK-nyckel:
    startTime
  • API-nyckel:
    media.ad.podSecond
  • Obligatoriskt:
    Ja
  • Typ:
    tal
  • Skickat med:
    Annonsstart, annonsstängning
  • Min. SDK-version: Alla
  • Exempelvärde:
    90
  • Beskrivning:
    Annonsens förskjutning i innehållet, i sekunder.
  • Adobe Analytics:
    (a.media.ad.
    podSecond)
  • Hjärtslag:
    (l:asset:pod_offset)
  • Tillgängligt:
    Ja
  • Reserverad variabel:
    Klassificering
  • Rapportnamn:
    Pod Position
  • Kontextdata:
    (a.media.ad.
    podSecond)
  • Datafeed:
    Ej tillämpligt
  • Audience Manager:
    (c_contextdata.
    a.media.ad.podSecond
  • Sökväg till XDM-fält:
    advertising.adAssetViewDetails.adBreak.
    offset
  • Sökväg till XDM-samlingsfält:
    mediaCollection.advertisingPodDetails.
    offset
  • Sökväg till Reporting XDM-fält:
    mediaReporting.advertisingPodDetails.
    offset

ID för annonsbrytning

Implementering
Nätverksparametrar
Rapportering
  • SDK-nyckel:
    Ställ in automatiskt
  • API-nyckel:
    Ej tillämpligt
  • Obligatoriskt:
    Ja
  • Typ:
    string
  • Skickat med:
    Annonsstart, annonsstängning
  • Min. SDK-version: Alla
  • Exempelvärde:
    c4a577424c84067899b807c76722d495_1
  • Adobe Analytics:
    (a.media.ad.
    pod)
  • Hjärtslag:
    (s:asset:pod_id)
  • Tillgängligt:
    Ja
  • Reserverad variabel:
    eVar
  • Förfallodatum:
    Vid TRIT
  • Rapportnamn:
    Annonsruta
  • Kontextdata:
    (a.media.ad.
    pod)
  • Datafeed:
    videoadpod
  • Audience Manager:
  • Sökväg till XDM-fält:
    advertising.adAssetViewDetails.adBreak.@id
  • Sökväg till Reporting XDM-fält:
    mediaReporting.advertisingPodDetails.
    ID

Annonsnamn

Implementering
Nätverksparametrar
Rapportering
  • SDK-nyckel:
    name
  • API-nyckel:
    media.ad.name
  • Obligatoriskt:
    Nej
  • Typ:
    string
  • Skickat med:
    Annonsstart, annonsstängning
  • Min. SDK-version: 1.5.1
  • Exempelvärde:
    "Ford F-150"
  • Beskrivning:
    Annonsens namn. I rapporter är"annonsnamn" klassificeringen och"annonsnamn (variabel)" eVarna.
  • Adobe Analytics:
    (a.media.ad.
    friendlyName)
  • Hjärtslag:
    (s:asset:ad_name)
  • Tillgängligt:
    Ja
  • Reserverad variabel:
    eVar och klassificering
  • Förfallodatum:
    Vid TRIT
  • Rapportnamn:
    Annonsnamn och annonsnamn (variabel)
  • Kontextdata:
    (a.media.ad.
    friendlyName)
  • Datafeed:
    Ej tillämpligt
  • Audience Manager:
    (c_contextdata.
    a.media.ad.friendlyName)
  • Sökväg till XDM-fält:
    advertising.adAssetReference.dc:title
  • Sökväg till XDM-samlingsfält:
    mediaCollection.advertisingDetails.friendlyName
  • Sökväg till Reporting XDM-fält:
    mediaReporting.advertisingDetails.friendlyName

Standard-annonsmetadata standard-ad-metadata

Annonsör

Implementering
Nätverksparametrar
Rapportering
  • SDK-nyckel:
    ADVERTISER
  • API-nyckel:
    media.ad.advertikser
  • Obligatoriskt:
    Nej
  • Typ:
    string
  • Skickat med:
    Annonsstart, annonsstängning
  • Min. SDK-version: 1.5.7
  • Exempelvärde:
  • Beskrivning:
    Företag/varumärke vars produkt visas i annonsen.
  • Adobe Analytics:
    (a.media.ad.
    annonsör)
  • Hjärtslag:
    (s:meta:
    a.media.ad.ad)
  • Tillgängligt:
    Ja
  • Reserverad variabel:
    eVar
  • Förfallodatum:
    Vid TRIT
  • Rapportnamn:
    Annonsör
  • Kontextdata:
    (a.media.ad.
    annonsör)
  • Datafeed:
    videoreklam
  • Audience Manager:
    (c_contextdata.
    a.media.ad.ad)
  • Sökväg till XDM-fält:
    advertising.adAssetReference.publish
  • Sökväg till XDM-samlingsfält:
    mediaCollection.advertisingDetails.publish
  • Sökväg till Reporting XDM-fält:
    mediaReporting.advertisingDetails.publish

Kampanj-ID

Implementering
Nätverksparametrar
Rapportering
  • SDK-nyckel:
    CAMPAIGN_ID
  • API-nyckel:
    media.ad.campaignId
  • Obligatoriskt:
    Nej
  • Typ:
    string
  • Skickat med:
    Annonsstart, annonsstängning
  • Min. SDK-version: 1.5.7
  • Exempelvärde:
    Heltal eller namn (sträng).
  • Beskrivning:
    ID för annonskampanjen.
  • Adobe Analytics:
    (a.media.ad.
    kampanj)
  • Hjärtslag:
    (s:meta:
    a.media.ad.ca)
  • Tillgängligt:
    Ja
  • Reserverad variabel:
    eVar
  • Förfallodatum:
    Vid TRIT
  • Rapportnamn:
    Kampanj-ID
  • Kontextdata:
    (a.media.ad.
    kampanj)
  • Datafeed:
    videokampanj
  • Audience Manager:
    (c_contextdata.
    a.media.ad.ca)
  • Sökväg till XDM-fält:
    advertising.adAssetReference.campaign
  • Sökväg till XDM-samlingsfält:
    mediaCollection.advertisingDetails.
    campaignID
  • Sökväg till Reporting XDM-fält:
    mediaReporting.advertisingDetails.
    campaignID

Kreativt ID

Implementering
Nätverksparametrar
Rapportering
  • SDK-nyckel:
    CREATIVE_ID
  • API-nyckel:
    media.ad.creativeId
  • Obligatoriskt:
    Nej
  • Typ:
    string
  • Skickat med:
    Annonsstart, annonsstängning
  • Min. SDK-version: 1.5.7
  • Exempelvärde:
    Heltal eller namn (sträng).
  • Beskrivning:
    ID för annonsens kreatör.
  • Adobe Analytics:
    (a.media.ad.
    creative)
  • Hjärtslag:
    (s:meta:
    a.media.ad.creative)
  • Tillgängligt:
    Ja
  • Reserverad variabel:
    eVar
  • Förfallodatum:
    Vid TRIT
  • Rapportnamn:
    Kreativt ID
  • Kontextdata:
    (a.media.ad.
    creative)
  • Datafeed:
    adklassificationcreative
  • Audience Manager:
    (c_contextdata.
    a.media.ad.creative)
  • Sökväg till XDM-fält:
    advertising.adAssetReference.creativeID
  • Sökväg till XDM-samlingsfält:
    mediaCollection.advertisingDetails.creativeID
  • Sökväg till Reporting XDM-fält:
    mediaReporting.advertisingDetails.creativeID

Plats-ID

Implementering
Nätverksparametrar
Rapportering
  • SDK-nyckel:
    SITE_ID
  • API-nyckel:
    media.ad.siteId
  • Obligatoriskt:
    Nej
  • Typ:
    string
  • Skickat med:
    Annonsstart, annonsstängning
  • Min. SDK-version: 1.5.7
  • Exempelvärde:
  • Beskrivning:
    ID för annonsplatsen.
  • Adobe Analytics:
    (a.media.ad.
    plats)
  • Hjärtslag:
    (s:meta:
    a.media.ad.site)
  • Tillgängligt:
    Använd anpassad bearbetningsregel
  • Reserverad variabel:
    eVar
  • Förfallodatum:
    Vid TRIT
  • Rapportnamn:
    Egen
  • Kontextdata:
    (a.media.ad.
    plats)
  • Datafeed:
    Ej tillämpligt
  • Audience Manager:
    (c_contextdata.
    a.media.ad.site)
  • Sökväg till XDM-fält:
    advertising.adAssetReference.siteID
  • Sökväg till XDM-samlingsfält:
    mediaCollection.advertisingDetails.siteID
  • Sökväg till Reporting XDM-fält:
    mediaReporting.advertisingDetails.siteID

Kreativ URL

Implementering
Nätverksparametrar
Rapportering
  • SDK-nyckel:
    CREATIVE_URL
  • API-nyckel:
    media.ad.creativeURL
  • Obligatoriskt:
    Nej
  • Typ:
    string
  • Skickat med:
    Annonsstart, annonsstängning
  • Min. SDK-version: 1.5.7
  • Exempelvärde:
  • Beskrivning:
    Webbadress till reklamkreatören.
  • Adobe Analytics:
    (a.media.ad.
    creativeURL)
  • Hjärtslag:
    (s:meta:<c ode=""> a.media.ad.creativeURL) ``
  • Tillgängligt:
    Använd anpassad bearbetningsregel
  • Reserverad variabel:
    eVar
  • Förfallodatum:
    Vid TRIT
  • Rapportnamn:
    Egen
  • Kontextdata:
    (a.media.ad.
    creativeURL)
  • Datafeed:
    Ej tillämpligt
  • Audience Manager:
    (c_contextdata.
    a.media.ad.creativeURL)
  • Sökväg till XDM-fält:
    advertising.adAssetReference.creativeURL
  • Sökväg till XDM-samlingsfält:
    mediaCollection.advertisingDetails.
    creativeURL
  • Sökväg till Reporting XDM-fält:
    mediaReporting.advertisingDetails.
    creativeURL

Placement-ID

Implementering
Nätverksparametrar
Rapportering
  • SDK-nyckel:
    PLACEMENT_ID
  • API-nyckel:
    media.ad.placementId
  • Obligatoriskt:
    Nej
  • Typ:
    string
  • Skickat med:
    Annonsstart, annonsstängning
  • Min. SDK-version: 1.5.7
  • Exempelvärde:
  • Beskrivning:
    Annonsens placerings-ID.
  • Adobe Analytics:
    (a.media.ad.
    placering)
  • Hjärtslag:
    (s:meta:
    a.media.ad.placement)
  • Tillgängligt:
    Använd anpassad bearbetningsregel
  • Reserverad variabel:
    eVar
  • Förfallodatum:
    Vid TRIT
  • Rapportnamn:
    Egen
  • Kontextdata:
    (a.media.ad.
    placering)
  • Datafeed:
    Ej tillämpligt
  • Audience Manager:
    (c_contextdata.
    a.media.ad.placement)
  • Sökväg till XDM-fält:
    advertising.adAssetReference.placementID
  • Sökväg till XDM-samlingsfält:
    mediaCollection.advertisingDetails.
    placementID
  • Sökväg till Reporting XDM-fält:
    mediaReporting.advertisingDetails.
    placementID

Annonsmått ad-metrics

Annonsstart

Implementering
Nätverksparametrar
Rapportering
  • SDK-nyckel:
    Ställ in automatiskt
  • API-nyckel:
    Ej tillämpligt
  • Obligatoriskt:
    Ja
  • Typ:
    string
  • Skickat med:
    Annonsstart
  • Min. SDK-version: Alla
  • Exempelvärde:
    TRUE
  • Beskrivning:
    Antal videoannonser som startar.
  • Adobe Analytics:
    (a.media.ad.
    vy)
  • Hjärtslag:
    (s:event:type=start)
    (s:asset:type=ad) ``
  • Tillgängligt:
    Ja
  • Reserverad variabel:
    event
  • Rapportnamn:
    Annonsöppningar
  • Datafeed:
    Ej tillämpligt
  • Kontextdata:
    (a.media.ad.
    vy)
  • Audience Manager:
    (c_contextdata.
    a.media.ad.vi)
  • Sökväg till XDM-fält:
    advertising.starting.value > 0 => "TRUE"
  • Sökväg till Reporting XDM-fält:
    mediaReporting.advertisingDetails.isStarted

Ad Complete

Implementering
Nätverksparametrar
Rapportering
  • SDK-nyckel:
    Ställ in automatiskt
  • API-nyckel:
    Ej tillämpligt
  • Obligatoriskt:
    Ja
  • Typ:
    string
  • Skickat med:
    Stäng annons
  • Min. SDK-version: Alla
  • Exempelvärde:
    TRUE
  • Beskrivning:
    Antal slutförda videoannonser.
  • Adobe Analytics:
    (a.media.ad.
    complete)
  • Hjärtslag:
    (s:event:type=complete)
    (s:asset:type=ad)
  • Tillgängligt:
    Ja
  • Reserverad variabel:
    event
  • Rapportnamn:
    Ad Completes
  • Datafeed:
    Ej tillämpligt
  • Kontextdata:
    (a.media.ad.
    complete)
  • Audience Manager:
    (c_contextdata.
    a.media.ad.comcomplete)
  • Sökväg till XDM-fält:
    advertising.complete.value > 0 => "TRUE"
  • Sökväg till Reporting XDM-fält:
    mediaReporting.advertisingDetails.
    isCompleted

Annonstid

Implementering
Nätverksparametrar
Rapportering
  • SDK-nyckel:
    Ställ in automatiskt
  • API-nyckel:
    Ej tillämpligt
  • Obligatoriskt:
    Ja
  • Typ:
    string
  • Skickat med:
    Stäng annons
  • Min. SDK-version: Alla
  • Exempelvärde:
    15
  • Beskrivning:
    Den totala tiden (i sekunder) som har ägnats åt att titta på annonsen (dvs. antalet sekunder som har spelats upp). Värdet visas i tidsformat (HH:MM:SS) i Analysis Workspace och Reports & Analytics. I Data Feeds, Data Warehouse och Reporting API:er visas värdena på några sekunder.
    Releasedatum: 09/13/18
  • Adobe Analytics:
    (a.media.ad.
    timePlay)
  • Hjärtslag:
  • Tillgängligt:
    Ja
  • Reserverad variabel:
    event
  • Rapportnamn:
    Annonstid
  • Datafeed:
    Ej tillämpligt
  • Kontextdata:
    (a.media.ad.
    timePlay)
  • Audience Manager:
    (c_contextdata.
    a.media.ad.timePlayed)
  • Sökväg till XDM-fält:
    advertising.timePlayed.value
  • Sökväg till Reporting XDM-fält:
    mediaReporting.advertisingDetails.
    timePlayayed

createAdObject API

createAdBreakObject API

MediaHeartbeatConfig-API

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