DokumentationExperience PlatformAnleitung zu Quell-Connectoren

[Beta]{class="badge informative"}

RainFocus

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

Erstellt für:

  • Entwickler
NOTE
Die RainFocus-Quelle befindet sich in der Beta-Phase. Weitere Informationen zur Verwendung von Beta-beschrifteten Quellen finden Sie in der Quellenübersicht .

RainFocus ist eine Plattform, mit der Sie Ihre Ereignisse bewerben und Ihre Zielgruppen erstellen können. Sie können RainFocus verwenden, um wunderschöne Werbeseiten zu erstellen, die Kampagnenleistung zu verfolgen und Registrierungsumrechnungen zu optimieren.

Verwenden Sie die RainFocus-Quelle in Adobe Experience Platform und Real-time Customer Data Platform, um Ihre Kundendatenprofile automatisch mit den zugehörigen Erlebnisereignissen in Echtzeit anzureichern. Nach der Aktivierung werden Erlebnisereignisse automatisch in Real-Time CDP gestreamt, was eine leistungsstarke Zielgruppensegmentierung, Datenanalyse und Aktivierung der Journey mit nachgelagerten Zielen und Anwendungen wie Customer Journey Analytics und Adobe Journey Optimizer ermöglicht.

IMPORTANT
Diese Quell-Connector- und Dokumentationsseite wird vom RainFocus-Team erstellt und gepflegt. Bei Fragen oder Aktualisierungsanfragen wenden Sie sich bitte direkt an clientcare@rainfocus.com oder besuchen Sie das RainFocus Help Center

Voraussetzungen

Sie müssen die folgenden Voraussetzungen erfüllen, bevor Sie die RainFocus -Integration auf dem Experience Platform aktivieren können:

Erstellen eines Adobe Service-Kontos (JWT) im Adobe Developer Portal

IMPORTANT
Adobe hat vor kurzem die Einstellung von JWT-Token zugunsten von OAuth angekündigt. Um dieser Änderung Rechnung zu tragen, wird die RainFocus-Quelle in naher Zukunft zu OAuth migriert.

Sammeln erforderlicher Anmeldeinformationen

Um RainFocus mit Experience Platform zu verbinden, müssen Sie Werte für die folgenden Verbindungseigenschaften in RainFocus angeben:

Anmeldedaten
Beschreibung
Beispiel
Client-ID
Die Client-ID kann über das Adobe Service-Konto im Adobe Developer Portal abgerufen werden.
b9c32a63e7d41a0f87d3e8b52a16e7a2
Client-Geheimnis
Das Client-Geheimnis kann über das Adobe Service-Konto im Adobe Developer Portal abgerufen werden.
k1b-p-umplcjtg_arnw-R-Bx44bybu
Technische Konto-ID
Die technische Konto-ID kann über das Adobe Service-Konto im Adobe Developer Portal abgerufen werden.
B3F9D2E8A64C573D21ABFE97@techacct.adobe.com
Organisations-ID
Die Organisations-ID kann über das Adobe Service-Konto im Adobe Developer Portal abgerufen werden.
D9A6F3BCE82FD147C50E3A19@techacct.adobe.com

Erstellen eines XDM-Schemas und Definieren des Identitätsfelds create-an-xdm-schema-and-define-the-identity-field

Um die Erlebnisereignisse von RainFocus im Experience Platform zu speichern, müssen Sie ein Experience-Datenmodell (XDM)-Schema erstellen, um einen Datensatz zu beschreiben, in dem die möglichen von RainFocus gesendeten Felder und Datentypen gespeichert werden können.

RainFocus empfiehlt die folgenden Felder, die alle standardmäßig gesendeten möglichen Daten abdecken.

Außerdem werden die folgenden Feldergruppen empfohlen (mit Präfix gekennzeichnet):

  • Teilnehmer
  • Aussteller
  • Lead
  • Session
  • SessionTime

Das Schema sollte die folgenden Felder enthalten:

