DocumentazioneExperience PlatformGuida alle destinazioni

Microsoft Dynamics 365 connessione

Last update: Thu Jan 25 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Admin
  • User

Panoramica overview

Microsoft Dynamics 365 è una piattaforma applicativa aziendale basata su cloud che combina la pianificazione delle risorse aziendali (ERP) e la gestione delle relazioni con i clienti (CRM), insieme alle applicazioni di produttività e agli strumenti di intelligenza artificiale, per garantire operazioni end-to-end più fluide e controllate, un migliore potenziale di crescita e costi ridotti.

Questo Adobe Experience Platform destinazione sfrutta Contact Entity Reference API, che consente di aggiornare le identità all’interno di un pubblico in Dynamics 365.

Dynamics 365 utilizza OAuth 2 con Concessione di autorizzazione come meccanismo di autenticazione per comunicare con Contact Entity Reference API. Istruzioni per l’autenticazione Dynamics 365 sono riportati di seguito, nella Autentica nella destinazione sezione.

Casi d’uso use-cases

In qualità di addetto al marketing, puoi fornire esperienze personalizzate ai tuoi utenti, in base agli attributi dei loro profili Adobe Experience Platform. Puoi creare tipi di pubblico dai dati offline e inviarli a Dynamics 365, per essere visualizzato nei feed degli utenti non appena i tipi di pubblico e i profili vengono aggiornati in Adobe Experience Platform.

Prerequisiti prerequisites

Experience Platform prerequisiti prerequisites-in-experience-platform

Prima di attivare i dati in Dynamics 365 destinazione, è necessario disporre di un schema, a set di dati, e audience creato in Experience Platform.

Consulta la documentazione di Adobe per Gruppo di campi schema Dettagli appartenenza pubblico per informazioni sugli stati del pubblico.

Microsoft Dynamics 365 prerequisiti prerequisites-destination

Prendi nota dei seguenti prerequisiti in Dynamics 365, per esportare i dati da Platform al tuo Dynamics 365 account:

Devi avere un Microsoft Dynamics 365 account prerequisites-account

Vai a Dynamics 365 prova per registrarsi e creare un account, se non ne hai già uno.

Crea campo in Dynamics 365 prerequisites-custom-field

Crea il campo personalizzato di tipo Simple con tipo di dati campo come Single Line of Text quale Experience Platform utilizzerà per aggiornare lo stato del pubblico in Dynamics 365.

Consulta la sezione Dynamics 365 Creare o modificare un campo (attributo) se hai bisogno di ulteriore assistenza.

Annota il Prefisso di personalizzazione del campo personalizzato creato in Dynamics 365. Questo prefisso sarà necessario durante il Inserisci i dettagli della destinazione passaggio. Consulta la sezione Creare e modificare i campi sezione del Dynamics 365 per ulteriori dettagli.
Schermata dell’interfaccia utente di Dynamics 365 con il prefisso di personalizzazione.

Un esempio di configurazione in Dynamics 365 è mostrato di seguito:
Schermata dell’interfaccia utente di Dynamics 365 con i campi personalizzati.

Registrare un'applicazione e un utente dell'applicazione in Azure Active Directory prerequisites-app-user

Per abilitare Dynamics 365 per accedere alle risorse è necessario accedere con il Azure Account a Azure Active Directory e crea quanto segue:

  • Un Azure Active Directory applicazione
  • Un'entità servizio
  • Segreto applicazione

È inoltre necessario creare un utente dell'applicazione in Azure Active Directory e associarlo all'applicazione appena creata.

Raccogli Dynamics 365 credenziali gather-credentials

Annota gli elementi riportati di seguito prima di eseguire l’autenticazione in Dynamics 365 Destinazione CRM:

