Microsoft Dynamics 365 verbinding

Overzicht overview

Microsoft Dynamics 365 ​ is een op wolk-gebaseerd bedrijfstoepassingsplatform dat de Planning van het Middel van de Onderneming (ERP) en het Beheer van de Verhouding van de Klant samen met productiviteitstoepassingen en AI hulpmiddelen combineert, om van begin tot eind vlottere en meer gecontroleerde verrichtingen, beter groeipotentieel en lagere kosten te brengen.

Dit Adobe Experience Platform ​ doel ​ hefboomwerkingen Contact Entity Reference API ​, die u toestaat om identiteiten binnen een publiek in Dynamics 365 bij te werken.

Dynamics 365 gebruikt OAuth 2 met de Vergunning verlenen als authentificatiemechanisme om met Contact Entity Reference API te communiceren. De instructies om aan uw Dynamics 365 instantie voor authentiek te verklaren zijn verder hieronder, in ​ voor authentiek verklaren aan bestemmings ​ sectie.

Gebruiksscenario’s use-cases

Als markeerteken kunt u uw gebruikers een persoonlijke ervaring bieden op basis van kenmerken uit hun Adobe Experience Platform-profielen. U kunt publiek maken van uw offline gegevens en deze soorten publiek naar Dynamics 365 sturen, zodat ze in de feeds van de gebruiker worden weergegeven zodra het publiek en de profielen in Adobe Experience Platform worden bijgewerkt.

Vereisten prerequisites

Experience Platform-voorwaarden prerequisites-in-experience-platform

Alvorens gegevens aan de Dynamics 365 bestemming te activeren, moet u a ​ schema ​, a ​ dataset ​ hebben, en ​ publiek ​ dat in Experience Platform wordt gecreeerd.

Verwijs naar de documentatie van Adobe voor ​ het schemagroep van de Details van het Lidmaatschap van het Publiek ​ als u begeleiding op publieksstatistieken nodig hebt.

Microsoft Dynamics 365 voorwaarden prerequisites-destination

Als u gegevens wilt exporteren van Experience Platform naar uw Dynamics 365 -account, moet u rekening houden met de volgende voorwaarden in Dynamics 365 :

U moet een Microsoft Dynamics 365 -account hebben prerequisites-account

Ga naar de Dynamics 365 ​ proefpagina ​ om een rekening te registreren en tot stand te brengen, als u niet reeds hebt.

Veld maken binnen Dynamics 365 prerequisites-custom-field

Maak het aangepaste veld van het type Simple met het veldgegevenstype Single Line of Text dat Experience Platform gebruikt om de status van het publiek in Dynamics 365 bij te werken.

Verwijs naar Dynamics 365 ​ creeer of geef een gebied (attribuut) uit ​ documentatie als u extra begeleiding nodig hebt.

