DokumentationExperience PlatformAnvändarhandbok om destinationer

Microsoft Dynamics 365-anslutning

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

Skapat för:

  • Administratör
  • Användare

Översikt

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

Detta Adobe Experience Platform mål utnyttjar Contact Entity Reference API, som gör att du kan uppdatera identiteter inom en målgrupp till Dynamics 365.

Dynamics 365 använder OAuth 2 med auktoriseringsauktorisering som autentiseringsmekanism för att kommunicera med Contact Entity Reference API. Instruktioner för autentisering till din Dynamics 365-instans finns längre ned i avsnittet Autentisera till mål.

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 målgrupper utifrån dina offlinedata och skicka dessa målgrupper till Dynamics 365, för att visa dem i användarens flöden så snart som målgrupper och profiler uppdateras i Adobe Experience Platform.

Förhandskrav

Förutsättningar för Experience Platform

Innan du aktiverar data till målet Dynamics 365 måste du ha ett schema, en datamängd och målgrupper som skapats i Experience Platform.

Se Adobe-dokumentationen för schemafältgruppen Information om målgruppsmedlemskap om du behöver vägledning om målgruppsstatus.

Krav för Microsoft Dynamics 365

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

Du måste ha ett Microsoft Dynamics 365-konto

Gå till sidan Dynamics 365 utvärderingsversion om du vill registrera och skapa ett konto, om du inte redan har ett.

Skapa fält i Dynamics 365

Skapa det anpassade fältet av typen Simple med fältdatatypen Single Line of Text som Experience Platform ska använda för att uppdatera målgruppsstatusen i Dynamics 365.

Mer information finns i dokumentationen för Dynamics 365 Skapa eller redigera ett fält (attribut) om du behöver ytterligare hjälp.

Skriv ned Customization prefix för det anpassade fältet som du skapar i Dynamics 365. Du behöver det här prefixet under steget Fyll i målinformation. Mer information finns i avsnittet Skapa och redigera fält i Dynamics 365-dokumentationen.
Skärmbild för användargränssnittet i Dynamics 365 med anpassningsprefixet.

Ett exempel 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

Om du vill att Dynamics 365 ska kunna komma åt resurser måste du logga in med Azure Account till Azure Active Directory och skapa följande:

  • Ett Azure Active Directory-program
  • Tjänsthuvudman
  • En programhemlighet

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

Samla in inloggningsuppgifter för Dynamics 365

Observera objekten nedan innan du autentiserar till CRM-målet Dynamics 365:

Autentiseringsuppgifter
Beskrivning
Exempel
Client ID
Klient-ID Dynamics 365 för ditt Azure Active Directory-program. Mer information finns i Dynamics 365 dokumentationen.
ababbaba-abab-baba-acac-acacacacacac
Client Secret
Klienthemligheten Dynamics 365 för ditt Azure Active Directory-program. Du använder alternativ 2 i Dynamics 365 dokumentationen.
abcde~abcdefghijklmnopqrstuvwxyz12345678 om du vill ha vägledning.
Tenant ID
Klient-ID Dynamics 365 för ditt Azure Active Directory-program. Mer information finns i Dynamics 365 dokumentationen.
1234567-aaaa-12ab-ba21-1234567890
Region
Den Microsoft-region som är associerad med URL:en för miljön.
Mer information finns i Dynamics 365 dokumentationen.
Om din domän är som nedan måste du ange det markerade värdet för CRM-fältet i den nedrullningsbara väljaren när du autentiserar till målet.
org57771b33.crm.dynamics.com
Som exempel: Om ditt företag etableras i Nordamerika (NAM) blir din URL crm.dynamics.com och du måste välja crm. Om ditt företag etableras i Kanada (CAN)-regionen är din URL crm3.dynamics.com och du måste välja crm3.
Environment URL
Mer information finns i Dynamics 365 dokumentationen.
Om din Dynamics 365-domän är som nedan behöver du det markerade värdet.
org57771b33.crm.dynamics.com

Guardrails

