Diffusion de destination

Pour mieux contrôler où se trouvent les données exportées vers la destination, Destination SDK vous permet de spécifier les paramètres de diffusion de destination.

La section de diffusion de destination indique l’emplacement des données exportées et la règle d’authentification utilisée à l’emplacement d’entrée des données.

Pour comprendre la place de ce composant dans une intégration créée avec Destination SDK, consultez le diagramme de la documentation Options de configuration ou consultez les pages de vue d’ensemble de la configuration de destination suivantes :

Vous pouvez configurer les paramètres de diffusion de destination via le point d’entrée /authoring/destinations. Pour obtenir des exemples d’appels API détaillés dans lesquels vous pouvez configurer les composants affichés sur cette page, consultez les pages de référence de l’API suivantes.

Cet article décrit toutes les options de diffusion de destination prises en charge que vous pouvez utiliser pour la destination.

IMPORTANT
Tous les noms et toutes les valeurs de paramètre pris en charge par Destination SDK sont sensibles à la casse. Pour éviter les erreurs de respect de la casse, utilisez les noms et valeurs des paramètres exactement comme indiqué dans la documentation.

Types d’intégration pris en charge supported-integration-types

Pour en savoir plus sur les types d’intégration qui prennent en charge les fonctionnalités décrites sur cette page, consultez le tableau ci-dessous.

Type d’intégration
Fonctionnalité de prise en charge
Intégrations en temps réel (streaming)
Oui
Intégrations basées sur des fichiers (par lots)
Oui

Paramètres pris en charge supported-parameters

Pendant la configuration des paramètres de diffusion de destination, vous pouvez utiliser les paramètres décrits dans le tableau ci-dessous pour définir l’endroit où les données exportées doivent être envoyées.

Paramètre
Type
Description
authenticationRule
Chaîne

Indique comment Platform devrait se connecter à la destination. Valeurs prises en charge :

  • CUSTOMER_AUTHENTICATION : utilisez cette option si la clientèle de Platform se connecte à votre système via l’une des méthodes d’authentification décrites ici.
  • PLATFORM_AUTHENTICATION : utilisez cette option s’il existe un système d’authentification global entre Adobe et la destination et que le client Platform n’a pas besoin de fournir d’informations d’authentification pour se connecter à la destination. Dans ce cas, vous devez créer des informations d’identification à l’aide de la configuration des informations d’identification API.
  • NONE : utilisez cette option si aucune authentification n’est obligatoire pour envoyer des données à votre plateforme de destination.
destinationServerId
Chaîne
Paramètre instanceId du serveur de destination vers lequel vous souhaitez exporter des données.
deliveryMatchers.type
Chaîne
  • Pendant la configuration de la diffusion de destination pour les destinations basées sur des fichiers, définissez toujours ce paramètre sur SOURCE.
  • Pendant la configuration de la diffusion de destination pour une destination de diffusion en streaming, la section deliveryMatchers n’est pas obligatoire.
deliveryMatchers.value
Chaîne
  • Pendant la configuration de la diffusion de destination pour les destinations basées sur des fichiers, définissez toujours ce paramètre sur batch.
  • Pendant la configuration de la diffusion de destination pour une destination de diffusion en streaming, la section deliveryMatchers n’est pas obligatoire.

Paramètres de diffusion de destination pour les destinations de diffusion en streaming destination-delivery-streaming

L’exemple ci-dessous montre comment les paramètres de diffusion de destination doivent être configurés pour une destination de diffusion en streaming. Notez que la section deliveryMatchers n’est pas obligatoire pour les destinations de diffusion en streaming.

recommendation-more-help
{
   "destinationDelivery":[
      {
         "authenticationRule":"CUSTOMER_AUTHENTICATION",
         "destinationServerId":"{{destinationServerId}}"
      }
   ]
}

Paramètres de diffusion de destination pour les destinations basées sur des fichiers destination-delivery-file-based

L’exemple ci-dessous montre comment les paramètres de diffusion de destination doivent être configurés pour une destination basée sur des fichiers. Notez que la section deliveryMatchers n’est pas obligatoire pour les destinations basées sur des fichiers.

{
   "destinationDelivery":[
      {
         "deliveryMatchers":[
            {
               "type":"SOURCE",
               "value":[
                  "batch"
               ]
            }
         ],
         "authenticationRule":"CUSTOMER_AUTHENTICATION",
         "destinationServerId":"{{destinationServerId}}"
      }
   ]
}

Étapes suivantes next-steps

Vous êtes arrivé au bout de cet article. À présent, vous devriez mieux comprendre comment configurer les emplacements des exportations de données de la destination, tant pour les destinations de diffusion en streaming que pour les destinations basées sur des fichiers.

Pour en savoir plus sur les autres composants de destination, consultez les articles suivants :

7f4d1967-bf93-4dba-9789-bb6b505339d6