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 :
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:
Client IDababbaba-abab-baba-acac-acacacacacacClient Secretabcde~abcdefghijklmnopqrstuvwxyz12345678 voor hulp.Tenant ID1234567-aaaa-12ab-ba21-1234567890Regionverwijs naar de Dynamics 365 documentatie voor begeleiding.
org57771b33.
crm .dynamics.comAls 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 URLorg57771b33.crm.dynamics.comGuardrails 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 .
contactidOndersteunde 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.
- 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.
- 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
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.comen moet ucrmselecteren. Als uw bedrijf is ingericht in het Canada-gebied (CAN), is de URLcrm3.dynamics.comen moet ucrm3selecteren. - 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 prefixvan 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
- Om gegevens te activeren, hebt u View Destinations, Activate Destinations, View Profiles, en View Segments toegangsbeheertoestemmingen nodig. Lees het overzicht van de toegangscontrole of contacteer uw productbeheerder om de vereiste toestemmingen te verkrijgen.
- Om identiteiten uit te voeren, hebt u de View Identity Graph toegangsbeheertoestemming nodig.
{width="100" modal="regular"}
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:
-
Selecteer Add new mapping in de stap Mapping . Er verschijnt een nieuwe toewijzingsrij op het scherm.
-
Kies in het venster Select source field de categorie Select identity namespace en selecteer
contactid.
-
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.
-
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 contactidcontactidJa -
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
lowercasestaan. - 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.
- Doelveldnamen moeten in
-
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.firstNamefirstnameperson.name.lastNamelastnamepersonalEmail.addressemailaddress1 -
Hieronder ziet u een voorbeeld waarin deze toewijzingen worden gebruikt:
-
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 .
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:
-
Selecteer Destinations > Browse om naar de lijst met doelen te navigeren.
{het schermschot van 0} Experience Platform UI die Browse Doelen toont.
-
Selecteer het doel en bevestig dat de status enabled is.
-
Ga naar het tabblad Activation data en selecteer vervolgens een publieksnaam.
-
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.
-
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.
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.
| 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. |