Sidan Begäranden om gränser och allokeringar innehåller information om de Dynamics 365 API-gränser som är kopplade till din 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. Mer information finns i Dynamics 365 dokumentationen.

Målgrupper

I det här avsnittet beskrivs alla målgrupper som du kan exportera till det här målet.

Det här målet stöder aktivering av alla målgrupper som genereras via Experience Platform segmenteringstjänsten.

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 en målgrupp tillsammans med de önskade schemafälten (till exempel e-postadress, telefonnummer, efternamn), enligt fältmappningen.
  • Varje målgruppsstatus i Dynamics 365 uppdateras med motsvarande målgruppsstatus från Platform, baserat på värdet Mapping ID som tillhandahölls under steget målgruppsplanering.
Exportfrekvens
Streaming
  • Direktuppspelningsmål är alltid på API-baserade anslutningar. Så snart en profil uppdateras i Experience Platform baserat på målgruppsutvärdering skickar anslutningsprogrammet uppdateringen nedströms till målplattformen. Läs mer om direktuppspelningsmål.

Anslut till målet

IMPORTANT
Om du vill ansluta till målet behöver du behörigheterna View Destinations och Manage Destinations åtkomstkontroll. Läs åtkomstkontrollsöversikten eller kontakta produktadministratören för att få den behörighet som krävs.

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

I Destinations > Catalog söker du efter Dynamics 365. Du kan också hitta den under kategorin CRM.

Autentisera till mål

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

Fyll i de obligatoriska fälten nedan. Mer information finns i avsnittet Samla in Dynamics 365-autentiseringsuppgifter.

  • Client ID: Klient-ID:t Dynamics 365 för ditt Azure Active Directory-program.
  • Tenant ID: Klient-ID:t Dynamics 365 för ditt Azure Active Directory-program.
  • Client Secret: Dynamics 365 Klienthemlighet för ditt Azure Active Directory-program.
  • Region: Din Dynamics 365-region. Exempel: Om ditt företag etableras i Nordamerika (NAM) är din URL crm.dynamics.com och du måste välja crm. Om ditt företag etableras i Kanada (CAN)-regionen är din URL crm3.dynamics.com och du måste välja crm3.
  • Environment URL: Din Dynamics 365-miljöadress.

Om den angivna informationen är giltig visas statusen Connected med en 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 plattformsgränssnitt 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.
  • Customization Prefix: Customization prefix för det anpassade fältet som du skapade i Dynamics 365. Mer information finns i avsnittet Skapa och redigera fält i Dynamics 365-dokumentationen.

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 statusen för ditt dataflöde. Mer information om varningar finns i guiden prenumerera på destinationsvarningar med användargränssnittet.

Välj Next när du är klar med att ange information för målanslutningen.

Aktivera målgrupper till det här målet

IMPORTANT

  • För att aktivera data behöver du behörigheterna View Destinations, Activate Destinations, View Profiles och View Segments åtkomstkontroll. Läs åtkomstkontrollsöversikten eller kontakta produktadministratören för att få den behörighet som krävs.

  • Om du vill exportera identiteter måste du ha View Identity Graph åtkomstkontrollbehörighet.

    Markera identitetsnamnområdet som är markerat i arbetsflödet för att aktivera målgrupper till mål.

Läs Aktivera profiler och målgrupper för att direktuppspela målgruppsexportdestinationer för instruktioner om hur du aktiverar målgrupper till det här målet.

Mappa överväganden och exempel

