DocumentazioneCampaignDocumentazione di Campaign v8

Utilizzare Campaign e Microsoft Dynamics 365 crm-ms-dynamics

Last update: Fri Jul 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:

Creato per:

  • Principiante
  • Intermedio
  • Amministratore
  • Utente

Attiva i dati CRM sulla comunicazione cross-channel: scopri come trasferire i contatti da Microsoft Dynamics 365 ad Adobe Campaign e condividere i dati sulle prestazioni della campagna (invii, aperture, clic e mancati recapiti) da Adobe Campaign a Microsoft Dynamics 365.

Al termine della configurazione, la sincronizzazione dei dati tra sistemi viene eseguita tramite un’attività del flusso di lavoro dedicata. Ulteriori informazioni.

NOTE
Le versioni supportate di Microsoft Dynamics sono descritte in dettaglio nella Matrice di compatibilità di Campaign.

Segui i passaggi seguenti per configurare un account esterno dedicato per importare ed esportare dati di Microsoft Dynamics 365 in Adobe Campaign.

Per ogni sistema, questi passaggi devono essere eseguiti da un amministratore.

CAUTION
I passaggi descritti in questa documentazione ti guideranno attraverso la creazione di integrazioni/registrazioni che richiedono l’assegnazione di autorizzazioni e/o l’accesso come amministratore. È tua responsabilità accertarti che questi passaggi siano conformi alle politiche aziendali prima di eseguire e di eseguirli con attenzione.

Configurare Microsoft Dynamics 365 config-crm-microsoft

Per connettere Microsoft Dynamics 365 per l'utilizzo con Adobe Campaign tramite API Web, accedere alla directory di Microsoft Azure utilizzando una credenziale Global administrator, quindi eseguire la procedura seguente:

  1. Ottieni l’ID dell’applicazione (client) Dynamics 365. Ulteriori informazioni
  2. Genera l'identificatore chiave del certificato e l'ID chiave di Microsoft Dynamics. Ulteriori informazioni
  3. Configurare le autorizzazioni. Ulteriori informazioni
  4. Crea un utente dell’app. Ulteriori informazioni
  5. Codifica la chiave privata. Ulteriori informazioni

Ottieni ID client Dynamics 365 get-client-id-microsoft

Per ottenere l'ID applicazione (client), è necessario registrare un'app in Azure Active Directory.

  1. Selezionare Azure Active Directory > Registrazioni app e selezionare Nuova registrazione.
  2. Immettere un nome univoco che consenta di identificare un'istanza, ad esempio adobecampaign<instance identifier>.

Dopo il salvataggio, la directory di Microsoft Azure assegna un ID applicazione (client) univoco all'app. Questo ID sarà necessario successivamente per configurare Dynamics 365 in Adobe Campaign.

Ulteriori informazioni sono disponibili nella documentazione di Microsoft Dynamics 365.

Genera ID chiave e identificatore chiave del certificato di Microsoft Dynamics config-certificate-key-id

Per ottenere l'identificatore chiave del certificato (customKeyIdentifier) e l'ID chiave (keyId), è necessario caricare un certificato. I certificati possono essere utilizzati come segreti per dimostrare l’identità dell’applicazione al momento della richiesta di un token. Possono anche essere denominate chiavi pubbliche.

Segui i passaggi seguenti:

  1. Selezionare Azure Active Directory > Registrazioni app e quindi l'applicazione creata in precedenza.
  2. Seleziona Certificati e segreto.
  3. Dalla scheda Certificati, fai clic su Carica certificato
  4. Carica il certificato pubblico.
  5. Passare al collegamento Manifesto per ottenere l'identificatore chiave del certificato (customKeyIdentifier) e l'ID chiave (keyId).

L'identificatore della chiave del certificato (customKeyIdentifier) e l'ID della chiave (keyId) sono necessari in Campaign per configurare l'account esterno di Microsoft Dynamics 365 CRM utilizzando il certificato CRM O-Auth type.

Come generare il certificato pubblico

Per generare il certificato, puoi utilizzare openssl.

Ad esempio:

