Documentazione Experience Platform Guida alle destinazioni

Connessione Zendesk

Last update: Wed Jul 31 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Argomenti:
Destinazioni

Creato per:

Amministratore
Utente

Zendesk è una soluzione di assistenza clienti e uno strumento di vendita.

Questa Adobe Experience Platform destinazione sfrutta l'API Zendesk Contatti per creare e aggiornare le identità all'interno di un pubblico come contatti in Zendesk.

Zendesk utilizza token Bearer come meccanismo di autenticazione per comunicare con l'API dei contatti di Zendesk. Le istruzioni per l'autenticazione nell'istanza Zendesk sono riportate di seguito, nella sezione Autentica nella destinazione.

Casi d’uso use-cases

Il reparto di assistenza clienti di una piattaforma B2C multicanale desidera garantire ai propri clienti un’esperienza personalizzata senza soluzione di continuità. Il reparto può creare tipi di pubblico dai propri dati offline per creare nuovi profili utente o aggiornare le informazioni di profilo esistenti da interazioni diverse (ad esempio acquisti, restituzioni, ecc.) e invia questi tipi di pubblico da Adobe Experience Platform a Zendesk. L'aggiornamento delle informazioni in Zendesk garantisce che l'agente del servizio clienti disponga immediatamente delle informazioni recenti del cliente, consentendo risposte e risoluzioni più rapide.

Prerequisiti prerequisites

Experience Platform prerequisiti prerequisites-in-experience-platform

Prima di attivare i dati nella destinazione Zendesk, è necessario disporre di uno schema, un set di dati e segmenti creati in Experience Platform.

Se hai bisogno di indicazioni sugli stati del pubblico, consulta la documentazione di Experience Platform per il gruppo di campi dello schema Dettagli appartenenza pubblico.

Zendesk prerequisiti prerequisites-destination

Per esportare i dati da Platform all'account Zendesk, è necessario disporre di un account Zendesk.

Raccogli Zendesk credenziali gather-credentials

Annotare gli elementi riportati di seguito prima di eseguire l'autenticazione nella destinazione Zendesk:

Credenziali

Descrizione

Esempio

Bearer token

Il token di accesso generato nell'account Zendesk.
Segui la documentazione per generare un Zendesk token di accesso se non ne hai uno.

a0b1c2d3e4...v20w21x22y23z

Guardrail guardrails

Nella pagina Determinazione prezzi e limiti tariffari sono illustrati i limiti API Zendesk associati al tuo account. Assicurati che i dati e il payload rientrino in questi vincoli.

Identità supportate supported-identities

Zendesk supporta l'aggiornamento delle identità descritte nella tabella seguente. Ulteriori informazioni su identità.

Identità di destinazione

Esempio

Descrizione

Obbligatorio

email

test@test.com

Indirizzo e-mail del contatto.

Sì

Tipo e frequenza di esportazione export-type-frequency

Per informazioni sul tipo e sulla frequenza di esportazione della destinazione, consulta la tabella seguente.

Elemento

Tipo

Note

Tipo di esportazione

Basato su profilo

Stai esportando tutti i membri di un segmento, insieme ai campi dello schema desiderati (ad esempio: indirizzo e-mail, numero di telefono, cognome), in base al mapping dei campi.
Ogni stato del segmento in Zendesk viene aggiornato con lo stato del pubblico corrispondente da Platform, in base al valore ID mappatura fornito durante il passaggio pianificazione del pubblico.

Frequenza di esportazione

Streaming

Le destinazioni di streaming sono connessioni "sempre attive" basate su API. Non appena un profilo viene aggiornato in Experience Platform in base alla valutazione del pubblico, il connettore invia l’aggiornamento a valle alla piattaforma di destinazione. Ulteriori informazioni sulle destinazioni di streaming.

Connettersi alla destinazione connect

IMPORTANT

Per connettersi alla destinazione, sono necessarie le Destinazioni visualizzazione e le Autorizzazioni di gestione delle destinazioni per il controllo degli accessi. Leggi la panoramica sul controllo degli accessi o contatta l'amministratore del prodotto per ottenere le autorizzazioni necessarie.

