Envoyer pour révision une destination productisée créée en Destination SDK

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

Vue d’ensemble

IMPORTANT
  • Le processus documenté ici n’est nécessaire que pour les partenaires qui envoient des destinations productisées (publiques). Si vous créez une destination privée pour votre propre usage, vous n’avez pas besoin de produire et de partager ces matériaux avec Adobe.

  • Le temps de réponse standard de l’Adobe pour passer en revue les demandes de publication de destination est de cinq jours ouvrables.

  • Si l’équipe d’Adobe vous demande d’apporter des mises à jour à vos configurations après votre envoi initial, vous devez envoyer une autre demande de publication de destination après avoir effectué les mises à jour.

  • Même une fois votre destination publiée dans le catalogue des Experience Platform, si vous devez apporter des mises à jour à vos configurations, vous devez envoyer une nouvelle demande de publication de destination pour que les mises à jour soient répercutées dans les configurations.

Pour que votre destination puisse être publiée dans le catalogue des destinations Experience Platform, vous devez fournir à Adobe certaines informations sur la destination et les tests effectués. Cela permet de sʼassurer que les utilisateurs bénéficient de la meilleure expérience possible lors de l’activation des données vers votre plateforme.

Cette page répertorie toutes les informations dont vous avez besoin pour envoyer ou mettre à jour une destination créée à l’aide dʼAdobe Experience Platform Destination SDK. Pour envoyer une destination dans Adobe Experience Platform, adressez un e-mail à aepdestsdk@adobe.com et précisez les informations suivantes :

  • Une description des cas d’utilisation que votre destination résout. Cela n’est nécessaire que si vous envoyez une nouvelle configuration de destination.
  • Description de la raison de l’envoi vers la destination. Cela n’est nécessaire que si vous mettez à jour une configuration de destination existante.
  • Des résultats de test après avoir utilisé le point dʼentrée de l’API de destination de test pour effectuer un appel HTTP vers votre destination. Partagez avec l’Adobe un appel API effectué à votre point de terminaison de destination et la réponse de l’API reçue de votre point de terminaison de destination.
  • Autres exigences pour les destinations basées sur des fichiers :
    • Partagez une requête et un exemple de réponse après avoir utilisé l’API de test sur tester votre destination basée sur des fichiers avec des exemples de profils ;.
    • Joignez un fichier d’exemple généré par votre destination et exporté vers votre emplacement de stockage.
    • Envoyez une forme de BAT indiquant que vous avez correctement ingéré le fichier exporté à partir de l’emplacement de stockage dans votre système.
  • La preuve que vous avez envoyé une demande de publication de destination pour votre destination à l’aide de l’API de publication de destination.
  • Une documentation PR (requête de tirage), suivant les instructions décrites dans la section processus de documentation en libre-service.
  • Un fichier image qui s’affichera sous forme de logo sur votre carte de destination dans le catalogue des destinations dʼExperience Platform.

Vous trouverez des informations détaillées sur chaque élément dans les sections ci-dessous :

Description du cas d’utilisation

Fournissez une description des cas d’utilisation que votre destination résout pour les clients Experience Platform. Vos descriptions peuvent être similaires aux cas d’utilisation des partenaires existants :

  • Pinterest: créez des audiences à partir des listes de clients, des personnes qui ont visité votre site ou des personnes qui ont déjà interagi avec votre contenu sur Pinterest.
  • Yahoo Data X: les API DataX sont disponibles pour les annonceurs qui souhaitent cibler un groupe d’audience spécifique en dehors des adresses électroniques dans Verizon Media (VMG) peuvent rapidement créer une nouvelle audience et pousser le groupe d’audience souhaité à l’aide de l’API en temps quasi réel de VMG.

Raison de la mise à jour

REMARQUE

Cette section n’est nécessaire que lorsque vous mettez à jour une configuration existante.

Fournissez une brève description du problème résolu par votre envoi pour la destination existante. Par exemple, votre envoi peut mettre à jour le nom, la description et le logo de votre destination au fur et à mesure que vous passez de la version bêta à la mise à disposition générale. Ou, votre envoi peut corriger un bogue détecté dans votre configuration de destination.

Résultats du test après l’utilisation de l’API de destination du test

Fournissez les résultats du test après avoir utilisé le point dʼentrée de l’API de destination du test pour effectuer un appel HTTP vers votre destination. Cela inclut :

  • La requête API complète (en-têtes et corps) effectuée sur votre point dʼentrée de destination, à l’aide de l’API de test.
  • La réponse de l’API reçue de votre point dʼentrée de destination.

Par exemple, votre requête et votre réponse peuvent ressembler aux exemples ci-dessous :

Requête

curl --location --request POST 'https://platform.adobe.io/data/core/activation/authoring/testing/destinationInstance/3e0ac39c-ef14-4101-9fd9-cf0909814510' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'x-api-key: {API_KEY}' \
--header 'Authorization: Bearer {ACCESS_TOKEN}' \
--header 'x-gw-ims-org-id: {ORG_ID}' \
--header 'x-sandbox-name: {SANDBOX_NAME}' \
--data-raw '{
   "profiles":[
      {
         "segmentMembership":{
            "ups":{
               "374a9a6c-c719-4cdb-a660-155a2838e6d6":{
                  "lastQualificationTime":"2021-05-13T12:16:27.248585Z",
                  "status":"realized"
               },
               "896f8776-9498-47b4-b994-51cb3f61c2c5":{
                  "lastQualificationTime":"2021-05-13T12:16:27.248605Z",
                  "status":"realized"
               }
            }
         },
         "identityMap":{
            "Email":[
               {
                  "id":"Email-iIyJc"
               }
            ],
            "IDFA":[
               {
                  "id":"IDFA-viPAW"
               }
            ],
            "GAID":[
               {
                  "id":"GAID-Bc6LE"
               }
            ],
            "Email_LC_SHA256":[
               {
                  "id":"Email_LC_SHA256-gEOdj"
               }
            ]
         },
         "attributes":{
            "key":{
               "value":"string"
            }
         }
      }
   ]
}'

