DokumentationExperience PlatformZielhandbuch

Zendesk-Verbindung

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Admin
  • Benutzende

Zendesk ist eine Kundendienstlösung und ein Verkaufstool.

Dieses Adobe Experience Platform Ziel nutzt die Zendesk Kontakte-API, um in einer Audience Identitäten zu erstellen und zu aktualisieren innerhalb von als Kontakte innerhalb von Zendesk.

Zendesk verwendet Träger-Token als Authentifizierungsmechanismus für die Kommunikation mit der Zendesk Contact-API. Anweisungen zur Authentifizierung bei Ihrer Zendesk-Instanz sehen Sie weiter unten im Abschnitt Authentifizieren bei Ziel.

Anwendungsbeispiele use-cases

Die Kundendienstabteilung einer mehrkanaligen B2C-Plattform möchte für ihre Kunden ein nahtloses personalisiertes Erlebnis gewährleisten. Die Abteilung kann Zielgruppen aus eigenen Offline-Daten erstellen, um neue Benutzerprofile zu erstellen oder vorhandene Profilinformationen aus verschiedenen Interaktionen zu aktualisieren (z. B. Käufe, Rückgaben usw.). und senden Sie diese Zielgruppen von Adobe Experience Platform an Zendesk. Die aktualisierten Informationen in Zendesk stellen sicher, dass der Kundendienstmitarbeiter die neuesten Informationen des Kunden sofort verfügbar hat, sodass schnellere Antworten und eine schnellere Lösung möglich sind.

Voraussetzungen prerequisites

Voraussetzungen für Experience Platform prerequisites-in-experience-platform

Vor der Aktivierung der Daten für das Zendesk-Ziel müssen Sie über ein Schema, einen Datensatz und Segmente verfügen, die in Experience Platform erstellt wurden.

Informationen zum Zielgruppenstatus finden Sie in der Experience Platform-Dokumentation für die Schemakonferenz Zielgruppenzugehörigkeitsdetails .

Voraussetzungen für Zendesk prerequisites-destination

Um Daten von Platform in Ihr Zendesk -Konto zu exportieren, benötigen Sie ein Zendesk -Konto.

Sammeln von Zendesk-Anmeldeinformationen gather-credentials

Beachten Sie die folgenden Elemente, bevor Sie sich beim Zendesk-Ziel authentifizieren:

Anmeldedaten
Beschreibung
Beispiel
Bearer token
Das Zugriffstoken, das Sie in Ihrem Zendesk -Konto generiert haben.
Befolgen Sie die Dokumentation, um ein Zendesk Zugriffstoken zu generieren, falls Sie noch kein Zugriffstoken haben.
a0b1c2d3e4...v20w21x22y23z

Leitplanken guardrails

Auf der Seite Preise- und Ratenbeschränkungen werden die mit Ihrem Konto verbundenen API-Beschränkungen für Zendesk beschrieben. Sie müssen sicherstellen, dass Ihre Daten und Payloads innerhalb dieser Beschränkungen liegen.

Unterstützte Identitäten supported-identities

Zendesk unterstützt die Aktualisierung von Identitäten, die in der folgenden Tabelle beschrieben werden. Erhalten Sie weitere Informationen zu Identitäten.

Ziel-Identität
Beispiel
Beschreibung
Obligatorisch
email
test@test.com
Email-Adresse des Kontakts.
Ja

Exporttyp und -häufigkeit export-type-frequency

Beziehen Sie sich auf die folgende Tabelle, um Informationen zu Typ und Häufigkeit des Zielexports zu erhalten.

Element
Typ
Anmerkungen
Exporttyp
Profilbasiert
  • Sie exportieren alle Mitglieder eines Segments zusammen mit den gewünschten Schemafeldern (z. B.: E-Mail-Adresse, Telefonnummer, Nachname), entsprechend Ihrer Feldzuordnung.
  • Jeder Segmentstatus in Zendesk wird mit dem entsprechenden Zielgruppenstatus von Platform aktualisiert, basierend auf dem Wert Zuordnungs-ID , der während des Schritts Zielgruppenplanung angegeben wurde.
Exporthäufigkeit
Streaming
  • Streaming-Ziele sind „immer verfügbare“ API-basierte Verbindungen. Sobald ein Profil in Experience Platform auf der Grundlage einer Zielgruppenauswertung aktualisiert wird, sendet der Connector das Update nachgelagert an die Zielplattform. Lesen Sie mehr über Streaming-Ziele.

Herstellen einer Verbindung mit dem Ziel connect

IMPORTANT
Um eine Verbindung zum Ziel herzustellen, benötigen Sie die Zugriffssteuerungsberechtigungen Ziele anzeigen und Ziele verwalten .Lesen Sie die Zugriffskontrolle – Übersicht oder wenden Sie sich an Ihren Produktadministrator, um die erforderlichen Berechtigungen zu erhalten.

Um eine Verbindung mit diesem Ziel herzustellen, gehen Sie wie im Tutorial zur Zielkonfiguration beschrieben vor. Füllen Sie im Workflow zum Konfigurieren des Ziels die Felder aus, die in den beiden folgenden Abschnitten aufgeführt sind.

