DokumentationAnalyticsDirektuppspelning av Media Collection Guide

Annonsparametrar ad-parameters

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Ämnen:

Skapat för:

  • Användare
  • Administratör
  • Utvecklare

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 implementeringsvärden och krav

    • Nyckel - Variabel, antingen manuellt i appen eller automatiskt i Adobe Media SDK.
    • Obligatorisk - Anger om parametern krävs för grundläggande videospårning.
    • Typ - Anger typen för variabeln som ska anges, strängen eller talet.
    • Skickat med - Anger när data skickas: Mediestart är det analysanrop som skickas vid mediestart, Ad Start är det analysanrop som skickas vid annonsstart och så vidare. Close -anropen är de kompilerade analysanrop som skickas direkt från hjärtslagsservern till analysservern i slutet av mediesessionen eller i slutet annons, kapitel 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 om det krävs en anpassad konfiguration (Anpassad)
    • Reserverad variabel - Anger om data hämtas som en händelse, eVar, prop eller klassificering i en reserverad variabel.
    • Rapportnamn - Namn på analysrapport för Adobe för variabel
    • Kontextdata - Namnet på de Adobe Analytics-kontextdata som skickas till rapportservern och används i bearbetningsregler.
    • Datafeed - kolumnnamn för variabel som hittas i dataflöden från 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:
    sträng
  • Skickat med:
    Lägg till, Lägg till och stäng
  • Min. SDK-version: Alla
  • Exempelvärde:
    "2125"
  • Beskrivning:
    ID för annonsen. (Valfritt heltal och/eller bokstavskombination)
  • Adobe Analytics:
    (a.media.ad).
    namn)
  • pulsslag:
    (s:asset:ad_id})
  • Tillgänglig:
    Ja
  • Reserverad variabel:
    eVar
  • Förfaller:
    vid BESÖK
  • Rapportnamn:
    Annons
  • Kontextdata:
    (a.media.ad).
    namn)
  • Datafeed:
    videoad
  • 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
  • Rapporterar XDM-fältsökväg:
    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:
    Lägg till, Lägg till och stäng
  • Min. SDK-version: Alla
  • Exempelvärde:
    1
  • Beskrivning:
    Positionen (indexvärdet) 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)
  • pulsslag:
    (s:asset:pod_position))
  • Tillgänglig:
    Ja
  • Reserverad variabel:
    eVar
  • Förfaller:
    vid HIT
  • Rapportnamn:
    Lägg till i rutposition
  • Kontextdata:
    (a.media.ad).
    podPosition)
  • Datafeed:
    videoadinpod
  • Audience Manager:
    (c_contextdata.
    a.media.ad.podPosition)
  • XDM-fältsökväg:
    advertising.adAssetViewDetails.index
  • Sökväg till XDM-samlingsfält:
    mediaCollection.advertisingDetails.index
  • Rapporterar XDM-fältsökväg:
    mediaReporting.advertisingDetails.index

Annonslängd

Implementering
Nätverksparametrar
Rapportering
  • SDK-nyckel:
    length
  • API-nyckel:
    media.ad.length
  • Obligatoriskt:
    Ja
  • Typ:
    tal
  • Skickat med:
    Lägg till, Lägg till och stäng
  • Min. SDK-version: 1.5.1
  • Exempelvärde:
    "15"
  • Beskrivning:
    Längd på videoannons i sekunder.
  • Adobe Analytics:
    (a.media.ad).
    längd)
  • pulsslag:
    (l:asset:ad_length)
  • Tillgänglig:
    Ja
  • Reserverad variabel:
    eVar och klassificering
  • Förfaller:
    vid HIT
  • Rapportnamn:
    Lägg till längd och annonslängd (variabel)
  • Kontextdata:
    (a.media.ad).
    längd)
  • Datafeed:
    videolängd
  • 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
  • Rapporterar XDM-fältsökväg:
    mediaReporting.advertisingDetails.length

Namn på annonsspelaren

Implementering
Nätverksparametrar
Rapportering
  • SDK-nyckel:
    playerName
  • API-nyckel:
    media.ad.playerName
  • Obligatoriskt:
    Ja
  • Typ:
    sträng
  • Skickat med:
    Lägg till, Lägg till och stäng
  • Min. SDK-version: Alla
  • Exempelvärde:
    "Freewheel"
  • Beskrivning:
    Namnet på spelaren som ansvarar för att återge annonsen.
  • Adobe Analytics:
    (a.media.ad).
    playerName)
  • pulsslag:
    (s:sp:player_name))
  • Tillgänglig:
    Ja
  • Reserverad variabel:
    eVar
  • Förfaller:
    vid HIT
  • Rapportnamn:
    Ad Player-namn
  • Kontextdata:
    (a.media.ad).
    playerName)
  • Datafeed:
    videoadplayername
  • Audience Manager:
    (c_contextdata.
    a.media.ad.playerName)
  • XDM-fältsökväg:
    advertising.adAssetViewDetails.playerName
  • Sökväg till XDM-samlingsfält:
    mediaCollection.advertisingDetails.
    playerName
  • Rapporterar XDM-fältsökväg:
    mediaReporting.advertisingDetails.
    playerName

