View a markdown version of this page

MediaTailor variables de lecteur pour les requêtes ADS - AWS Elemental MediaTailor

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 variables de lecteur pour les requêtes ADS

AWS Elemental MediaTailor envoie les données reçues du lecteur à l'ADS lorsque vous configurez AWS Elemental MediaTailor pour spécifier player_params.<query_parameter_name> des variables dans l'URL ADS modèle. Par exemple, si le joueur envoie un paramètre de requête nommé user_id dans sa demande à MediaTailor, pour transmettre ces données dans la demande ADS, incluez-le [player_params.user_id] dans la configuration de l'URL ADS.

Cela vous permet de contrôler les paramètres de la requête qui sont inclus dans la demande ADS. En général, vous ajoutez un paramètre de requête particulier que le serveur ADS reconnaît à l'URL de demande du serveur ADS et fournissez les paires clé-valeur comme la valeur du paramètre.

Les exemples utilisés dans la procédure suivante utilisent les paires clé-valeur suivantes :

  • param1 avec une valeur valeur1 :

  • param2 avec une valeur valeur2 :

Pour ajouter les paramètres de requête en tant que paires clé-valeur

  1. Dans AWS Elemental MediaTailor, configurez l'URL du modèle de demande ADS pour référencer les paramètres. L'URL suivante affiche l'inclusion des exemples de paramètres : 

    https://my.ads.com/path?param1=[player_params.param1]&param2=[player_params.param2]

  2. (Facultatif) Pour les rapports de suivi des publicités côté serveur, URL-encode les paires clé-valeur sur le lecteur. Lorsqu'il MediaTailor reçoit la demande d'initialisation de session, il saisit URL-decodes les valeurs une fois avant de les substituer dans l'URL de la demande ADS.

    Note

    Si votre ADS nécessite une URL-encoded valeur, celle-ci URL-encode doit être doublée sur le lecteur. De cette façon, le décodage effectué par MediaTailor aboutit à une valeur codée une fois pour l'ADS.

    Par exemple, si la représentation décodée des valeurs envoyées à l'ADS estparam1=value1:&param2=value2:, alors la URL-encoded représentation l'estparam1=value1%3A&param2=value2%3A.

  3. Lors de l'appel d'initialisation de session depuis le lecteur, transmettez les paires clé-valeur à MediaTailor la valeur d'un seul paramètre de requête. Les exemples d'appels suivants fournissent les exemples de paires clé-valeur pour le reporting du suivi publicitaire côté serveur et côté client.

    • Exemples de demandes de rapports de suivi des publicités côté serveur, utilisant des paires URL-encoded

      HLS :

      <master>.m3u8?ads.param1=value1%3A&ads.param2=value2%3A

      DASH :

      <manifest>.mpd?ads.param1=value1%3A&ads.param2=value2%3A

    • Exemple de demande de rapports de suivi des publicités côté client, sans URL-encoding

      HLS :

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

      DASH :

      POST <manifest>.mpd
    {
        "adsParams": {
           "param1": "value1:",
           "param2": "value2:"
       }
    }

Pour les rapports côté serveur, MediaTailor décode les paramètres lorsque la demande du joueur est reçue. Pour les rapports côté client, cela ne modifie pas les paramètres reçus dans la charge utile JSON. MediaTailor envoie la demande suivante à l'ADS :

https://my.ads.com/<path>?param1=value1:&param2=value2:

De cette manière, les paires clé-valeur param1 et param2 sont incluses en tant que paramètres de requête de première classe dans la demande ADS.