Feld
Typ
Beispiel
Beschreibung
attendee.registered
Zeichenfolge
Ja
Eine Markierung, die bestimmt, ob der Teilnehmer als registriert gilt.
attendee.attendeeId
Zeichenfolge
1619119968857001fvLB
Die Teilnehmer-ID in RainFocus.
attendee.externalId
Zeichenfolge
1666809456617001wyPj
Die von einer Organisation angegebene externe ID.
attendee.clientId
Zeichenfolge
8EFC1F57631CAFE70A495ECB@8f3f1f5c631caf3e495fd8.e
Die Teilnehmer-SSO-Client-ID.
attendee.email
Zeichenfolge
user@company.com
Die E-Mail-Adresse des Teilnehmers.
transmissionId
Zeichenfolge
1680309557133001YHhz
Eine eindeutige Kennung, die für Daten-Push verwendet wird.
eventType
Zeichenfolge
SessionScheduled
Der Name des Teilnehmer-Erlebnisereignisses.
timestamp
DateTime
2023-04-01T00:41:57.000Z
Der Zeitstempel der Daten-Push-Benachrichtigung.
event.name
Zeichenfolge
Adobe Summit 2023
Der Name des Ereignisses, bei dem eine Übertragung stattgefunden hat.
exhibitor.exhibitorId
Zeichenfolge
1680309557133001YHhz
Die RainFocus-Kennung des Ausstellers.
exhibitor.externalId
Zeichenfolge
1666809514105001lSJN
Die Kennung für den Aussteller im Kundensystem.
exhibitor.name
Zeichenfolge
IBM
Der Name des Ausstellers.
lead.leadId
Zeichenfolge
1666809456617001wyPj
Die RainFocus-Kennung für den Lead.
lead.note
Zeichenfolge
session.sessionId
Zeichenfolge
1666809373585001t4aV
Die RainFocus-Kennung für die Sitzung.
session.externalId
Zeichenfolge
1666809456617001wyPj
Die Kennung für die Sitzung im Client-System.
session.code
Zeichenfolge
GS3
Der Code für die Sitzung.
session.title
Zeichenfolge
Inspiration - Keynote
Der Titel der Sitzung.
session.length
Ganzzahl
90
Die Dauer der Sitzung.
sessiontime.sessiontimeId
Zeichenfolge
1673033149739001OJLZ
Die RainFocus -Kennung für die Sitzungszeit.
sessiontime.startTime
Zeichenfolge
22.03.2023 10:00:00
Die Startzeit der Sitzung.
sessiontime.endTime
Zeichenfolge
22.03.2023 10:00:00
Die Endzeit der Sitzung.
sessiontime.room
Zeichenfolge
B32
Der für die Sitzung verwendete Raum.

Um Ihr Schema für RainFocus -Daten zu erstellen, lesen Sie die folgende Dokumentation, um zu erfahren, wie Sie ein Schema mit APIs oder der Benutzeroberfläche erstellen.

IMPORTANT
  • Das Schema muss die XDM ExperienceEvent-Klasse erweitern.
  • Sie müssen sicherstellen, dass das Schema eine primäre Identität enthält und für Profil aktiviert ist. Weitere Informationen finden Sie im Handbuch zum Definieren von Identitätsfeldern in der Benutzeroberfläche 🔗
  • Sie können die Beispielidentität (E-Mail) durch eine andere geeignete Kennung wie eine SHA256-E-Mail oder ECID ersetzen.

Erstellen eines Integrationsprofils in RainFocus create-an-integration-profile-in-rainfocus

Sobald Ihr Dienstkonto und Ihr XDM-Schema fertig sind, können Sie jetzt die Integration Profile über die RainFocus-Plattform aktivieren. Der Integration Profile ist für das Streaming von Daten an Experience Platform verantwortlich.

Melden Sie sich bei RainFocus platform an. Wählen Sie im primären Navigationsbereich Libraries und dann Integration Profiles aus.

Die RainFocus-Benutzeroberfläche mit ausgewählten Bibliotheken und Integrationsprofilen.

Um ein neues Profil zu erstellen, wählen Sie das Symbol (+) aus. Wählen Sie als Nächstes Adobe Real-time Customer Data Platform und dann OK aus.

Das Fenster Integrationsprofil erstellenin der RainFocus-Benutzeroberfläche.

Geben Sie als Nächstes die Anmeldeinformationen ein, die Sie im Adobe Developer Portal-Projekt abgerufen haben:

  • Client ID (Client-ID)
  • Client Secret (Client-Geheimnis)
  • Technische Konto-ID
  • Organisations-ID

Nachdem die Anmeldeinformationen angegeben wurden, wählen Sie Save aus. Jetzt sollte das neue Integration Profile im Dashboard RainFocus aufgeführt sein.

Wählen Sie die soeben erstellte Integration Profile aus, um eine Liste mit vordefinierten Push-Typen anzuzeigen, die bereits konfiguriert sind. Dies sind die Erlebnisereignisse, die bei ihrem Auftreten an Experience Platform gesendet werden.

Eine Liste vordefinierter Push-Typen im Dashboard RainFocus.

Um eine Kopie der JSON-Beispielnutzlast abzurufen, wählen Sie Sample JSON Payload aus. Markieren und kopieren Sie anschließend die JSON-Beispielnutzlast und speichern Sie sie in einer neuen Datei mit der Erweiterung .json . Dies wird später im Experience Platform für Zuordnungskonfigurationen verwendet.

Eine JSON-Beispielnutzlast im Dashboard RainFocus.

TIP
Die Einrichtung ist noch nicht abgeschlossen: Nachdem Ihr Datenfluss erstellt wurde, müssen Sie zum Dashboard RainFocus zurückkehren, um Ihr Integration Profile abzuschließen, indem Sie Ihre Streaming-Endpunkt-URL und Ihre Datenfluss-ID angeben.

Nächste Schritte

Durch Lesen dieses Dokuments haben Sie die erforderliche Einrichtung abgeschlossen, um Daten von Ihrem RainFocus-Konto an Experience Platform zu streamen. Sie können jetzt mit dem Handbuch zum Verbinden von 1}mit dem Experience Platform über die Benutzeroberfläche fortfahren. RainFocus

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089