Réponse

{
   "results":[
      {
         "aggregationKey":{
            "destinationInstanceId":"string",
            "segmentId":"string",
            "segmentStatus":"realized",
            "identityNamespaces":[
               [
                  "email",
                  "phone"
               ]
            ]
         },
         "httpCalls":[
            {
               "traceId":"a06fec2d-a886-4219-8975-4e4b7ed26539",
               "request":{
                  "body":"{ \"attributes\": [  { \"external_id\": \"external_id-h29Fq\"  , \"AdobeExperiencePlatformSegments\": { \"add\": [  \"Nirvana fans\" ,  \"RHCP fans\"   ], \"remove\": [  ] }  ,  \"key\":  \"string\"    }  ] }",
                  "headers":[
                     {
                        "Content-Type":"application/json"
                     }
                  ],
                  "method":"POST",
                  "uri":"https://api.moviestar.com/users/track"
               },
               "response":{
                  "body":"{\"status\": \"success\"}",
                  "code":"200",
                  "headers":[
                     {
                        "Connection":"keep-alive"
                     },
                     {
                        "Content-Type":"application/json"
                     },
                     {
                        "Server":"nginx"
                     },
                     {
                        "Vary":"Origin,Accept-Encoding"
                     },
                     {
                        "transfer-encoding":"chunked"
                     }
                  ]
               }
            }
         ]
      }
   ],
   "inputProfiles":[
      {
         "segmentMembership":{
            "ups":{
               "03fb9938-8537-4b4c-87f9-9c4d413a0ee5":{
                  "lastQualificationTime":"2021-06-17T12:25:12.872039Z",
                  "status":"realized"
               },
               "27e05542-d6a3-46c7-9c8e-d59d50229530":{
                  "lastQualificationTime":"2021-06-17T12:25:12.872042Z",
                  "status":"realized"
               }
            }
         },
         "personalEmail":{
            "address":"john.smith@abc.com"
         },
         "identityMap":{
            "Email":[
               {
                  "id":"Email-iIyJc"
               }
            ],
            "IDFA":[
               {
                  "id":"IDFA-viPAW"
               }
            ],
            "GAID":[
               {
                  "id":"GAID-Bc6LE"
               }
            ],
            "Email_LC_SHA256":[
               {
                  "id":"Email_LC_SHA256-gEOdj"
               }
            ]
         },
         "person":{
            "name":{
               "firstName":"string"
            }
         }
      }
   ]
}

Autres exigences pour les destinations basées sur des fichiers

Pour les destinations basées sur des fichiers, vous devez fournir un BAT supplémentaire que vous avez correctement configuré votre destination. Veillez à inclure les éléments ci-dessous :

Test de la réponse de l’API

Inclure une requête et un exemple de réponse après avoir utilisé l’API de test pour tester votre destination basée sur des fichiers avec des exemples de profils ;.

Joindre le fichier exporté

Dans votre courrier électronique d’envoi, joignez un fichier CSV qui a été exporté dans votre emplacement de stockage par la destination que vous avez configurée.

Preuve d’ingestion réussie

Enfin, vous devez fournir une forme de preuve que les données ont bien été ingérées dans votre système après leur exportation vers l’emplacement de stockage que vous avez fourni. Veuillez fournir tous les éléments ci-dessous :

  • Captures d’écran ou courte capture d’écran dans laquelle vous prenez le fichier manuellement à partir de l’emplacement de stockage et l’ingérez dans votre système.
  • Captures d’écran ou courte capture d’écran dans laquelle l’interface utilisateur de votre système confirme que le nom de fichier généré par l’Experience Platform a bien été ingéré dans votre système.
  • Des lignes de journal de votre système qui peuvent être corrélées avec le nom de fichier ou avec les données générées par Experience Platform.

Preuve dʼenvoi dʼune demande de publication de destination

Une fois votre destination testée, vous devez utiliser l’API de publication de destination pour envoyer la destination à Adobe pour examen et publication.

Indiquez l’identifiant de la demande de publication pour votre destination. Pour plus d’informations sur la manière de récupérer l’ID de requête de publication, lisez comment récupération des requêtes de publication de destination.

Documentation de destination PR (demande de tirage) pour les intégrations personnalisées

Si vous êtes un fournisseur de logiciels indépendant (ISV) ou un intégrateur de système (SI), créez une intégration productive, vous devez utiliser la variable processus de documentation en libre-service pour créer une page de documentation du produit pour votre destination. Dans le cadre du processus d’envoi, indiquez la demande de tirage (PR) pour votre documentation de destination.

Le catalogue des destinations comprend un logo pour chaque carte de destination. Incluez dans votre e-mail une image avec le logo de votre destination.

Les exigences relatives aux images sont les suivantes :

  • Format : SVG
  • Taille : moins de 2 Mo

Télécharger un exemple d’e-mail

Téléchargez un exemple d’e-mail contenant toutes les informations que vous devez fournir à Adobe.

Sur cette page