(API) Oracle Eloqua-Verbindung
Oracle Eloqua ermöglicht es Marketing-Experten, Kampagnen zu planen und auszuführen und dabei ein personalisiertes Kundenerlebnis für ihre potenziellen Kunden zu liefern. Dank der integrierten Lead-Verwaltung und der einfachen Kampagnenerstellung können Marketing-Fachleute die richtige Zielgruppe zur richtigen Zeit auf der Journey ihres Käufers ansprechen. Außerdem kann die Lösung elegant skaliert werden, um Zielgruppen über verschiedene Kanäle wie E-Mail, Display-Suche, Video und Mobilgeräte zu erreichen. Vertriebsteams können mehr Angebote schneller abschließen und so den Marketing-ROI durch Echtzeit-Einblicke erhöhen.
Dieses Adobe Experience Platform Ziel nutzt den Vorgang Aktualisieren einesaus der Oracle Eloqua REST-API, mit dem Sie einer Zielgruppe Identitäten in Oracle Eloqua aktualisieren können.
Oracle Eloqua verwendet Standardauthentifizierung für die Kommunikation mit der Oracle Eloqua REST-API. Anweisungen zur Authentifizierung bei Ihrer Oracle Eloqua-Instanz sehen Sie weiter unten im Abschnitt Authentifizieren bei Ziel.
Anwendungsbeispiele use-cases
Die Marketing-Abteilung einer Online-Plattform möchte eine E-Mail-basierte Marketing-Kampagne an eine kuratierte Audience von Leads senden. Das Marketing-Team der Plattform kann bestehende Lead-Informationen über Adobe Experience Platform aktualisieren, Zielgruppen aus ihren eigenen Offline-Daten erstellen und diese Zielgruppen an Oracle Eloqua senden, die dann zum Senden der E-Mail mit der Marketing-Kampagne verwendet werden können.
Voraussetzungen prerequisites
Voraussetzungen für Experience Platform prerequisites-in-experience-platform
Vor der Aktivierung der Daten für das Oracle Eloqua-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 zur Schemafeldgruppe „Details zur Zielgruppenzugehörigkeit wenn Sie Anleitung zu Zielgruppenstatus benötigen.
Voraussetzungen für Oracle Eloqua prerequisites-destination
Um Daten von Platform in Ihr Oracle Eloqua-Konto zu exportieren, benötigen Sie ein Oracle Eloqua-Konto.
Darüber hinaus benötigen Sie mindestens die „Erweiterte Benutzer - Marketing-Berechtigungen“ für Ihre Oracle Eloqua. Eine Anleitung finden Sie im Abschnitt Sicherheitsgruppen auf der Seite Gesicherter". Der Zugriff ist für das Ziel erforderlich, um beim Aufrufen der Oracle Eloqua-API programmgesteuert Ihre Basis- zu bestimmen).
Sammeln von Oracle Eloqua-Anmeldedaten gather-credentials
Beachten Sie die folgenden Punkte, bevor Sie sich beim Oracle Eloqua-Ziel authentifizieren:
Company Name
Sie verwenden die
Username
Company Name
und Oracle Eloqua später als verkettete Zeichenfolge, die beim der Authentifizierung beim Ziel als Benutzername verwendet wird.Username
Password
Pod
secure.p01.eloqua.com
lautet, wird Ihr pod
p01
. Weitere Anleitungen finden Sie auf Seite BestimmenPOD .Eine Anleitung finden Sie Abschnitt „Anmelden Oracle Eloqua".
Leitplanken guardrails
- Oracle Eloqua benutzerdefinierten Kontaktfelder werden automatisch mit den Namen der Zielgruppen erstellt, die im Schritt Segmente auswählen ausgewählt wurden.
-
Oracle Eloqua ist auf maximal 250 benutzerdefinierte Kontaktfelder beschränkt.
-
Stellen Sie vor dem Export neuer Zielgruppen sicher, dass diese Grenze nicht überschritten wird, sowohl von Platform-Zielgruppen als auch von der Anzahl vorhandener Zielgruppen in Oracle Eloqua.
-
Wenn dieser Grenzwert überschritten wird, tritt beim Experience Platform ein Fehler auf. Der Grund dafür ist, dass die Oracle Eloqua-API die Anfrage nicht validieren kann und mit der Fehlermeldung - 400: Es gab einen Validierungsfehler - , der das Problem beschreibt.
-
Wenn Sie das oben angegebene Limit erreicht haben, müssen Sie vorhandene Zuordnungen aus Ihrem Ziel entfernen und die entsprechenden benutzerdefinierten Kontaktfelder in Ihrem Oracle Eloqua-Konto löschen, bevor Sie weitere Segmente exportieren können.
-
Weitere Informationen zu zusätzlichen Oracle Eloqua finden Sie aufSeite „Kontaktfelder erstellen“.
Unterstützte Identitäten supported-identities
Oracle Eloqua unterstützt die Aktualisierung von Identitäten, die in der folgenden Tabelle beschrieben werden. Erhalten Sie weitere Informationen zu Identitäten.
EloquaId
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.
- Sie exportieren alle Mitglieder eines Segments zusammen mit den gewünschten Schemafeldern (z. B.: E-Mail-Adresse, Telefonnummer, Nachname), entsprechend Ihrer Feldzuordnung.
- Für jede ausgewählte Zielgruppe in Platform wird der entsprechende Oracle Eloqua Segmentstatus mit dem Zielgruppenstatus in Platform aktualisiert.
- 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
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 (API) Oracle Eloqua. Alternativ können Sie es unter der Kategorie E-Mail-Marketing finden.
Beim Ziel authentifizieren authenticate
Füllen Sie die erforderlichen Felder aus. Eine Anleitung dazu finden im Abschnitt Oracle Eloqua SammelnAnmeldeinformationen“.
- Kennwort: Das Kennwort Ihres Oracle Eloqua Kontos.
- Benutzername: Eine verkettete Zeichenfolge, die aus dem Namen Ihres Oracle Eloqua Unternehmens und dem Oracle Eloqua Benutzernamen besteht.
Der verkettete Wert hat die Form von{COMPANY_NAME}\{USERNAME}
.
Hinweis: Verwenden Sie keine Klammern oder Leerzeichen und behalten Sie die\
bei.
Wenn Ihr Oracle Eloqua Firmenname beispielsweiseMyCompany
und Oracle Eloqua BenutzernameUsername
ist, wird der verkettete Wert, den Sie im Feld Benutzername verwenden,MyCompany\Username
.
Um sich beim Ziel zu authentifizieren, wählen Sie Mit Ziel verbinden.
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.
- 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.
- Pod: Um zu erfahren, in welchem
pod
Sie sich befinden, melden Sie sich bei Oracle Eloqua an und notieren Sie sich die URL in Ihrem Browser, nachdem Sie sich erfolgreich angemeldet haben. Wenn Ihre Browser-URL beispielsweisesecure.p01.eloqua.com
ist, müssen Sie denpod
Wertp01
auswählen. Weitere Anleitungen finden im Abschnitt Oracle Eloqua SammelnAnmeldeinformationen“.
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
-
Zum Aktivieren von Daten benötigen Sie die Berechtigungen Ziele anzeigen, Ziele aktivieren, Profile anzeigen und Segmente anzeigen Zugriffssteuerung. 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.
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 Oracle Eloqua-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.
Gehen Sie wie folgt vor, um Ihre XDM-Felder den Oracle Eloqua-Zielfeldern zuzuordnen:
-
Wählen Sie Im Schritt Zuordnung die Option Neue Zuordnung hinzufügen aus. Auf dem Bildschirm wird eine neue Zuordnungszeile angezeigt.
-
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.
-
Wählen Sie im Fenster Zielfeld auswählen die Option Identity-Namespace und wählen Sie eine Identität aus, oder wählen Sie Benutzerdefinierte Attribute auswählen und geben Sie den gewünschten Attributnamen in das Feld Attributname ein. Der von Ihnen angegebene Attributname sollte mit einem vorhandenen Kontaktattribut in Oracle Eloqua übereinstimmen. Unter create a contact finden Sie die genauen Attributnamen, die Sie in Oracle Eloqua verwenden können.
-
Wiederholen Sie diese Schritte, um sowohl die erforderlichen als auch alle gewünschten Attributzuordnungen zwischen Ihrem XDM-Profilschema und Oracle Eloqua hinzuzufügen:
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 8-row-3 9-row-3 10-row-3 Quellfeld Zielfeld Obligatorisch IdentityMap: Eid
Identity: EloquaId
Ja xdm: personalEmail.address
Attribute: emailAddress
Ja xdm: personName.firstName
Attribute: firstName
xdm: personName.lastName
Attribute: lastName
xdm: workAddress.street1
Attribute: address1
xdm: workAddress.street2
Attribute: address2
xdm: workAddress.street3
Attribute: address3
xdm: workAddress.postalCode
Attribute: postalCode
xdm: workAddress.country
Attribute: country
xdm: workAddress.city
Attribute: city
-
Nachfolgend finden Sie ein Beispiel mit den oben genannten Zuordnungen:
-
- Die im Feld "" angegebenen Attribute genau so benannt werden, wie sie im Create a contact angegeben sind, 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 Oracle Eloqua nicht korrekt ist, führt dies zu einem Fehler. Sie können beispielsweise das Feld Source, Namespace-
contact key
,ABC ID
usw. zuordnen. nach Zielfeld :EloquaId
, nachdem sichergestellt wurde, dass die ID-Werte dem Format entsprechen, das von Oracle Eloqua akzeptiert wird. - Die
EloquaID
Zuordnung ist obligatorisch, um Attribute zu aktualisieren, die der Identität entsprechen. - Die
emailAddress
Zuordnung ist erforderlich. Ohne sie gibt die API einen Fehler aus, wie unten dargestellt:
code language-json |
---|
|
Wenn Sie mit dem Eingeben der Zuordnungen für Ihre Zielverbindung fertig sind, klicken Sie auf Weiter.
Überprüfen des Datenexports exported-data
Gehen Sie wie folgt vor, um zu überprüfen, ob Sie das Ziel korrekt eingerichtet haben:
-
Wählen Sie Ziele > Durchsuchen aus und navigieren Sie zur Liste der Ziele.
-
Wählen Sie als Nächstes das Ziel aus, wechseln Sie zur Registerkarte Aktivierungsdaten und wählen Sie dann einen Zielgruppennamen aus.
-
Überwachen Sie die Zielgruppenzusammenfassung und stellen Sie sicher, dass die Anzahl der Profile der Anzahl innerhalb des Segments entspricht.
-
Melden Sie sich bei der Oracle Eloqua-Website an und navigieren Sie dann zur Seite Kontaktübersicht, um zu überprüfen, ob die Profile aus der Audience hinzugefügt wurden. Um den Zielgruppenstatus anzuzeigen, gehen Sie zu einer Seite Kontaktdetails und überprüfen Sie, ob das Kontaktfeld mit dem ausgewählten Zielgruppennamen als Präfix erstellt wurde.
Screenshot der Benutzeroberfläche von
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.
Fehler und Fehlerbehebung errors-and-troubleshooting
Beim Erstellen des Ziels erhalten Sie möglicherweise eine der folgenden Fehlermeldungen: 400: There was a validation error
oder 400 BAD_REQUEST
. Dies geschieht, wenn Sie das Limit von 250 benutzerdefinierten Kontaktfeldern überschreiten, wie im Abschnitt Leitplanken beschrieben. Um diesen Fehler zu beheben, stellen Sie sicher, dass Sie das Limit für benutzerdefinierte Kontaktfelder in Oracle Eloqua nicht überschreiten.
Auf den Seiten Oracle Eloqua HTTP-StatusCodes und Oracle Eloqua Validierungsfehler finden Sie eine umfassende Liste von Status- und Fehler-Codes mit Erläuterungen.
Zusätzliche Ressourcen additional-resources
Weitere Informationen finden Sie in der Oracle Eloqua:
Änderungsprotokoll
In diesem Abschnitt werden aktualisierte Funktionen und wesentliche Dokumentationsänderungen für diesen Ziel-Connector erfasst.
table 0-row-3 1-row-3 2-row-3 layout-auto | ||
---|---|---|
Veröffentlichungsmonat | Art der Aktualisierung | Beschreibung |
April 2023 | Dokumentation aktualisieren |
|
März 2023 | Erstmalige Veröffentlichung | Erstmalige Zielveröffentlichung und Dokumentation. |