MediaTailor transmission de paramètres à ADS - AWS Elemental MediaTailor
Utilisation 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.

MediaTailor transmission de paramètres à ADS

AWS Elemental MediaTailor prend en charge la configuration de variables dynamiques dans les MediaTailor demandes adressées à l'ADS en suivant les étapes suivantes.

Méthodes d'initialisation de session

MediaTailor prend en charge plusieurs méthodes d'initialisation de session et de transmission de paramètres :

  1. POST avec le corps de la requête :

    POST <master>.m3u8
{
    "adsParams": {"param1": "value1", "param2": "value2"},
    "playerParams": {"param3": "value3"}
}

  2. Paramètres de requête dans l'URL :

    GET <master>.m3u8?ads.param1=value1&ads.param2=value2&playerParams.param3=value3
Important

Vous ne pouvez spécifier les paramètres qu'une seule fois, au moment de l'initialisation. Les alias de configuration sont résolus en valeurs réelles avant le transfert.

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

  1. Collaborez avec l'ADS pour déterminer les informations dont il a besoin pour répondre à une requête publicitaire provenant de celui-ci 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 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

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. Il vous suffit 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]