Credenziali
Descrizione
Esempio
Client ID
Il Dynamics 365 ID client per Azure Active Directory applicazione. Consulta la sezione Dynamics 365 documentazione a titolo indicativo.
ababbaba-abab-baba-acac-acacacacacac
Client Secret
Il Dynamics 365 Segreto client per Azure Active Directory applicazione. Utilizzeresti l’opzione #2 all’interno di Dynamics 365 documentazione.
abcde~abcdefghijklmnopqrstuvwxyz12345678 a titolo indicativo.
Tenant ID
Il Dynamics 365 ID tenant per il Azure Active Directory applicazione. Consulta la sezione Dynamics 365 documentazione a titolo indicativo.
1234567-aaaa-12ab-ba21-1234567890
Region
L’area Microsoft associata all’URL dell’ambiente.
Consulta la sezione Dynamics 365 documentazione a titolo indicativo.
Se il tuo dominio è come di seguito, devi fornire il valore evidenziato per il campo CRM nel selettore a discesa durante l'autenticazione in destinazione.
org57771b33.crm.dynamics.com
Ad esempio: se il provisioning della tua azienda viene eseguito nell’area Nord America (NAM), l’URL sarà crm.dynamics.com e devi selezionare crm. Se il provisioning della tua azienda viene eseguito nell’area del Canada (CAN), l’URL sarà crm3.dynamics.com e devi selezionare crm3.
Environment URL
Consulta la sezione Dynamics 365 documentazione a titolo indicativo.
Se il Dynamics 365 è come di seguito, è necessario il valore evidenziato.
org57771b33.crm.dynamics.com

Guardrail guardrails

Il Richieste limiti e allocazioni dettagli pagina Dynamics 365 Limiti API associati al tuo Dynamics 365 licenza. Assicurati che i dati e il payload rientrino in questi vincoli.

Identità supportate supported-identities

Dynamics 365 supporta l’aggiornamento delle identità descritte nella tabella seguente. Ulteriori informazioni su identità.

Identità di destinazione
Esempio
Descrizione
Considerazioni
contactid
7eb682f1-ca75-e511-80d4-00155d2a68d1
Identificatore univoco di un contatto.
Obbligatorio. Consulta la sezione Dynamics 365 documentazione per ulteriori dettagli.

Tipi di pubblico supportati supported-audiences

Questa sezione descrive tutti i tipi di pubblico che puoi esportare in questa destinazione.

Questa destinazione supporta l’attivazione di tutti i tipi di pubblico generati tramite l’Experience Platform Servizio di segmentazione.

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 pubblico, insieme ai campi di schema desiderati ad esempio: indirizzo e-mail, numero di telefono, cognome, in base alla mappatura del campo.
  • Ogni stato del pubblico in Dynamics 365 viene aggiornato con il corrispondente stato del pubblico da Platform, in base al ID mappatura valore fornito durante il pianificazione del pubblico passaggio.
Frequenza di esportazione
Streaming
  • Le destinazioni di streaming sono connessioni "sempre attive" basate su API. Non appena un profilo viene aggiornato in Experienci Platform in base alla valutazione del pubblico, il connettore invia l’aggiornamento a valle alla piattaforma di destinazione. Ulteriori informazioni su destinazioni di streaming.

Connettersi alla destinazione connect

IMPORTANT
Per connettersi alla destinazione, è necessario Visualizza destinazioni e Gestire le destinazioni autorizzazioni di controllo degli accessi. Leggi le panoramica sul controllo degli accessi oppure contatta l’amministratore del prodotto per ottenere le autorizzazioni necessarie.

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

Entro Destinazioni > Catalogo cerca Dynamics 365. In alternativa, è possibile posizionarlo sotto il CRM categoria.

Autenticarsi nella destinazione authenticate

Per eseguire l’autenticazione nella destinazione, seleziona Connetti alla destinazione.
Schermata dell’interfaccia utente di Platform che mostra come eseguire l’autenticazione.

