DokumentationCampaignDokumentation om Campaign v8

Arbeta med Campaign och Microsoft Dynamics 365 crm-ms-dynamics

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

Skapat för:

  • Nybörjare
  • Mellanliggande
  • Administratör
  • Användare

Aktivera dina CRM-data för kommunikation över flera kanaler: lär dig hur du skickar kontakter från Microsoft Dynamics 365 till Adobe Campaign och delar kampanjresultatdata (skickar, öppnar, klickar och studsar) tillbaka från Adobe Campaign till Microsoft Dynamics 365.

När konfigurationen är klar utförs datasynkronisering mellan system via en dedikerad arbetsflödesaktivitet. Läs mer.

NOTE
Microsoft Dynamics-versioner som stöds finns detaljerade i Campaign Kompatibilitetsmatrisen.

Följ stegen nedan för att konfigurera ett dedikerat externt konto för att importera och exportera Microsoft Dynamics 365-data till Adobe Campaign.

För varje system måste dessa steg utföras av en administratör.

CAUTION
Steg i den här dokumentationen hjälper dig att skapa integreringar/registreringar som inbegriper tilldelning av behörigheter och/eller administratörsåtkomst. Det är ditt ansvar att se till att dessa steg följer företagets regler innan de utförs och att de utförs med omsorg.

Konfigurera Microsoft Dynamics 365 config-crm-microsoft

Om du vill ansluta Microsoft Dynamics 365 till Adobe Campaign via webb-API loggar du in på Microsoft Azure Directory med hjälp av en global administratörs-autentiseringsuppgift och följer stegen nedan:

  1. Hämta ditt program-ID för Dynamics 365 (klient). Läs mer
  2. Generera nyckelidentifierare och nyckel-ID för Microsoft Dynamics-certifikat. Läs mer
  3. Konfigurera behörigheter. Läs mer
  4. Skapa en appanvändare. Läs mer
  5. Koda den privata nyckeln. Läs mer

Hämta klient-ID för Dynamics 365 get-client-id-microsoft

Om du vill hämta program-ID:t (klient) måste du registrera ett program i Azure Active Directory.

  1. Bläddra till Azure Active Directory > App Registrations och välj Ny registrering.
  2. Ange ett unikt namn som kan hjälpa till att identifiera en instans, till exempel adobecampaign<instance identifier>.

När du har sparat tilldelar Microsoft Azure Directory ditt program ett unikt program-ID (klient). Du behöver detta ID senare när du konfigurerar Dynamics 365 i Adobe Campaign.

Läs mer i Microsoft Dynamics 365-dokumentationen.

Generera nyckelidentifierare och nyckel-ID för Microsoft Dynamics-certifikat config-certificate-key-id

Du måste överföra ett certifikat för att hämta certifikatnyckelidentifieraren (customKeyIdentifier) och nyckel-ID (keyId). Certifikat kan användas som hemligheter för att bevisa programmets identitet när en token begärs. Det kan också kallas publika nycklar.

Följ stegen nedan:

  1. Bläddra till Azure Active Directory > App Registrations och välj det program som skapades tidigare.
  2. Välj på Certifikat och hemlighet.
  3. Klicka på Överför certifikat på fliken Certifikat
  4. Överför ditt offentliga certifikat.
  5. Bläddra till länken Manifest för att hämta identifieraren för certifikatnyckeln (customKeyIdentifier) och nyckel-ID:t (keyId).

Certifikatnyckelidentifieraren (customKeyIdentifier) och Key-ID (keyId) behövs i Campaign för att konfigurera ditt externa Microsoft Dynamics 365 CRM-konto med certifikatet CRM O-Auth type.

Så här skapar du det offentliga certifikatet

Om du vill generera certifikatet kan du använda openssl.

Exempel:

code language-none 
- openssl req -x509 -sha256 -nodes -days 365 -newkey rsa:2048 -keyout '<'private key name'>' -out '<'public certificate name'>
note note
NOTE
Du kan ändra antalet dagar, här -days 365, i kodexemplet för en längre certifikatgiltighetsperiod.

