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

Diese Adobe Experience Platform Ziel nutzt die Kontakt aktualisieren Vorgang von Oracle Eloqua REST-API, mit der Sie Identitäten aktualisieren innerhalb einer Zielgruppe in Oracle Eloqua.

Oracle Eloqua uses Grundlegende Authentifizierung zur Kommunikation mit dem Oracle Eloqua REST-API. Anweisungen zur Authentifizierung bei Ihrer Oracle Eloqua-Instanz sehen Sie weiter unten im Abschnitt Authentifizieren bei Ziel.

Anwendungsbeispiele

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 senden Oracle Eloqua, die dann zum Versand der E-Mail-Adresse der Marketing-Kampagne verwendet werden kann.

Voraussetzungen

Voraussetzungen für 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 Platform-Dokumentation für Feldergruppe Zielgruppenzugehörigkeitsdetails wenn Sie Anleitungen zum Zielgruppenstatus benötigen.

Voraussetzungen für Oracle Eloqua

So exportieren Sie Daten von Platform in Ihre Oracle Eloqua -Konto, für das Sie eine Oracle Eloqua -Konto.

Darüber hinaus benötigen Sie mindestens die Variable "Erweiterte Benutzer - Marketing-Berechtigungen" für Ihre Oracle Eloqua -Instanz. Siehe Abschnitt "Sicherheitsgruppen" im Abschnitt Sicherer Benutzerzugriff -Seite für Anleitungen. Der Zugriff ist für das Ziel erforderlich, um programmgesteuert die Basis-URL bestimmen beim Aufrufen der Oracle Eloqua API.

Sammeln von Oracle Eloqua-Anmeldeinformationen

Beachten Sie die folgenden Elemente, bevor Sie sich bei der Oracle Eloqua Ziel:

Siehe Abschnitt Anmelden bei Oracle Eloqua für Leitlinien.

Leitplanken

• Oracle Eloqua hat eine maximale Anzahl von 250 benutzerdefinierten Kontaktfeldern.

• Stellen Sie vor dem Export neuer Zielgruppen sicher, dass die Anzahl der Platform-Zielgruppen und die Anzahl der vorhandenen Zielgruppen in Oracle Eloqua diese Grenze nicht überschreiten.

• Wenn diese Grenze überschritten wird, tritt beim Experience Platform ein Fehler auf. Dies liegt daran, dass die Variable Oracle Eloqua Die API kann die Anfrage nicht validieren und antwortet mit einem - 400: Validierungsfehler - Fehlermeldung, die das Problem beschreibt.

• Wenn Sie die oben angegebene Grenze erreicht haben, müssen Sie vorhandene Zuordnungen aus Ihrem Ziel entfernen und die entsprechenden benutzerdefinierten Kontaktfelder in Ihrem Oracle Eloqua , bevor Sie weitere Segmente exportieren können.

• Siehe Abschnitt Oracle Eloqua Erstellen von Kontaktfeldern Seite mit Informationen zu zusätzlichen Beschränkungen.

Unterstützte Identitäten

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

Beziehen Sie sich auf die folgende Tabelle, um Informationen zu Typ und Häufigkeit des Zielexports zu erhalten.

Herstellen einer Verbindung mit dem Ziel

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 sie unter der E-Mail-Marketing Kategorie.

Beim Ziel authentifizieren

Füllen Sie die erforderlichen Felder aus. Eine Anleitung dazu finden Sie im Abschnitt Oracle Eloqua Sammeln von -Anmeldeinformationen.

