Annonsparametrar ad-parameters
I det här avsnittet finns 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 av 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å Adobe Analytics-rapport 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. Då och då 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.
>beskrivs under Rapportering/Reserverad variabel som"klassificering".
>Medieklassificeringarna definieras när en rapportserie aktiveras för media
>spårning. Då och då 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.
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: (inaktuellt)
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: (inaktuell)
advertising.adAssetViewDetails.index - Sökväg till XDM-samlingsfält:
mediaCollection.advertisingDetails.podPosition - Rapporterar XDM-fältsökväg:
mediaReporting.advertisingDetails.podPosition
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: (inaktuellt)
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: (inaktuell)
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: (inaktuellt)
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.podIndex - 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.
- 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: (inaktuell)
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) - Sökväg till XDM-fält: (inaktuellt)
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:
- Sökväg till XDM-fält: (inaktuellt)
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)" eVar.
- 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:
videoadname - Audience Manager:
(c_contextdata.
a.media.ad.friendlyName) - Sökväg till XDM-fält: (inaktuellt)
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 Key:
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:
videoannonsör - Audience Manager:
(c_contextdata.
a.media.ad.advertiser) - XDM-fältsökväg: (inaktuell)
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:
videokampanj - Audience Manager:
(c_contextdata.
a.media.ad.caämta) - Sökväg till XDM-fält: (inaktuellt)
advertising.adAssetReference.campaign - Sökväg till XDM-samlingsfält:
mediaCollection.advertisingDetails.
campaignID - Rapporterar XDM-fältsökväg:
mediaReporting.advertisingDetails.
campaignID
CREATIVE 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:
Creative-ID - Kontextdata:
(a.media.ad).
kreativ) - Datafeed:
adklassifikationcreative - Audience Manager:
(c_contextdata.
a.media.ad.creative) - Sökväg till XDM-fält: (inaktuellt)
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: (inaktuellt)
advertising.adAssetReference.siteID - Sökväg till XDM-samlingsfält:
mediaCollection.advertisingDetails.siteID - Rapporterar XDM-fältsökväg:
mediaReporting.advertisingDetails.siteID
CREATIVE 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) - XDM-fältsökväg: (inaktuell)
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: (inaktuellt)
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:
videoadstart - Kontextdata:
(a.media.ad).
vy) - Audience Manager:
(c_contextdata.
a.media.ad.viytt) - Sökväg till XDM-fält: (inaktuellt)
advertising.imponsions.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:
videoadcomplete - Kontextdata:
(a.media.ad).
slutförd) - Audience Manager:
(c_contextdata.
a.media.ad.comcomplete) - Sökväg till XDM-fält: (inaktuellt)
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:
videoadtime - Kontextdata:
(a.media.ad).
timePlayed) - Audience Manager:
(c_contextdata.
a.media.ad.timePlay) - Sökväg till XDM-fält: (inaktuellt)
advertising.timePlayed.value - Rapporterar XDM-fältsökväg:
mediaReporting.advertisingDetails.
timePlay
Relaterade API:er section_Related_APIs
createAdObject API
- Android - createAdObject
- iOS - createAdObject
- JavaScript - createAdObject
createAdBreakObject API
- Android - createAdBreakObject
- iOS - createAdBreakObject
- JavaScript - createAdBreakObject
MediaHeartbeatConfig-API
- Android - MediaHeartbeatConfig
- iOS - ADBMediaHeartbeatConfig
- JavaScript - MediaHeartbeatConfig
recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb