Die Einwilligung anpassen und erweitern

Anforderungen

  • Grundkenntnisse über das Erstellen und Debuggen von Dataverse-Plug-Ins
  • Grundkenntnisse über das Erstellen benutzerdefinierter API-Endpunkte
  • Eine Einwilligungslösung (DynamicsMKT_Consent) mit dem Update vom April 2024 (Lösungsversion 1.1.40197.xxx oder höher)

Die Einwilligungsanbieterentität ist der wichtigste Konfigurationseintrag, der die Funktionen Ihrer Einwilligungslösung beschreibt.

Name der Eigenschaft Beschreibung Obligatorisch Beispiel
msdynmkt_consentproviderid Eindeutiger Bezeichner für Ihren Einwilligungsanbieter Ja 003f5e82-49ce-4253-947d-8daa11f1ff75
msdynmkt_consentcheckurltemplate Eindeutiger Name der benutzerdefinierten API, die Ihre Einwilligungsüberprüfung verfügbar macht Ja new_contosoconsentcheck
msdynmkt_consentproviderexternalformidentifier Verweis auf das (Hauptformular über der -Entität), das bei Bedarf die Benutzeroberfläche der Compliance-Profilentität erweitert Nein 0c0126d4-d0d5-43e1-8d3b-dfa96e87285f
msdynmkt_consentproviderexternalentity Verweis auf die Entität, welche die Compliance-Profilkonfiguration erweitert Nein new_contosocompliancesetting
msdynmkt_consentproviderexternalpurposeformidentifier Verweis auf das Systemformular (Hauptformular über der -Entität), das bei Bedarf die Benutzeroberfläche der Zweckentität erweitert Nein 4dfb6f18-7a89-48da-86cb-edbb9a56e3d5
msdynmkt_consentproviderexternalpurposeentity Verweis auf die Entität, welche die Compliance-Zweckentität erweitert Nein new_contosopurpose
msdynmkt_consentresolutionmessageoptions Auswahlliste, die bestimmt, wie die Einwilligung für die Nachricht gelöst wird (siehe externe Optionen zur Lösung der Einwilligung) Ja 238550001
msdynmkt_consentresolutiontrackingoptions Auswahlliste, die bestimmt, wie die Einwilligung für die Nachverfolgung gelöst wird (siehe externe Optionen zur Lösung der Einwilligung) Ja 238550001
msdynmkt_email_consentresolutionmessageoverride Auswahlliste, die bestimmt, wie die Einwilligung für die E-Mail-Nachricht gelöst wird (siehe externe Optionen zur Kanalüberschreibung der Lösung der Einwilligung) Nein 238550000
msdynmkt_email_consentresolutiontrackingoverride Auswahlliste, die bestimmt, wie die Einwilligung für die Nachverfolgung E-Mail-Nachricht gelöst wird (siehe externe Optionen zur Kanalüberschreibung der Lösung der Einwilligung) Nein 238550000
msdynmkt_oneclickunsubscribesupported Boolescher Wert, der bestimmt, ob die Einwilligungs-API die Abmeldung mit einem Klick unterstützt Ja 1

Beispiel-Konfigurationsentität

<?xml version="1.0" encoding="utf-8"?>
<msdynmkt_consentprovider msdynmkt_name="new_contosoconsentcheck">
  <msdynmkt_consentproviderid>003f5e82-49ce-4253-947d-8daa11f1ff75</msdynmkt_consentproviderid>
  <msdynmkt_consentcheckurltemplate>new_contosocompliancesetting</msdynmkt_consentcheckurltemplate>
  <msdynmkt_consentproviderexternalformidentifier>0c0126d4-d0d5-43e1-8d3b-dfa96e87285f</msdynmkt_consentproviderexternalformidentifier>
  <msdynmkt_consentproviderexternalentity>new_contosocompliancesetting</msdynmkt_consentproviderexternalentity>
  <msdynmkt_consentproviderexternalpurposeformidentifier>4dfb6f18-7a89-48da-86cb-edbb9a56e3d5</msdynmkt_consentproviderexternalpurposeformidentifier>
  <msdynmkt_consentproviderexternalpurposeentity>new_contosopurpose</msdynmkt_consentproviderexternalpurposeentity>
  <msdynmkt_consentresolutionmessageoptions>238550001</msdynmkt_consentresolutionmessageoptions>
  <msdynmkt_consentresolutiontrackingoptions>238550001</msdynmkt_consentresolutiontrackingoptions>
  <msdynmkt_email_consentresolutionmessageoverride>238550000</msdynmkt_email_consentresolutionmessageoverride>
  <msdynmkt_email_consentresolutiontrackingoverride>238550000</msdynmkt_email_consentresolutiontrackingoverride>
  <msdynmkt_oneclickunsubscribesupported>1</msdynmkt_oneclickunsubscribesupported>
