Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Commencer à utiliser les publicités incrustées avec MediaTailor
Cette section explique comment commencer à utiliser la fonctionnalité de superposition de. MediaTailor Vous allez configurer la signalisation SCTE-35, configurer les réponses du serveur ADS (Ad Decision Server) et configurer le contrôle au niveau de la session.
**Topics**
+ [Activation des publicités superposées](overlay-ads-getting-started-enabling.md)
+ [Suivi des publicités superposées à l'aide de métadonnées côté client](overlay-ads-client-side-tracking-metadata.md)
# Activation des publicités superposées
MediaTailor la prise en charge des annonces incrustées est activée par défaut. Un type de marqueur publicitaire SCTE-35 spécifique dans le manifeste déclenche l'insertion d'une publicité superposée. Certains joueurs étant susceptibles de ne pas prendre en charge le rendu des publicités incrustées côté client, vous pouvez désactiver cette fonctionnalité au niveau de la session.
**Pour désactiver la prise en charge des publicités en superposition à l'aide des préfixes de lecture HLS ou DASH :**
+ Depuis le lecteur, initialisez une nouvelle session de MediaTailor lecture à l'aide d'une requête dans l'un des formats suivants, conformément à votre protocole :
+ Exemple : format HLS
```
GET mediatailorURL/v1/master/hashed-account-id/origin-id/asset-id?aws.overlayAvails=off
```
+ Exemple : format DASH
```
GET mediatailorURL/v1/master/hashed-account-id/origin-id/asset-id?aws.overlayAvails=off
```
**Pour désactiver la prise en charge des publicités superposées à l'aide du préfixe d'initialisation de session :**
+ Sur le lecteur, créez un corps de message JSON pour la demande d'initialisation de session afin de MediaTailor :
+ Pour désactiver la prise en charge de la superposition de publicités, ajoutez un `overlays` objet en tant que clé de niveau supérieur avec une valeur de. `off` La `overlays` valeur par défaut est`on`.
+ (Facultatif) Fournissez tous les paramètres qui sont MediaTailor ensuite transmis à l'ADS à l'intérieur d'un `adsParams` objet. Ces paramètres correspondent aux paramètres `[player_params.param]` dans l'URL modèle d'ADS de la configuration de MediaTailor.
**Example HLS :**
```
POST master.m3u8
{
"adsParams": {
"deviceType": "ipad"
},
"overlayAvails": "off"
}
```
**Example DASH :**
```
POST manifest.mpd
{
"adsParams": {
"deviceType": "androidmobile"
},
"overlayAvails": "off"
}
```
# Signalisation manifeste
MediaTailor trigger overlay-ads support lorsqu'il voit un marqueur SCTE-35 spécifique dans le manifeste. Le signal requis est une commande d'épissage de type 6, ou signal horaire, qui est un signal Provider Overlay Advertisement Start. Ce signal possède un identifiant de type de segmentation de `0x38`
L'exemple suivant montre le marqueur `0x38` SCTE-35 dans un objet 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
}
```
L'exemple suivant montre le signal SCTE-35 représenté sous forme de valeur binaire (base 32/hexadécimal) :
```
0xfc303500000000000000fff00506fe001b78c8001f021d435545490970d4717fdf00000dbba009076f7665726c6179380100000084226c4f
```
Les exemples suivants montrent le marqueur SCTE-35 dans les manifestes HLS et DASH.
**Example : manifeste 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 : manifeste DASH**
```
https://aws.cloudfront.net/out/v1/abc/123/def/63736f7665726c6179
```
# Réponse du serveur ADS (Ad Decision Server)
La réponse ADS doit contenir un événement de suivi valide. Au minimum, l'événement de suivi peut être un événement `Impression` de suivi. L'événement de suivi doit contenir au moins une `NonLinear` annonce. Cette annonce est une publicité superposée, qui prend la forme d'une ressource statique, HTML ou iFrame.
```
2.02
```
**Example 1 : source du manifeste DASH pour MediaTailor**
```
...
SCTE35-binary
...
...
```
**Example 2 : manifeste DASH MediaTailor personnalisé contenant une décoration d'identifiant publicitaire**
```
...
...
...
```
# Suivi des publicités superposées à l'aide de métadonnées côté client
MediaTailor place les publicités superposées dans `nonLinearAdsList` le catalogue. L'API de suivi MediaTailor côté client possède deux objets racines, appelés `avails` et. `nonLinearAvails` Si la réponse VAST est un VMAP avec ou `breakType``nonlinear`, les métadonnées Avail se trouvent dans l'objet `nonLinearAvails` racine. Si la réponse VAST est une réponse VMAP avec un `breakType` de`linear`, ou une réponse VAST simple sans VMAP, les métadonnées Avail se trouvent dans l'`avails`objet racine.
Pour plus d'informations sur le suivi côté client, consultez. [Suivi des publicités côté client](ad-reporting-client-side.md)
L'exemple suivant montre une réponse VAST simple ou une réponse VMAP avec une `breakType` valeur 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": []
}
```
L'exemple suivant montre une réponse VMAP simple avec une `breakType` valeur 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
}
]
}
```