Votre connexion de destination your-destination

Au fur et à mesure que vous parcourez ce modèle, remplacez ou supprimez tous les paragraphes en italique (en commençant par celui-ci).

Commencez par mettre à jour les métadonnées (titre et description) en haut de la page. Veuillez ignorer toutes les instances d'UICONTROL sur cette page. Il s’agit d’une balise qui aide nos processus de traduction automatique à traduire correctement la page dans les différentes langues que nous prenons en charge. Nous ajouterons des balises à votre documentation une fois que vous l’aurez envoyée.

IMPORTANT
  • Renseignez toutes les sections de ce modèle, dans l’ordre dans lequel elles sont décrites dans le modèle.
  • Ce modèle est mis à jour périodiquement, en fonction des commentaires du partenaire. Avant de commencer à créer de la documentation pour la destination, veillez à avoir téléchargé la dernière version du modèle.

Vue d’ensemble overview

Donnez un bref aperçu de votre entreprise, y compris de la valeur qu'elle offre aux clients. Insérez un lien vers la page d’accueil de la documentation de votre produit pour en savoir plus.

IMPORTANT
Ce connecteur de destination et cette page de documentation sont créés et gérés par l’équipe YourDestination. Pour toute demande ou information, contactez-les directement à l'adresse Insérez un lien ou une adresse e-mail où vous pouvez être contacté pour les mises à jour, par exemple support@YourDestination.com.

Cas d’utilisation use-cases

Pour mieux comprendre quand et comment utiliser la destination YourDestination, consultez les exemples de cas d’utilisation ci-dessous que la clientèle de Adobe Experience Platform peut résoudre.

Cas d’utilisation #1 use-case-1

Pour les plateformes de messagerie mobile :

Une plateforme de location et de vente d’habitations souhaite envoyer des notifications mobiles aux appareils Android et iOS des clients pour leur indiquer qu’il existe 100 annonces mises à jour dans la zone où ils ont précédemment recherché une location.

Cas d’utilisation #2 use-case-2

Pour les plateformes de réseaux sociaux :

Une marque de vêtements de sport souhaite atteindre des clients existants par le biais de leurs comptes de médias sociaux. La marque de vêtements peut ingérer des adresses e-mail de son propre CRM vers Adobe Experience Platform, créer des audiences à partir de ses propres données hors ligne et envoyer ces audiences à YourDestination, pour afficher des annonces dans les flux de médias sociaux de ses clients.

Conditions préalables prerequisites

Ajoutez dans cette section des informations sur tout ce que les clients doivent savoir avant de commencer à configurer la destination dans l’interface utilisateur de Adobe Experience Platform. Cela peut concerner :

  • ajout nécessaire à une liste autorisée
  • exigences relatives au hachage des e-mails
  • toutes les caractéristiques du compte de votre côté
  • comment obtenir une clé API pour se connecter à votre plateforme

Vous pouvez créer un lien vers la documentation appropriée si cela s’avère utile pour les clients.

Identités prises en charge supported-identities

Ajoutez des informations dans cette section sur les identités prises en charge par la destination. Nous avons prérempli le tableau avec des valeurs standard. Supprimez les valeurs qui ne s’appliquent pas à votre destination et/ou ajoutez des valeurs qui ne sont pas préremplies.

YourDestination prend en charge l’activation des identités décrites dans le tableau ci-dessous. En savoir plus sur les identités.

Identité cible
Description
Considérations
GAID
GOOGLE ADVERTISING ID
Sélectionnez l’identité cible GAID lorsque votre identité source est un espace de noms GAID.
IDFA
Identifiant Apple pour les annonceurs
Sélectionnez l’identité cible IDFA lorsque votre identité source est un espace de noms IDFA.
ECID
Experience Cloud ID
Un espace de noms représentant l’ECID. Cet espace de noms peut également être référencé par les alias suivants : « ID Adobe Marketing Cloud », « ID Adobe Experience Cloud », « ID Adobe Experience Platform ». Lisez le document suivant sur ECID pour plus d’informations.
phone_sha256
Numéros de téléphone hachés avec l’algorithme SHA256
Adobe Experience Platform prend en charge le texte brut et les numéros de téléphone hachés avec SHA256. Lorsque votre champ source contient des attributs non hachés, cochez l’option Appliquer la transformation pour que Experience Platform hache automatiquement les données lors de l’activation.
email_lc_sha256
Adresses e-mail hachées avec l’algorithme SHA256
Adobe Experience Platform prend en charge le texte brut et les adresses e-mail hachées avec SHA256. Lorsque votre champ source contient des attributs non hachés, cochez l’option Appliquer la transformation pour que Experience Platform hache automatiquement les données lors de l’activation.
extern_id
ID d’utilisateur personnalisés
Sélectionnez cette identité cible lorsque votre identité source est un espace de noms personnalisé.

