Destinations sono integrazioni predefinite con piattaforme di destinazione che consentono l’attivazione senza soluzione di continuità dei dati da Adobe Experience Platform. Puoi utilizzare le destinazioni per attivare i dati noti e sconosciuti per le campagne di marketing cross-channel, le campagne e-mail, la pubblicità mirata e molti altri casi d’uso.
Prima di attivare i dati, è necessario connettersi alla destinazione impostando prima un account di destinazione. Questa esercitazione descrive i passaggi per eliminare gli account di destinazione che non sono più necessari utilizzando Flow Service API.
L’eliminazione degli account di destinazione è attualmente supportata solo nell’API del servizio di flusso. Gli account di destinazione non possono essere eliminati utilizzando l'interfaccia utente di Experience Platform.
Questa esercitazione richiede un ID di connessione valido. L'ID di connessione rappresenta la connessione dell'account alla destinazione. Se non disponi di un ID di connessione valido, seleziona la destinazione scelta dalla catalogo delle destinazioni e seguire i passi descritti in connettersi alla destinazione prima di provare questa esercitazione.
Questa esercitazione richiede anche di avere una buona conoscenza dei seguenti componenti di Adobe Experience Platform:
Le sezioni seguenti forniscono informazioni aggiuntive che sarà necessario conoscere per eliminare correttamente un account di destinazione utilizzando Flow Service API.
Questa esercitazione fornisce esempi di chiamate API per dimostrare come formattare le richieste. Questi includono percorsi, intestazioni richieste e payload di richiesta formattati correttamente. Viene inoltre fornito un esempio di codice JSON restituito nelle risposte API. Per informazioni sulle convenzioni utilizzate nella documentazione per le chiamate API di esempio, consulta la sezione sulle come leggere le chiamate API di esempio in Experience Platform guida alla risoluzione dei problemi.
Per effettuare chiamate a Platform API, devi prima completare l’ esercitazione sull'autenticazione. Il completamento dell’esercitazione sull’autenticazione fornisce i valori per ciascuna delle intestazioni richieste in tutte le Experience Platform Chiamate API, come mostrato di seguito:
Authorization: Bearer {ACCESS_TOKEN}
x-api-key: {API_KEY}
x-gw-ims-org-id: {ORG_ID}
Tutte le risorse in Experience Platform, compresi quelli appartenenti Flow Service, sono isolate in sandbox virtuali specifiche. Tutte le richieste a Platform Le API richiedono un’intestazione che specifichi il nome della sandbox in cui avrà luogo l’operazione:
x-sandbox-name: {SANDBOX_NAME}
Se la x-sandbox-name
intestazione non specificata, le richieste vengono risolte sotto prod
sandbox.
Tutte le richieste che contengono un payload (POST, PUT, PATCH) richiedono un’intestazione di tipo multimediale aggiuntiva:
Content-Type: application/json
Questa esercitazione utilizza la funzione Destinazione dell'aeromobile ad esempio, ma i passaggi descritti si applicano a uno qualsiasi dei destinazioni disponibili.
Il primo passaggio nell'eliminazione di un account di destinazione consiste nell'individuare l'ID di connessione corrispondente all'account di destinazione che si desidera eliminare.
Nell’interfaccia utente di Experience Platform, seleziona Destinazioni > Account e seleziona l'account da eliminare selezionando il numero nel Destinazioni colonna.
Successivamente, puoi recuperare l’ID di connessione dell’account di destinazione dall’URL nel browser.
Prima di eliminare l'account di destinazione, è necessario eliminare tutti i flussi di dati esistenti nell'account di destinazione.
Per eliminare i flussi di dati esistenti, fai riferimento alle pagine seguenti:
Una volta ottenuto un ID di connessione e verificato che non siano presenti flussi di dati per l’account di destinazione, esegui una richiesta DELETE al Flow Service API.
Formato API
DELETE /connections/{CONNECTION_ID}
Parametro | Descrizione |
---|---|
{CONNECTION_ID} |
L'unico id valore della connessione che si desidera eliminare. |
Richiesta
curl -X DELETE \
'https://platform.adobe.io/data/foundation/flowservice/connections/c8622ec7-7d94-44a5-a35a-ffcc6bdcc384' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}'
Risposta
Una risposta corretta restituisce lo stato HTTP 204 (Nessun contenuto) e un corpo vuoto. Puoi confermare l’eliminazione tentando una richiesta di ricerca (GET) alla connessione. L’API restituirà un errore HTTP 404 (Non trovato) che indica che l’account di destinazione è stato eliminato.
Gli endpoint API in questa esercitazione seguono i principi generali dei messaggi di errore API di Experience Platform. Fai riferimento a Codici di stato API e errori di intestazione della richiesta nella guida alla risoluzione dei problemi di Platform.
Seguendo questa esercitazione, hai utilizzato correttamente il Flow Service API per eliminare gli account di destinazione esistenti. Per ulteriori informazioni sull’utilizzo delle destinazioni, consulta panoramica sulle destinazioni.