

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.

# Guide de démarrage rapide pour l'optimisation du rendement
<a name="yield-optimization-quickstart"></a>

Ce guide explique comment activer l'optimisation du rendement sur une configuration de lecture et vérifier qu'elle fonctionne.

**Objectif : ** À la fin de ce guide, vous disposerez d'une configuration de lecture qui remplira automatiquement l'inventaire publicitaire non rempli avec les publicités programmatiques d'APS.

## Conditions préalables
<a name="yield-optimization-quickstart-prereqs"></a>
+ Configuration de MediaTailor lecture existante avec une source de contenu en direct.
+ Un identifiant d'éditeur APS. Voyez [Intégration à APS](yield-optimization-integrating-aps.md) si vous n'en avez pas.

## Étape 1 : Activez l'optimisation du rendement dans la console
<a name="yield-optimization-quickstart-step1"></a>

1. Ouvrez la [console MediaTailor](https://console.aws.amazon.com/mediatailor/home).

1. Dans le volet de navigation de gauche, choisissez ** Configurations**.

1. Choisissez la configuration de lecture que vous souhaitez mettre à jour.

1. Choisissez **Modifier**.

1. Développez la ** section Paramètres d'optimisation du ** rendement (marquée d'un ** nouveau ** badge au lancement). La description de la section se lit comme suit : « Configurez les paramètres d'optimisation du rendement, notamment l'identifiant de l'éditeur, les limites de durée des annonces et le ciblage régional ».

1. Réglez la liste déroulante d'activation sur Activé. ** **

1. Remplissez les champs suivants :
   + **APS Publisher ID ** : L'APS Publisher ID associé à votre compte Publisher (par exemple,`8caf35b3-402b-4d75-bab2-f2aef63a66d3`). Découvrez [Intégration à APS](yield-optimization-integrating-aps.md) comment l'obtenir.
   + **Durée minimale non remplie ** : durée minimale non remplie, en secondes, que Yield Optimization tentera de remplir. Réglez-le sur ** 15 ** ou plus. Les valeurs inférieures à 15 secondes ne renverront pas d'annonces car les créations publicitaires APS durent généralement 15 secondes ou plus.
   + **Région Amazon Ads ** : région Amazon Ads vers laquelle acheminer les demandes d'enchères. Choisissez l'un de `Americas``Europe`, ou `Asia Pacific` en fonction de votre public principal. Cela correspond au `Region` champ du modèle d'`YieldOptimizationConfiguration`API et les noms des régions correspondent aux régions APS décrites dans[Intégration à APS](yield-optimization-integrating-aps.md).
   + **Configuration du modèle OpenRTB ** : votre modèle JSON. Voir [Exemple de modèles ](yield-optimization-examples.md) les points de départ. La console valide la syntaxe JSON et affiche les erreurs et les avertissements en ligne. Le modèle par défaut est prérempli avec le modèle de démarrage de la console. Consultez [Construction et création de modèles d'offres](yield-optimization-bid-construction.md).

1. Choisissez **Enregistrer**.

## Étape 2 : Configuration du modèle OpenRTB
<a name="yield-optimization-quickstart-step2"></a>

La console fournit un éditeur JSON pour le modèle OpenRTB. Au minimum, votre modèle doit inclure :

```
{
  "app": {
    "bundle": "your.app.bundle.id",
    "storeurl": "https://your-app-store-url",
    "content": {}
  },
  "device": {
    "ua": "{{session.user_agent}}",
    "ip": "{{session.client_ip}}"
  },
  "imp": [
    {
      "video": {
        "mimes": ["video/mp4"],
        "protocols": [2, 3, 5, 6],
        "ext": {
          "slotId": "your-aps-slot-id"
        }
      },
      "bidfloor": 1.0
    }
  ]
}
```

La console vous avertira si des champs obligatoires sont manquants.

## Étape 3 : démarrer une session et vérifier
<a name="yield-optimization-quickstart-step3"></a>

1. Démarrez une session de lecture qui inclut les paramètres de votre lecteur (agent utilisateur, adresse IP, etc.).

1. Attendez une pause publicitaire dont la durée n'est pas remplie.

1. Vérifiez CloudWatch les statistiques pour `YieldOptimization.BidRequest` et`YieldOptimization.AdsInserted`.

S'`BidRequest`il émet mais `AdsInserted` vaut 0, vérifiez l'`RAW_BID_REQUEST`événement dans le `ads_interaction_log` pour vérifier que votre modèle produit des demandes d'enchères valides.

## Étape 2 (alternative) : Configuration à l'aide de l'API
<a name="yield-optimization-quickstart-step2-api"></a>

Utilisez l'`PutPlaybackConfiguration`API avec le `YieldOptimizationConfiguration` paramètre :

```
aws mediatailor put-playback-configuration \
  --name "MyStreamingService" \
  --ad-decision-server-url "https://ads.example.com/vast" \
  --video-content-source-url "https://origin.example.com/hls/" \
  --yield-optimization-configuration '{
    "MinimumUnfilledDuration": 15,
    "PublisherId": "your-aps-publisher-id",
    "Region": "AMERICAS",
    "OpenRtbTemplate": "{\"app\":{\"bundle\":\"your.app.bundle\",\"storeurl\":\"https://store-url\",\"content\":{}},\"device\":{\"ua\":\"{{session.user_agent}}\",\"ip\":\"{{session.client_ip}}\"},\"imp\":[{\"video\":{\"mimes\":[\"video/mp4\"],\"protocols\":[2,3,5,6],\"ext\":{\"slotId\":\"your-slot-id\"}},\"bidfloor\":1.0}]}"
  }'
```

## Étapes suivantes
<a name="yield-optimization-quickstart-next-steps"></a>
+ Pour vous inscrire à APS et obtenir votre identifiant d'éditeur, consultez[Intégration à APS](yield-optimization-integrating-aps.md).
+ Pour comprendre comment MediaTailor décider du moment où les demandes d'offres doivent être soumises, voir[Comment fonctionne l'optimisation du rendement](yield-optimization-how-it-works.md).
+ Pour voir des exemples complets de modèles, consultez[Exemple de modèles ](yield-optimization-examples.md).