Zendesk-Verbindung

Zendesk ist eine Kundendienstlösung und ein Vertriebswerkzeug.

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

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

Anwendungsbeispiele use-cases

Die Kundendienstabteilung einer Multi-Channel B2C-Plattform möchte ihren Kunden ein nahtloses personalisiertes Erlebnis bieten. Die Abteilung kann Zielgruppen aus ihren eigenen Offline-Daten erstellen, um neue Benutzerprofile zu erstellen oder vorhandene Profilinformationen aus verschiedenen Interaktionen (z. B. Käufe, Rücksendungen usw.) zu aktualisieren und diese Zielgruppen von Adobe Experience Platform an Zendesk zu senden. Durch die Aktualisierung der Informationen in Zendesk wird sichergestellt, dass der Kundendienstmitarbeiter die aktuellen Kundeninformationen sofort verfügbar hat, was schnellere Reaktionen und eine schnellere Lösung ermöglicht.

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.

Weitere Informationen finden Sie in der Experience PlatformDokumentation für die Schemafeldgruppe „Details zur Zielgruppenzugehörigkeit , wenn Sie Anleitungen zu Zielgruppenstatus benötigen.

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-Anmeldedaten gather-credentials

Beachten Sie die folgenden Punkte, 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 zum Generieren eines Zendesk -Zugriffstokens, wenn Sie noch keines haben.
a0b1c2d3e4...v20w21x22y23z

Leitplanken guardrails

Auf Seite „Preise und" werden die Zendesk API-Limits für Ihr Konto 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
E-Mail-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 im Schritt Zielgruppen-Planung 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 mit dem Ziel herzustellen, benötigen Sie Ziele anzeigen und Ziele verwalten Zugriffssteuerungsberechtigungen. 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 dazu finden im Abschnitt Zendesk SammelnAnmeldeinformationen“.

  • Bearer-Token: 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
  • Zum Aktivieren von Daten benötigen Sie die Berechtigungen Ziele anzeigen, Ziele aktivieren, Profile anzeigen und Segmente anzeigenZugriffssteuerung. Lesen Sie die Übersicht über die Zugriffssteuerung oder wenden Sie sich an Ihre Produktadmins, um die erforderlichen Berechtigungen zu erhalten.

  • Zum Exportieren Identitäten benötigen Sie die Berechtigung Identitätsdiagramm anzeigen Zugriffssteuerung.

    Wählen Sie einen im Workflow hervorgehobenen Identity-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-Datenmodells (XDM) in Ihrem Platform-Konto und den entsprechenden Entsprechungen vom Ziel zu erstellen.

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

Im Feld Source angegebene Attribute folgen keiner dieser Einschränkungen. Sie können sie nach Bedarf zuordnen. Wenn das Datenformat jedoch beim Pushen in Zendesk nicht korrekt ist, führt dies zu einem Fehler.

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 und wählen Sie das XDM-Attribut oder den Identity-Namespace auswählen und wählen Sie eine Identität aus.

  3. Wählen Sie im Fenster Zielfeld auswählen die Kategorie Identity-Namespace auswählen und wählen Sie eine Zielidentität aus, oder wählen Sie 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:

      table 0-row-3 1-row-3 2-row-3 3-row-3
      Quellfeld 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:

      Beispiel-Screenshot der Platform-Benutzeroberfläche mit Attributzuordnungen.

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

Wenn Sie mit dem Eingeben der Zuordnungen für Ihre Zielverbindung fertig sind, klicken Sie auf Weiter.

Planen des Zielgruppenexports und Beispiel schedule-segment-export-example

Im Schritt Planen des Zielgruppenexports 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-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 als Nächstes das Ziel aus, 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 Audience hinzugefügt wurden. Diese Liste kann so konfiguriert werden, dass Spalten für die zusätzlichen Felder angezeigt werden, die mit den Zielgruppen-Zuordnungs-ID und Zielgruppenstatus erstellt wurden.
    Screenshot der Zendesk-Benutzeroberfläche mit der Seite „Kontakte“ mit den zusätzlichen Feldern, die mit dem Zielgruppennamen erstellt wurden.

  5. Alternativ können Sie einen Drilldown in eine einzelne Person-Seite durchführen und den Abschnitt Zusätzliche Felder mit dem Zielgruppennamen und dem Zielgruppenstatus überprüfen.
    Screenshot der Zendesk-Benutzeroberfläche, der die Seite Person mit dem Abschnitt „Zusätzliche Felder“ zeigt, auf der der Zielgruppenname und der Zielgruppenstatus angezeigt werden.

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 Dokumentation aktualisieren
  • Wir haben den Abschnitt Anwendungsfälle mit einem klareren Beispiel dafür aktualisiert, wann Kundinnen und Kunden von der Verwendung dieses Ziels profitieren würden.
  • Der Abschnitt Zuordnung wurde aktualisiert, um die richtigen erforderlichen Zuordnungen widerzuspiegeln. Die Attribute: last_name- und Identity: email Zielgruppen-Mappings sind für dieses Ziel obligatorisch. Wenn diese Zuordnungen fehlen, werden alle anderen Zuordnungen ignoriert und nicht an Zendesk gesendet.
  • Der Abschnitt Zuordnung wurde mit klaren Beispielen für obligatorische und optionale Zuordnungen aktualisiert.
März 2023 Erstmalige Veröffentlichung Erstmalige Zielveröffentlichung und Dokumentation.
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6