Per connettersi a questa destinazione, seguire i passaggi descritti nell'esercitazione sulla configurazione della destinazione. Nel flusso di lavoro di configurazione della destinazione, compila i campi elencati nelle due sezioni seguenti.

All'interno di Destinazioni > Catalogo, cerca Zendesk. In alternativa, è possibile individuarlo nella categoria CRM.

Autenticarsi nella destinazione authenticate

Compila i campi obbligatori di seguito. Per ulteriori informazioni, consulta la sezione Raccogli Zendesk credenziali.

Token Bearer: il token di accesso generato nell'account Zendesk.

Per eseguire l'autenticazione nella destinazione, selezionare Connetti alla destinazione.
Schermata dellinterfaccia utente di Platform che mostra come eseguire lautenticazione.

Se i dettagli forniti sono validi, nell'interfaccia utente viene visualizzato lo stato Connesso con un segno di spunta verde. A questo punto è possibile procedere al passaggio successivo.

Inserire i dettagli della destinazione destination-details

Per configurare i dettagli per la destinazione, compila i campi obbligatori e facoltativi seguenti. Un asterisco accanto a un campo nell’interfaccia utente indica che il campo è obbligatorio.
Schermata dellinterfaccia utente di Platform che mostra i dettagli della destinazione.

Nome: un nome con cui riconoscerai questa destinazione in futuro.
Descrizione: una descrizione che ti aiuterà a identificare questa destinazione in futuro.

Abilita avvisi enable-alerts

Puoi abilitare gli avvisi per ricevere notifiche sullo stato del flusso di dati verso la tua destinazione. Seleziona un avviso dall’elenco per abbonarti e ricevere notifiche sullo stato del flusso di dati. Per ulteriori informazioni sugli avvisi, consulta la guida su abbonamento a destinazioni avvisi tramite l'interfaccia utente.

Dopo aver fornito i dettagli per la connessione di destinazione, seleziona Avanti.

Attivare tipi di pubblico in questa destinazione activate

IMPORTANT

Per attivare i dati, è necessario Visualizza destinazioni, Attiva destinazioni, Visualizza profili e Visualizza segmenti Autorizzazioni di controllo di accesso. Leggi la panoramica sul controllo degli accessi o contatta l'amministratore del prodotto per ottenere le autorizzazioni necessarie.
Per esportare identità, è necessario disporre dell'autorizzazione Visualizza grafo identità Controllo di accesso.

{width="100" modal="regular"}

Leggi Attivare profili e tipi di pubblico nelle destinazioni di esportazione del pubblico di streaming per le istruzioni sull'attivazione dei tipi di pubblico in questa destinazione.

Considerazioni sulla mappatura ed esempio mapping-considerations-example

Per inviare correttamente i dati sul pubblico da Adobe Experience Platform alla destinazione Zendesk, è necessario eseguire il passaggio di mappatura dei campi. La mappatura consiste nella creazione di un collegamento tra i campi dello schema Experience Data Model (XDM) nell’account Platform e i corrispondenti equivalenti dalla destinazione.

Gli attributi specificati nel campo Target devono essere denominati esattamente come descritto nella tabella dei mapping degli attributi, in quanto tali attributi formeranno il corpo della richiesta.

Gli attributi specificati nel campo Source non seguono alcuna restrizione di questo tipo. È possibile eseguirne la mappatura in base alle proprie esigenze. Tuttavia, se il formato dei dati non è corretto al momento del push in Zendesk, si verificherà un errore.

Per mappare correttamente i campi XDM ai campi di destinazione Zendesk, effettua le seguenti operazioni:

Nel passaggio Mapping, seleziona Aggiungi nuovo mapping. Viene visualizzata una nuova riga di mappatura.
Nella finestra Seleziona campo di origine, scegli la categoria Seleziona attributi e seleziona l'attributo XDM oppure scegli lo spazio dei nomi Seleziona identità e seleziona un'identità.