</msdynmkt_consentprovider>

Anfrage

Name der Eigenschaft Typ Beschreibung Beispiel
Kontaktpunkte string[] Kontaktpunkte zur Ermittlung der Einwilligung ["john.doe@contoso.com"]
Zweck EntityReference Verweis auf die -Entität 6952ed55-42bb-4549-9f8b-ddf7af3ccc82
Thema EntityReference Verweis auf die -Entität 1d7fc107-c915-45e9-99ef-50ad5d5c728f
Kanaltyp string Entweder , , oder email
Compliance-Profil EntityReference Verweis auf die -Entität 0d923da1-355e-471d-84fa-e30fa198633b
owningbusinessunit EntityReference Verweis auf die -Entität 9a6c0f7f-9a26-4717-bb13-025fb514bc5d
Abmeldeurl erforderlich bool Ob Sie in der Antwort eine Abmelde-URL angeben sollen Wahr
One-Click-Unsubscribe-URL-erforderlich bool Ob Sie in der Antwort eine URL für die Abmeldung mit einem Klick angeben sollen Wahr
Korrelationskopfzeilen Entity Enthält Korrelationsheader im Zusammenhang mit der Journeyausführung, nützlich für die Telemetrie NICHT ZUTREFFEND

Antworten

Name der Eigenschaft Typ Beschreibung
Zustimmungen EntityCollection Liste der Einwilligungen für die jeweilige Anforderung

Jede Entität in der -Sammlung sollte die folgenden Eigenschaften haben:

Name der Eigenschaft Typ Beschreibung Beispiel
consentformessage bool Ob die Einwilligung zum Senden von Nachrichten erteilt wurde oder nicht Wahr
Kontaktpunkt string Kopie jedes Eintrags in "john.doe@contoso.com"
Abmelden-URL string URL, die auf die Seite verweist, auf der die Kundschaft ihre Einwilligungen verwalten können https://contoso.com/manage-email-sending-preferences?for=1253515123
Ein-Klick-Abmeldungs-URL string URL, die auf die Seite verweist, auf der die Kundschaft ihre Einwilligungen verwalten können; die URL setzt RFC 8085 um https://contoso.com/manage-email-list?for=1253515123
  1. Erstellen Sie eine neue, leere Lösung.
  2. Fügen Sie eine benutzerdefinierte API hinzu, die dem Vertrag der benutzerdefinierten API für Einwilligungsüberprüfungen entspricht.
  3. Deklarieren Sie Ihre Einwilligungsanbieterentität in der Lösung (sollte sich unter befinden).
  4. Verpacken Sie Ihre Lösung und importieren Sie sie in Ihre Entwicklungsorganisation.
  5. Gehen Sie zu EinstellungenCompliance-ProfileNeues ProfilMit externem Einwilligungsanbieter, wählen Sie Ihren Einwilligungsanbieter aus und speichern Sie das Formular.
  6. Aktivieren Sie Plugin-Ablaufverfolgungsprotokolle.
  7. Erstellen Sie unter EinstellungenCompliance eine E-Mail-Entität. Stellen Sie sicher, dass Sie das neu erstellte Compliance-Profil auswählen.
  8. Veröffentlichen Sie die E-Mail-Entität. An dieser Stelle sollte die Anforderung an Ihren Einwilligungsanbieter unter der -E-Mail erfolgen.
    1. Wenn die Prüfung der E-Mail-Entität fehlschlägt, untersuchen Sie die Ablaufverfolgungsprotokolle des Plug-Ins auf Fehler in Ihrer Logik.
    2. Wenn die E-Mail live gegangen ist, testen Sie unbedingt auch eine kleine Journey. Erstellen Sie ein statisches Segment mit Ihrer Test-E-Mail-Adresse und erstellen Sie eine segmentbasierte Journey, die auf dieses Segment abzielt. Die E-Mail sollte an die angegebene E-Mail-Adresse versendet werden. Stellen Sie sicher, dass die Abmelde-URL in der E-Mail und die -Header (sofern Ihr Einwilligungssystem die Abmeldung mit einem Klick unterstützt) richtig eingestellt sind.

Beispiel für eine Einwilligungsanbieterlösung

  • Last updated on