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

Vue d’ensemble overview

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 :

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

Description du cas d’utilisation use-case-description

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 :

Raison de la mise à jour reason-for-update

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 testing-api-response

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 :

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 additional-file-based-destination-requirements

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

Test de la réponse de l’API testing-api-response-file-based

Insérez 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é attach-exported-file

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

Preuve d’ingestion réussie proof-of-successful-ingestion

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 :

Preuve dʼenvoi dʼune demande de publication de destination destination-publishing-request-proof

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 la section Récupérer les requêtes de publication de destination.

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

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

Logo de votre destination logo

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 :

Télécharger un exemple d’e-mail download-sample-email

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