Nella finestra Seleziona campo di destinazione, scegli la categoria Seleziona spazio dei nomi identità e seleziona un'identità di destinazione, oppure scegli la categoria Seleziona attributi e seleziona uno degli attributi di schema supportati.

Ripeti questi passaggi per aggiungere le seguenti mappature obbligatorie, puoi anche aggiungere qualsiasi altro attributo che desideri aggiornare tra lo schema del profilo XDM e l'istanza Zendesk:

table 0-row-3 1-row-3 2-row-3 3-row-3
Campo origine	Campo di destinazione	Obbligatorio
`xdm: person.name.lastName`	`xdm: last_name`	Sì
`IdentityMap: Email`	`Identity: email`	Sì
`xdm: person.name.firstName`	`xdm: first_name`

Di seguito è riportato un esempio che utilizza queste mappature:

IMPORTANT

Le mappature di destinazione Attribute: last_name e Identity: email sono obbligatorie per questa destinazione. Se mancano queste mappature, tutte le altre mappature vengono ignorate e non inviate a Zendesk.

Al termine della fornitura dei mapping per la connessione di destinazione, selezionare Avanti.

Esempio di esportazione e pianificazione di un pubblico schedule-segment-export-example

Nel passaggio Pianifica esportazione pubblico del flusso di lavoro di attivazione, devi mappare manualmente i tipi di pubblico di Platform all'attributo del campo personalizzato in Zendesk.

A questo scopo, seleziona ogni segmento, quindi immetti l'attributo del campo personalizzato corrispondente da Zendesk nel campo ID mappatura.

Di seguito è riportato un esempio:
Esempio di schermata dellinterfaccia utente di Platform che mostra lesportazione pianificata del pubblico.

Convalidare l’esportazione dei dati exported-data

Per verificare di aver impostato correttamente la destinazione, segui i passaggi seguenti:

Seleziona Destinazioni > Sfoglia e passa all'elenco delle destinazioni.
Quindi, seleziona la destinazione e passa alla scheda Dati attivazione, quindi seleziona un nome di pubblico.
Controlla il riepilogo del pubblico e assicurati che il conteggio dei profili corrisponda al conteggio all’interno del segmento.
Accedi al sito Web Zendesk, quindi passa alla pagina Contatti per verificare se i profili del pubblico sono stati aggiunti. Questo elenco può essere configurato in modo da visualizzare le colonne per i campi aggiuntivi creati con il pubblico ID mappatura e stati di pubblico.
In alternativa, puoi eseguire il drill-down in una singola pagina di Persona e controllare la sezione Campi aggiuntivi che mostra il nome del pubblico e gli stati del pubblico.

Utilizzo dei dati e governance data-usage-governance

Tutte le destinazioni Adobe Experience Platform sono conformi ai criteri di utilizzo dei dati durante la gestione dei dati. Per informazioni dettagliate su come Adobe Experience Platform applica la governance dei dati, vedi Panoramica sulla governance dei dati.

Risorse aggiuntive additional-resources

Di seguito sono riportate ulteriori informazioni utili dalla documentazione di Zendesk:

Changelog

Questa sezione acquisisce le funzionalità e i significativi aggiornamenti alla documentazione apportati al connettore di destinazione.

Visualizza changelog

table 0-row-3 1-row-3 2-row-3 layout-auto
Mese di rilascio	Tipo di aggiornamento	Descrizione
Aprile 2023	Aggiornamento della documentazione	Abbiamo aggiornato la sezione casi d'uso con un esempio più chiaro di quando i clienti trarrebbero vantaggio dall'utilizzo di questa destinazione. La sezione mapping è stata aggiornata per riflettere i mapping richiesti corretti. Le mappature di destinazione `Attribute: last_name` e `Identity: email` sono obbligatorie per questa destinazione. Se mancano queste mappature, tutte le altre mappature vengono ignorate e non inviate a Zendesk. La sezione mapping è stata aggiornata con chiari esempi di mapping obbligatori e facoltativi.
Marzo 2023	Versione iniziale	Versione di destinazione iniziale e pubblicazione della documentazione.

recommendation-more-help

7f4d1967-bf93-4dba-9789-bb6b505339d6