(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:

Eine Anleitung finden Sie Abschnitt „Anmelden Oracle Eloqua".

Leitplanken guardrails

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.

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.

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“.

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.

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

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:

{
     "type":"ObjectValidationError",
     "container":{
           "type":"ObjectKey",
           "objectType":"Contact"
     },
     "property":"emailAddress",
     "requirement":{
           "type":"EmailAddressRequirement"
     },
     "value":"<null>"
}

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:

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.