Invia per la revisione una destinazione prodotta creata in Destination SDK

Ultimo aggiornamento: 2023-08-10
  • Argomenti:
  • Destinations
    Visualizza ulteriori informazioni su questo argomento
  • Creato per:
  • Admin
    User

Panoramica

IMPORTANTE
  • Il processo qui documentato è necessario solo per i partner che inviano destinazioni (pubbliche) prodotte. Se stai creando una destinazione privata per il tuo uso personale, non è necessario produrre e condividere questi materiali con Adobe.

  • Il tempo di risposta standard di Adobe per esaminare le richieste di pubblicazione delle destinazioni è di cinque giorni lavorativi.

  • Se il team di Adobi ti chiede di apportare eventuali aggiornamenti alle configurazioni dopo l’invio iniziale, devi inviare un’altra richiesta di pubblicazione di destinazione dopo aver apportato gli aggiornamenti.

  • Anche dopo che la destinazione è live nel catalogo Experienci Platform, se devi apportare aggiornamenti alle configurazioni, devi inviare una nuova richiesta di pubblicazione di destinazione affinché gli aggiornamenti vengano rispecchiati nelle configurazioni.

Prima che la destinazione possa essere pubblicata su catalogo delle destinazioni di Experience Platform, è necessario fornire agli Adobi alcune informazioni sulla destinazione e sui test eseguiti, per garantire che gli utenti godano 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, invia un’e-mail a aepdestsdk@adobe.com che comprende:

  • Una descrizione dei casi d’uso risolti dalla tua destinazione. Questa operazione è necessaria solo se si invia una nuova configurazione di destinazione.
  • Una descrizione del motivo dell’invio a destinazione. Questa opzione è necessaria solo se si sta aggiornando una configurazione di destinazione esistente.
  • Risultati del test dopo l’utilizzo dell’endpoint API di destinazione del test per eseguire una chiamata HTTP alla destinazione. Condividi con Adobe una chiamata API effettuata all’endpoint di destinazione e la risposta API ricevuta dall’endpoint di destinazione.
  • Requisiti aggiuntivi per le destinazioni basate su file:
    • Condividi un esempio di richiesta e risposta dopo aver utilizzato l’API di test per testare la destinazione basata su file con profili di esempio.
    • Allega un file di esempio generato dalla destinazione ed esportato nel percorso di archiviazione.
    • Inviare una bozza che attesti che il file esportato è stato correttamente acquisito dal percorso di archiviazione nel sistema.
  • Prova di aver inviato una richiesta di pubblicazione di destinazione per la tua destinazione utilizzando API di pubblicazione della destinazione.
  • Una PR (richiesta pull) alla documentazione, seguendo le istruzioni descritte nella sezione processo di documentazione self-service.
  • Un file di immagine che verrà visualizzato come logo per la scheda di destinazione nel catalogo delle destinazioni di Experience Platform.

Puoi trovare informazioni dettagliate su ciascun elemento nelle sezioni seguenti:

Descrizione del caso d’uso

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:

  • Pinterest: crea tipi di pubblico dagli elenchi dei clienti, dalle persone che hanno visitato il tuo sito o dalle persone che hanno già interagito con il tuo contenuto su Pinterest.
  • Dati Yahoo X: le API DataX sono disponibili per gli inserzionisti che desiderano indirizzare un gruppo di pubblico specifico ricavato dagli indirizzi e-mail in Verizon Media (VMG) e che possono creare rapidamente un nuovo pubblico e inviarlo al gruppo di pubblico desiderato utilizzando l’API quasi in tempo reale di VMG.

Motivo dell’aggiornamento

NOTA

Questa sezione è necessaria solo quando si aggiorna una configurazione esistente.

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

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

  • La richiesta API completa (intestazioni e corpo) effettuata all'endpoint di destinazione, utilizzando l'API di test.
  • Risposta API ricevuta dall'endpoint di destinazione.

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

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

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

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

Prova della corretta acquisizione

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:

  • Screenshot o un breve video di cattura in cui il file viene prelevato manualmente dal percorso di archiviazione e caricato nel sistema.
  • Screenshot o un breve video di screencapture in cui l’interfaccia utente del sistema conferma che il nome del file generato da Experienci Platform è stato correttamente acquisito nel sistema.
  • Registra le righe del sistema che Adobe può correlare con il nome del file o con i dati generati da Experienci Platform.

Prova di aver inviato una richiesta di pubblicazione di destinazione

Dopo aver testato correttamente la destinazione, devi utilizzare 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

Se si è un fornitore di software indipendente (ISV) o un integratore di sistemi (SI) che crea un integrazione di produzione, è necessario utilizzare 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.

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:

  • Formato: SVG
  • Dimensione: meno di 2 MB

Scarica e-mail di esempio

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

In questa pagina