Om du vill skicka målgruppsdata från Adobe Experience Platform till målet Dynamics 365 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. Följ de här stegen för att mappa dina XDM-fält korrekt till målfälten för Dynamics 365:

  1. Välj Add new mapping i steget Mapping. En ny mappningsrad visas på skärmen.
    Exempel på skärmbild för användargränssnittet för plattformen för Lägg till ny mappning.

  2. I fönstret Select source field väljer du kategorin Select identity namespace och sedan contactid.
    Exempel på skärmbild för användargränssnittet för plattformen för Source-mappning.

  3. I fönstret 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 kontaktperson.

    • Lägg till följande mappning mellan ditt XDM-profilschema och din Dynamics 365-instans:

      XDM-profilschema
      Dynamics 365-instans
      Obligatoriskt
      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 fältet Attribute name. I Dynamics 365 dokumentationen finns en omfattande lista över attribut som stöds.

      Skärmbild för plattformsgränssnitt med målmappning för e-post.

      IMPORTANT
      • Målfältsnamnen ska vara i lowercase.
      • Om du har ett källfält för datum eller tidsstämpling som är mappat till ett Dynamics 365 date- eller timestamp -målfält kontrollerar du att det mappade värdet inte är tomt. Om det exporterade fältvärdet är tomt visas ett Bad request reported while pushing events to the destination. Please contact the administrator and try again.-felmeddelande och data uppdateras inte. 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 Dynamics 365-instansen:

      XDM-profilschema
      Dynamics 365-instans
      person.name.firstName
      firstname
      person.name.lastName
      lastname
      personalEmail.address
      emailaddress1

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

    Exempel på skärmbild för plattformsgränssnitt som visar målmappningar.

Schemalägg målgruppsexport och exempel

I steget Schedule audience export i aktiveringsarbetsflödet måste du manuellt mappa plattformsmålgrupper till det anpassade fältattributet i Dynamics 365.

Det gör du genom att markera varje målgrupp och sedan ange motsvarande anpassade fältattribut från Dynamics 365 i fältet Mapping ID.

IMPORTANT
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 plattformsgränssnitt som visar export av schemalagda målgrupper.

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 mål.
    Skärmbild för plattformsgränssnitt med bläddringsmål.

  2. Markera målet och validera att statusen är enabled.
    Skärmbild för plattformsgränssnitt med körning av måldataflöde.

  3. Växla till fliken Activation data och välj sedan ett publiknamn.
    Exempel på skärmbild för användargränssnittet för plattformen som visar aktiveringsdata för destinationer.

  4. Övervaka målgruppssammanfattningen och se till att antalet profiler motsvarar antalet som skapas inom målgruppen.
    Exempel på skärmbild för plattformsgränssnitt som visar målgrupp.

  5. Logga in på webbplatsen Dynamics 365, gå till sidan Customers > Contacts och kontrollera om profilerna från målgruppen har lagts till. Du kan se att varje målgruppsstatus i Dynamics 365 har uppdaterats med motsvarande målgruppsstatus från Platform, baserat på det Mapping ID -värde som tillhandahölls under steget målgruppsplanering.
    Skärmbilden Dynamics 365 UI som visar sidan Kontakter med uppdaterade målgruppsstatusar.

Dataanvändning och styrning

Alla Adobe Experience Platform-mål är kompatibla med dataanvändningsprinciper när data hanteras. Mer information om hur Adobe Experience Platform använder datastyrning finns i Datastyrningsöversikten.

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 plattformsgränssnitt som visar ett fel med felaktig begäran.

Om du vill åtgärda det här felet kontrollerar du att Mapping ID som du angav i Dynamics 365 för din plattformspublik är giltig och finns i Dynamics 365.

Ytterligare resurser

Ytterligare användbar information från Dynamics 365 dokumentationen finns nedan:

  • IOrganizationService.Update(Entity) Method
  • Uppdatera och ta bort tabellrader med webb-API:t

Changelog

I det här avsnittet beskrivs funktionaliteten och viktiga dokumentationsuppdateringar för den här målanslutningen.

Visa ändringslogg
Releasamånad
Uppdateringstyp
Beskrivning
Oktober 2023
Dokumentation - uppdatering
Uppdaterad vägledning för att indikera alla målattributnamn ska vara i gemener i steget Mappning och example.
Augusti 2023
Funktioner och dokumentation
Stöd har lagts till för Dynamics 365 anpassade fältprefix för anpassade fält som inte skapades i standardlösningen i Dynamics 365. Ett nytt inmatningsfält, Customization Prefix, har lagts till i steget Fyll i målinformation. (PLATIR-31602).
Nov 2022
Inledande version
Ursprunglig målversion och dokumentationspublicering.
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6