DocumentaçãoAnalyticsGuia de serviços para mídia de streaming

ID de posicionamento

Última atualização: 29 de maio de 2026

Criado para:

  • Developer

Esta página aborda a coleta de dados para a variável ID de posicionamento. Consulte ID de posicionamento para a dimensão de relatório correspondente.

style
shade-box

A variável de ID de posicionamento identifica o posicionamento do anúncio (normalmente um slot ou zona definida na plataforma do servidor de anúncios).

Propriedade
Valor
Variável de dados de contexto
a.media.ad.placement
Campo da coleção XDM
xdm.mediaCollection.advertisingDetails.placementID
Característica do Audience Manager
c_contextdata.a.media.ad.placement
Obrigatório
Não
Enviado com
Início do anúncio e fechamento

Tipos de implementação recomendados

Web SDK

Definir placementID dentro de xdm.mediaCollection.advertisingDetails ao chamar sendEvent:

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

Passe a ID de posicionamento como uma chave de metadados no argumento HashMap para trackEvent(AdStart). Use MediaConstants.AdMetadataKeys.PLACEMENT_ID.

code language-swift 
var metadata: [String: String] = [:]
metadata[MediaConstants.AdMetadataKeys.PLACEMENT_ID] = "placement-12"

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

Passe a ID de posicionamento como uma chave de metadados no argumento HashMap para trackEvent(AdStart). Use MediaConstants.AdMetadataKeys.PLACEMENT_ID.

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

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

Definir placementID dentro de xdm.mediaCollection.advertisingDetails ao chamar sendMediaEvent para media.adStart:

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

Chame o ponto de extremidade adStart com placementID dentro de xdm.mediaCollection.advertisingDetails:

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

Tipos de implementação herdada (somente Analytics)

Media SDK JS 3.x

Passar a ID de posicionamento no objeto contextData usando ADB.Media.AdMetadataKeys.PlacementId:

code language-javascript 
var contextData = {};
contextData[ADB.Media.AdMetadataKeys.PlacementId] = "placement-12";

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

Defina a ID de posicionamento usando ADBMobile.media.AdMetadataKeys.PLACEMENT_ID no objeto de metadados de anúncio padrão:

code language-javascript 
var adInfo = ADBMobile.media.createAdObject("Ford F-150", "ad-2125", 1, 30);
var standardAdMetadata = {};
standardAdMetadata[ADBMobile.media.AdMetadataKeys.PLACEMENT_ID] = "placement-12";
adInfo[ADBMobile.media.MediaObjectKey.StandardAdMetadata] = standardAdMetadata;
ADBMobile.media.trackEvent(ADBMobile.media.Event.AdStart, adInfo, null);
API da coleção de mídia

Incluir media.ad.placementId no objeto params:

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

Consulte a Referência de eventos da API Media Collection para obter a estrutura de solicitação completa.

recommendation-more-help
media-analytics-help