DocumentazioneExperience PlatformGuida alle destinazioni

Connessione Microsoft Dynamics 365

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

Creato per:

  • Amministratore
  • Utente

Panoramica overview

Microsoft Dynamics 365 è una piattaforma di applicazioni aziendali 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 complete più fluide e controllate, un migliore potenziale di crescita e costi ridotti.

Questa 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. Le istruzioni per l'autenticazione nell'istanza Dynamics 365 sono riportate di seguito, nella sezione Autentica nella destinazione.

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 visualizzarli 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 nella destinazione Dynamics 365, è necessario disporre di uno schema, un set di dati e tipi di pubblico creati in Experience Platform.

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

Microsoft Dynamics 365 prerequisiti prerequisites-destination

Per esportare i dati da Platform al tuo account Dynamics 365, tieni presente i seguenti prerequisiti in Dynamics 365:

Devi avere un account Microsoft Dynamics 365 prerequisites-account

Vai alla pagina Dynamics 365 prova per registrarti e creare un account, se non ne hai già uno.

Crea campo in Dynamics 365 prerequisites-custom-field

Creare il campo personalizzato di tipo Simple con tipo di dati del campo Single Line of Text che l'Experience Platform utilizzerà per aggiornare lo stato del pubblico entro Dynamics 365.

Per ulteriori informazioni, consulta la documentazione di Dynamics 365 Creare o modificare un campo (attributo).

Annotare il prefisso di personalizzazione del campo personalizzato creato in Dynamics 365. Questo prefisso sarà necessario durante il passaggio Compila i dettagli della destinazione. Per ulteriori informazioni, consulta la sezione Creare e modificare i campi della documentazione di Dynamics 365.
Schermata dellinterfaccia utente di Dynamics 365 con il prefisso di personalizzazione.

Di seguito è riportato un esempio di configurazione in Dynamics 365:
Schermata dellinterfaccia utente di Dynamics 365 con i campi personalizzati.

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

Per consentire a Dynamics 365 di accedere alle risorse, è necessario accedere con Azure Account a Azure Active Directory e creare quanto segue:

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

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

Raccogli Dynamics 365 credenziali gather-credentials

Annotare gli elementi riportati di seguito prima di eseguire l'autenticazione nella destinazione CRM Dynamics 365:

Credenziali
Descrizione
Esempio
Client ID
L'ID client Dynamics 365 per l'applicazione Azure Active Directory. Consulta la Dynamics 365 documentazione per maggiori informazioni.
ababbaba-abab-baba-acac-acacacacacac
Client Secret
Il segreto client Dynamics 365 per l'applicazione Azure Active Directory. Stai utilizzando l'opzione #2 nella Dynamics 365 documentazione.
abcde~abcdefghijklmnopqrstuvwxyz12345678 come guida.
Tenant ID
L'ID tenant Dynamics 365 per l'applicazione Azure Active Directory. Consulta la Dynamics 365 documentazione per maggiori informazioni.
1234567-aaaa-12ab-ba21-1234567890
Region
L’area Microsoft associata all’URL dell’ambiente.
Consulta la Dynamics 365 documentazione.
Se il dominio è il seguente, devi fornire il valore evidenziato per il campo CRM nel selettore a discesa durante l'autenticazione nella destinazione.
org57771b33.crm.dynamics.com
Ad esempio: se il provisioning della tua società è eseguito nell'area Nord America (NAM), l'URL sarà crm.dynamics.com e dovrai selezionare crm. Se la società dispone del provisioning nell'area canadese (CAN), l'URL sarà crm3.dynamics.com e sarà necessario selezionare crm3.
Environment URL
Consulta la Dynamics 365 documentazione per maggiori informazioni.
Se il dominio Dynamics 365 è il seguente, è necessario il valore evidenziato.
org57771b33.crm.dynamics.com

Guardrail guardrails

Nella pagina Limiti delle richieste e allocazioni sono illustrati i limiti API Dynamics 365 associati alla licenza Dynamics 365. 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. Per ulteriori informazioni, consulta la Dynamics 365 documentazione.

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 al mapping dei campi.
  • Ogni stato del pubblico in Dynamics 365 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 Dynamics 365. In alternativa, è possibile individuarlo nella categoria CRM.

Autenticarsi nella destinazione authenticate

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

