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, ce qui l'aide à ADS choisir les meilleures publicités à fournir dans sa réponse. Lorsque vous configurez le ADS modèle 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 MediaTailor réponse attendu duADS.
Variables de domaine : variables dynamiques pouvant être utilisées pour URL les domaines, telles que la partie my-ads-server.com du 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 l'aident 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 au ADS

Les étapes suivantes décrivent comment configurer des variables dynamiques dans les MediaTailor demandes adressées auADS.

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 etADSlimites de longueur des paramètres de requête.
Pour des personnalisations supplémentaires de la ADS demande, voirUtilisation avancée.

Pour transmettre les informations relatives à la session et au joueur ADS

Travaillez avec le 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 de ADS demande URL répondant aux ADS exigences. Dans leURL, incluez des paramètres statiques et incluez des espaces réservés pour les paramètres dynamiques. Entrez votre modèle URL dans le champ Serveur de décision publicitaire de la configuration.

Dans l'exemple de modèle suivantURL, correlation fournit des données de session et deviceType fournit des données de joueur :
```
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 ADS et auth_token est destiné à l'origine :
- (Option) Demandez des rapports de suivi des publicités côté serveur — Préfixez les paramètres que vous souhaitez envoyer MediaTailor au with. 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 pour HLS et DASH pour AWS Elemental MediaTailor. MediaTailor utilise le deviceType dans sa demande au ADS et auth_token dans sa demande au serveur d'origine.
  
  HLSexemple :
```
GET master.m3u8?ads.deviceType=ipad&auth_token=kjhdsaf7gh
```
  DASHexemple :
```
GET manifest.mpd?ads.deviceType=ipad&auth_token=kjhdsaf7gh
```
- (Option) Demandez des rapports de suivi des publicités côté client — Fournissez des paramètres pour l'ADSintérieur d'un objet. adsParams
  
  HLSexemple :
```
POST master.m3u8
    {
        "adsParams": {
           "deviceType": "ipad"
       }
    }
```
  DASHexemple :
```
POST manifest.mpd
    {
        "adsParams": {
           "deviceType": "ipad"
       }
    }
```

Lorsque le joueur lance une session, il AWS Elemental MediaTailor remplace les variables du modèle de ADS demande URL 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 montrent les appels vers le serveur d'origine ADS et depuis lesquels ils AWS Elemental MediaTailor correspondent aux exemples d'appels d'initialisation de session du joueur précédent :

MediaTailor appelle le 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.

HLSexemple :


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

DASHexemple :


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)

ADSlimites de longueur des paramètres de requête

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

ADSnom du paramètre : 10000 caractères
ADSvaleur du paramètre : 25 000 caractères
ADSURL: 25000 caractères

Utilisation avancée

Vous pouvez personnaliser la ADS demande de nombreuses manières à l'aide des données du joueur et de la session. La seule exigence est d'inclure le nom ADS d'hôte.

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