Audiences prises en charge supported-audiences

Ajoutez des informations dans cette section sur les audiences prises en charge par la destination. Nous avons prérempli le tableau avec des valeurs standard. Utilisez les caractères et X pour indiquer si votre type d’audience est pris en charge par cette destination.

Cette section décrit les types d’audiences que vous pouvez exporter vers cette destination.

Origine de l’audience
Pris en charge
Description
Segmentation Service
Audiences générées via Experience Platform Segmentation Service.
Chargements personnalisés
X
Audiences importées dans Experience Platform à partir de fichiers CSV.

Type et fréquence d’exportation export-type-frequency

Dans le tableau, conservez uniquement les lignes qui correspondent à votre destination. Vous devriez avoir une ligne pour le type d’exportation et une ligne pour la fréquence d’exportation. Supprimez les valeurs qui ne s’appliquent pas à votre destination.

Reportez-vous au tableau ci-dessous pour plus d’informations sur le type et la fréquence d’exportation des destinations.

Élément
Type
Notes
Type d’exportation
Export d’audience
Vous exportez tous les membres d’une audience avec les identifiants (nom, numéro de téléphone ou autres) utilisés dans la destination YourDestination.
Type d’exportation
Basé sur les profils
Vous exportez tous les membres d’une audience, ainsi que les champs de schéma souhaités (par exemple : adresse e-mail, numéro de téléphone, nom), tels qu’ils ont été choisis dans l’écran de sélection des attributs de profil du workflow d’activation de destination.
Type d’exportation
Exportation de jeu de données
Vous exportez des jeux de données bruts, qui ne sont pas regroupés ou structurés par intérêt ou qualification d’audience.
Fréquence des exportations
Diffusion en continu
Les destinations de diffusion en continu sont des connexions basées sur l’API « toujours actives ». Dès qu’un profil est mis à jour dans Experience Platform en fonction de l’évaluation des audiences, le connecteur envoie la mise à jour en aval vers la plateforme de destination. En savoir plus sur les destinations de diffusion en continu.
Fréquence des exportations
Lot
Les destinations par lots exportent des fichiers vers des plateformes en aval par incréments de trois, six, huit, douze ou vingt-quatre heures. En savoir plus sur les destinations basées sur des fichiers par lots.

Se connecter à la destination connect

IMPORTANT
Pour vous connecter à la destination, vous avez besoin des autorisations de contrôle d’accès Afficher les destinations et Gérer les destinations 🔗. Lisez la présentation du contrôle d’accès ou contactez votre administrateur de produit pour obtenir les autorisations requises.

Pour vous connecter à cette destination, procédez comme décrit dans le tutoriel sur la configuration des destinations. Dans le workflow de configuration des destinations, renseignez les champs répertoriés dans les deux sections ci-dessous.

S’authentifier auprès de la destination authenticate

Ajoutez les champs que les clients doivent remplir lors de l’authentification à la destination. Ces champs sont spécifiques à la destination et dépendent de votre configuration dans Destination SDK. Les champs de la destination peuvent être différents de ceux répertoriés ci-dessous. Veuillez également inclure une capture d’écran similaire à l’exemple de capture d’écran ci-dessous.

Pour vous authentifier à la destination, renseignez les champs requis et sélectionnez Se connecter à la destination.

Exemple de capture d’écran montrant comment s’authentifier à la destination

  • Jeton porteur  : renseignez le jeton porteur pour vous authentifier sur la destination.

Renseigner les détails de la destination destination-details

Ajoutez les champs que les clients doivent remplir lors de la configuration d’une nouvelle destination. Ces champs sont spécifiques à la destination et dépendent de votre configuration dans Destination SDK. Les champs de la destination peuvent être différents de ceux répertoriés ci-dessous. Veuillez également inclure une capture d’écran similaire à l’exemple de capture d’écran ci-dessous.

Pour configurer les détails de la destination, renseignez les champs obligatoires et facultatifs ci-dessous. Un astérisque situé en regard d’un champ de l’interface utilisateur indique que le champ est obligatoire.

Exemple de capture d’écran montrant comment remplir les détails pour votre destination

  • Nom  : un nom par lequel vous reconnaîtrez cette destination à l’avenir.
  • Description  : une description qui vous aidera à identifier cette destination à l’avenir.
  • Identifiant de compte : votre identifiant de compte YourDestination.

