Invia per la revisione una destinazione prodotta creata in Destination SDK

Panoramica overview

Prima che la destinazione possa essere pubblicata nel catalogo delle destinazioni Experience Platform, devi fornire ad Adobe determinate informazioni sulla destinazione e sui test eseguiti, per garantire che gli utenti possano godere della migliore esperienza possibile durante l'attivazione dei dati sulla piattaforma.

In questa pagina sono elencate tutte le informazioni che è necessario fornire quando si invia o si aggiorna una destinazione creata con Adobe Experience Platform Destination SDK. Per inviare correttamente una destinazione in Adobe Experience Platform, inviare un'e-mail a aepdestsdk@adobe.com che includa:

Puoi trovare informazioni dettagliate su ciascun elemento nelle sezioni seguenti:

Descrizione del caso d’uso use-case-description

Fornisci una descrizione dei casi d’uso risolti dalla tua destinazione, ad Experience Platform i clienti. Le descrizioni possono essere simili ai casi d’uso dei partner esistenti:

Motivo dell’aggiornamento reason-for-update

Fornisci una breve descrizione del problema che l’invio risolve per la destinazione esistente. Ad esempio, l’invio potrebbe aggiornare il nome, la descrizione e il logo della destinazione nel passaggio dalla versione beta a quella di disponibilità generale. In alternativa, l’invio potrebbe correggere un bug rilevato nella configurazione di destinazione.

Risultati del test dopo l’utilizzo dell’API di destinazione del test testing-api-response

Fornisci i risultati del test dopo aver utilizzato l'endpoint API di destinazione del test per eseguire una chiamata HTTP alla destinazione. Ciò include:

Ad esempio, la richiesta e la risposta potrebbero essere simili agli esempi seguenti:

Richiesta

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"
            }
         }
      }
   ]
}'

Risposta

{
   "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"
            }
         }
      }
   ]
}

Requisiti aggiuntivi per le destinazioni basate su file additional-file-based-destination-requirements

Per le destinazioni basate su file, devi fornire un’ulteriore prova della corretta configurazione della destinazione. Assicurati di includere gli elementi seguenti:

Verifica della risposta API testing-api-response-file-based

Includi una richiesta e un esempio di risposta dopo aver utilizzato l'API di test per testare la destinazione basata su file con profili di esempio.

Allega file esportato attach-exported-file

Nell'e-mail di invio, allega un file CSV esportato nel percorso di archiviazione dalla destinazione configurata.

Prova della corretta acquisizione proof-of-successful-ingestion

Infine, devi fornire una prova che i dati siano stati correttamente acquisiti nel sistema dopo essere stati esportati nel percorso di archiviazione fornito. Fornisci uno dei seguenti elementi:

Prova di aver inviato una richiesta di pubblicazione di destinazione destination-publishing-request-proof

Dopo aver testato correttamente la destinazione, devi utilizzare l'API di pubblicazione della destinazione per inviare la destinazione ad Adobe per la revisione e la pubblicazione.

Immetti l’ID della richiesta di pubblicazione per la destinazione. Per informazioni su come recuperare l'ID della richiesta di pubblicazione, leggi come recuperare le richieste di pubblicazione di destinazione.

Documentazione di destinazione PR (richiesta pull) per le integrazioni prodotte documentation-pr

Se sei un fornitore di software indipendente (ISV) o un integratore di sistemi (SI) che crea una integrazione prodotta, devi utilizzare il processo di documentazione self-service per creare una pagina di documentazione del prodotto per la tua destinazione. Come parte del processo di invio, fornisci la richiesta di pull (PR) per la documentazione di destinazione.

Logo per la destinazione logo

Il catalogo delle destinazioni include un logo per ogni scheda di destinazione. Nell’e-mail inviata, includi un’immagine con il logo della tua destinazione.

I requisiti dell'immagine sono:

Scarica e-mail di esempio download-sample-email

Scarica un'e-mail di esempio con tutte le informazioni necessarie da fornire a Adobe.