Connexion de personnalisation personnalisée

Dernière mise à jour : 2023-11-01
  • Créé pour :
  • Developer
    User
    Admin
    Leader

Journal des modifications de destination

Mois de publication Type de mise à jour Description
Mai 2023 Nouvelles fonctionnalités et mise à jour de la documentation En mai 2023, la Personnalisation personnalisée prise en charge de la connexion personnalisation basée sur les attributs et est généralement disponible pour tous les clients.
IMPORTANT

Les attributs de profil peuvent contenir des données sensibles. Pour protéger ces données, la variable Personnalisation personnalisée La destination requiert que vous utilisiez la variable API du serveur réseau Edge lors de la configuration de la destination pour la personnalisation basée sur les attributs. Tous les appels de l’API du serveur doivent être effectués dans une contexte authentifié.


Si vous utilisez déjà le SDK Web ou le SDK mobile pour votre intégration, vous pouvez récupérer les attributs via l’API serveur en ajoutant une intégration côté serveur.


Si vous ne respectez pas les exigences ci-dessus, la personnalisation sera basée uniquement sur l’appartenance à l’audience.

Vue d’ensemble

Cette destination permet de récupérer les informations sur l’audience de Adobe Experience Platform vers des plateformes de personnalisation externes, des systèmes de gestion de contenu, des serveurs de publicités et d’autres applications exécutées sur les sites web des clients.

Conditions préalables

Cette intégration est optimisée par le SDK web Adobe Experience Platform ou le SDK mobile Adobe Experience Platform. Pour utiliser cette destination, vous devez utiliser l’un de ces SDK.

IMPORTANT

Avant de créer une connexion de personnalisation personnalisée, lisez le guide sur la façon de activation des données d’audience vers les destinations de personnalisation de périphérie. Ce guide vous fait parcourir toutes les étapes de configuration requises pour les cas d’utilisation de la personnalisation de la même page et de la page suivante, sur plusieurs composants Experience Platform.

Audiences prises en charge

Cette section décrit le type d’audiences que vous pouvez exporter vers cette destination.

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

Type et fréquence d’exportation

Élément Type Notes
Type d’exportation Profile request Vous demandez toutes les audiences qui sont mappées dans la destination de personnalisation personnalisée pour un seul profil. Différentes destinations de personnalisation personnalisées peuvent être configurées pour différents flux de données de collecte de données Adobe.
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.

Se connecter à la destination

IMPORTANT

Pour vous connecter à la destination, vous devez disposer de l’autorisation de contrôle d’accès 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.

Paramètres de connexion

Pendant la configuration de cette destination, vous devez fournir les informations suivantes :

  • Nom : renseignez le nom de votre choix pour cette destination.
  • Description : saisissez une description pour votre destination. Vous pouvez, par exemple, mentionner la campagne pour laquelle vous utilisez cette destination. Ce champ est facultatif.
  • Alias d’intégration : cette valeur est envoyée au SDK web Experience Platform sous forme de nom d’objet JSON.
  • Identifiant du flux de données: détermine dans quel jeu de données de collecte de données les audiences seront incluses dans la réponse à la page. Le menu déroulant affiche uniquement les flux de données pour lesquels la configuration de destination est activée. Voir Configurer un flux de données pour plus d’informations.

Activer les alertes

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

IMPORTANT

Pour activer les données, vous avez besoin des autorisations de contrôle d’accès pour les fonctions Gérer 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 de produit pour obtenir les autorisations requises.

Lecture Activation des destinations de personnalisation de périphérie des profils et des audiences pour obtenir des instructions sur l’activation des audiences vers cette destination.

Données exportées

Si vous utilisez des balises dans Adobe Experience Platform pour déployer le SDK web Experience Platform, utilisez la fonctionnalité Envoi de l’événement terminé et votre action de code personnalisé contiendra une variable event.destinations que vous pourrez utiliser pour afficher les données exportées.

Voici un exemple de valeur pour la variable event.destinations :

[
   {
      "type":"profileLookup",
      "destinationId":"7bb4cb8d-8c2e-4450-871d-b7824f547111",
      "alias":"personalizationAlias",
      "segments":[
         {
            "id":"399eb3e7-3d50-47d3-ad30-a5ad99e8ab77"
         },
         {
            "id":"499eb3e7-3d50-47d3-ad30-a5ad99e8ab77"
         }
      ]
   }
]

Si vous n’utilisez pas de balises pour déployer le SDK web Experience Platform, utilisez la fonctionnalité Gestion des réponses d’événements pour afficher les données exportées.

Vous pouvez analyser la réponse JSON d’Adobe Experience Platform pour trouver l’alias d’intégration correspondant à l’application que vous intégrez dans Adobe Experience Platform. Les identifiants d’audience peuvent être transmis dans le code de l’application en tant que paramètres de ciblage. Vous trouverez ci-dessous un exemple de ce à quoi cela ressemblerait dans le cas spécifique de la réponse de destination.

alloy("sendEvent", {
  "renderDecisions": true,
  "xdm": {
    "commerce": {
      "order": {
        "purchaseID": "a8g784hjq1mnp3",
        "purchaseOrderNumber": "VAU3123",
        "currencyCode": "USD",
        "priceTotal": 999.98
      }
    }
  }
}).then(function(result) {
    if(result.destinations) { // Looking to see if the destination results are there

        // Get the destination with a particular alias
        var personalizationDestinations = result.destinations.filter(x => x.alias == "personalizationAlias")
        if(personalizationDestinations.length > 0) {
             // Code to pass the audience IDs into the system that corresponds to personalizationAlias
        }
        var adServerDestinations = result.destinations.filter(x => x.alias == "adServerAlias")
        if(adServerDestinations.length > 0) {
            // Code to pass the audience IDs into the system that corresponds to adServerAlias
        }
     }
   })
  .catch(function(error) {
    // Tracking the event failed.
  });

Exemple de réponse pour Personnalisation Personnalisée Avec Attributs

Lorsque vous utilisez Personnalisation Personnalisée Avec Attributs, la réponse de l’API ressemblera à l’exemple ci-dessous.

La différence entre Personnalisation Personnalisée Avec Attributs et Personnalisation personnalisée est l’inclusion de la variable attributes dans la réponse de l’API.

[
    {
        "type": "profileLookup",
        "destinationId": "7bb4cb8d-8c2e-4450-871d-b7824f547130",
        "alias": "personalizationAlias",
        "attributes": {
             "countryCode": {
                   "value" : "DE"
              },
             "membershipStatus": {
                   "value" : "PREMIUM"
              }
         },
        "segments": [
            {
                "id": "399eb3e7-3d50-47d3-ad30-a5ad99e8ab77"
            },
            {
                "id": "499eb3e7-3d50-47d3-ad30-a5ad99e8ab77"
            }
        ]
    }
]

Utilisation et gouvernance des données

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.

Sur cette page