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.

Construction et création de modèles d'offres

Cette page explique comment MediaTailor créer une demande d'enchère OpenRTB à partir de votre modèle, comment fonctionne l'interpolation des variables et quelles valeurs sont définies automatiquement. MediaTailor

Champs de configuration

Lorsque vous activez l'optimisation du rendement dans une configuration de lecture, vous fournissez quatre champs :

Comment est construite la demande d'offre

Lorsqu'il ne reste plus de temps pour une pause publicitaire, MediaTailor construit la demande d'offre en procédant comme suit :

Modèle de console par défaut

Lorsque vous activez l'optimisation du rendement dans la MediaTailor console, le modèle prérempli suivant est fourni comme point de départ. Vous devez personnaliser les valeurs de votre application :

{
  "imp": [
    {
      "bidfloor": 5
    }
  ],
  "app": {
    "id": "{{player_params.app_id}}",
    "name": "{{player_params.app_name}}",
    "bundle": "{{player_params.bundle}}",
    "storeurl": "{{player_params.storeurl}}",
    "domain": "{{player_params.domain}}",
    "content": {
      "genre": "{{asset.genre}}",
      "contentrating": "{{asset.content_rating}}"
    }
  },
  "device": {
    "dnt": "{{player_params.dnt}}",
    "ua": "{{session.user_agent}}",
    "ip": "{{session.client_ip}}",
    "ifa": "{{player_params.device_ifa}}",
    "w": "{{player_params.device_width}}",
    "h": "{{player_params.device_height}}",
    "language": "{{player_params.language}}",
    "model": "{{player_params.model}}",
    "os": "{{player_params.os}}",
    "osv": "{{player_params.osv}}",
    "devicetype": "{{player_params.devicetype}}",
    "make": "{{player_params.make}}"
  },
  "user": {
    "consent": "{{player_params.consent}}"
  },
  "regs": {
    "gdpr": "{{player_params.gdpr}}",
    "us_privacy": "{{player_params.us_privacy}}",
    "gpp": "{{player_params.gpp_consent}}",
    "gpp_sid": "{{player_params.gpp_sid}}"
  }
}

Field-by-field explication :

Interpolation de modèles (modèles de moustache)

Votre modèle ORTB utilise la syntaxe de modélisation Mustache pour la substitution dynamique de valeurs. Les espaces réservés utilisent des crochets doubles. {{ }}

Variables de modèle disponibles

Votre modèle ORTB peut utiliser les mêmes variables dynamiques que celles disponibles dans les modèles d'URL ADS. Il s'agit notamment des variables de session (par exemple{{session.user_agent}},{{session.client_ip}}), des paramètres du joueur ({{player_params.*}}), des métadonnées des actifs ({{asset.*}}), du contexte de disponibilité ({{avail.*}}) et des données de signal SCTE ({{scte.*}}).

Pour obtenir la liste complète des variables disponibles et leurs descriptions, consultezMediaTailor variables publicitaires dynamiques pour les demandes ADS. Pour savoir comment MediaTailor URL-decodes le joueur paramètre les valeurs avant de les remplacer dans le modèle, voir Comportement de codage et de décodage plus loin sur cette page.

Les variables les plus couramment utilisées dans les modèles ORTB sont les suivantes :

Comment transmettre les paramètres du joueur

Il existe deux manières de transmettre les paramètres du lecteur lors de l'initialisation de la session.

Méthode 1 : requête POST avec corps JSON (recommandé)

POST https://<mediatailor-endpoint>/v1/session/<config-hash>/<origin-id>/master.m3u8
Content-Type: application/json

{
  "playerParams": {
    "app_id": "558775_example",
    "slot_id": "608109df-2378-4bc5-8da5-24bc355f01a4",
    "os": "Tizen",
    "make": "Samsung",
    "model": "Tizen TV",
    "language": "en",
    "us_privacy": "1YNY"
  }
}

Cette méthode est préférable car elle permet d'éviter les URL-encoding problèmes liés à des valeurs complexes telles que les chaînes de l'agent utilisateur.

Méthode 2 : paramètres de requête d'URL

GET https://<mediatailor-endpoint>/v1/session/<config-hash>/<origin-id>/master.m3u8
  ?playerParams.app_id=558775_example

Avec cette méthode, les valeurs doivent être URL-encoded. MediaTailor URL-decodes avant l'interpolation.

Comportement de codage et de décodage

MediaTailor effectue un niveau de décodage d'URL sur les valeurs des paramètres du joueur avant de les interpoler dans le modèle. Cela s'applique quelle que soit la manière dont les paramètres sont transmis (corps POST ou paramètres de requête URL).

Exemples de valeurs décodées :

Points clés :

Que se passe-t-il lorsqu'une variable est manquante

Si le lecteur n'envoie aucun paramètre référencé dans votre modèle (par exemple, {{player_params.app_name}} mais aucun app_name dans les paramètres du lecteur), l'espace réservé se transforme en une chaîne vide. ""

Conséquence : si la chaîne vide se trouve dans un champ obligatoire (commeapp.bundle), la demande d'offre échoueBidRequestConfigurationError. S'il se trouve dans un champ facultatif, APS reçoit une valeur vide qui peut provoquer une réponse sans enchère (HTTP 204).

Qu'est-ce qui MediaTailor se règle automatiquement

Les champs suivants sont toujours définis à l' MediaTailor aide des valeurs de la configuration de votre console et du contexte de disponibilité actuel. Si vous les incluez dans votre modèle, vos valeurs sont remplacées :

Étapes suivantes