Configuration de destination de diffusion en continu

Présentation

Cette configuration vous permet d’indiquer les informations essentielles à votre destination de diffusion en continu, telles que votre nom de destination, votre catégorie, votre description, etc. Les paramètres de cette configuration déterminent également comment les utilisateurs d’Experience Platform s’authentifient pour votre destination, comment ils apparaissent dans l’interface utilisateur d’Experience Platform ainsi que les identités qui peuvent être exportées vers votre destination.

Cette configuration connecte également les autres configurations requises pour que votre destination fonctionne (métadonnées de serveur de destination et d’audience) à celle-ci. Découvrez comment vous pouvez référencer les deux configurations dans une section ci-dessous.

Vous pouvez configurer la fonctionnalité décrite dans ce document à l’aide du point d’entrée de l’API /authoring/destinations. Consultez Opérations de point d’entrée de l’API Destinations pour obtenir une liste complète des opérations que vous pouvez effectuer sur le point d’entrée.

Exemple de configuration de diffusion en continu

Voici un exemple de configuration d’une destination fictive de diffusion en continu, Moviestar, qui dispose de points d’entrée dans quatre endroits sur le globe. La destination appartient à la catégorie des destinations mobiles.

{
   "name":"Moviestar",
   "description":"Moviestar is a fictional destination, used for this example.",
   "status":"TEST",
   "customerAuthenticationConfigurations":[
      {
         "authType":"BEARER"
      }
   ],
   "customerDataFields":[
      {
         "name":"endpointsInstance",
         "type":"string",
         "title":"Select Endpoint",
         "description":"Moviestar manages several instances across the globe for REST endpoints that our customers are provisioned for. Select your endpoint in the dropdown list.",
         "isRequired":true,
         "enum":[
            "US",
            "EU",
            "APAC",
            "NZ"
         ]
      },
      {
         "name":"customerID",
         "type":"string",
         "title":"Moviestar Customer ID",
         "description":"Your customer ID in the Moviestar destination (e.g. abcdef).",
         "isRequired":true,
         "pattern":"^[A-Za-z]+$"
      }
   ],
   "uiAttributes":{
      "documentationLink":"http://www.adobe.com/go/destinations-moviestar-en",
      "category":"mobile",
      "connectionType":"Server-to-server",
      "frequency":"Streaming"
   },
   "identityNamespaces":{
      "external_id":{
         "acceptsAttributes":true,
         "acceptsCustomNamespaces":true,
         "acceptedGlobalNamespaces":{
            "Email":{

            }
         }
      },
      "another_id":{
         "acceptsAttributes":true,
         "acceptsCustomNamespaces":true
      }
   },
   "schemaConfig":{
      "profileRequired":false,
      "segmentRequired":true,
      "identityRequired":true
   },
   "destinationDelivery":[
      {
         "authenticationRule":"CUSTOMER_AUTHENTICATION",
         "destinationServerId":"9c77000a-4559-40ae-9119-a04324a3ecd4"
      }
   ],
   "segmentMappingConfig":{
      "mapExperiencePlatformSegmentName":false,
      "mapExperiencePlatformSegmentId":false,
      "mapUserInput":false,
      "audienceTemplateId":"cbf90a70-96b4-437b-86be-522fbdaabe9c"
   },
   "aggregation":{
      "aggregationType":"CONFIGURABLE_AGGREGATION",
      "configurableAggregation":{
         "splitUserById":true,
         "maxBatchAgeInSecs":2400,
         "maxNumEventsInBatch":5000,
         "aggregationKey":{
            "includeSegmentId":true,
            "includeSegmentStatus":true,
            "includeIdentity":true,
            "oneIdentityPerGroup":false,
            "groups":[
               {
                  "namespaces":[
                     "IDFA",
                     "GAID"
                  ]
               },
               {
                  "namespaces":[
                     "EMAIL"
                  ]
               }
            ]
         }
      }
   },
   "backfillHistoricalProfileData":true
}

Configurations de l’authentification du client

Cette section de la configuration des destinations génère la page Configurer une nouvelle destination dans l’interface utilisateur d’Experience Platform, où les utilisateurs connectent Experience Platform aux comptes qu’ils possèdent avec votre destination. Selon l’option d’authentification que vous indiquez dans le champ authType, la page Experience Platform est générée pour les utilisateurs comme suit :

Authentification du porteur

Lorsque vous configurez le type d’authentification du porteur, les utilisateurs doivent saisir le jeton du porteur qu’ils obtiennent de votre destination.

Authentification OAuth 2

Les utilisateurs sélectionnent Se connecter à la destination pour déclencher le flux d’authentification OAuth 2 vers votre destination, comme illustré dans l’exemple ci-dessous pour la destination Audiences personnalisées de Twitter. Pour plus d’informations sur la configuration de l’authentification OAuth 2 à votre point d’entrée de destination, consultez la page Authentification OAuth 2 de Destination SDK.

Champs de données client

