DocumentatieAnalyticsHandleiding voor streaming-mediaservices

Campagne-id

Laatst bijgewerkt: 29 mei 2026

Gemaakt voor:

  • Developer

Deze pagina behandelt gegevensinzameling voor identiteitskaart van de Campagne​variabele. Zie ​ identiteitskaart van de Campagne ​ voor de overeenkomstige het melden afmeting.

style
shade-box

De campagne-id-variabele identificeert de advertentiecampagne waartoe de creatieve id behoort. Elke tekenreekswaarde (doorgaans een campagne-id van uw ad-serverplatform) is acceptabel. Gebruik de variabele om de betrokkenheid van meerdere creatieve personen die een campagne delen, te verhogen.

Eigenschap
Waarde
de gegevensvariabele van de context
a.media.ad.campaign
XDM inzamelingsgebied
xdm.mediaCollection.advertisingDetails.campaignID
eigenschap van Audience Manager
c_contextdata.a.media.ad.campaign
Vereist
Nee
Verzonden met
​ begin van de Advertentie ​, en sluit

Aanbevolen implementatietypen

SDK van het Web

Stel campaignID inside xdm.mediaCollection.advertisingDetails in bij het aanroepen van sendEvent ​ :

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

Geef de campagne-id door als een metagegevenssleutel in het argument HashMap aan trackEvent(AdStart) . Gebruik MediaConstants.AdMetadataKeys.CAMPAIGN_ID .

code language-swift 
var metadata: [String: String] = [:]
metadata[MediaConstants.AdMetadataKeys.CAMPAIGN_ID] = "fall-2024"

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

Geef de campagne-id door als een metagegevenssleutel in het argument HashMap aan trackEvent(AdStart) . Gebruik MediaConstants.AdMetadataKeys.CAMPAIGN_ID .

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

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

Stel campaignID inside xdm.mediaCollection.advertisingDetails in wanneer u sendMediaEvent aanroept voor media.adStart :

code language-brightscript 
m.aepSdk.sendMediaEvent({
    "xdm": {
        "eventType": "media.adStart",
        "mediaCollection": {
            "advertisingDetails": {
                "name": "ad-2125",
                "campaignID": "fall-2024"
            },
            "playhead": 0
        }
    }
})
Media Edge API

Roep het ​ adStart ​ eindpunt met campaignID binnen xdm.mediaCollection.advertisingDetails:

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

Oudere implementatietypen (alleen voor analyse)

Media SDK JS 3.x

Geef de campagne-id in het contextData -object door met ADB.Media.AdMetadataKeys.CampaignId :

code language-javascript 
var contextData = {};
contextData[ADB.Media.AdMetadataKeys.CampaignId] = "fall-2024";

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

Stel de campagne-id in met ADBMobile.media.AdMetadataKeys.CAMPAIGN_ID in het standaard- en metagegevensobject:

code language-javascript 
var adInfo = ADBMobile.media.createAdObject("Ford F-150", "ad-2125", 1, 30);
var standardAdMetadata = {};
standardAdMetadata[ADBMobile.media.AdMetadataKeys.CAMPAIGN_ID] = "fall-2024";
adInfo[ADBMobile.media.MediaObjectKey.StandardAdMetadata] = standardAdMetadata;
ADBMobile.media.trackEvent(ADBMobile.media.Event.AdStart, adInfo, null);
de Inzameling API van Media

media.ad.campaignId opnemen in het params -object:

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

Zie de ​ Verwijzing van de Inzameling API van Media ​ voor de volledige verzoekstructuur.

recommendation-more-help
media-analytics-help