Inizio annuncio
L’evento di inizio annuncio segnala l’inizio della riproduzione di un singolo annuncio. Deve verificarsi all’interno di una coppia Inizio interruzione annuncio / Interruzione annuncio completata.
- Prerequisiti: Inizio sessione, Inizio interruzione annuncio
- Metrica associata: Inizio annuncio
IMPORTANT
Questo evento deve essere circondato da
adBreakStart e adBreakComplete bookend, anche quando viene riprodotto un singolo annuncio. Senza questi bookend, gli eventi pubblicitari vengono ignorati e la durata dell’annuncio viene conteggiata come durata del contenuto principale.Web SDK
Chiama sendEvent con eventType: "media.adStart" e il advertisingDetails richiesto:
alloy("sendEvent", {
xdm: {
eventType: "media.adStart",
mediaCollection: {
advertisingDetails: {
name: "ad-2125",
friendlyName: "Ford F-150",
length: 15,
playerName: "Freewheel",
podPosition: 0
},
sessionID: "{sid}",
playhead: 0
}
}
});
Mobile SDK
Passa il nome, l’ID, la posizione e la lunghezza dell’annuncio a createAdObject, quindi chiama trackEvent.
iOS (Swift)
let adObject = Media.createAdObjectWith(name: "Ford F-150",
id: "ad-2125",
position: 0,
length: 15)
tracker.trackEvent(event: MediaEvent.AdStart, info: adObject, metadata: nil)
Android (Cotlino)
val adObject = Media.createAdObject("Ford F-150",
"ad-2125",
0,
15)
tracker.trackEvent(Media.Event.AdStart, adObject, null)
Roku (BrightScript)
Chiama sendMediaEvent con eventType: "media.adStart" e il advertisingDetails richiesto:
m.aepSdk.sendMediaEvent({
"xdm": {
"eventType": "media.adStart",
"mediaCollection": {
"advertisingDetails": {
"name": "ad-2125",
"friendlyName": "Ford F-150",
"length": 15,
"playerName": "Roku Player",
"podPosition": 0
},
"playhead": 0
}
}
})
API di Media Edge
Chiama l’endpoint adStart con advertisingDetails richiesto:
curl -X POST "https://edge.adobedc.net/ee/va/v1/adStart?configId={datastreamID}" \
--header 'Content-Type: application/json' \
--data '{
"events": [{
"xdm": {
"eventType": "media.adStart",
"mediaCollection": {
"sessionID": "{sid}",
"playhead": 0,
"advertisingDetails": {
"name": "ad-2125",
"length": 15,
"playerName": "Freewheel",
"podPosition": 0
}
},
"timestamp": "YYYY-08-20T22:41:40+00:00"
}
}]
}'
Media SDK
Passa il nome, l’ID, la posizione e la lunghezza dell’annuncio a ADB.Media.createAdObject:
var adInfo = ADB.Media.createAdObject(
"Ford F-150", // name (friendly name)
"ad-2125", // ad ID
0, // position in pod
15 // length (seconds)
);
tracker.trackEvent(ADB.Media.Event.AdStart, adInfo, null);
API Media Collection
Invia un POST adStart all’endpoint eventi:
{
"playerTime": { "playhead": 0, "ts": 1699523820000 },
"eventType": "adStart",
"params": {
"media.ad.id": "ad-2125",
"media.ad.name": "Ford F-150",
"media.ad.length": 15,
"media.ad.podPosition": 0
}
}
recommendation-more-help
media-analytics-help