Namn på annonsbrytning

Implementering
Nätverksparametrar
Rapportering
  • SDK-nyckel:
    namn
  • API-nyckel:
    media.ad.podFriendlyName
  • Obligatoriskt:
    SDK: Ja; API: Nej.
  • Typ:
    sträng
  • Skickat med:
    Lägg till, Lägg till och stäng
  • Min. SDK-version: Alla
  • Exempelvärde:
    "pre-roll"
  • Beskrivning:
    Ad Breaks egna namn.
  • Adobe Analytics:
    (a.media.ad).
    podFriendlyName)
  • pulsslag:
    (s:asset:pod_name))
  • Tillgänglig:
    Ja
  • Reserverad variabel:
    Klassificering
  • Rapportnamn:
    Podnamn
  • 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
  • Rapporterar XDM-fältsökväg:
    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 i innehållet med början vid 1. Den här egenskapen används endast av Media SDK för att generera Pod-ID:t.
  • Adobe Analytics:
  • pulsslag:
  • Tillgänglig:
    Nej
  • Reserverad variabel:
    Ej tillämpligt
  • Rapportnamn:
    Ej tillämpligt
  • Kontextdata:
  • Datafeed:
    Ej tillämpligt
  • Audience Manager:
  • XDM-fältsökväg:
    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:
    Lägg till, Lägg till och stäng
  • Min. SDK-version: Alla
  • Exempelvärde:
    90
  • Beskrivning:
    Annonsbrytningens förskjutning inuti innehållet, i sekunder.
  • Adobe Analytics:
    (a.media.ad).
    podSecond)
  • pulsslag:
    (l:asset:pod_offset))
  • Tillgänglig:
    Ja
  • Reserverad variabel:
    Klassificering
  • Rapportnamn:
    Pod Position
  • Kontextdata:
    (a.media.ad).
    podSecond)
  • Datafeed:
    Ej tillämpligt
  • Audience Manager:
    (c_contextdata.
    a.media.ad.podSecond)
  • XDM-fältsökväg:
    advertising.adAssetViewDetails.adBreak.
    förskjutning
  • Sökväg till XDM-samlingsfält:
    mediaCollection.advertisingPodDetails.
    förskjutning
  • Rapporterar XDM-fältsökväg:
    mediaReporting.advertisingPodDetails.
    förskjutning

ID för annonsbrytning

Implementering
Nätverksparametrar
Rapportering
  • SDK-nyckel:
    Ange automatiskt
  • API-nyckel:
    Ej tillämpligt
  • Obligatoriskt:
    Ja
  • Typ:
    sträng
  • Skickat med:
    Lägg till, Lägg till och stäng
  • Min. SDK-version: Alla
  • Exempelvärde:
    c4a577424c84067899b807c76722d495_1
  • Adobe Analytics:
    (a.media.ad).
    pod)
  • pulsslag:
    (s:asset:pod_id))
  • Tillgänglig:
    Ja
  • Reserverad variabel:
    eVar
  • Förfaller:
    vid HIT
  • Rapportnamn:
    Annonspod
  • Kontextdata:
    (a.media.ad).
    pod)
  • Datafeed:
    videoadpod
  • Audience Manager:
  • XDM-fältsökväg:
    advertising.adAssetViewDetails.adBreak.@id
  • Rapporterar XDM-fältsökväg:
    mediaReporting.advertisingPodDetails.
    ID

Annonsnamn

Implementering
Nätverksparametrar
Rapportering
  • SDK-nyckel:
    namn
  • API-nyckel:
    media.ad.name
  • Obligatoriskt:
    Nej
  • Typ:
    sträng
  • Skickat med:
    Lägg till, Lägg till och stäng
  • Min. SDK-version: 1.5.1
  • Exempelvärde:
    "Ford F-150"
  • Beskrivning:
    Annonsens eget namn. I rapporter är"annonsnamn" klassificeringen och"annonsnamn (variabel)" eVarna.
  • Adobe Analytics:
    (a.media.ad).
    friendlyName)
  • pulsslag:
    (s:asset:ad_name))
  • Tillgänglig:
    Ja
  • Reserverad variabel:
    eVar och klassificering
  • Förfaller:
    vid HIT
  • 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
  • Rapporterar XDM-fältsökväg:
    mediaReporting.advertisingDetails.friendlyName

Standard-annonsmetadata standard-ad-metadata

Annonsör

