Utilisation de variables publicitaires dynamiques dans MediaTailor

La AWS Elemental MediaTailor demande adressée au serveur de décision publicitaire (ADS) inclut des informations sur la session de visionnage en cours, qui aident l'ADS à choisir les meilleures publicités à fournir dans sa réponse. Lorsque vous configurez le modèle ADS dans votre MediaTailor configuration, vous pouvez inclure des variables dynamiques, également appelées macros. Les variables dynamiques sont des chaînes remplaçables.

Les variables dynamiques peuvent prendre les formes suivantes :

Valeurs statiques : valeurs qui ne changent pas d'une session à l'autre. Par exemple, le type de réponse que MediaTailor attend du serveur ADS.
Variables de domaine : variables dynamiques pouvant être utilisées pour les domaines URL, telles que la partie my-ads-server.com de l'URL http ://my-ads-server.com. Pour plus de détails, consultez Utilisation de variables de domaine.
Données de session : valeurs dynamiques fournies par MediaTailor chaque session, par exemple l'ID de session. Pour plus de détails, consultez Utilisation de variables de session.
Données du joueur : valeurs dynamiques fournies par le joueur pour chaque session. Ils décrivent le lecteur de contenu et aident l'ADS à déterminer quelles publicités MediaTailor doivent être intégrées au flux. Pour plus de détails, consultez Utilisation des variables du joueur.

Transmission de paramètres à l'ADS

Les étapes suivantes décrivent comment configurer des variables dynamiques dans les MediaTailor demandes adressées à l'ADS.

Pour plus d'informations sur le formatage pris en charge pour les paramètres de requête, reportez-vous Caractères pris en charge et limites des paramètres de requête du manifeste aux sections etLimitations de longueur des paramètres de requête ADS.
Pour des personnalisations supplémentaires de la demande ADS, voirUtilisation avancée.

Pour transmettre les informations de session et de lecteur au serveur ADS

Collaborez avec l'ADS pour déterminer les informations dont il a besoin pour répondre à une requête publicitaire provenant de AWS Elemental MediaTailor.
Créez une configuration MediaTailor qui utilise un modèle d'URL de demande ADS qui répond aux exigences ADS. Dans l'URL, incluez les paramètres statiques et les espaces réservés correspondant aux paramètres dynamiques. Entrez l'URL de votre modèle dans le champ Ad decision server (Serveur ADS) de la configuration.

Dans l'exemple suivant d'URL du modèle correlation fournit les données de session et deviceType fournit des données de lecteur :
```
https://my.ads.server.com/path?correlation=[session.id]&deviceType=[player_params.deviceType]
```
Sur le joueur, configurez la demande d'initiation de session pour que AWS Elemental MediaTailor fournisse les paramètres pour les données de lecteur. Incluez vos paramètres dans la demande d'initiation de session et omettez-les des demandes suivantes pour la session.

Le type d'appel effectué par le joueur pour initialiser la session détermine si le joueur (client) ou MediaTailor (serveur) fournit des rapports de suivi publicitaire pour la session. Pour plus d'informations sur ces deux options, consultez la section Signalement des données de suivi et .

Effectuez l'une des types suivants d'appels, selon que vous voulez un rapport de suivi publicitaire côté serveur ou côté client. Dans les deux exemples d'appels, userID est destiné au serveur ADS et auth_token à l'origine :
- (Option) Demandez des rapports de suivi des publicités côté serveur — Préfixez les paramètres que vous souhaitez envoyer MediaTailor à l'ADS. ads Conservez le préfixe désactivé pour les paramètres que MediaTailor doit envoyer au serveur d'origine :
  
  Les exemples suivants montrent les demandes entrantes adressées à HLS et DASH à AWS Elemental MediaTailor. MediaTailor utilise le deviceType dans sa demande à l'ADS et auth_token dans sa demande au serveur d'origine.
  
  Exemple HLS :
```
GET master.m3u8?ads.deviceType=ipad&auth_token=kjhdsaf7gh
```
  Exemple DASH :
```
GET manifest.mpd?ads.deviceType=ipad&auth_token=kjhdsaf7gh
```
- (Option) Demandez des rapports de suivi des publicités côté client — Fournissez les paramètres de l'ADS à l'intérieur d'un objet. adsParams
  
  Exemple HLS :
```
POST master.m3u8
    {
        "adsParams": {
           "deviceType": "ipad"
       }
    }
```
  Exemple DASH :
```
POST manifest.mpd
    {
        "adsParams": {
           "deviceType": "ipad"
       }
    }
```

Lorsque le joueur lance une session, il AWS Elemental MediaTailor remplace les variables du modèle d'URL de demande ADS par les données de session et les ads paramètres du joueur. Il transmet les paramètres restants du lecteur au serveur d'origine.

Exemple MediaTailor demandes avec variables publicitaires

Les exemples suivants illustrent les appels à l'ADS et au serveur d'origine provenant d' AWS Elemental MediaTailor qui correspondent aux exemples d'appel d'initialisation de session de lecteur précédents :

MediaTailor appelle l'ADS avec les données de session et le type d'appareil du joueur :
```
https://my.ads.server.com/path?correlation=896976764&deviceType=ipad
```

MediaTailor appelle le serveur d'origine avec le jeton d'autorisation du joueur.

Exemple HLS :


https://my.origin.server.com/master.m3u8?auth_token=kjhdsaf7gh

Exemple DASH :


https://my.origin.server.com/manifest.mpd?auth_token=kjhdsaf7gh

Caractères pris en charge et limites des paramètres de requête du manifeste

Vous pouvez utiliser les caractères suivants dans les paramètres de requête utilisés dans les demandes de manifeste :

Alphanumérique (A-Z, a-z, 0-9)
Périodes (.)
Tirets (-)
Soulignements (_)
Barres obliques arrières (\)

Limites de longueur

La longueur totale de tous les paramètres de requête du manifeste (clé et valeur combinées) ne doit pas dépasser 2 000 caractères.

Personnages non pris en charge

Vous ne pouvez pas utiliser les caractères suivants dans les paramètres de requête du manifeste : : ? & = % / (barre oblique)

Limitations de longueur des paramètres de requête ADS

Les limites de longueur suivantes s'appliquent aux paramètres de requête utilisés dans les demandes adressées à l'ADS :

Nom du paramètre ADS : 10000 caractères
Valeur du paramètre ADS : 25 000 caractères
URL de l'ADS : 25000 caractères

Utilisation avancée

Vous pouvez personnaliser la demande ADS de multiples façons avec les données du lecteur et les données de session. La seule exigence est d'inclure le nom d'hôte ADS.

Les exemples suivants illustrent certaines façons de personnaliser votre demande :

Concaténez les paramètres du lecteur et les paramètres de session pour créer de nouveaux paramètres. Exemple :
```
https://my.ads.com?key1=[player_params.value1][session.id]
```
Utilisez un paramètre du lecteur comme partie intégrante d'un élément du chemin. Exemple :
```
https://my.ads.com/[player_params.path]?key=value
```
Utilisez les paramètres du lecteur pour transmettre les éléments du chemin d'accès et les clés elles-mêmes, plutôt que les seules valeurs. Exemple :
```
https://my.ads.com/[player_params.path]?[player_params.key1]=[player_params.value1]
```

Pour plus d'informations sur l'utilisation de variables dynamiques de domaine, de session et de joueur, sélectionnez la rubrique appropriée.

Rubriques

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Publicités préconditionnées

Utilisation de variables de domaine