Microsoft Dynamics 365 anslutning

Översikt

Microsoft Dynamics 365 är en molnbaserad plattform för affärsapplikationer som kombinerar ERP (Enterprise Resource Planning) och CRM (Customer Relationship Management) med produktivitetsprogram och AI-verktyg, vilket ger smidigare och mer kontrollerad drift, bättre tillväxtpotential och minskade kostnader.

Detta Adobe Experience Platform mål utnyttjar Contact Entity Reference APIsom gör att du kan uppdatera identiteter inom ett segment till Dynamics 365.

Dynamics 365 använder OAuth 2 med auktoriseringsbidrag som autentiseringsmekanism för att kommunicera med Contact Entity Reference API. Instruktioner för hur du autentiserar Dynamics 365 -instansen är längre ned, i Autentisera till mål -avsnitt.

Användningsfall

Som marknadsförare kan ni leverera personaliserade upplevelser till era användare, baserat på attribut från deras Adobe Experience Platform-profiler. Du kan skapa segment utifrån offlinedata och skicka dessa segment till Dynamics 365, som visas i användarnas flöden så snart segment och profiler uppdateras i Adobe Experience Platform.

Förutsättningar

Krav för Experience Platform

Innan du aktiverar data för Dynamics 365 mål, du måste ha en schema, a datauppsättningoch segment skapad i Experience Platform.

Mer information finns i Adobe dokumentation Schemafältgrupp för detaljer om segmentmedlemskap om du behöver vägledning om segmentstatus.

Microsoft Dynamics 365 krav

Observera följande krav i Dynamics 365för att exportera data från Platform till Dynamics 365 konto:

Du måste ha en Microsoft Dynamics 365 konto

Gå till Dynamics 365 testversion sida för att registrera och skapa ett konto, om du inte redan har ett.

Skapa fält i Dynamics 365

Skapa ett anpassat typfält Simple med fältdatatyp som Single Line of Text vilket Experience Platform som ska använda för att uppdatera segmentstatusen i Dynamics 365.
Se Dynamics 365 dokumentation till skapa ett fält (attribut) om du behöver ytterligare vägledning.

Exempelinställningar i Dynamics 365 visas nedan:
Skärmbild för användargränssnittet i Dynamics 365 med anpassade fält.

Registrera en program- och programanvändare i Azure Active Directory

Aktivera Dynamics 365 för att få tillgång till resurser som du måste logga in med Azure Account till Azure Active Directory och skapa följande:

  • An Azure Active Directory program
  • Tjänsthuvudman
  • En programhemlighet

Du måste också skapa en programanvändare in Azure Active Directory och associera det med det nya programmet.

Samla Dynamics 365 autentiseringsuppgifter

Anteckna vad som står nedan innan du autentiserar dig för Dynamics 365 CRM-mål:

Autentiseringsuppgifter Beskrivning Exempel
Client ID The Dynamics 365 Klient-ID för din Azure Active Directory program. Se Dynamics 365 dokumentation för vägledning. ababbaba-abab-baba-acac-acacacacacac
Client Secret The Dynamics 365 Klienthemlighet för Azure Active Directory program. Du använder alternativ 2 i Dynamics 365 dokumentation. abcde~abcdefghijklmnopqrstuvwxyz12345678 för vägledning.
Tenant ID The Dynamics 365 Klient-ID för din Azure Active Directory program. Se Dynamics 365 dokumentation för vägledning. 1234567-aaaa-12ab-ba21-1234567890
Environment URL Se Dynamics 365 dokumentation för vägledning. Om Dynamics 365 domänen är som nedan, du behöver det markerade värdet.
org57771b33.crm.dynamics.com

Guardrails

The Begäranden om gränser och tilldelningar sidinformation om Dynamics 365 API-begränsningar som är kopplade till Dynamics 365 licens. Du måste se till att dina data och din nyttolast är inom dessa begränsningar.

Identiteter som stöds

Dynamics 365 har stöd för uppdatering av identiteter som beskrivs i tabellen nedan. Läs mer om identiteter.

Målidentitet Exempel Beskrivning Överväganden
contactId 7eb682f1-ca75-e511-80d4-00155d2a68d1 Unik identifierare för en kontakt. Obligatoriskt. Se Dynamics 365 dokumentation för mer information.

