DokumentationAnalyticsGuide för direktuppspelande medietjänster

Namn på annonsspelare

Senast uppdaterad: 29 maj 2026

Skapat för:

  • Developer

Den här sidan täcker datainsamling för variabeln Ad player name. Se Lägg till spelarnamn för motsvarande rapporteringsdimension.

style
shade-box

Namnvariabeln för annonsspelaren identifierar vilken spelare som återges för varje annons (till exempel "Freewheel", "Google IMA"). Annonsspelaren kan skilja sig från huvudinnehållsspelaren när annonser sammanfogas med en annonsinfogningstjänst på serversidan. Använd den här variabeln för att jämföra kvalitet och slutförande i alla annonsservrar.

Egenskap
Värde
Kontextdatavariabel
a.media.ad.playerName
XDM-samlingsfält
xdm.mediaCollection.advertisingDetails.playerName
Audience Manager trait
c_contextdata.a.media.ad.playerName
Krävs
Ja
Skickat med
Lägg till start, och stäng

Rekommenderade implementeringstyper

SDK för webben

Ange playerName i xdm.mediaCollection.advertisingDetails vid anrop till sendEvent:

code language-javascript 
alloy("sendEvent", {
  xdm: {
    eventType: "media.adStart",
    mediaCollection: {
      advertisingDetails: {
        name: "ad-2125",
        playerName: "Freewheel"
      },
      sessionID: "{sid}",
      playhead: 0
    }
  }
});
iOS

Skicka annonsspelarens namn som MediaConstants.AdMetadataKeys.AD_PLAYER-nyckeln i HashMap-metadataargumentet till trackEvent(AdStart).

code language-swift 
var metadata: [String: String] = [:]
metadata[MediaConstants.AdMetadataKeys.AD_PLAYER] = "Freewheel"

tracker.trackEvent(event: MediaEvent.AdStart, info: adObject, metadata: metadata)
Android

Skicka annonsspelarens namn som MediaConstants.AdMetadataKeys.AD_PLAYER-nyckeln i HashMap-metadataargumentet till trackEvent(AdStart).

code language-kotlin 
val metadata = HashMap<String, String>()
metadata[MediaConstants.AdMetadataKeys.AD_PLAYER] = "Freewheel"

tracker.trackEvent(Media.Event.AdStart, adObject, metadata)
Roku

Ange playerName i xdm.mediaCollection.advertisingDetails vid anrop av sendMediaEvent för media.adStart:

code language-brightscript 
m.aepSdk.sendMediaEvent({
    "xdm": {
        "eventType": "media.adStart",
        "mediaCollection": {
            "advertisingDetails": {
                "name": "ad-2125",
                "playerName": "Freewheel",
                "length": 15,
                "podPosition": 0
            },
            "playhead": 0
        }
    }
})
Media Edge API

Anropa slutpunkten adStart med playerName inuti xdm.mediaCollection.advertisingDetails:

code language-json 
{
  "events": [{
    "xdm": {
      "eventType": "media.adStart",
      "mediaCollection": {
        "advertisingDetails": {
          "name": "ad-2125",
          "length": 15,
          "playerName": "Freewheel",
          "podPosition": 0
        },
        "sessionID": "{sid}",
        "playhead": 0
      }
    }
  }]
}

Äldre implementeringstyper (endast analys)

Media SDK JS 3.x

Skicka annonsspelarens namn i objektet contextData med ADB.Media.AdMetadataKeys.AdPlayer:

code language-javascript 
var contextData = {};
contextData[ADB.Media.AdMetadataKeys.AdPlayer] = "Freewheel";

tracker.trackEvent(ADB.Media.Event.AdStart, adInfo, contextData);
Chromecast

Skicka annonsspelarens namn i kontextmetadataobjektet när du spårar händelsen annonsstart:

code language-javascript 
var adInfo = ADBMobile.media.createAdObject("Ford F-150", "ad-2125", 1, 30);
var metadata = { "a.media.ad.playerName": "Chromecast Player" };
ADBMobile.media.trackEvent(ADBMobile.media.Event.AdStart, adInfo, metadata);
Media Collection API

Inkludera media.ad.playerName i params-objektet för din adStart POST-begäran:

code language-json 
{
  "playerTime": { "playhead": 0, "ts": 1699523820000 },
  "eventType": "adStart",
  "params": {
    "media.ad.playerName": "Freewheel"
  }
}

Se API-händelseferensen för mediainsamling för den fullständiga strukturen för begäran.

recommendation-more-help
media-analytics-help