Utilisez cette section pour demander aux utilisateurs de renseigner des champs personnalisés, spécifiques à votre destination, lors de la connexion à la destination dans l’interface utilisateur d’Experience Platform. La configuration se reflète dans le flux d’authentification comme illustré ci-dessous :

Attributs de l’interface utilisateur

Cette section fait référence aux éléments de l’interface utilisateur dans la configuration ci-dessus qu’Adobe doit utiliser pour votre destination dans l’interface utilisateur d’Adobe Experience Platform. Consultez le tableau ci-dessous :

Configuration du schéma dans l’étape de mappage

Utilisez les paramètres de la section schemaConfig pour activer l’étape de mappage du workflow d’activation de destination. En utilisant les paramètres décrits ci-dessous, vous pouvez déterminer si les utilisateurs Experience Platform peuvent mapper des attributs de profil et/ou des identités au schéma souhaité du côté de votre destination.

Identités et attributs

Les paramètres de cette section déterminent les identités acceptées par votre destination. Cette configuration renseigne également les identités et les attributs cibles dans l’étape de mappage de l’interface utilisateur dʼExperience Platform, où les utilisateurs mappent les identités et les attributs de leurs schémas XDM au schéma de votre destination.

Vous devez indiquer quelles identités Platform les clients peuvent exporter vers votre destination. Voici quelques exemples : Experience Cloud ID, e-mail haché, identifiant de l’appareil (IDFA, GAID). Ces valeurs sont les suivantes : espaces de noms d’identité Platform que les clients peuvent mapper aux espaces de noms d’identité de votre destination. Vous pouvez également indiquer si les clients peuvent mapper des espaces de noms personnalisés à des identités prises en charge par votre destination.

Les espaces de noms d’identité ne nécessitent pas de correspondance 1-1 entre Platform et votre destination.
Par exemple, les clients peuvent mapper un espace de nom Platform IDFA à un espace de noms IDFA depuis votre destination ou mapper le même espace de noms Platform IDFA à un espace de noms Customer ID dans votre destination.

En savoir plus dans la section Présentation des espaces de noms d’identité.

Diffusion de destination

Configuration du mappage de segments

Cette section de la configuration de destination concerne la manière dont les métadonnées de segment telles que les noms ou les identifiants doivent être partagées entre Experience Platform et votre destination.

Par le biais de audienceTemplateId, cette section associe également cette configuration à la configuration des métadonnées d’audience.

Les paramètres affichés dans la configuration ci-dessus sont décrits dans la référence de l’API de point d’entrée des destinations.

Stratégie d’agrégation

Cette section vous permet de définir les stratégies d’agrégation qu’Experience Platform doit utiliser lors de l’exportation de données vers votre destination.

Une stratégie d’agrégation détermine la manière dont les profils exportés sont combinés dans les exportations de données. Les options disponibles sont les suivantes :

• Agrégation des meilleurs efforts
• Agrégation configurable (affichée dans la configuration ci-dessus)

Lisez la section relative à l’utilisation de modèles ainsi que les exemples de clés d’agrégation pour comprendre comment inclure la stratégie d’agrégation dans votre modèle de transformation des messages en fonction de votre stratégie d’agrégation sélectionnée.

Agrégation des meilleurs efforts

Cette option fonctionne mieux pour les destinations qui préfèrent moins de profils par requête et qui préfèrent recevoir plus de requêtes avec moins de données que de requêtes avec plus de données.

Utilisez le paramètre maxUsersPerRequest pour spécifier le nombre maximal de profils que votre destination peut prendre dans une requête.

Agrégation configurable

Cette option fonctionne mieux si vous préférez accepter des lots volumineux, avec des milliers de profils sur le même appel. Cette option permet également d’agréger les profils exportés en fonction de règles d’agrégation complexes.

Cette option vous permet d’effectuer les opérations suivantes :

• Définissez la durée maximale et le nombre maximal de profils à agréger avant qu’un appel API ne soit effectué vers votre destination.
• Agrégez les profils exportés mappés à la destination en fonction des éléments suivants :
  • Identifiant du segment ;
  • Statut du segment ;
  • Identité ou groupes d’identités.

Pour des explications détaillées des paramètres d’agrégation, reportez-vous à la page de référence Opérations de point d’entrée de l’API Destinations, où chaque paramètre est décrit.

Qualifications des profils historiques

Vous pouvez utiliser le paramètre backfillHistoricalProfileData dans la configuration des destinations pour déterminer si les qualifications des profils historiques doivent être exportées vers votre destination.

Comment cette configuration connecte toutes les informations nécessaires à votre destination

Certains de vos paramètres de destination doivent être configurés via le serveur de destination ou la configuration des métadonnées d’audience. La configuration de destination décrite ici connecte tous ces paramètres en référençant les deux autres configurations comme suit :

• Utilisez la variable destinationServerId pour référencer la configuration du serveur de destination et du modèle pour votre destination.
• Utilisez la variable audienceMetadataId pour référencer la configuration des métadonnées d’audience pour votre destination.