(API) Oracle Eloqua-Verbindung

Oracle Eloqua ermöglicht es Marketing-Experten, Kampagnen zu planen und auszuführen und gleichzeitig ein personalisiertes Kundenerlebnis für ihre potenziellen Kunden bereitzustellen. Dank integrierter Lead-Verwaltung und einfacher Kampagnenerstellung können Marketingexperten die richtige Zielgruppe zum richtigen Zeitpunkt auf der Journey ansprechen und elegant skalieren, um Zielgruppen kanalübergreifend zu erreichen, einschließlich E-Mail, Display-Suche, Video und Mobil. Vertriebsteams können mehr Angebote schneller schließen und so den Marketing-ROI durch Echtzeiteinblicke steigern.

Dieses Adobe Experience Platform Ziel nutzt den Vorgang Kontaktaufnahme aktualisieren der Oracle Eloqua REST-API, mit dem Sie Identitäten innerhalb einer Audience in Oracle Eloqua aktualisieren können.

Oracle Eloqua verwendet Grundlegende Authentifizierung 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 Marketingabteilung einer Online-Plattform möchte eine E-Mail-basierte Marketing-Kampagne an eine kuratierte Zielgruppe von Leads senden. Das Marketing-Team der Plattform kann vorhandene Lead-Informationen über Adobe Experience Platform aktualisieren, Zielgruppen aus eigenen Offline-Daten erstellen und diese Zielgruppen an Oracle Eloqua senden, was dann zum Senden der E-Mail-Adresse der Marketing-Kampagne verwendet werden kann.

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.

Informationen zum Zielgruppenstatus finden Sie in der Experience Platform-Dokumentation für die Schemafeldergruppe Zielgruppenzugehörigkeitsdetails .

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.

Zusätzlich benötigen Sie mindestens die "Erweiterte Benutzer - Marketing-Berechtigungen" für Ihre Oracle Eloqua -Instanz. Eine Anleitung dazu finden Sie im Abschnitt "Sicherheitsgruppen" auf der Seite Sicherer Benutzerzugriff . Der Zugriff ist für das Ziel erforderlich, um beim Aufrufen der Oracle Eloqua -API programmgesteuert Ihre Basis-URL zu bestimmen.

Sammeln von Oracle Eloqua-Anmeldedaten gather-credentials

Beachten Sie die folgenden Elemente, bevor Sie sich beim Oracle Eloqua-Ziel authentifizieren:

Eine Anleitung dazu finden Sie unter Anmelden bei 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 ihn unter der Kategorie E-Mail-Marketing finden.

Beim Ziel authentifizieren authenticate

Füllen Sie die erforderlichen Felder aus. Eine Anleitung finden Sie im Abschnitt Anmeldedaten sammeln Oracle Eloqua 2} .

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-Datenmodell (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 die Zuordnungen für Ihre Zielverbindung bereitgestellt haben, wählen Sie Weiter aus.

Überprüfen des Datenexports exported-data

Gehen Sie wie folgt vor, um zu überprüfen, ob Sie das Ziel korrekt eingerichtet haben:

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 die Beschränkung von 250 benutzerdefinierten Kontaktfeldern überschreiten, wie im Abschnitt Limits beschrieben. Um diesen Fehler zu beheben, stellen Sie sicher, dass Sie die Grenze für benutzerdefinierte Kontaktfelder in Oracle Eloqua nicht überschreiten.

Eine umfassende Liste der Status- und Fehlercodes mit Erklärungen finden Sie auf den Seiten Oracle Eloqua HTTP-Status-Codes und Oracle Eloqua Validierungsfehler .

Zusätzliche Ressourcen additional-resources

Weitere Informationen finden Sie in der Dokumentation zu Oracle Eloqua:

Änderungsprotokoll

In diesem Abschnitt werden aktualisierte Funktionen und wesentliche Dokumentationsänderungen für diesen Ziel-Connector erfasst.