Du måste sedan koda certifikatet i base64. Det gör du genom att använda en Base64-kodare eller kommandoraden base64 -w0 private.key för Linux.

Konfigurera behörigheter config-permissions-microsoft

Steg 1: Konfigurera nödvändiga behörigheter för det program som skapades.

  1. Navigera till Azure Active Directory > App Registrations och välj det program som skapades tidigare.
  2. Klicka på Inställningar överst till vänster.
  3. På Nödvändiga behörigheter klickar du på Lägg till och Välj ett API > Dynamics CRM Online.
  4. Klicka på kryssrutan Välj, aktivera kryssrutan Använd Dynamics 365 som organisationsanvändare och klicka på Välj.
  5. Välj sedan Manifest på menyn Hantera i din app.
  6. Ange egenskapen allowPublicClient från null till true i redigeraren Manifest och klicka på Spara.

Steg 2: Medgivande från bidragsadministratör

  1. Navigera till Azure Active Directory > Enterprise-program.
  2. Välj det program som du vill ge innehavaromfattande administratörsgodkännande för.
  3. Välj Behörigheter under Dokumentskydd på den vänstra panelmenyn.
  4. Klicka på Bevilja administratörens samtycke.

Mer information finns i Azure-dokumentationen.

Skapa en appanvändare create-app-user-microsoft

NOTE
Det här steget är valfritt med Password credentials-autentisering.

Appanvändaren är den användare som programmet som registrerats ovan kommer att använda. Alla ändringar som görs i Microsoft Dynamics med den app som registrerats ovan görs via den här användaren.

Steg 1: Skapa en icke-interaktiv användare i Azure Active Directory

  1. Klicka på Azure Active Directory > Användare och sedan på Ny användare.
  2. Ange ett egennamn som du vill använda och användarnamnet ska vara ett e-postformat.
  3. Välj Dynamics 365 Administrator i katalogrollen.

Steg 2: Tilldela rätt licens till den skapade användaren

  1. Klicka på Admin-appen från Microsoft Azure.
  2. Gå till Användare > Aktiva användare och klicka på den nyskapade användaren.
  3. Klicka på Redigera produktlicenser och välj Dynamics 365 Customer Engagement Plan.
  4. Klicka på Stäng.

Steg 3: Skapa en programanvändare i Dynamics CRM

  1. Navigera från Microsoft Azure till Inställningar > Säkerhet > Användare.
  2. Klicka på listrutan, välj Programanvändare och klicka på Nytt.
  3. Använd samma användarnamn som användaren som skapades i den aktiva katalogen ovan.
  4. Tilldela program-ID för det program du skapade tidigare.
  5. Klicka på Hantera roller och välj rollen Systemadministratör för användaren.

Konfigurera kampanj configure-acc-for-microsoft

Skapa anslutningen new-ms-dyn-external-account

