Utilisation de variables publicitaires dynamiques dans AWS Elemental MediaTailor - AWS Elemental MediaTailor
Transmission de paramètres à l'ADSUtilisation avancée

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.

Utilisation de variables publicitaires dynamiques dans AWS Elemental MediaTailor

La demande AWS Elemental MediaTailor adressée au serveur ADS inclut les informations sur la session d'affichage en cours, ce qui permet au serveur ADS de 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.

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

Rubriques

Transmission de paramètres à l'ADS

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

  1. Utilisez le serveur ADS afin de déterminer les informations dont il a besoin, afin qu'il puisse répondre à une requête de publicité provenant de AWS Elemental MediaTailor.

  2. 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]

  3. 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 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 lecteur initie une session, AWS Elemental MediaTailor remplace les variables de l'URL de demande du modèle ADS par les données de session et les paramètres ads du lecteur. Il transmet les paramètres restants du lecteur au serveur d'origine.

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

Les sections suivantes fournissent des détails pour la configuration de la session et des données du lecteur.

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]