Implementering
Nätverksparametrar
Rapportering
  • SDK-nyckel:
    ADVERTISER
  • API-nyckel:
    media.ad.advertiser
  • Obligatoriskt:
    Nej
  • Typ:
    sträng
  • Skickat med:
    Lägg till, Lägg till och stäng
  • Min. SDK-version: 1.5.7
  • Exempelvärde:
  • Beskrivning:
    Företag/varumärke vars produkt visas i annonsen.
  • Adobe Analytics:
    (a.media.ad).
    annonser)
  • pulsslag:
    (s:meta:)
    a.media.ad.advertiser)
  • Tillgänglig:
    Ja
  • Reserverad variabel:
    eVar
  • Förfaller:
    vid HIT
  • Rapportnamn:
    Advertiser
  • Kontextdata:
    (a.media.ad).
    annonser)
  • Datafeed:
    videoreklerare
  • Audience Manager:
    (c_contextdata.
    a.media.ad.advertiser)
  • XDM-fältsökväg:
    advertising.adAssetReference.publish
  • Sökväg till XDM-samlingsfält:
    mediaCollection.advertisingDetails.publishser
  • Rapporterar XDM-fältsökväg:
    mediaReporting.advertisingDetails.publish

Kampanj-ID

Implementering
Nätverksparametrar
Rapportering
  • SDK-nyckel:
    CAMPAIGN_ID
  • API-nyckel:
    media.ad.campaignId
  • Obligatoriskt:
    Nej
  • Typ:
    sträng
  • Skickat med:
    Lägg till, Lägg till och stäng
  • Min. SDK-version: 1.5.7
  • Exempelvärde:
    Heltal eller namn (sträng).
  • Beskrivning:
    ID för annonskampanjen.
  • Adobe Analytics:
    (a.media.ad).
    kampanj)
  • pulsslag:
    (s:meta:)
    a.media.ad.caämta)
  • Tillgänglig:
    Ja
  • Reserverad variabel:
    eVar
  • Förfaller:
    vid HIT
  • Rapportnamn:
    Kampanj-ID
  • Kontextdata:
    (a.media.ad).
    kampanj)
  • Datafeed:
    videokamera
  • Audience Manager:
    (c_contextdata.
    a.media.ad.caämta)
  • Sökväg till XDM-fält:
    advertising.adAssetReference.campaign
  • Sökväg till XDM-samlingsfält:
    mediaCollection.advertisingDetails.
    campaignID
  • Rapporterar XDM-fältsökväg:
    mediaReporting.advertisingDetails.
    campaignID

Kreativt ID

Implementering
Nätverksparametrar
Rapportering
  • SDK-nyckel:
    CREATIVE_ID
  • API-nyckel:
    media.ad.creativeId
  • Obligatoriskt:
    Nej
  • Typ:
    sträng
  • Skickat med:
    Lägg till, Lägg till och stäng
  • Min. SDK-version: 1.5.7
  • Exempelvärde:
    Heltal eller namn (sträng).
  • Beskrivning:
    ID för annonsskaparen.
  • Adobe Analytics:
    (a.media.ad).
    kreativ)
  • pulsslag:
    (s:meta:)
    a.media.ad.creative)
  • Tillgänglig:
    Ja
  • Reserverad variabel:
    eVar
  • Förfaller:
    vid HIT
  • Rapportnamn:
    Kreativt ID
  • Kontextdata:
    (a.media.ad).
    kreativ)
  • Datafeed:
    adklassifikationcreative
  • 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
  • Rapporterar XDM-fältsökväg:
    mediaReporting.advertisingDetails.creativeID

Plats-ID

Implementering
Nätverksparametrar
Rapportering
  • SDK-nyckel:
    SITE_ID
  • API-nyckel:
    media.ad.siteId
  • Obligatoriskt:
    Nej
  • Typ:
    sträng
  • Skickat med:
    Lägg till, Lägg till och stäng
  • Min. SDK-version: 1.5.7
  • Exempelvärde:
  • Beskrivning:
    ID för annonsplatsen.
  • Adobe Analytics:
    (a.media.ad).
    plats)
  • pulsslag:
    (s:meta:)
    a.media.ad.site)
  • Tillgängligt:
    Använd anpassad bearbetningsregel
  • Reserverad variabel:
    eVar
  • Förfaller:
    vid HIT
  • Rapportnamn:
    Anpassat
  • 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
  • Rapporterar XDM-fältsökväg:
    mediaReporting.advertisingDetails.siteID

Kreativ URL