Suchen Sie in Ziele > Katalog nach Zendesk. Alternativ können Sie es unter der CRM-Kategorie finden.

Beim Ziel authentifizieren authenticate

Füllen Sie die erforderlichen Felder aus. Eine Anleitung finden Sie im Abschnitt Anmeldedaten sammeln Zendesk 2} .

  • Trägertoken: Das Zugriffstoken, das Sie in Ihrem Zendesk -Konto generiert haben.

Um sich beim Ziel zu authentifizieren, wählen Sie Mit Ziel verbinden.
Screenshot der Platform-Benutzeroberfläche, auf dem die Authentifizierung gezeigt wird.

Wenn die angegebenen Details gültig sind, zeigt die Benutzeroberfläche den Status Verbunden mit einem grünen Häkchen an. Sie können dann mit dem nächsten Schritt fortfahren.

Ausfüllen der Zieldetails destination-details

Füllen Sie die folgenden erforderlichen und optionalen Felder aus, um Details für das Ziel zu konfigurieren. Ein Sternchen neben einem Feld in der Benutzeroberfläche zeigt an, dass das Feld erforderlich ist.
Screenshot der Platform-Benutzeroberfläche mit den Zieldetails.

  • Name: Ein Name, durch den Sie dieses Ziel in Zukunft erkennen können.
  • Beschreibung: Eine Beschreibung, die Ihnen hilft, dieses Ziel in Zukunft zu identifizieren.

Aktivieren von Warnhinweisen enable-alerts

Sie können Warnhinweise aktivieren, um Benachrichtigungen zum Status des Datenflusses zu Ihrem Ziel zu erhalten. Wählen Sie einen Warnhinweis aus der zu abonnierenden Liste aus, um Benachrichtigungen über den Status Ihres Datenflusses zu erhalten. Weitere Informationen zu Warnhinweisen finden Sie im Handbuch zum Abonnieren von Zielwarnhinweisen über die Benutzeroberfläche.

Wenn Sie alle Details für Ihre Zielverbindung eingegeben haben, klicken Sie auf Weiter.

Aktivieren von Zielgruppen für dieses Ziel activate

IMPORTANT
  • Um Daten zu aktivieren, benötigen Sie die Zugriffssteuerungsberechtigungen Ziele anzeigen, Ziele aktivieren, Profile anzeigen und Segmente anzeigen .Lesen Sie die Übersicht über die Zugriffssteuerung oder wenden Sie sich an Ihre Produktadmins, um die erforderlichen Berechtigungen zu erhalten.
  • Um identities zu exportieren, benötigen Sie die Zugriffssteuerungsberechtigung Identitätsdiagramm anzeigen 🔗.
    Wählen Sie den im Workflow hervorgehobenen Identitäts-Namespace aus, um Zielgruppen für Ziele zu aktivieren. {width="100" modal="regular"}

Anweisungen zum Aktivieren von Zielgruppen für dieses Ziel finden Sie unter Aktivieren von Profilen und Zielgruppen für Streaming-Zielgruppen-Exportziele.

Zuordnungsüberlegungen und Beispiel mapping-considerations-example

Um Ihre Zielgruppendaten ordnungsgemäß von Adobe Experience Platform an das Zendesk-Ziel zu senden, müssen Sie den Schritt zur Feldzuordnung durchlaufen. Die Zuordnung besteht darin, eine Verknüpfung zwischen den Schemafeldern Ihres Experience-Datenmodell (XDM) in Ihrem Platform-Konto und den entsprechenden Entsprechungen vom Ziel zu erstellen.

Die im Feld Ziel angegebenen Attribute sollten genau wie in der Tabelle der Attributzuordnungen beschrieben benannt werden, da diese Attribute den Anfrageinhalt bilden.

Im Feld Source angegebene Attribute unterliegen keiner solchen Einschränkung. Sie können sie nach Bedarf zuordnen. Wenn das Datenformat jedoch beim Pushen auf Zendesk nicht korrekt ist, wird ein Fehler ausgegeben.

Um Ihre XDM-Felder den Zendesk-Zielfeldern korrekt zuzuordnen, führen Sie die folgenden Schritte aus:

  1. Wählen Sie Im Schritt Zuordnung die Option Neue Zuordnung hinzufügen aus. Auf dem Bildschirm wird eine neue Zuordnungszeile angezeigt.

  2. Wählen Sie im Fenster Quellfeld auswählen die Kategorie Attribute auswählen aus, wählen Sie das XDM-Attribut aus oder wählen Sie den Eintrag Identitäts-Namespace auswählen und wählen Sie eine Identität aus.

  3. Wählen Sie im Fenster Zielfeld auswählen die Kategorie Identitäts-Namespace auswählen aus und wählen Sie eine Zielidentität oder die Kategorie Attribute auswählen und wählen Sie eines der unterstützten Schemaattribute aus.

    • Wiederholen Sie diese Schritte, um die folgenden obligatorischen Zuordnungen hinzuzufügen. Sie können auch alle anderen Attribute hinzufügen, die Sie zwischen Ihrem XDM-Profilschema und Ihrer Zendesk-Instanz aktualisieren möchten:
      |Source-Feld|Zielfeld| Obligatorisch|
      |—|—|—|
      |xdm: person.name.lastName|xdm: last_name| Ja |
      |IdentityMap: Email|Identity: email| Ja |
      |xdm: person.name.firstName|xdm: first_name| |

    • Nachfolgend finden Sie ein Beispiel für die Verwendung dieser Zuordnungen:

      Screenshot der Platform-Benutzeroberfläche mit Attributzuordnungen.