Exportera typ och frekvens

Se tabellen nedan för information om exporttyp och frekvens för destinationen.

Objekt Typ Anteckningar
Exporttyp Profile-based
  • Du exporterar alla medlemmar i ett segment tillsammans med de önskade schemafälten (till exempel: e-postadress, telefonnummer, efternamn), enligt fältmappningen.
  • Varje segmentstatus i Dynamics 365 uppdateras med motsvarande segmentstatus från Platform, baserat på Mapping ID det värde som anges under segmentplanering steg.
Exportfrekvens Streaming
  • Direktuppspelningsmål är alltid på API-baserade anslutningar. Så snart en profil uppdateras i Experience Platform baserat på segmentutvärdering skickar kopplingen uppdateringen nedåt till målplattformen. Läs mer om mål för direktuppspelning.

Anslut till målet

VIKTIGT

Om du vill ansluta till målet behöver du Manage Destinations åtkomstkontrollbehörighet. Läs åtkomstkontroll - översikt eller kontakta produktadministratören för att få de behörigheter som krävs.

Om du vill ansluta till det här målet följer du stegen som beskrivs i självstudiekurs om destinationskonfiguration. I arbetsflödet för att konfigurera mål fyller du i fälten som listas i de två avsnitten nedan.

Inom Destinations > Catalog sök efter Dynamics 365. Du kan även hitta den under CRM kategori.

Autentisera till mål

Om du vill autentisera mot målet väljer du Connect to destination.
Skärmbild av användargränssnittet för plattformen som visar hur man autentiserar.

Fyll i de obligatoriska fälten nedan. Se Samla in Dynamics 365-autentiseringsuppgifter för vägledning.

  • Client ID: The Dynamics 365 Klient-ID för din Azure Active Directory program.
  • Tenant ID: The Dynamics 365 Klient-ID för din Azure Active Directory program.
  • Client Secret: The Dynamics 365 Klienthemlighet för Azure Active Directory program.
  • Environment URL: Dina Dynamics 365 Miljö-URL.

Om den angivna informationen är giltig visas en Connected status med grön bockmarkering. Du kan sedan gå vidare till nästa steg.

Fyll i målinformation

Om du vill konfigurera information för målet fyller du i de obligatoriska och valfria fälten nedan. En asterisk bredvid ett fält i användargränssnittet anger att fältet är obligatoriskt.
Skärmbild för användargränssnittet för plattformen som visar målinformationen.

  • Name: Ett namn som du känner igen det här målet med i framtiden.
  • Description: En beskrivning som hjälper dig att identifiera det här målet i framtiden.

Aktivera aviseringar

Du kan aktivera varningar för att få meddelanden om dataflödets status till ditt mål. Välj en avisering i listan om du vill prenumerera och få meddelanden om status för ditt dataflöde. Mer information om varningar finns i guiden prenumerera på destinationsvarningar med hjälp av användargränssnittet.

När du är klar med informationen för målanslutningen väljer du Next.

Aktivera segment till den här destinationen

VIKTIGT

Om du vill aktivera data måste du ha Manage Destinations, Activate Destinations, View Profiles och View Segments behörigheter för åtkomstkontroll. Läs åtkomstkontroll - översikt eller kontakta produktadministratören för att få de behörigheter som krävs.

Läs Aktivera profiler och segment för att direktuppspela segmentexportmål om du vill ha instruktioner om hur du aktiverar målgruppssegment till det här målet.

Mappa överväganden och exempel