Compila i campi obbligatori di seguito. Consulta la sezione Raccogli credenziali Dynamics 365 sezione per eventuali indicazioni.

  • ID client: Il Dynamics 365 ID client per Azure Active Directory applicazione.
  • ID tenant: Il Dynamics 365 ID tenant per il Azure Active Directory applicazione.
  • Segreto client: Il Dynamics 365 Segreto client per Azure Active Directory applicazione.
  • Regione: il tuo Dynamics 365 Regione. Ad esempio: se il provisioning della tua azienda viene eseguito nell’area Nord America (NAM), l’URL sarà crm.dynamics.com e devi selezionare crm. Se il provisioning della tua azienda viene eseguito nell’area del Canada (CAN), l’URL sarà crm3.dynamics.com e devi selezionare crm3.
  • URL ambiente: il tuo Dynamics 365 URL ambiente.

Se i dettagli forniti sono validi, nell’interfaccia utente viene visualizzato un 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 dell’interfaccia utente di Platform che mostra i dettagli della destinazione.

  • Nome: nome con cui riconoscerai questa destinazione in futuro.
  • Descrizione: descrizione che ti aiuterà a identificare questa destinazione in futuro.
  • Prefisso di personalizzazione: Il Customization prefix del campo personalizzato creato in Dynamics 365. Consulta la sezione Creare e modificare i campi sezione del Dynamics 365 per ulteriori dettagli.

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 agli avvisi sulle destinazioni tramite l’interfaccia utente.

Una volta completate le informazioni sulla connessione di destinazione, seleziona Successivo.

Attivare tipi di pubblico in questa destinazione activate

IMPORTANT

Letto Attiva profili e tipi di pubblico nelle destinazioni di esportazione del pubblico in streaming per 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 a Dynamics 365 destinazione, devi passare attraverso 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. Per mappare correttamente i campi XDM su Dynamics 365 campi di destinazione, effettua le seguenti operazioni:

  1. In Mappatura passaggio, seleziona Aggiungi nuova mappatura. Viene visualizzata una nuova riga di mappatura.
    Esempio di schermata dell’interfaccia utente di Platform per Aggiungere una nuova mappatura.

  2. In Seleziona campo di origine finestra, scegli la Seleziona lo spazio dei nomi dell’identità categoria e selezione contactid.
    Esempio di schermata dell’interfaccia utente di Platform per la mappatura sorgente.

  3. In Seleziona campo di destinazione selezionare il tipo di campo di destinazione a cui si desidera mappare il campo di origine.

    • Seleziona lo spazio dei nomi dell’identità: seleziona questa opzione per mappare il campo sorgente a uno spazio dei nomi di identità dall’elenco.

      Schermata dell’interfaccia utente di Platform che mostra la mappatura di Target per contactid.

    • Aggiungi la seguente mappatura tra lo schema del profilo XDM e il Dynamics 365 istanza: |Schema profilo XDM|Dynamics 365 Istanza| Obbligatorio |—|—|—| |contactid|contactid| Sì |

    • Seleziona attributi personalizzati: seleziona questa opzione per mappare il campo sorgente a un attributo personalizzato definito in Nome attributo campo. Fai riferimento a Dynamics 365 documentazione per un elenco completo degli attributi supportati.

      Schermata dell’interfaccia utente di Platform che mostra la mappatura di Target per l’e-mail.

      note important
      IMPORTANT
      • I nomi dei campi di destinazione devono essere in lowercase.
      • Inoltre, se disponi di un campo sorgente data o marca temporale mappato a un Dynamics 365 data o timestamp campo di destinazione, assicurati che il valore mappato non sia vuoto. Se il valore del campo esportato è vuoto, si verifica un Bad request reported while pushing events to the destination. Please contact the administrator and try again. e i dati non verranno aggiornati. Questo è un Dynamics 365 limitazione.

    • Ad esempio, a seconda dei valori che desideri aggiornare, aggiungi la seguente mappatura tra lo schema di profilo XDM e il Dynamics 365 istanza: |Schema profilo XDM|Dynamics 365 Istanza| |—|—| |person.name.firstName|firstname| |person.name.lastName|lastname| |personalEmail.address|emailaddress1|

    • Di seguito è riportato un esempio che utilizza queste mappature:

      Esempio di schermata dell’interfaccia utente di Platform che mostra le mappature di Target.

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