Schrijf de Customization prefix op van het aangepaste veld dat u in Dynamics 365 maakt. U zult dit voorvoegsel tijdens ​ nodig hebben vult in bestemmingsdetails ​ stap. Verwijs naar ​ creeer en geef gebieden ​ sectie van de Dynamics 365 documentatie voor verdere details uit.
{de het schermschot van de Dynamiek 365 UI die van de aanpassingsprefix toont.

Hieronder ziet u een voorbeeldinstelling in Dynamics 365 :
Dynamiek 365 UI het schermschot die de douanegebieden tonen.

Registreer een toepassing en toepassingsgebruiker binnen Azure Actieve Folder prerequisites-app-user

Als u Dynamics 365 toegang wilt geven tot bronnen, moet u zich aanmelden met uw Azure Account to Azure Active Directory ​ en het volgende maken:

  • Een Azure Active Directory -toepassing
  • A Service principal
  • Een toepassingsgeheim

U zult ook ​ een toepassingsgebruiker ​ binnen Azure Active Directory moeten creëren en het met de pas gecreëerde toepassing associëren.

Dynamics 365 gebruikersgegevens verzamelen gather-credentials

Noteer de onderstaande items voordat u verifieert voor de bestemming Dynamics 365 CRM:

Credentials
Beschrijving
Voorbeeld
Client ID
De Dynamics 365 client-id voor uw Azure Active Directory -toepassing. Verwijs naar de Dynamics 365 documentatie ​ voor begeleiding.
ababbaba-abab-baba-acac-acacacacacac
Client Secret
Het Dynamics 365 clientgeheim voor uw Azure Active Directory -toepassing. U zou optie #2 binnen de Dynamics 365 documentatie ​ gebruiken.
abcde~abcdefghijklmnopqrstuvwxyz12345678 voor hulp.
Tenant ID
De Dynamics 365 Tenant ID voor uw Azure Active Directory -toepassing. Verwijs naar de Dynamics 365 documentatie ​ voor begeleiding.
1234567-aaaa-12ab-ba21-1234567890
Region
Het Microsoft-gebied dat is gekoppeld aan de URL van de omgeving.
verwijs naar de Dynamics 365 documentatie ​ voor begeleiding.
Als uw domein zoals hieronder is, moet u de benadrukte waarde voor het gebied van CRM in de dropdown selecteur verstrekken wanneer het voor authentiek verklaren aan de ​ bestemming ​.
org57771b33.crm .dynamics.com
Als voorbeeld: Als uw bedrijf provisioned in het gebied van Noord-Amerika (NAM) is, zou uw URL crm.dynamics.com zijn en u moet selecteren crm. Als uw bedrijf is ingericht in het Canada-gebied (CAN), is de URL crm3.dynamics.com en moet u crm3 selecteren.
Environment URL
Verwijs naar de Dynamics 365 documentatie ​ voor begeleiding.
Als uw Dynamics 365 domein hieronder is, hebt u de benadrukte waarde nodig.
org57771b33.crm.dynamics.com

Guardrails guardrails

De ​ grenzen en de toewijzingen van Verzoeken ​ pagina details de Dynamics 365 API grenzen verbonden aan uw Dynamics 365 vergunning. U moet ervoor zorgen dat uw gegevens en lading binnen deze beperkingen zijn.

Ondersteunde identiteiten supported-identities

Dynamics 365 ondersteunt het bijwerken van de identiteiten die in de onderstaande tabel worden beschreven. Leer meer over ​ identiteiten ​.

Doelidentiteit
Voorbeeld
Beschrijving
Overwegingen
contactid
7eb682f1-ca75-e511-80d4-00155d2a68d1
Unieke id voor een contactpersoon.
Verplicht. Verwijs naar de Dynamics 365 documentatie ​ voor verdere details.

Ondersteunde doelgroepen supported-audiences

In deze sectie worden alle soorten publiek beschreven die u naar deze bestemming kunt exporteren.

Deze bestemming steunt de activering van alle die publiek door de Dienst van de Segmentatie van Experience Platform ​ wordt geproduceerd ​.

Type en frequentie exporteren export-type-frequency

Raadpleeg de onderstaande tabel voor informatie over het exporttype en de exportfrequentie van de bestemming.

Item
Type
Notities
Exporttype
Profile-based
  • U exporteert alle leden van een publiek samen met de gewenste schemavelden (bijvoorbeeld: e-mailadres, telefoonnummer, achternaam) volgens uw veldtoewijzing.
  • Elke publieksstatus in Dynamics 365 wordt bijgewerkt met de overeenkomstige publieksstatus van Experience Platform, die op de Mapping ID waarde wordt gebaseerd tijdens de ​ publiek die ​ stap plannen.
Exportfrequentie
Streaming
  • Streaming doelen zijn "altijd aan" API-verbindingen. Zodra een profiel in Experience Platform wordt bijgewerkt dat op publieksevaluatie wordt gebaseerd, verzendt de schakelaar de update stroomafwaarts naar het bestemmingsplatform. Lees meer over ​ het stromen bestemmingen ​.

Verbinden met de bestemming connect

IMPORTANT
Om met de bestemming te verbinden, hebt u View Destinations en Manage Destinations ​ toegangsbeheertoestemmingen ​ nodig. Lees het ​ overzicht van de toegangscontrole ​ of contacteer uw productbeheerder om de vereiste toestemmingen te verkrijgen.

Om met deze bestemming te verbinden, volg de stappen die in het ​ leerprogramma van de bestemmingsconfiguratie ​ worden beschreven. In vormen bestemmingswerkschema, vul de gebieden in die in de twee hieronder secties worden vermeld.

Kies in Destinations > Catalog Zoeken naar Dynamics 365 . U kunt de locatie ook in de categorie CRM vinden.

Verifiëren voor bestemming authenticate

Selecteer Connect to destination als u wilt verifiëren bij het doel.
{het schermschot van 0} Experience Platform UI die toont hoe te voor authentiek te verklaren.

Vul de vereiste velden hieronder in. Verwijs naar de ​ Dynamica 365 van de Verzameling geloofsbrieven ​ sectie voor om het even welke begeleiding.

  • Client ID: De Dynamics 365 client-id voor uw Azure Active Directory -toepassing.
  • Tenant ID: De Dynamics 365 Tenant-id voor uw Azure Active Directory -toepassing.
  • Client Secret: Het Dynamics 365 clientgeheim voor uw Azure Active Directory -toepassing.
  • Region: Uw Dynamics 365 ​ gebied. Als voorbeeld: Als uw bedrijf is ingericht in het gebied Noord-Amerika (NAM), is de URL crm.dynamics.com en moet u crm selecteren. Als uw bedrijf is ingericht in het Canada-gebied (CAN), is de URL crm3.dynamics.com en moet u crm3 selecteren.
  • Environment URL: de URL van uw Dynamics 365 omgeving.

Als de opgegeven gegevens geldig zijn, geeft de gebruikersinterface de status Connected weer met een groen vinkje. Vervolgens kunt u verdergaan met de volgende stap.

Doelgegevens invullen destination-details

Als u details voor de bestemming wilt configureren, vult u de vereiste en optionele velden hieronder in. Een sterretje naast een veld in de gebruikersinterface geeft aan dat het veld verplicht is.
{het schermschot van 0} Experience Platform UI die de bestemmingsdetails toont.

  • Name: Een naam waarmee u dit doel in de toekomst herkent.
  • Description: Een beschrijving die u zal helpen deze bestemming in de toekomst identificeren.
  • Customization Prefix: De Customization prefix van het aangepaste veld dat u hebt gemaakt in Dynamics 365 . Verwijs naar ​ creeer en geef gebieden ​ sectie van de Dynamics 365 documentatie voor verdere details uit.

Waarschuwingen inschakelen enable-alerts

U kunt alarm toelaten om berichten over de status van dataflow aan uw bestemming te ontvangen. Selecteer een waarschuwing in de lijst om u te abonneren op meldingen over de status van uw gegevensstroom. Voor meer informatie over alarm, zie de gids bij ​ het intekenen aan bestemmingsalarm gebruikend UI ​.

Wanneer u klaar bent met het opgeven van details voor uw doelverbinding, selecteert u Next .

Soorten publiek naar dit doel activeren activate

IMPORTANT

Lees ​ activeer profielen en publiek aan het stromen publiek uitvoerbestemmingen ​ voor instructies bij het activeren van publiek aan deze bestemming.

Afbeeldingsoverwegingen en voorbeeld mapping-considerations-example

Als u uw publieksgegevens correct vanuit Adobe Experience Platform naar de Dynamics 365 -bestemming wilt verzenden, moet u de stap voor veldtoewijzing doorlopen. Toewijzing bestaat uit het maken van een koppeling tussen de schemavelden van uw Experience Data Model (XDM) in uw Experience Platform-account en de overeenkomstige equivalenten van de doelbestemming. Voer de volgende stappen uit om uw XDM-velden correct toe te wijzen aan de Dynamics 365 -doelvelden:

  1. Selecteer Add new mapping in de stap Mapping . Er verschijnt een nieuwe toewijzingsrij op het scherm.
    het schermschot van Experience Platform UI voor Add nieuwe afbeelding.

  2. Kies in het venster Select source field de categorie Select identity namespace en selecteer contactid .
    het schermschot van Experience Platform UI voor de afbeelding van Source.

  3. Selecteer in het Select target field -venster het type doelveld waaraan u het bronveld wilt toewijzen.

    • Select identity namespace: selecteer deze optie om het bronveld toe te wijzen aan een naamruimte in de lijst.

      het schermschot van Experience Platform UI die de afbeelding van het Doel voor contact tonen.

    • Voeg de volgende toewijzing toe tussen uw XDM-profielschema en uw Dynamics 365 -instantie:

      table 0-row-3 1-row-3
      XDM-profielschema Dynamics 365 Instantie Verplicht
      contactid contactid Ja
    • Select custom attributes: selecteer deze optie om het bronveld toe te wijzen aan een aangepast kenmerk dat u in het veld Attribute name definieert. Verwijs naar Dynamics 365 documentatie ​ voor een uitvoerige lijst van gesteunde attributen.

      {het schermschot van 0} Experience Platform UI die de afbeelding van het Doel voor e-mail toont.

      note important
      IMPORTANT
      • Doelveldnamen moeten in lowercase staan.
      • Bovendien, als u een datum of timestamp brongebied hebt dat aan a Dynamics 365 ​ datum of timestamp ​ doelgebied in kaart wordt gebracht, zorg ervoor dat de in kaart gebrachte waarde niet leeg is. Als de geëxporteerde veldwaarde leeg is, wordt een Bad request reported while pushing events to the destination. Please contact the administrator and try again. -foutbericht weergegeven en worden de gegevens niet bijgewerkt. Dit is een Dynamics 365 -beperking.
    • Afhankelijk van de waarden die u wilt bijwerken, voegt u bijvoorbeeld de volgende toewijzing toe tussen uw XDM-profielschema en uw Dynamics 365 -instantie:

      table 0-row-2 1-row-2 2-row-2 3-row-2
      XDM-profielschema Dynamics 365 Instantie
      person.name.firstName firstname
      person.name.lastName lastname
      personalEmail.address emailaddress1
    • Hieronder ziet u een voorbeeld waarin deze toewijzingen worden gebruikt:

    Experience Platform UI het screenshot voorbeeld dat de afbeeldingen van het Doel toont.

Het publiek van het programma uitvoeren en voorbeeld schedule-audience-export-example

In de stap Schedule audience export van de activeringsworkflow moet u Experience Platform-soorten publiek handmatig toewijzen aan het aangepaste veldkenmerk in Dynamics 365 .

U doet dit door elk publiek te selecteren en vervolgens het bijbehorende aangepaste veldkenmerk in te voeren vanuit Dynamics 365 in het veld Mapping ID .

IMPORTANT
De waarde die voor de Mapping ID wordt gebruikt, moet exact overeenkomen met de naam van het aangepaste veldkenmerk dat in Dynamics 365 is gemaakt. Zie Dynamics 365 documentatie ​ als u begeleiding bij het vinden van uw attributen van het douanegebied nodig hebt.

Hieronder ziet u een voorbeeld:
{het screenshot voorbeeld van 0} Experience Platform UI die het publiek van het Programma tonen uitvoer.

Gegevens exporteren valideren exported-data

Volg onderstaande stappen om te controleren of u de bestemming correct hebt ingesteld:

  1. Selecteer Destinations > Browse om naar de lijst met doelen te navigeren.
    {het schermschot van 0} Experience Platform UI die Browse Doelen toont.

  2. Selecteer het doel en bevestig dat de status enabled is.
    het schermschot van Experience Platform UI die de Looppas van Doelen Dataflow toont.

  3. Ga naar het tabblad Activation data en selecteer vervolgens een publieksnaam.
    het schermschot van Experience Platform UI die de Gegevens van de Activering van Doelen toont.

  4. Controleer het overzicht van het publiek en zorg ervoor dat het aantal profielen overeenkomt met het aantal profielen dat in het publiek is gemaakt.
    {het schermschot van 0} Experience Platform UI die publiek toont.

  5. Meld u aan bij de Dynamics 365 -website, navigeer naar de pagina Customers > Contacts en controleer of de profielen van het publiek zijn toegevoegd. U kunt zien dat elke publieksstatus in Dynamics 365 met de overeenkomstige publieksstatus van Experience Platform werd bijgewerkt, die op de Mapping ID waarde wordt gebaseerd die tijdens de ​ publiek wordt verstrekt die ​ stap plant.
    {de het schermschot van de Dynamiek 365 UI die de pagina van Contacten met bijgewerkte publieksstatussen toont.

Gegevensgebruik en -beheer data-usage-governance

Alle Adobe Experience Platform -doelen zijn compatibel met het beleid voor gegevensgebruik bij het verwerken van uw gegevens. Voor gedetailleerde informatie over hoe Adobe Experience Platform gegevensbeheer afdwingt, zie het ​ overzicht van het Beleid van Gegevens ​.

Fouten en problemen oplossen errors-and-troubleshooting

Onbekende fouten aangetroffen tijdens het naar bestemming duwen van gebeurtenissen unknown-errors

Wanneer u een gegevensstroomuitvoering controleert, als u het volgende foutbericht krijgt: Bad request reported while pushing events to the destination. Please contact the administrator and try again.

het schermschot van Experience Platform UI die Onjuiste verzoekfout toont.

Om deze fout te corrigeren, controleert u of de Mapping ID die u in Dynamics 365 voor uw Experience Platform-publiek hebt opgegeven, geldig is en bestaat binnen Dynamics 365 .

Aanvullende bronnen additional-resources

De extra nuttige informatie van de Dynamics 365 documentatie ​ is hieronder:

Changelog

Deze sectie vangt de functionaliteit en de significante documentatieupdates aan deze bestemmingsschakelaar worden aangebracht die.

Wijzigingen weergeven
table 0-row-3 1-row-3 2-row-3 3-row-3 layout-auto
Releasedatum Type bijwerken Beschrijving
Oktober 2023 Documentatie bijgewerkt De bijgewerkte begeleiding om op alle namen van doelattributen te wijzen zou in kleine letters, in de ​ Afbeelding overwegingen en voorbeeld ​ stap moeten zijn.
Augustus 2023 Bijwerken van functionaliteit en documentatie Extra ondersteuning voor Dynamics 365 aangepaste veldvoorvoegsels voor aangepaste velden die niet zijn gemaakt in de standaardoplossing van Dynamics 365 . Een nieuw inputgebied, Customization Prefix, is toegevoegd in ​ Vul de stap van bestemmingsdetails ​. (PLATIR-31602).
nov. 2022 Eerste release Oorspronkelijke doelversie en documentatie publiceren.
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6