code language-none 
- openssl req -x509 -sha256 -nodes -days 365 -newkey rsa:2048 -keyout '<'private key name'>' -out '<'public certificate name'>
note note
NOTE
È possibile modificare il numero di giorni, qui -days 365, nell'esempio di codice per un periodo di validità del certificato più lungo.

È quindi necessario codificare il certificato in base64. A tale scopo, è possibile utilizzare l'aiuto di un codificatore Base64 o la riga di comando base64 -w0 private.key per Linux.

Configurare le autorizzazioni config-permissions-microsoft

Passaggio 1: configurare le autorizzazioni richieste per l'app creata.

  1. Passare a Azure Active Directory > Registrazioni app e selezionare l'applicazione creata in precedenza.
  2. Fai clic su Impostazioni in alto a sinistra.
  3. In Autorizzazioni richieste, fare clic su Aggiungi e Seleziona un'API > Dynamics CRM Online.
  4. Fai clic su Seleziona, abilita Access Dynamics 365 come utenti dell'organizzazione, seleziona la casella di controllo e fai clic su Seleziona.
  5. Quindi, dall'app, seleziona Manifesto nel menu Gestisci.
  6. Dall'editor Manifest, impostare la proprietà allowPublicClient da null a true e fare clic su Salva.

Passaggio 2: concedere il consenso dell'amministratore

  1. Passare a Azure Active Directory > Applicazioni aziendali.
  2. Seleziona l’applicazione a cui desideri concedere il consenso dell’amministratore a livello di tenant.
  3. Dal menu del riquadro a sinistra, selezionare Autorizzazioni in Sicurezza.
  4. Fai clic su Concedi il consenso dell'amministratore.

Per ulteriori informazioni, consulta Documentazione di Azure.

Creare un utente dell’app create-app-user-microsoft

NOTE
Questo passaggio è facoltativo con autenticazione Password credentials.

L’utente dell’app è l’utente che verrà utilizzato dall’applicazione registrata in precedenza. Eventuali modifiche apportate a Microsoft Dynamics utilizzando l’app registrata in precedenza verranno eseguite tramite questo utente.

Passaggio 1: creare un utente non interattivo in Azure Active Directory

  1. Fare clic su Azure Active Directory > Utenti e quindi su Nuovo utente.
  2. Assegna un nome appropriato che desideri utilizzare e il nome utente deve essere in formato e-mail.
  3. Scegliere Amministratore Dynamics 365 in Ruolo directory.

Passaggio 2: assegna una licenza corretta all'utente creato

  1. Da Microsoft Azure, fare clic su App amministratore.
  2. Vai a Utenti > Utenti attivi e fai clic sull'utente appena creato.
  3. Fai clic su Modifica licenze prodotto e seleziona il Piano di coinvolgimento del cliente Dynamics 365.
  4. Fai clic su Chiudi.

Passaggio 3: creare un utente dell'applicazione in Dynamics CRM

  1. Da Microsoft Azure, passare a Impostazioni > Protezione > Utenti.
  2. Fare clic sull'elenco a discesa, selezionare Utenti applicazioni e fare clic su Nuovo.
  3. Utilizzare lo stesso nome utente creato in Active Directory.
  4. Assegna ID applicazione per l'applicazione creata in precedenza.
  5. Fai clic su Gestisci ruoli e scegli il ruolo Amministratore di sistema per l'utente.

Configurare Campaign configure-acc-for-microsoft

Creare la connessione new-ms-dyn-external-account

