DokumentationExperience PlatformAnleitung zu Quell-Connectoren

[Beta]{class="badge informative"}

RainFocus

Last update: Tue Dec 31 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 Betagekennzeichneten Quellen finden Sie„Quellen - Übersicht“.

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

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

IMPORTANT
Dieser Quell-Connector und diese Dokumentationsseite werden vom RainFocus-Team erstellt und gepflegt. Bei Fragen oder Aktualisierungsanfragen wenden Sie sich bitte direkt an clientcare@rainfocus.com oder besuchen Sie das RainFocus Hilfezentrum

Voraussetzungen

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

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

IMPORTANT
Adobe hat kürzlich bekannt gegeben, dass JWT-Token zugunsten von OAuth nicht mehr unterstützt werden. Um diese Änderung vorzunehmen, wird die RainFocus in naher Zukunft zu OAuth migriert.

Sammeln erforderlicher Anmeldedaten

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 erhalten Sie über das Adobe Service-Konto im Adobe Developer-Portal.
b9c32a63e7d41a0f87d3e8b52a16e7a2
Client-Geheimnis
Das Client-Geheimnis können Sie über das Adobe Service-Konto im Adobe Developer-Portal abrufen.
k1b-p-umplcjtg_arnw-R-Bx44bybu
ID des technischen Kontos
Die ID des technischen Kontos erhalten Sie über das Adobe Service-Konto im Adobe Developer-Portal.
B3F9D2E8A64C573D21ABFE97@techacct.adobe.com
Organisations-ID
Die Organisations-ID erhalten Sie vom Adobe Service-Konto im Adobe Developer-Portal
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 aus RainFocus im Experience Platform zu speichern, müssen Sie ein Experience-Datenmodell (XDM)-Schema erstellen, um einen Datensatz zu beschreiben. Dieser Datensatz kann die möglichen Felder und Datentypen speichern, die vom RainFocus gesendet werden.

RainFocus empfiehlt die folgenden Felder, in denen alle standardmäßig gesendeten möglichen Daten erfasst sind.

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

  • Teilnehmer
  • Aussteller
  • Lead
  • Session
  • Sitzungsdauer

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
String
1619119968857001fvLB
Die Teilnehmer-ID in RainFocus.
attendee.externalId
String
1666809456617001pj
Die von einer Organisation angegebene externe ID.
attendee.clientId
String
8EFC1F57631CAFE70A495ECB@8f3f1f5c631caf3e495fd8.e
Die Teilnehmer-SSO-Client-ID.
attendee.email
String
user@company.com
Die E-Mail-Adresse des Teilnehmers.
transmissionId
String
1680309557133001JHz
Eine eindeutige Kennung, die für die Daten-Push-Benachrichtigung verwendet wird.
eventType
String
Sitzung geplant
Der Name des Teilnehmererlebnisereignisses.
timestamp
DateTime
01.04.2023:41:T00.57.000Z
Der Zeitstempel der Daten-Push-Benachrichtigung.
event.name
String
Adobe Summit 2023
Der Name des Ereignisses, bei dem eine Übertragung stattgefunden hat.
exhibitor.exhibitorId
String
1680309557133001JHz
Die RainFocus Kennung des Ausstellers.
exhibitor.externalId
String
1666809514105001lSJN
Die Kennung für den Aussteller im Client-System.
exhibitor.name
String
IBM
Der Name des Ausstellers.
lead.leadId
String
1666809456617001pj
Die RainFocus für den Lead.
lead.note
Zeichenfolge
session.sessionId
Zeichenfolge
1666809373585001t4aV
Die RainFocus Kennung für die Sitzung.
session.externalId
String
1666809456617001pj
Die Kennung für die Sitzung im Client-System.
session.code
String
GS3
Der Code für die Sitzung.
session.title
String
Inspiration Keynote
Der Titel der Sitzung.
session.length
Ganzzahl
90
Die Dauer der Sitzung.
sessiontime.sessiontimeId
String
1673033149739001OJLZ
Die RainFocus Kennung für die Sitzungszeit.
sessiontime.startTime
String
22.03.2023 :00:.00
Die Startzeit der Sitzung.
sessiontime.endTime
String
22.03.2023 :00:.00
Die Endzeit der Sitzung.
sessiontime.room
String
B32
Der für die Sitzung genutzte Raum

Wie Sie Ihr Schema für RainFocus Daten erstellen, erfahren Sie in der folgenden Dokumentation , wie Sie ein Schema mithilfe von APIs oder der Benutzeroberfläche erstellen.

IMPORTANT
  • Das Schema muss die Klasse XDM ExperienceEvent“ erweitern
  • Sie müssen sicherstellen, dass das Schema eine primäre Identität enthält und für Profil aktiviert ist. Weitere Informationen finden sich im Handbuch unter 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 Service-Konto und Ihr XDM-Schema fertig sind, können Sie das Integration Profile über die RainFocus-Plattform aktivieren. Die Integration Profile ist für das Streaming von Daten an Experience Platform verantwortlich.

Melden Sie sich bei RainFocus Plattform an. Wählen Sie in der primären Navigation 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 erstellen in der RainFocus-Benutzeroberfläche.

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

  • Client ID (Client-ID)
  • Client Secret (Client-Geheimnis)
  • ID des technischen Kontos
  • Organisations-ID

Wählen Sie nach Angabe der Anmeldeinformationen Save aus. Jetzt sollte die neue Integration Profile im RainFocus-Dashboard aufgeführt werden.

Wählen Sie die soeben erstellte Integration Profile aus, um eine Liste der bereits konfigurierten vordefinierten Push-Typen anzuzeigen. Hierbei handelt es sich um Erlebnisereignisse die bei ihrem Auftreten an Experience Platform gesendet werden.

Eine Liste vordefinierter Push-Typen im RainFocus-Dashboard.

Um eine Kopie der JSON-Beispiel-Payload abzurufen, wählen Sie Sample JSON Payload aus. Markieren und kopieren Sie als Nächstes die JSON-Beispiel-Payload und Sie sie in einer neuen Datei mit der Erweiterung .json. Dies wird später beim Experience Platform für „Zuordnungskonfigurationen verwendet.

Beispiel-JSON-Payload im RainFocus-Dashboard.

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

Nächste Schritte

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

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