In Pianificare l’esportazione del pubblico passaggio del flusso di lavoro di attivazione, devi mappare manualmente i tipi di pubblico di Platform all’attributo del campo personalizzato in Dynamics 365.

A questo scopo, seleziona ogni pubblico, quindi immetti l’attributo di campo personalizzato corrispondente da Dynamics 365 nel ID mappatura campo.

IMPORTANT
Valore utilizzato per ID mappatura deve corrispondere esattamente al nome dell’attributo del campo personalizzato creato in Dynamics 365. Consulta Dynamics 365 documentazione per informazioni su come trovare gli attributi dei campi personalizzati.

Di seguito è riportato un esempio:
Esempio di schermata dell’interfaccia utente di Platform che mostra l’esportazione pianificata del pubblico.

Convalidare l’esportazione dei dati exported-data

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

  1. Seleziona Destinazioni > Sfoglia per passare all’elenco delle destinazioni.
    Schermata dell’interfaccia utente di Platform che mostra le destinazioni di navigazione.

  2. Seleziona la destinazione e verifica che lo stato sia abilitato.
    Schermata dell’interfaccia utente di Platform che mostra l’esecuzione del flusso di dati delle destinazioni.

  3. Passa a Activation data , quindi seleziona un nome per il pubblico.
    Esempio di schermata dell’interfaccia utente di Platform che mostra i dati di attivazione delle destinazioni.

  4. Controlla il riepilogo del pubblico e assicurati che il conteggio dei profili corrisponda al conteggio creato all’interno del pubblico.
    Esempio di schermata dell’interfaccia utente di Platform che mostra il pubblico.

  5. Accedi a Dynamics 365 , quindi passare al Customers > Contacts e verificare se i profili del pubblico sono stati aggiunti. Puoi vedere che ogni stato del pubblico in Dynamics 365 è stato aggiornato con il corrispondente stato del pubblico da Platform, in base al ID mappatura valore fornito durante il pianificazione del pubblico passaggio.
    Screenshot dell’interfaccia utente di Dynamics 365 che mostra la pagina Contatti con stati del pubblico aggiornati.

Utilizzo dei dati e governance data-usage-governance

Tutti Adobe Experience Platform le destinazioni 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, consulta la sezione Panoramica sulla governance dei dati.

Errori e risoluzione problemi errors-and-troubleshooting

Sono stati riscontrati errori sconosciuti durante la trasmissione degli eventi alla destinazione unknown-errors

Durante il controllo di un’esecuzione del flusso di dati, se viene visualizzato il seguente messaggio di errore: Bad request reported while pushing events to the destination. Please contact the administrator and try again.

Schermata dell’interfaccia utente di Platform che mostra un errore di richiesta non valida.

Per correggere questo errore, verifica che ID mappatura hai fornito in Dynamics 365 per il pubblico di Platform è valido ed esiste in Dynamics 365.

Risorse aggiuntive additional-resources

Ulteriori informazioni utili da Dynamics 365 documentazione è sotto:

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 3-row-3 layout-auto
Mese di rilascio Tipo di aggiornamento Descrizione
Ottobre 2023 Aggiornamento della documentazione Sono state aggiornate le indicazioni per indicare che tutti i nomi degli attributi di destinazione devono essere in minuscolo, nel Considerazioni sulla mappatura ed esempio passaggio.
Agosto 2023 Aggiornamento della funzionalità e della documentazione È stato aggiunto il supporto per Dynamics 365 prefissi di campi personalizzati per campi personalizzati non creati nella soluzione predefinita in Dynamics 365. Un nuovo campo di input, Prefisso di personalizzazione, è stato aggiunto nel Inserisci i dettagli della destinazione passaggio. (PLATIR-31602).
Novembre 2022 Versione iniziale Versione di destinazione iniziale e pubblicazione della documentazione.
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6