Först måste du skapa det externa kontot för Microsoft Dynamics 365.

  1. Bläddra i noden Administration > Platform > External accounts i Campaign Explorer och skapa ett externt konto.

  2. Välj Microsoft Dynamics CRM externt konto i avsnittet Typ.

  3. Välj autentiseringsmetoden i listrutan CRM O-Auth type.

    1. Om du vill konfigurera det externa Microsoft Dynamics CRM-kontot så att det ansluter till Adobe Campaign med lösenordsreferenser anger du följande information:

      • Server: URL-adressen till din Microsoft CRM-server. Om du vill hitta URL-adressen till din Microsoft CRM-server öppnar du ditt Microsoft Dynamics CRM-konto och klickar sedan på Dynamics 365 och väljer din app. Du kan sedan hitta din server-URL i webbläsarens adressfält, t.ex. https://myserver.crm.dynamics.com/.
      • Konto: Det konto som används för att logga in på Microsoft CRM.
      • Lösenord: Det konto som används för att logga in på Microsoft CRM.
      • Klient-ID: Program-ID (klient) som kan hittas från Microsoft Azure-hanteringsportalen i fältet Uppdatera din kodkategori, Klient-ID.
      • CRM-version: Välj Dynamics CRM 365 CRM-version.

    2. Om du vill konfigurera det externa Microsoft Dynamics CRM-kontot så att det ansluter till Adobe Campaign med ett certifikat anger du följande information:

      • Server: URL-adressen till din Microsoft CRM-server. Om du vill hitta URL-adressen till din Microsoft CRM-server öppnar du ditt Microsoft Dynamics CRM-konto och klickar sedan på Dynamics 365 och väljer din app. Du kan sedan hitta din server-URL i webbläsarens adressfält, t.ex. https://myserver.crm.dynamics.com/.
      • Privat nyckel: Kopiera/klistra in den privata nyckeln, kodad base64 enligt beskrivningen i det här avsnittet.
      • Nyckel-ID: Nyckeln finns på fliken Manifest i ditt program, vilket förklaras i det här avsnittet.
      • Anpassad nyckelidentifierare: Identifieraren är tillgänglig på fliken Manifest i ditt program, vilket förklaras i det här avsnittet.
      • Klient-ID: Program-ID (klient) som kan hittas från Microsoft Azure-hanteringsportalen enligt beskrivningen i det här avsnittet.
      • CRM-version: Välj Dynamics CRM 365 CRM-version.

  4. Välj alternativet Aktivera om du vill aktivera kontot i Campaign.

NOTE
Logga ut och in igen på Adobe Campaign klientkonsol för att godkänna konfigurationen.

Markera tabeller som ska synkroniseras ms-dyn-create-tables

Nu kan du konfigurera tabeller att synkronisera.

  1. Klicka på Microsoft CRM configuration wizard….
  2. Markera de tabeller som ska synkroniseras och starta processen.
  3. Kontrollera schemat som genererats i Adobe Campaign i noden Administration > Configuration > Data schemas.
NOTE
Lägg till två URL:er i tillåtelselista: server-URL:en och login.microsoftonline.com. Kontakta din Adobe-representant för att göra detta.

Synkronisera uppräkningar sfdc-enum-sync

När schemat har skapats kan du synkronisera uppräkningar automatiskt från Dynamics 365 till Adobe Campaign.

  1. Öppna assistenten från länken Synchronizing enumerations….
  2. Välj den Adobe Campaign-uppräkning som matchar uppräkningen i Dynamics 365.
    Du kan ersätta alla värden i en Adobe Campaign-uppräkning med dem i CRM: om du vill göra det väljer du Yes i kolumnen Replace.
  3. Klicka på Next och sedan på Start för att börja importera uppräkningarna.
  4. Bläddra i noden Administration > Platform > Enumerations för att kontrollera importerade värden.

Adobe Campaign och Microsoft Dynamics 365 är nu anslutna. Du kan konfigurera datasynkronisering mellan de två systemen.

Om du vill synkronisera data mellan Adobe Campaign-data och Microsoft CRM skapar du ett arbetsflöde och använder aktiviteten CRM connector.

Läs mer om datasynkronisering på den här sidan.

Datatyper för fält som stöds ms-dyn-supported-types

För Microsoft Dynamics 365 finns följande attributtyper som stöds/inte stöds:

Attributtyp
Stöds
Grundläggande typer: boolesk, datetime, decimal, float, double, integer, bigint , string
Ja
Pengar (som dubbla)
Ja
memo, entityname , primarykey, uniqueidentifier (som strängar)
Ja
Status, picklist (vi lagrar möjliga värden i uppräkningar), state (sträng)
Ja
ägare (som sträng)
Ja
Uppslag (endast referenssökningar för en entitet)
Ja
kund
Nej
Angående
Nej
PartyList
Nej
ManagedProperty
Nej
recommendation-more-help
35662671-8e3d-4f04-a092-029a056c566b