Activer les alertes enable-alerts

Vous pouvez activer les alertes pour recevoir des notifications sur le statut de votre flux de données vers votre destination. Sélectionnez une alerte dans la liste et abonnez-vous à des notifications concernant le statut de votre flux de données. Pour plus d’informations sur les alertes, consultez le guide sur l’abonnement aux alertes des destinations dans l’interface utilisateur.

Lorsque vous avez terminé de renseigner les détails sur votre connexion de destination, sélectionnez Suivant.

Activer des audiences vers cette destination activate

IMPORTANT
  • Pour activer les données, vous avez besoin des autorisations de contrôle d’accès Afficher les destinations, Activer les destinations, Afficher les profils et Afficher les segments 🔗. Lisez la présentation du contrôle d’accès ou contactez votre administrateur ou administratrice du produit pour obtenir les autorisations requises.

  • Pour exporter des identités, vous devez disposer de l’autorisation de contrôle d’accès Afficher le graphique d’identités 🔗.

    Sélectionnez l’espace de noms d’identité en surbrillance dans le workflow pour activer les audiences vers les destinations. {width="100" modal="regular"}

Supprimer les éléments appropriés - Si vous documentez une nouvelle destination de diffusion en continu, conservez le premier paragraphe ci-dessous. Si vous documentez une nouvelle destination basée sur des fichiers, conservez le deuxième paragraphe. Si vous documentez une destination qui exporte des jeux de données, conservez le troisième paragraphe.

Consultez la section Activer les profils et les audiences vers les destinations d’exportation d’audiences en flux continu pour obtenir des instructions sur l’activation des audiences vers cette destination.

Consultez la section Activer des données d’audience vers des destinations d’exportation de profils par lots pour obtenir des instructions sur l’activation des audience vers cette destination.

Lisez (Beta) Exporter des jeux de données pour obtenir des instructions détaillées sur l’exportation de jeux de données vers cette destination.

Mapper les attributs et les identités map

Ajoutez des informations sur les mappages pris en charge entre les champs source et cible dans l’étape Mappage du workflow d’activation. Votre destination peut prendre en charge l’exportation d’attributs de profil, d’espaces de noms d’identité ou les deux. Certains champs peuvent être obligatoires. Les attributs de la cible peuvent être prédéfinis ou personnalisés. Signalez les avertissements importants et utilisez des exemples, de préférence avec des captures d’écran. Voici deux exemples de pages de destination que vous pouvez utiliser comme référence :

Données exportées / Valider l’exportation des données exported-data

Ajoutez un paragraphe sur la manière dont les données sont exportées vers la destination. Cela permet au client de s’assurer qu’il s’est correctement intégré à la destination. Par exemple, vous pouvez fournir un exemple de fichier JSON comme celui ci-dessous. Vous pouvez également fournir des captures d’écran et des informations à partir de l’interface de la destination qui montrent comment les clients et les clientes doivent s’attendre à ce que les audiences soient renseignées dans la plateforme de destination.

{
  "person": {
    "email": "yourstruly@adobe.com"
  },
  "segmentMembership": {
    "ups": {
      "7841ba61-23c1-4bb3-a495-00d3g5fe1e93": {
        "lastQualificationTime": "2020-05-25T21:24:39Z",
        "status": "exited"
      },
      "59bd2fkd-3c48-4b18-bf56-4f5c5e6967ae": {
        "lastQualificationTime": "2020-05-25T23:37:33Z",
        "status": "realized"
      }
    }
  },
  "identityMap": {
    "ecid": [
      {
        "id": "14575006536349286404619648085736425115"
      },
      {
        "id": "66478888669296734530114754794777368480"
      }
    ],
    "email_lc_sha256": [
      {
        "id": "655332b5fa2aea4498bf7a290cff017cb4"
      },
      {
        "id": "66baf76ef9de8b42df8903f00e0e3dc0b7"
      }
    ]
  }
}

Utilisation et gouvernance des données data-usage-governance

Lors de la gestion de vos données, toutes les destinations Adobe Experience Platform se conforment aux politiques d’utilisation des données. Pour obtenir des informations détaillées sur la manière dont Adobe Experience Platform applique la gouvernance des données, consultez la Présentation de la gouvernance des données.

Ressources supplémentaires additional-resources

Vous pouvez fournir d’autres liens vers la documentation de votre produit ou toute autre ressource que vous jugez importante pour le succès de l’activité du client.

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6