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 vue d'ensemble des alias de configuration
AWS Elemental MediaTailor les alias de configuration permettent le remplacement dynamique des variables dans les domaines URL et autres champs pris en charge. Utilisez cette fonctionnalité pour utiliser plusieurs domaines et effectuer une configuration dynamique URLs lors de l'initialisation de la session.
## Cas d’utilisation
Les alias de configuration permettent d'utiliser des architectures multiconfigurations sophistiquées pour les scénarios suivants :
+ **Routage géographique : acheminez** les demandes vers différentes origines ou vers différents serveurs publicitaires en fonction de la localisation des internautes à l'aide d'alias spécifiques à la région. Pour obtenir des conseils de mise en œuvre, consultez [CloudFront Origin Failover](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/high_availability_origin_failover.html).
+ **Routage basé sur le contenu : Dirigez** les différents types de contenu vers des origines ou des pipelines de traitement spécialisés. Pour la configuration du comportement de routage, voir[Configurer les comportements de routage du CDN pour MediaTailor](cdn-routing-behaviors.md).
+ **Scénarios de basculement :** implémentez les origines de sauvegarde et les serveurs publicitaires avec un basculement automatique à l'aide du changement d'alias. Pour une mise en œuvre détaillée, voir [Mettre en œuvre la résilience multirégionale MediaTailor avec MQAR](media-quality-resiliency.md) et[Planifiez votre intégration au CDN pour AWS Elemental MediaTailor](planning-cdn-integration.md).
+ **Tests A/B :** testez différents serveurs publicitaires, origines ou configurations en acheminant le trafic en fonction des paramètres du joueur. Pour obtenir des conseils sur les tests de charge, consultez [Préparer et exécuter des tests de performance pour Amazon CloudFront avec une véritable surveillance des utilisateurs](https://aws.amazon.com/blogs/networking-and-content-delivery/prepare-and-run-performance-tests-for-amazon-cloudfront-with-real-user-monitoring/).
+ **Optimisation spécifique à l'appareil :** optimisez la diffusion de contenu et la diffusion d'annonces pour différents types d'appareils ou fonctionnalités. Pour des conseils complets, voir[Configurer le filtrage des manifestes avec MediaTailor MediaPackage, et le CDN](cdn-emp-manifest-filtering.md).
+ **Équilibrage de charge :** répartissez la charge entre plusieurs origines ou serveurs publicitaires à l'aide du routage dynamique. Pour des conseils de mise en œuvre, voir [Mettre en œuvre la résilience multirégionale MediaTailor avec MQAR](media-quality-resiliency.md) et[Planifiez votre intégration au CDN pour AWS Elemental MediaTailor](planning-cdn-integration.md).
## Champs pris en charge
Vous pouvez utiliser des variables dynamiques dans les champs de configuration suivants :
+ `VideoContentSourceUrl`
+ `AdDecisionServerUrl`
+ `LivePreroll.AdDecisionServerUrl`
+ `AdSegmentUrlPrefix`
+ `ContentSegmentUrlPrefix`
+ `TranscodeProfileName`
+ `SlateAdUrl`
+ `StartUrl`
+ `EndUrl`
Les sections suivantes décrivent comment utiliser les alias de configuration.
**Topics**
+ [Cas d’utilisation](#configuration-aliases-use-cases)
+ [Champs pris en charge](#configuration-aliases-supported)
+ [Création et utilisation](creating-configuration-aliases.md)
+ [Exemple de flux](configuration-aliases-examples.md)
# Création et utilisation d'alias de configuration avec MediaTailor
Avant de commencer à utiliser des variables de domaine, vous devez créer des alias de configuration pour votre configuration. Vous utilisez les alias de configuration comme variables de remplacement de domaine au moment de l'initialisation de la session.
**Restrictions**
Notez les restrictions suivantes lorsque vous utilisez des alias de configuration :
+ Toutes les variables dynamiques utilisées dans le domaine doivent être définies en tant que variables `ConfigurationAliases` dynamiques.
+ Les variables des paramètres du joueur doivent être préfixées par`player_params.`. Par exemple, `player_params.origin_domain`.
+ La liste des valeurs aliasées doit être exhaustive pour les variables de domaine dans critical URLs (`VideoContentSourceUrl`,`AdSegmentUrlPrefix`,`ContentSegmentUrlPrefix`).
+ Si une demande est faite pour une variable de domaine critique URLs qui ne spécifie pas la variable dynamique ou utilise un alias non valide, la demande échouera avec un code d'`400`état HTTP. Les champs non critiques (`SlateAdUrl`,`TranscodeProfileName`, bumper URLs) enregistreront les avertissements mais ne feront pas échouer la demande.
**Comportement de secours en cas d'alias manquants**
Lorsque les alias de configuration sont introuvables ou ne sont pas valides, MediaTailor implémente le comportement de secours suivant :
+ **Variables de domaine :** si un alias de variable de domaine est manquant ou non valide, la demande échoue avec le code d'état HTTP 400. Des alias valides doivent être définis pour toutes les variables de domaine.
+ **Variables non liées au domaine :** pour les variables utilisées dans des parties non liées au domaine de URLs (telles que les éléments de chemin ou les paramètres de requête), les alias manquants entraînent le remplacement de chaînes vides.
+ **Validation de la configuration :** MediaTailor vérifie que tous les alias requis sont présents lors des opérations de création et de mise à jour de la configuration.
## Étape 1 : créer des alias de configuration
Pour créer des alias de configuration à utiliser pour le remplacement de domaines à l'aide de la MediaTailor console, effectuez la procédure suivante.
------
#### [ Console ]
**Pour créer des alias de configuration à l'aide de la console**
1. Ouvrez la MediaTailor console à l'adresse [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/).
1. Dans la section **Alias de configuration** de la page **Configurations**, choisissez **Ajouter un paramètre de joueur**.
1. Dans **Paramètre du joueur**, entrez le nom du paramètre du joueur que vous souhaitez utiliser comme variable dynamique. Par exemple, `player_params.origin_domain`.
1. **Dans Alias**, entrez les alias et leurs valeurs que vous souhaitez utiliser pour le paramètre du joueur.
1. Choisissez **OK**.
AWS Elemental MediaTailor affiche le nouveau paramètre dans le tableau de la section **Alias de configuration**.
1. Répétez les étapes précédentes pour ajouter d'autres paramètres au joueur.
1. Choisissez **Enregistrer**.
------
#### [ API ]
**Pour créer des alias de configuration à l'aide de l'API**
Lorsque vous créez ou mettez à jour une MediaTailor configuration, utilisez le `ConfigurationAliases` paramètre avec la structure JSON suivante :
```
{
"ConfigurationAliases": {
"player_params.origin_domain": {
"pdx": "abc.mediapackage.us-west-2.amazonaws.com",
"iad": "xyz.mediapackage.us-east-1.amazonaws.com"
},
"player_params.ad_type": {
"customized": "abc12345",
"default": "defaultAdType"
}
}
}
```
------
## Étape 2 : Utiliser des alias de configuration lors de l'initialisation de session
Après avoir configuré les alias de configuration, vous pouvez les utiliser comme variables de remplacement pour les domaines dans votre demande d'initialisation de session. Cela vous permet de configurer dynamiquement les domaines de votre session.
**Example Exemple d'alias de configuration de base**
Voici un exemple de configuration de base qui inclut des alias de configuration et des variables de domaine dynamiques :
```
PUT /playbackConfiguration
{
"Name": "aliasedConfig",
"AdDecisionServerUrl": "https://abc.execute-api.us-west-2.amazonaws.com/ads?sid=[session.id]&ad_type=[player_params.ad_type]",
"VideoContentSourceUrl": "https://[player_params.origin_domain].mediapackage.[player_params.region].amazonaws.com/out/v1/[player_params.endpoint_id]",
"ConfigurationAliases": {
"player_params.origin_domain": {
"pdx": "abc",
"iad": "xyz"
},
"player_params.region": {
"pdx": "us-west-2",
"iad": "us-east-1"
},
"player_params.endpoint_id": {
"pdx": "abcd",
"iad": "wxyz"
},
"player_params.ad_type": {
"customized": "abc12345",
"default": "defaultAdType"
}
}
}
```
**Example Initialisation de session avec des alias**
En utilisant la configuration précédente, une demande d'initialisation de session utilisant les variables et les alias du lecteur ressemblerait à ce qui suit :
```
POST index.m3u8
{
"playerParams": {
"origin_domain": "pdx",
"region": "pdx",
"endpoint_id": "pdx",
"ad_type": "customized"
}
}
```
MediaTailor remplace les chaînes d'alias par les valeurs mappées dans la configuration des alias de configuration.
La demande adressée à l'ADS ressemblera à ce qui suit :
```
https://abc.execute-api.us-west-2.amazonaws.com/ads?sid=[session.id]&ad_type=abc12345
```
La demande adressée à l'origine pour les manifestes ressemblera à ce qui suit :
```
https://abc.mediapackage.us-west-2.amazonaws.com/out/v1/abcd
```
# Alias de configuration avec exemple MediaTailor d'utilisation
Les exemples suivants illustrent une MediaTailor configuration complète avec des alias de configuration, une demande d'initialisation de session avec des alias et le flux de traitement des alias.
**Example Configuration complète avec alias**
L'exemple suivant montre une configuration complète qui inclut des alias de configuration et des variables de domaine dynamiques :
```
PUT /playbackConfiguration
{
"Name": "aliasedConfig",
"AdDecisionServerUrl": "https://abc.execute-api.us-west-2.amazonaws.com/ads?sid=[session.id]&ad_type=[player_params.ad_type]",
"VideoContentSourceUrl": "https://[player_params.origin_domain].mediapackage.[player_params.region].amazonaws.com/out/v1/[player_params.endpoint_id]",
"AdSegmentUrlPrefix": "https://[player_params.ad_cdn_domain]/ads/",
"ContentSegmentUrlPrefix": "https://[player_params.content_cdn_domain]/content/",
"TranscodeProfileName": "[player_params.transcode_profile]",
"SlateAdUrl": "https://[player_params.slate_domain]/slate/[player_params.slate_type].mp4",
"StartUrl": "https://[player_params.tracking_domain]/start?session=[session.id]",
"EndUrl": "https://[player_params.tracking_domain]/end?session=[session.id]",
"ConfigurationAliases": {
"player_params.origin_domain": {
"pdx": "abc",
"iad": "xyz"
},
"player_params.region": {
"pdx": "us-west-2",
"iad": "us-east-1"
},
"player_params.endpoint_id": {
"pdx": "abcd",
"iad": "wxyz"
},
"player_params.ad_type": {
"customized": "abc12345",
"default": "defaultAdType"
},
"player_params.ad_cdn_domain": {
"pdx": "ads-west.cdn.example.com",
"iad": "ads-east.cdn.example.com"
},
"player_params.content_cdn_domain": {
"pdx": "content-west.cdn.example.com",
"iad": "content-east.cdn.example.com"
},
"player_params.transcode_profile": {
"mobile": "mobile_optimized",
"desktop": "high_quality",
"tv": "4k_profile"
},
"player_params.slate_domain": {
"pdx": "slate-west.example.com",
"iad": "slate-east.example.com"
},
"player_params.slate_type": {
"standard": "default_slate",
"branded": "brand_slate"
},
"player_params.tracking_domain": {
"pdx": "tracking-west.example.com",
"iad": "tracking-east.example.com"
}
}
}
```
**Example Initialisation de session avec des alias**
L'exemple suivant montre une demande d'initialisation de session qui spécifie les variables et alias du joueur :
```
POST master.m3u8
{
"playerParams": {
"origin_domain": "pdx",
"region": "pdx",
"endpoint_id": "pdx",
"ad_type": "customized",
"ad_cdn_domain": "pdx",
"content_cdn_domain": "pdx",
"transcode_profile": "mobile",
"slate_domain": "pdx",
"slate_type": "branded",
"tracking_domain": "pdx"
}
}
```
**Example Flux de traitement des paramètres**
Dans l'exemple suivant, MediaTailor remplace les chaînes d'alias par les valeurs mappées dans les alias de configuration. Le traitement donne lieu aux demandes suivantes :
+ Demande ADS :
```
https://abc.execute-api.us-west-2.amazonaws.com/ads?sid=[session.id]&ad_type=abc12345
```
+ VideoContentSource demande :
```
https://abc.mediapackage.us-west-2.amazonaws.com/out/v1/abcd
```
+ AdSegmentUrlPrefix:
```
https://ads-west.cdn.example.com/ads/
```
+ ContentSegmentUrlPrefix:
```
https://content-west.cdn.example.com/content/
```
+ TranscodeProfileName:
```
mobile_optimized
```
+ SlateAdUrl:
```
https://slate-west.example.com/slate/brand_slate.mp4
```
+ StartUrl:
```
https://tracking-west.example.com/start?session=[session.id]
```
+ EndUrl:
```
https://tracking-west.example.com/end?session=[session.id]
```