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

Anmeldedaten
Beschreibung
Company Name
Der mit Ihrem Oracle Eloqua-Konto verknüpfte Firmenname.
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
Der Benutzername Ihres Oracle Eloqua.
Password
Das Kennwort Ihres Oracle Eloqua Kontos.
Pod
Oracle Eloqua unterstützt mehrere Rechenzentren mit jeweils einem eindeutigen Domain-Namen. Oracle Eloqua bezeichnet diese als „Pods“, es gibt derzeit insgesamt sieben - P01, P02, P03, P04, P06, P07 und P08. 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 beispielsweise 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

NOTE
  • 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.

Ziel-Identität
Beschreibung
Obligatorisch
EloquaId
Eindeutige Kennung des Kontakts.
Ja

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.

Element
Typ
Anmerkungen
Exporttyp
Profilbasiert
  • 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.
Exporthäufigkeit
Streaming
  • 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

IMPORTANT
Um eine Verbindung mit dem Ziel herzustellen, benötigen Sie Ziele anzeigen und Ziele verwalten Zugriffssteuerungsberechtigungen. Lesen Sie die Zugriffskontrolle – Übersicht oder wenden Sie sich an Ihren Produktadministrator, um die erforderlichen Berechtigungen zu erhalten.

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 beispielsweise MyCompany und Oracle Eloqua Benutzername Username 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.
Screenshot der Platform-Benutzeroberfläche, auf dem die Authentifizierung gezeigt wird.

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.
Screenshot der Platform-Benutzeroberfläche mit den Zieldetails.

  • 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 beispielsweise secure.p01.eloqua.com ist, müssen Sie den pod Wert p01 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

IMPORTANT
  • Zum Aktivieren von Daten benötigen Sie die Berechtigungen Ziele anzeigen, Ziele aktivieren, Profile anzeigen und Segmente anzeigenZugriffssteuerung. 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.

    Wählen Sie einen im Workflow hervorgehobenen Identity-Namespace aus, um Zielgruppen für Ziele zu aktivieren. {width="100" modal="regular"}

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:

  1. Wählen Sie Im Schritt Zuordnung die Option Neue Zuordnung hinzufügen aus. Auf dem Bildschirm wird eine neue Zuordnungszeile angezeigt.

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

  3. 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:

      Beispiel-Screenshot der Platform-Benutzeroberfläche mit Attributzuordnungen.

IMPORTANT
  • 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
{
     "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.

NOTE
Das Ziel fügt bei jeder Ausführung automatisch eine eindeutige Kennung zu den ausgewählten Zielgruppennamen hinzu, wenn die Kontaktfeldinformationen an Oracle Eloqua gesendet werden. Dadurch wird sichergestellt, dass sich die Namen der Kontaktfelder, die Ihren Zielgruppennamen entsprechen, nicht überschneiden. Siehe den Datenexport validieren Abschnitt Screenshot-Beispiel einer Seite mit Oracle Eloqua Kontaktdetails, auf der ein benutzerdefiniertes Kontaktfeld mithilfe der Zielgruppennamen erstellt wurde.

Überprüfen des Datenexports exported-data

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

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

  2. Wählen Sie als Nächstes das Ziel aus, wechseln Sie zur Registerkarte Aktivierungsdaten und wählen Sie dann einen Zielgruppennamen aus.
    Beispiel-Screenshot der Platform-Benutzeroberfläche mit Daten zur Aktivierung von Zielen.

  3. Überwachen Sie die Zielgruppenzusammenfassung und stellen Sie sicher, dass die Anzahl der Profile der Anzahl innerhalb des Segments entspricht.
    Beispiel-Screenshot der Platform-Benutzeroberfläche mit Segment.

  4. 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 Oracle Eloqua, der die Seite mit den Kontaktdetails mit dem benutzerdefinierten Kontaktfeld zeigt, das mit dem Zielgruppennamen erstellt wurde.

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.
Screenshot der Platform-Benutzeroberfläche mit Fehler.

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.

Änderungsprotokoll anzeigen
table 0-row-3 1-row-3 2-row-3 layout-auto
Veröffentlichungsmonat Art der Aktualisierung Beschreibung
April 2023 Dokumentation aktualisieren
  • Wir haben den Abschnitt Anwendungsfälle mit einem klareren Beispiel dafür aktualisiert, wann Kundinnen und Kunden von der Verwendung dieses Ziels profitieren würden.
  • Der Abschnitt Zuordnung wurde mit klaren Beispielen für obligatorische und optionale Zuordnungen aktualisiert.
  • Der Abschnitt Verbindung zum Ziel herstellen wurde mit einem Beispiel für die Erstellung des verketteten Werts für das Feld Benutzername unter Verwendung des Oracle Eloqua Unternehmensnamens und des Oracle Eloqua Benutzernamens aktualisiert. (PLATIR-28343)
  • Die Abschnitte Sammeln Oracle Eloqua Anmeldeinformationen und Ausfüllen der Zieldetails wurden mit Anleitungen zur Auswahl Oracle Eloqua Pod aktualisiert. Der Pod“-Wert wird vom Ziel verwendet, um die Basis-URL für die API-Aufrufe zu erstellen. Der Abschnitt Oracle Eloqua Voraussetzungen wurde auch mit Anleitungen zum Zuweisen von „Erweiterte Benutzer - Marketing-Berechtigungen“ als erforderliches „Sicherheitsgruppen“ für Ihre Oracle Eloqua-Instanz aktualisiert.
März 2023 Erstmalige Veröffentlichung Erstmalige Zielveröffentlichung und Dokumentation.
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6