IMPORTANT
Die Zielgruppen-Mappings Attribute: last_name und Identity: email sind für dieses Ziel obligatorisch. Wenn diese Zuordnungen fehlen, werden alle anderen Zuordnungen ignoriert und nicht an Zendesk gesendet.

Wenn Sie die Zuordnungen für Ihre Zielverbindung bereitgestellt haben, wählen Sie Weiter aus.

Zielgruppenexport und Beispiel planen schedule-segment-export-example

Im Schritt Zielgruppenexport planen des Aktivierungs-Workflows müssen Sie Platform-Zielgruppen manuell dem benutzerdefinierten Feldattribut in Zendesk zuordnen.

Wählen Sie dazu jedes Segment aus und geben Sie dann das entsprechende benutzerdefinierte Feldattribut aus Zendesk im Feld Zuordnungs-ID an.

Nachfolgend finden Sie ein Beispiel:
Beispiel für einen Screenshot der Platform-Benutzeroberfläche mit der Option Zielgruppenexport planen

Überprüfen des Datenexports exported-data

Gehen Sie wie folgt vor, um zu überprüfen, ob Sie das Ziel korrekt eingerichtet haben:

  1. Wählen Sie Ziele > Durchsuchen aus und navigieren Sie zur Liste der Ziele.

  2. Wählen Sie anschließend das Ziel aus und wechseln Sie zur Registerkarte Aktivierungsdaten und wählen Sie dann einen Zielgruppennamen aus.
    Beispiel-Screenshot der Platform-Benutzeroberfläche mit Daten zur Aktivierung von Zielen.

  3. Überwachen Sie die Zielgruppenzusammenfassung und stellen Sie sicher, dass die Anzahl der Profile der Anzahl innerhalb des Segments entspricht.
    Beispiel-Screenshot der Platform-Benutzeroberfläche mit Segment.

  4. Melden Sie sich bei der Zendesk -Website an und navigieren Sie dann zur Seite Kontakte , um zu überprüfen, ob die Profile aus der Zielgruppe hinzugefügt wurden. Diese Liste kann so konfiguriert werden, dass Spalten für die zusätzlichen Felder angezeigt werden, die mit der Zielgruppe​ Zuordnungs-ID und dem Zielgruppenstatus erstellt wurden.
    Zendesk UI-Screenshot mit der Seite Kontakte mit den zusätzlichen Feldern, die mit dem Zielgruppennamen erstellt wurden.

  5. Alternativ können Sie einen Drilldown zu einer einzelnen Person-Seite durchführen und den Abschnitt Zusätzliche Felder überprüfen, in dem der Zielgruppenname und der Zielgruppenstatus angezeigt werden.
    Zendesk UI-Screenshot mit der Seite Personmit den zusätzlichen Feldern, Abschnitt mit dem Zielgruppennamen und dem Zielgruppenstatus.

Datennutzung und -Governance data-usage-governance

Alle Adobe Experience Platform-Ziele sind bei der Verarbeitung Ihrer Daten mit Datennutzungsrichtlinien konform. Ausführliche Informationen darüber, wie Adobe Experience Platform Data Governance erzwingt, finden Sie unter Data Governance – Übersicht.

Zusätzliche Ressourcen additional-resources

Weitere nützliche Informationen aus der Zendesk -Dokumentation finden Sie unten:

Änderungsprotokoll

In diesem Abschnitt werden aktualisierte Funktionen und wesentliche Dokumentationsänderungen für diesen Ziel-Connector erfasst.

Änderungsprotokoll anzeigen
table 0-row-3 1-row-3 2-row-3 layout-auto
Veröffentlichungsmonat Art der Aktualisierung Beschreibung
April 2023 Aktualisierung der Dokumentation
  • Wir haben den Abschnitt Anwendungsfälle mit einem klareren Beispiel aktualisiert, wann Kunden von der Verwendung dieses Ziels profitieren würden.
  • Wir haben den Abschnitt mapping aktualisiert, um die korrekten erforderlichen Zuordnungen widerzuspiegeln. Die Zielgruppen-Mappings Attribute: last_name und Identity: email sind für dieses Ziel obligatorisch. Wenn diese Zuordnungen fehlen, werden alle anderen Zuordnungen ignoriert und nicht an Zendesk gesendet.
  • Wir haben den Abschnitt Zuordnen mit klaren Beispielen für obligatorische und optionale Zuordnungen aktualisiert.
März 2023 Erstmalige Veröffentlichung Erste Zielversion und Veröffentlichung der Dokumentation.
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6