Så här skickar du målgruppsdata från Adobe Experience Platform till Dynamics 365 mål måste du gå igenom fältmappningssteget. Mappningen består av att skapa en länk mellan XDM-schemafälten (Experience Data Model) i ditt plattformskonto och motsvarande motsvarigheter från målmålet. Koppla XDM-fälten till Dynamics 365 målfält, följ dessa steg:

  1. I Mapping steg, välja Add new mapping. En ny mappningsrad visas på skärmen.
    Exempel på skärmbild för användargränssnittet för plattformen för att lägga till ny mappning.

  2. I Select source field väljer du Select identity namespace kategori och välj contactId.
    Exempel på skärmbild för plattformsgränssnitt för källmappning.

  3. I Select target field väljer du den typ av målfält som du vill mappa källfältet till.

    • Select identity namespace: Välj det här alternativet om du vill mappa källfältet till ett identitetsnamnområde från listan.

      Skärmbild för plattformsgränssnitt som visar målmappning för contactId.

    • Lägg till följande mappning mellan XDM-profilschemat och Dynamics 365 instans: |XDM-profilschema|Dynamics 365 Instans| Obligatorisk| |—|—|—| |contactId|contactId| Ja |

    • Select custom attributes: välj det här alternativet om du vill mappa källfältet till ett anpassat attribut som du definierar i dialogrutan Attribute name fält. Se Dynamics 365 dokumentation om du vill ha en omfattande lista över attribut som stöds.

      Skärmbild för plattformsgränssnitt som visar målmappning för LastName.

      VIKTIGT

      Om du har ett källfält för datum eller tidsstämpling som är mappat till en Dynamics 365 datum eller tidsstämpel målfält, kontrollera att det mappade värdet inte är tomt. Om det skickade värdet är tomt kommer du att stöta på en Bad request reported while pushing events to the destination. Please contact the administrator and try again. felmeddelande och data kommer inte att uppdateras. Det här är en Dynamics 365 begränsning.

    • Beroende på vilka värden du vill uppdatera lägger du till följande mappning mellan XDM-profilschemat och ditt Dynamics 365 instans: |XDM-profilschema|Dynamics 365 Instans| |—|—| |person.name.firstName|FirstName| |person.name.lastName|LastName| |personalEmail.address|Email|

    • Ett exempel på hur du använder dessa mappningar visas nedan:

      Exempel på skärmbild för användargränssnittet för plattformen som visar målmappningar.

Schemalägg segmentexport och exempel

I Schedule segment export steg i aktiveringsarbetsflödet måste du manuellt mappa plattformssegment till det anpassade fältattributet i Dynamics 365.

Om du vill göra det markerar du varje segment och anger sedan motsvarande attribut för anpassade fält från Dynamics 365 i Mapping ID fält.

VIKTIGT

Värdet som används för Mapping ID ska exakt matcha namnet på det anpassade fältattributet som skapats i Dynamics 365. Se Dynamics 365 dokumentation om du behöver hjälp med att hitta anpassade fältattribut.

Ett exempel visas nedan:
Exempel på skärmbild för användargränssnittet för plattformen som visar export av Schedule-segment.

Validera dataexport

Följ stegen nedan för att verifiera att du har konfigurerat målet korrekt:

  1. Välj Destinations > Browse för att navigera till listan över destinationer.
    Skärmbild av användargränssnittet för plattformen med bläddringsmål.

  2. Markera målet och validera att statusen är enabled.
    Skärmbild av användargränssnittet för plattformen med körning av måldataflöde.

  3. Växla till Activation data väljer du ett segmentnamn.
    Skärmbild för användargränssnittet för plattformen visar aktiveringsdata för destinationer.

  4. Övervaka segmentsammanfattningen och se till att antalet profiler motsvarar antalet som skapas i segmentet.
    Exempel på skärmbild för plattformsgränssnitt som visar segment.

  5. Logga in på Dynamics 365 webbplatsen och sedan navigera till Customers > Contacts och kontrollera om profilerna från segmentet har lagts till. Du kan se att varje segmentstatus i Dynamics 365 uppdaterades med motsvarande segmentstatus från Platform, baserat på Mapping ID det värde som anges under segmentplanering steg.
    Skärmbild för användargränssnittet i Dynamics 365 visar sidan Kontakter med uppdaterad segmentstatus.

Dataanvändning och styrning

Alla Adobe Experience Platform destinationerna är kompatibla med dataanvändningsprinciper när data hanteras. Detaljerad information om hur Adobe Experience Platform använder datastyrning, se Datastyrning - översikt.

Fel och felsökning

Okända fel påträffades när händelser skickades till målet

Om du får följande felmeddelande när du kontrollerar ett dataflöde: Bad request reported while pushing events to the destination. Please contact the administrator and try again.

Skärmbild för användargränssnittet för plattformen visar ett fel för felaktig begäran.

Kontrollera att Mapping ID du angav i Dynamics 365 för ditt plattformssegment är giltigt och finns inom Dynamics 365.

Ytterligare resurser

Ytterligare användbar information från Dynamics 365 dokumentation är under:

På denna sida