Innanzitutto, devi creare l’account esterno di Microsoft Dynamics 365.

  1. Sfoglia il nodo Administration > Platform > External accounts di Esplora campagne e crea un account esterno.

  2. Selezionare l'account esterno Microsoft Dynamics CRM nella sezione Tipo.

  3. Selezionare il metodo di autenticazione nell'elenco a discesa CRM O-Auth type.

    1. Per configurare l'account esterno di Microsoft Dynamics CRM per la connessione ad Adobe Campaign con credenziali password, specificare i dettagli seguenti:

      • Server: URL del server Microsoft CRM. Per trovare l'URL del server di Microsoft CRM, accedere all'account di Microsoft Dynamics CRM, quindi fare clic su Dynamics 365 e selezionare l'app. Puoi quindi trovare l’URL del server nella barra degli indirizzi del browser, ad esempio https://myserver.crm.dynamics.com/.
      • Account: account utilizzato per accedere a Microsoft CRM.
      • Password: account utilizzato per accedere a Microsoft CRM.
      • Identificatore client: ID applicazione (client) che è possibile trovare dal portale di gestione di Microsoft Azure nel campo Aggiorna categoria codice, ID client.
      • Versione CRM: scegliere la versione CRM 365 di Dynamics CRM.

    2. Per configurare l'account esterno di Microsoft Dynamics CRM per la connessione ad Adobe Campaign con un certificato, specificare i dettagli seguenti:

      • Server: URL del server Microsoft CRM. Per trovare l'URL del server di Microsoft CRM, accedere all'account di Microsoft Dynamics CRM, quindi fare clic su Dynamics 365 e selezionare l'app. Puoi quindi trovare l’URL del server nella barra degli indirizzi del browser, ad esempio https://myserver.crm.dynamics.com/.
      • Chiave privata: copia/incolla la chiave privata, codificata base64 come spiegato in questa sezione.
      • ID chiave: chiave disponibile nella scheda Manifesto dell'applicazione, come spiegato in questa sezione.
      • Identificatore chiave personalizzato: identificatore disponibile nella scheda Manifesto dell'applicazione, come spiegato in questa sezione.
      • Identificatore client: ID dell'applicazione (client) che è possibile trovare dal portale di gestione di Microsoft Azure come spiegato in questa sezione.
      • Versione CRM: scegliere la versione CRM 365 di Dynamics CRM.

  4. Seleziona l'opzione Abilita per attivare l'account in Campaign.

NOTE
Per approvare la configurazione, disconnettiti e accedi di nuovo alla console client di Adobe Campaign.

Seleziona tabelle da sincronizzare ms-dyn-create-tables

È ora possibile configurare le tabelle da sincronizzare.

  1. Fare clic su Microsoft CRM configuration wizard….
  2. Selezionare le tabelle da sincronizzare e avviare il processo.
  3. Controllare lo schema generato in Adobe Campaign nel nodo Administration > Configuration > Data schemas.
NOTE
Assicurarsi di aggiungere al elenco Consentiti di due URL: l'URL del server e login.microsoftonline.com. Per eseguire questa operazione, contatta il rappresentante del tuo Adobe.

Sincronizzare le enumerazioni sfdc-enum-sync

Una volta creato lo schema, puoi sincronizzare automaticamente le enumerazioni da Dynamics 365 ad Adobe Campaign.

  1. Apri l'assistente dal collegamento Synchronizing enumerations….
  2. Seleziona l’enumerazione Adobe Campaign che corrisponde all’enumerazione Dynamics 365.
    È possibile sostituire tutti i valori di un'enumerazione Adobe Campaign con quelli del CRM: a questo scopo, selezionare Yes nella colonna Replace.
  3. Fare clic su Next e quindi su Start per avviare l'importazione delle enumerazioni.
  4. Sfoglia il nodo Administration > Platform > Enumerations per controllare i valori importati.

Adobe Campaign e Microsoft Dynamics 365 sono ora connessi. È possibile impostare la sincronizzazione dei dati tra i due sistemi.

Per sincronizzare i dati tra i dati di Adobe Campaign e Microsoft CRM, creare un workflow e utilizzare l'attività CRM connector.

Ulteriori informazioni sulla sincronizzazione dei dati sono disponibili in questa pagina.

Tipi di dati dei campi supportati ms-dyn-supported-types

Di seguito sono elencati i tipi di attributo supportati/non supportati per Microsoft Dynamics 365:

Tipo di attributo
Supportato
Tipi di base : boolean, datetime, decimal, float, double, integer, bigint , string
Sì
Denaro (doppio)
Sì
memo, entityname , primarykey, uniqueidentifier (come stringhe)
Sì
Stato, elenco a discesa (i valori possibili vengono memorizzati nelle enumerazioni), stato (stringa)
Sì
proprietario (come stringa)
Sì
Ricerca (solo ricerche di riferimento a entità singola)
Sì
cliente
No
Riguardo
No
PartyList
No
ManagedProperty
No
recommendation-more-help
35662671-8e3d-4f04-a092-029a056c566b