• Passwort: Das Kennwort Ihres Oracle Eloqua -Konto.
• Benutzername: Eine verkettete Zeichenfolge aus Ihrem Oracle Eloqua Firmenname und Oracle Eloqua Benutzername.
  Der verkettete Wert hat die Form {COMPANY_NAME}\{USERNAME}.
  Beachten Sie, dass Sie keine Leerzeichen oder Leerzeichen verwenden und die \.
  Beispiel: Wenn Oracle Eloqua Firmenname ist MyCompany und Oracle Eloqua Benutzername ist Username, der verkettete Wert, den Sie im Benutzername Feld ist 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

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: So erhalten Sie welche pod Sie sind auf, melden Sie sich bei Oracle Eloqua und beachten Sie die URL in Ihrem Browser, nachdem Sie sich erfolgreich angemeldet haben. Wenn Ihre Browser-URL beispielsweise secure.p01.eloqua.com die pod Wert, den Sie auswählen müssen, ist p01. Siehe Abschnitt Gather Oracle Eloqua Anmeldeinformationen für zusätzliche Anleitungen.

Aktivieren von Warnhinweisen

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

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

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 jeweiligen Entsprechungen vom Ziel zu erstellen.

So ordnen Sie Ihre XDM-Felder dem Oracle Eloqua Führen Sie die folgenden Schritte aus:

1. Wählen Sie Im Schritt Zuordnung die Option Neue Zuordnung hinzufügen aus. Auf dem Bildschirm wird eine neue Zuordnungszeile angezeigt.
2. Im Quellfeld auswählen Fenster, wählen Sie die Attribute auswählen und wählen Sie das XDM-Attribut oder die Identitäts-Namespace auswählen und wählen Sie eine Identität.
3. Im Zielgruppenfeld auswählen auswählen Identitäts-Namespace auswählen und wählen Sie eine Identität aus oder wählen Sie Benutzerdefinierte Attribute auswählen und geben Sie den gewünschten Attributnamen in die Attributname -Feld. Der Attributname, den Sie angeben, sollte mit dem vorhandenen Kontaktattribut in Oracle Eloqua. Siehe create a contact für die genauen Attributnamen, die Sie in Oracle Eloqua.

   • Wiederholen Sie diese Schritte, um sowohl die erforderlichen als auch alle gewünschten Attributzuordnungen zwischen Ihrem XDM-Profilschema und Oracle Eloqua: | Quellfeld | Zielfeld | Erforderlich | |—|—|—| |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 aufgeführten Zuordnungen:

     

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

Wenn Sie mit der Bereitstellung der Zuordnungen für Ihre Zielverbindung fertig sind, wählen Sie Nächste.

Überprüfen des Datenexports

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

1. Auswählen Ziele > Durchsuchen und navigieren Sie zur Liste der Ziele.

2. Wählen Sie als Nächstes das Ziel aus und wechseln Sie zur Aktivierungsdaten und wählen Sie einen Zielgruppennamen aus.
   

3. Überwachen Sie die Zielgruppenzusammenfassung und stellen Sie sicher, dass die Anzahl der Profile der Anzahl innerhalb des Segments entspricht.
   

4. Melden Sie sich bei Oracle Eloqua Website und navigieren Sie dann zur Kontaktübersicht -Seite, um zu überprüfen, ob die Profile aus der Audience hinzugefügt wurden. Um den Zielgruppenstatus anzuzeigen, führen Sie einen Drilldown in eine Kontaktdetails und überprüfen Sie, ob das Kontaktfeld mit dem ausgewählten Zielgruppennamen als Präfix erstellt wurde.

Datennutzung und -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

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 Abschnitt. Um diesen Fehler zu beheben, dürfen Sie die benutzerdefinierte Feldbegrenzung in Oracle Eloqua.

Siehe Abschnitt Oracle Eloqua HTTP-Statuscodes und Oracle Eloqua Validierungsfehler Seiten für eine umfassende Liste von Status- und Fehlercodes mit Erklärungen.

Zusätzliche Ressourcen

Weitere Informationen finden Sie im Abschnitt Oracle Eloqua Dokumentation:

• Oracle Eloqua Marketing Automation
• REST-API für Oracle Eloqua Marketing Cloud Service

Änderungsprotokoll

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