Implementering
Nätverksparametrar
Rapportering
  • SDK-nyckel:
    CREATIVE_URL
  • API-nyckel:
    media.ad.creativeURL
  • Obligatoriskt:
    Nej
  • Typ:
    sträng
  • Skickat med:
    Lägg till, Lägg till och stäng
  • Min. SDK-version: 1.5.7
  • Exempelvärde:
  • Beskrivning:
    URL för annonsskaparen.
  • Adobe Analytics:
    (a.media.ad).
    creativeURL)
  • pulsslag:
    (s:meta:<c/ode> a.media.ad.creativeURL) ``
  • Tillgängligt:
    Använd anpassad bearbetningsregel
  • Reserverad variabel:
    eVar
  • Förfaller:
    vid HIT
  • Rapportnamn:
    Anpassat
  • 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
  • Rapporterar XDM-fältsökväg:
    mediaReporting.advertisingDetails.
    creativeURL

Placement-ID

Implementering
Nätverksparametrar
Rapportering
  • SDK-nyckel:
    PLACEMENT_ID
  • API-nyckel:
    media.ad.placementId
  • Obligatoriskt:
    Nej
  • Typ:
    sträng
  • Skickat med:
    Lägg till, Lägg till och stäng
  • Min. SDK-version: 1.5.7
  • Exempelvärde:
  • Beskrivning:
    Annonsens placerings-ID.
  • Adobe Analytics:
    (a.media.ad).
    placering)
  • pulsslag:
    (s:meta:)
    a.media.ad.placement)
  • Tillgängligt:
    Använd anpassad bearbetningsregel
  • Reserverad variabel:
    eVar
  • Förfaller:
    vid HIT
  • Rapportnamn:
    Anpassat
  • 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
  • Rapporterar XDM-fältsökväg:
    mediaReporting.advertisingDetails.
    placementID

Annonsmått ad-metrics

Annonsstart

Implementering
Nätverksparametrar
Rapportering
  • SDK-nyckel:
    Ange automatiskt
  • API-nyckel:
    Ej tillämpligt
  • Obligatoriskt:
    Ja
  • Typ:
    sträng
  • Skickat med:
    annonsstart
  • Min. SDK-version: Alla
  • Exempelvärde:
    TRUE
  • Beskrivning:
    Antal videoannonser som startar.
  • Adobe Analytics:
    (a.media.ad).
    vy)
  • pulsslag:
    (s:event:type=start)
    (s:asset:type=ad) ``
  • Tillgänglig:
    Ja
  • Reserverad variabel:
    händelse
  • Rapportnamn:
    Ad Starts
  • Datafeed:
    Ej tillämpligt
  • Kontextdata:
    (a.media.ad).
    vy)
  • Audience Manager:
    (c_contextdata.
    a.media.ad.viytt)
  • XDM-fältsökväg:
    advertising.starting.value > 0 => "TRUE"
  • Rapporterar XDM-fältsökväg:
    mediaReporting.advertisingDetails.isStarted

Ad Complete

Implementering
Nätverksparametrar
Rapportering
  • SDK-nyckel:
    Ange automatiskt
  • API-nyckel:
    Ej tillämpligt
  • Obligatoriskt:
    Ja
  • Typ:
    sträng
  • Skickat med:
    och stäng
  • Min. SDK-version: Alla
  • Exempelvärde:
    TRUE
  • Beskrivning:
    Antal videoannonser har slutförts.
  • Adobe Analytics:
    (a.media.ad).
    slutförd)
  • pulsslag:
    (s:event:type=complete)
    (s:asset:type=ad)
  • Tillgänglig:
    Ja
  • Reserverad variabel:
    händelse
  • Rapportnamn:
    Annonsen är klar
  • Datafeed:
    Ej tillämpligt
  • Kontextdata:
    (a.media.ad).
    slutförd)
  • Audience Manager:
    (c_contextdata.
    a.media.ad.comcomplete)
  • XDM-fältsökväg:
    advertising.complete.value > 0 => "TRUE"
  • Rapporterar XDM-fältsökväg:
    mediaReporting.advertisingDetails.
    isCompleted

Annonstid

Implementering
Nätverksparametrar
Rapportering
  • SDK-nyckel:
    Ange automatiskt
  • API-nyckel:
    Ej tillämpligt
  • Obligatoriskt:
    Ja
  • Typ:
    sträng
  • Skickat med:
    och stäng
  • 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).
    timePlayed)
  • pulsslag:
  • Tillgänglig:
    Ja
  • Reserverad variabel:
    händelse
  • Rapportnamn:
    Annonstid
  • Datafeed:
    Ej tillämpligt
  • Kontextdata:
    (a.media.ad).
    timePlayed)
  • Audience Manager:
    (c_contextdata.
    a.media.ad.timePlay)
  • Sökväg till XDM-fält:
    advertising.timePlayed.value
  • Rapporterar XDM-fältsökväg:
    mediaReporting.advertisingDetails.
    timePlay

createAdObject API

createAdBreakObject API

MediaHeartbeatConfig-API

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