Compila i campi obbligatori di seguito. Per ulteriori informazioni, consulta la sezione Raccolta credenziali Dynamics 365.

  • ID client: l'ID client Dynamics 365 per l'applicazione Azure Active Directory.
  • ID tenant: l'ID tenant Dynamics 365 per l'applicazione Azure Active Directory.
  • Segreto client: Segreto client Dynamics 365 per l'applicazione Azure Active Directory.
  • Area: La Tua Area Dynamics 365. Ad esempio: se il provisioning della tua società è stato eseguito nell'area Nord America (NAM), l'URL sarà crm.dynamics.com e devi selezionare crm. Se la società dispone del provisioning nell'area canadese (CAN), l'URL sarà crm3.dynamics.com e sarà necessario selezionare crm3.
  • URL ambiente: URL ambiente Dynamics 365.

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.
  • Prefisso personalizzazione: Customization prefix del campo personalizzato creato in Dynamics 365. Per ulteriori informazioni, consulta la sezione Creare e modificare i campi della documentazione di Dynamics 365.

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

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 Dynamics 365, è 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. Per mappare correttamente i campi XDM ai campi di destinazione Dynamics 365, effettua le seguenti operazioni:

  1. Nel passaggio Mapping, seleziona Aggiungi nuovo mapping. Viene visualizzata una nuova riga di mappatura.
    Esempio di schermata dellinterfaccia utente di Platform per aggiungere una nuova mappatura.

  2. Nella finestra Seleziona campo di origine, scegli la categoria Seleziona spazio dei nomi identità e seleziona contactid.
    Esempio di schermata dellinterfaccia utente di Platform per la mappatura di Source.

  3. Nella finestra Seleziona campo di destinazione, seleziona il tipo di campo di destinazione a cui vuoi mappare il campo di origine.

    • Seleziona lo spazio dei nomi delle identità: seleziona questa opzione per mappare il campo di origine a uno spazio dei nomi delle identità dall'elenco.

      Schermata dellinterfaccia utente di Platform che mostra il mapping di Target per contactid.

    • Aggiungi la seguente mappatura tra lo schema del profilo XDM e l'istanza Dynamics 365:

      table 0-row-3 1-row-3
      Schema profilo XDM Istanza Dynamics 365 Obbligatorio
      contactid contactid Sì

    • Seleziona attributi personalizzati: seleziona questa opzione per mappare il campo di origine a un attributo personalizzato definito nel campo Nome attributo. Per un elenco completo degli attributi supportati, consulta la Dynamics 365 documentazione.

      Schermata dellinterfaccia utente di Platform che mostra la mappatura di Target per le-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 campo di destinazione Dynamics 365 data o marca temporale, assicurati che il valore mappato non sia vuoto. Se il valore del campo esportato è vuoto, verrà visualizzato un messaggio di errore Bad request reported while pushing events to the destination. Please contact the administrator and try again. e i dati non verranno aggiornati. Limitazione di Dynamics 365.

    • Ad esempio, a seconda dei valori che desideri aggiornare, aggiungi la seguente mappatura tra lo schema del profilo XDM e l'istanza Dynamics 365:

      table 0-row-2 1-row-2 2-row-2 3-row-2
      Schema profilo XDM Istanza Dynamics 365
      person.name.firstName firstname
      person.name.lastName lastname
      personalEmail.address emailaddress1

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

    Esempio di schermata dellinterfaccia utente di Platform che mostra le mappature di Target.

Esempio di esportazione e pianificazione di un pubblico schedule-audience-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 Dynamics 365.

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

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

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:

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

  2. Selezionare la destinazione e verificare che lo stato sia abilitato.
    Schermata dellinterfaccia utente di Platform che mostra lesecuzione del flusso di dati delle destinazioni.

  3. Passa alla scheda Activation data, quindi seleziona un nome di pubblico.
    Esempio di schermata dellinterfaccia 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 dellinterfaccia utente di Platform che mostra il pubblico.

  5. Accedi al sito Web Dynamics 365, quindi passa alla pagina Customers > Contacts e controlla se i profili del pubblico sono stati aggiunti. È possibile vedere che ogni stato del pubblico in Dynamics 365 è stato aggiornato con lo stato del pubblico corrispondente da Platform, in base al valore ID mappatura fornito durante il passaggio pianificazione del pubblico.
    Schermata dellinterfaccia utente di Dynamics 365 che mostra la pagina Contatti con stati di pubblico aggiornati.

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.

Errori e risoluzione problemi errors-and-troubleshooting

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

Durante la verifica 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 dellinterfaccia utente di Platform che mostra un errore di richiesta non valida.

Per correggere questo errore, verifica che l'ID mappatura fornito in Dynamics 365 per il pubblico di Platform sia valido ed esista in Dynamics 365.

Risorse aggiuntive additional-resources

Ulteriori informazioni utili dalla Dynamics 365 documentazione sono riportate di seguito:

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 passaggio Considerazioni sul mapping e esempio.
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. Nel passaggio Compila i dettagli della destinazione è stato aggiunto il nuovo campo di input Prefisso personalizzazione. (PLATIR-31602).
Novembre 2022 Versione iniziale Versione di destinazione iniziale e pubblicazione della documentazione.
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6