Utilisation des variables du joueur - 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.

Utilisation des variables du joueur

Pour configurer AWS Elemental MediaTailor pour envoyer les données reçues du joueur aux player_params.<query_parameter_name> variables spécifiées dans ADS URL le modèle. ADS 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 ADS demande, incluez-le [player_params.user_id] dans la ADS URL configuration.

Cela vous permet de contrôler les paramètres de requête inclus dans la ADS demande. Généralement, vous ajoutez un paramètre de requête spécial qui est ADS reconnu à la ADS demande URL et vous fournissez des paires clé-valeur comme 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. Entrée AWS Elemental MediaTailor, configurez le modèle de ADS demande URL pour référencer les paramètres. Ce qui suit URL montre 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 publicitaire côté serveur, encodez les URL paires clé-valeur sur le lecteur. Lorsqu'il MediaTailor reçoit la demande d'initialisation de session, il URL décode les valeurs une fois avant de les substituer dans la demande. ADS URL

    Note

    Si vous avez ADS besoin d'une valeur URL codée, URL codez-la deux fois sur le lecteur. De cette façon, le décodage effectué par MediaTailor aboutit à une valeur codée une fois pour le. ADS

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

  3. Dans l'appel d'initialisation de session lancé par le joueur, transmettez les paires clé-valeur à MediaTailor en tant que 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 publicitaire côté serveur, à l'aide de paires codées URL

      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 publicitaire côté client, sans encodage URL

      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 JSON charge utile. MediaTailor envoie la demande suivante au ADS :

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

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