As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Começando a usar anúncios de sobreposição com MediaTailor
Esta seção explica como começar a usar o recurso de anúncios sobrepostos do. MediaTailor Você configurará a sinalização SCTE-35, configurará as respostas do Ad Decision Server (ADS) e configurará o controle em nível de sessão.
**Topics**
+ [Ativando anúncios de sobreposição](overlay-ads-getting-started-enabling.md)
+ [Rastreamento de anúncios sobrepostos com metadados do lado do cliente](overlay-ads-client-side-tracking-metadata.md)
# Ativando anúncios de sobreposição
MediaTailor o suporte para anúncios de sobreposição está ativado por padrão. Um tipo específico de marcador de anúncio SCTE-35 no manifesto aciona a inserção de um anúncio de sobreposição. Como alguns players podem não oferecer suporte à renderização de anúncios sobrepostos no lado do cliente, você pode desativar o recurso no nível da sessão.
**Para desativar o suporte a anúncios sobrepostos usando prefixos de reprodução HLS ou DASH:**
+ No player, inicialize uma nova sessão de MediaTailor reprodução usando uma solicitação em um dos seguintes formatos, de acordo com seu protocolo:
+ Exemplo: formato HLS
```
GET mediatailorURL/v1/master/hashed-account-id/origin-id/asset-id?aws.overlayAvails=off
```
+ Exemplo: formato DASH
```
GET mediatailorURL/v1/master/hashed-account-id/origin-id/asset-id?aws.overlayAvails=off
```
**Para desativar o suporte a anúncios sobrepostos usando o prefixo de inicialização da sessão:**
+ No player, construa um corpo de mensagem JSON para a solicitação de inicialização da sessão para: MediaTailor
+ Para desativar o suporte à sobreposição de anúncios, adicione um `overlays` objeto como chave de nível superior com um valor de. `off` O `overlays` valor padrão é`on`.
+ (Opcional) Forneça quaisquer parâmetros que MediaTailor , em seguida, sejam passados para o ADS dentro de um `adsParams` objeto. Esses parâmetros correspondem às configurações `[player_params.param]` no URL de modelo ADS da configuração do MediaTailor.
**Example HLS:**
```
POST master.m3u8
{
"adsParams": {
"deviceType": "ipad"
},
"overlayAvails": "off"
}
```
**Example DASH:**
```
POST manifest.mpd
{
"adsParams": {
"deviceType": "androidmobile"
},
"overlayAvails": "off"
}
```
# Sinalização manifesta
MediaTailor aciona o suporte a anúncios de sobreposição quando vê um marcador SCTE-35 específico no manifesto. O sinal necessário é um comando de emenda tipo 6, ou sinal de tempo, que é um sinal Provider Overlay Advertisement Start. Este sinal tem um ID do tipo de segmentação de `0x38`
O exemplo a seguir mostra o marcador `0x38` SCTE-35 em um objeto JSON.
```
{
"tableId": 252,
"selectionSyntaxIndicator": false,
"privateIndicator": false,
"sectionLength": 53,
"protocolVersion": 0,
"encryptedPacket": false,
"encryptedAlgorithm": 0,
"ptsAdjustment": 0,
"cwIndex": 0,
"tier": 4095,
"spliceCommandLength": 5,
"spliceCommandType": 6,
"spliceCommand": {
"specified": true,
"pts": 1800392
},
"descriptorLoopLength": 31,
"descriptors": [
{
"spliceDescriptorTag": 2,
"descriptorLength": 29,
"indentifier": "CUEI",
"segmentationEventId": 158389361,
"segmentationEventCancelIndicator": false,
"programSegmentationFlag": true,
"segmentationDurationFlag": true,
"deliveryNotRestrictedFlag": false,
"webDeliveryAllowedFlag": true,
"noRegionalBlackoutFlag": true,
"archiveAllowedFlag": true,
"deviceResctrictions": 3,
"segmentationDuration": 1350000,
"segmentationUpidType": 9,
"segmentationUpidLength": 7,
"segmentationUpid": {
"0": 111,
"1": 118,
"2": 101,
"3": 114,
"4": 108,
"5": 97,
"6": 121
},
"segmentationTypeId": 56,
"segmentNum": 1,
"segmentsExpected": 0
}
],
"crc": 2510422713
}
```
O exemplo a seguir mostra o sinal SCTE-35 representado como um valor binário (base 32/hexadecimal):
```
0xfc303500000000000000fff00506fe001b78c8001f021d435545490970d4717fdf00000dbba009076f7665726c6179380100000084226c4f
```
Os exemplos a seguir mostram o marcador SCTE-35 nos manifestos HLS e DASH.
**Example : Manifesto HLS**
```
#EXTM3U
#EXT-X-VERSION:6
#EXT-X-TARGETDURATION:7
#EXT-X-MEDIA-SEQUENCE:419
#EXT-X-DISCONTINUITY-SEQUENCE:3
#EXT-X-PROGRAM-DATE-TIME:2023-08-15T04:30:09.231Z
#EXTINF:6.02,
https://aws.cloudfront.net/media/asset1/index1_00007.ts
#EXT-X-DISCONTINUITY
#EXT-X-KEY:METHOD=NONE
#EXT-X-PROGRAM-DATE-TIME:2023-08-15T04:30:15.251Z
#EXTINF:6.0,
https://aws.cloudfront.net/media/asset1/index1_00001.ts
#EXT-X-PROGRAM-DATE-TIME:2023-08-15T04:30:21.251Z
#EXTINF:4.0,
https://aws.cloudfront.net/media/asset1/index1_00002.ts
#EXT-X-DISCONTINUITY
#EXT-X-DATERANGE:ID="1692073825251-30-1",START-DATE="2023-08-15T04:30:25.251Z",DURATION=10.0,PLANNED-DURATION=10.0,SCTE35-OUT=0xfc303500000000000000fff00506fe001b78c8001f021d435545490970d4717fdf00000dbba009076f7665726c6179380100000084226c4f
#EXT-X-PROGRAM-DATE-TIME:2023-08-15T04:30:25.251Z
#EXTINF:2.0,
https://aws.cloudfront.net/media/asset1/index1_00003.ts
#EXT-X-PROGRAM-DATE-TIME:2023-08-15T04:30:27.251Z
#EXTINF:6.0,
https://aws.cloudfront.net/media/asset1/index1_00004.ts
#EXT-X-PROGRAM-DATE-TIME:2023-08-15T04:30:33.251Z
#EXTINF:2.0,
https://aws.cloudfront.net/media/asset1/index1_00005.ts
#EXT-X-DISCONTINUITY
#EXT-X-PROGRAM-DATE-TIME:2023-08-15T04:30:35.251Z
#EXTINF:4.0,
https://aws.cloudfront.net/media/asset1/index1_00006.ts
#EXT-X-PROGRAM-DATE-TIME:2023-08-15T04:30:39.251Z
#EXTINF:6.02,
https://aws.cloudfront.net/media/asset1/index1_00007.ts
```
**Example : Manifesto DASH**
```
https://aws.cloudfront.net/out/v1/abc/123/def/63736f7665726c6179
```
# Resposta do Ad Decision Server (ADS)
A resposta do ADS deve conter um evento de rastreamento válido. No mínimo, o evento de rastreamento pode ser um evento `Impression` de rastreamento. O evento de rastreamento deve conter pelo menos um `NonLinear` anúncio. Esse anúncio é o anúncio de sobreposição, assumindo a forma de um recurso estático, HTML ou iFrame.
```
2.02
```
**Example 1: Fonte do manifesto DASH para MediaTailor**
```
...
SCTE35-binary
...
...
```
**Example 2: manifesto DASH MediaTailor personalizado contendo uma decoração de ID de anúncio**
```
...
...
...
```
# Rastreamento de anúncios sobrepostos com metadados do lado do cliente
MediaTailor coloca os anúncios de sobreposição no local `nonLinearAdsList` da disponibilidade. A API de rastreamento MediaTailor do lado do cliente tem dois objetos raiz, chamados e. `avails` `nonLinearAvails` Se a resposta VAST for um VMAP com `breakType` of`nonlinear`, os metadados disponíveis estarão dentro do `nonLinearAvails` objeto raiz. Se a resposta VAST for um VMAP com um `breakType` de `linear` ou for uma resposta VAST simples sem VMAP, os metadados disponíveis estarão dentro do objeto raiz. `avails`
Para obter mais informações sobre o rastreamento do lado do cliente, consulte. [Rastreamento de anúncios do lado do cliente](ad-reporting-client-side.md)
O exemplo a seguir mostra uma resposta VAST simples ou uma resposta VMAP com um `breakType` valor de`linear`.
```
{
"avails": [
{
"adBreakTrackingEvents": [
{
"beaconUrls": [
"https://adserver.com/beacon=breakstartimpression"
],
"eventType": "breakStart"
},
{
"beaconUrls": [
"https://adserver.com/beacon=breakendimpression"
],
"eventType": "breakEnd"
}
],
"adMarkerDuration": null,
"ads": [],
"availId": "828",
"availProgramDateTime": null,
"duration": "PT0S",
"durationInSeconds": 0,
"meta": null,
"nonLinearAdsList": [
{
"extensions": null,
"nonLinearAdList": [
{
"adId": "",
"adParameters": null,
"adSystem": "2.0",
"adTitle": "2",
"apiFramework": null,
"clickThrough": null,
"clickTracking": null,
"clickTrackingId": null,
"creativeAdId": "",
"creativeId": "18",
"creativeSequence": "",
"duration": null,
"durationInSeconds": 0,
"expandedHeight": null,
"expandedWidth": null,
"height": "360",
"htmlResource": null,
"iFrameResource": null,
"maintainAspectRatio": false,
"minSuggestedDuration": null,
"scalable": false,
"staticResource": "https://client-side-ads.com/tags/static/ctv-generic/overlay001.json?iv_geo_country%3DUS%26",
"staticResourceCreativeType": "text/js_ref",
"width": "640"
}
],
"trackingEvents": [
{
"beaconUrls": [
"https://adserver.com/beacon=impression"
],
"duration": null,
"durationInSeconds": 0,
"eventId": null,
"eventProgramDateTime": null,
"eventType": "impression",
"startTime": null,
"startTimeInSeconds": 0
}
]
}
],
"startTime": "PT1M46.08S",
"startTimeInSeconds": 106.08
}
],
"dashAvailabilityStartTime": null,
"hlsAnchorMediaSequenceNumber": null,
"nextToken": null,
"nonLinearAvails": []
}
```
O exemplo a seguir mostra uma resposta simples do VMAP com um `breakType` valor de`nonlinear`.
```
{
"avails": [],
"dashAvailabilityStartTime": null,
"hlsAnchorMediaSequenceNumber": null,
"nextToken": null,
"nonLinearAvails": [
{
"adBreakTrackingEvents": [
{
"beaconUrls": [
"https://adserver.com/beacon=breakstartimpression"
],
"eventType": "breakStart"
},
{
"beaconUrls": [
"https://adserver.com/beacon=breakendimpression"
],
"eventType": "breakEnd"
}
],
"adMarkerDuration": null,
"ads": [],
"availId": "828",
"availProgramDateTime": null,
"duration": "PT0S",
"durationInSeconds": 0,
"meta": null,
"nonLinearAdsList": [
{
"extensions": null,
"nonLinearAdList": [
{
"adId": "",
"adParameters": null,
"adSystem": "2.0",
"adTitle": "2",
"apiFramework": null,
"clickThrough": null,
"clickTracking": null,
"clickTrackingId": null,
"creativeAdId": "",
"creativeId": "18",
"creativeSequence": "",
"duration": null,
"durationInSeconds": 0,
"expandedHeight": null,
"expandedWidth": null,
"height": "360",
"htmlResource": null,
"iFrameResource": null,
"maintainAspectRatio": false,
"minSuggestedDuration": null,
"scalable": false,
"staticResource": "https://client-side-ads.com/tags/static/ctv-generic/overlay001.json?iv_geo_country%3DUS%26",
"staticResourceCreativeType": "text/js_ref",
"width": "640"
}
],
"trackingEvents": [
{
"beaconUrls": [
"https://adserver.com/beacon=impression"
],
"duration": null,
"durationInSeconds": 0,
"eventId": null,
"eventProgramDateTime": null,
"eventType": "impression",
"startTime": null,
"startTimeInSeconds": 0
}
]
}
],
"startTime": "PT1M46.08S",
"startTimeInSeconds": 106.08
}
]
}
```