(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 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 senden Oracle Eloqua, die dann zum Versand 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.

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 prerequisites-destination

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 gather-credentials

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

Anmeldedaten
Beschreibung
Company Name
Der mit Ihrer Oracle Eloqua -Konto.
Sie verwenden später die Company Name und Oracle Eloqua Username als verkettete Zeichenfolge, die als Benutzername when beim Ziel authentifizieren.
Username
Der Benutzername Ihres Oracle Eloqua -Konto.
Password
Das Kennwort Ihres Oracle Eloqua -Konto.
Pod
Oracle Eloqua unterstützt mehrere Rechenzentren mit jeweils einem eindeutigen Domänennamen. Oracle Eloqua bezeichnet diese als "Pods", es gibt derzeit insgesamt sieben - p01, p02, p03, p04, p06, p07 und p08. Um zu erfahren, welchen POD Sie verwenden, melden Sie sich bei an. 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 Ihre pod is p01. Siehe Abschnitt Bestimmen Ihres POD für zusätzliche Anleitungen.

Siehe Abschnitt Anmelden bei Oracle Eloqua für Leitlinien.

Leitplanken guardrails

NOTE
  • Oracle Eloqua Benutzerdefinierte Kontaktfelder werden automatisch unter Verwendung der Namen der Zielgruppen erstellt, die während der Segmente auswählen Schritt.
  • 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 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 die entsprechende Oracle Eloqua Der Segmentstatus wird mit dem Zielgruppenstatus von 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 zum Ziel herzustellen, benötigen Sie die 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 sie unter der E-Mail-Marketing Kategorie.

Beim Ziel authentifizieren authenticate

Füllen Sie die erforderlichen Felder aus. Siehe Abschnitt Gather Oracle Eloqua Anmeldeinformationen für Hinweise.

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

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.

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 | 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 aufgeführten Zuordnungen:

      Screenshot der Platform-Benutzeroberfläche mit Attributzuordnungen.

IMPORTANT
  • In der Variablen Zielfeld sollte genau wie in der Variablen Create a contact da diese Attribute den Anfrageinhalt bilden.
  • In der Variablen Quellfeld keine solchen Einschränkungen befolgen. Sie können sie jedoch nach Bedarf zuordnen, wenn das Datenformat beim Senden an Oracle Eloqua wird ein Fehler ausgegeben. Sie können beispielsweise die Quellfeld Identitäts-Namespace contact key, ABC ID usw. nach Zielfeld : EloquaId nachdem sichergestellt wurde, dass die ID-Werte mit dem Format übereinstimmen, das von Oracle Eloqua.
  • Die EloquaID -Zuordnung ist erforderlich, um Attribute zu aktualisieren, die der Identität entsprechen.
  • Die emailAddress -Zuordnung erforderlich. Andernfalls 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 der Bereitstellung der Zuordnungen für Ihre Zielverbindung fertig sind, wählen Sie Nächste.

NOTE
Bei jeder Ausführung fügt das Ziel den ausgewählten Zielgruppennamen automatisch eine eindeutige Kennung hinzu, wenn die Kontaktinformationen an Oracle Eloqua. Dadurch wird sichergestellt, dass sich die Kontaktfeldnamen, die Ihren Zielgruppennamen entsprechen, nicht überschneiden. Siehe Abschnitt Datenexport überprüfen Screenshot-Beispiel eines Abschnitts Oracle Eloqua Kontaktinformationen-Seite mit benutzerdefiniertem Kontaktfeld, das 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. 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.
    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 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.

Oracle Eloqua UI-Screenshot mit der Seite Kontaktdetailsmit dem benutzerdefinierten Kontaktfeld, 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 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.
Screenshot der Platform-Benutzeroberfläche mit Fehlermeldung.

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 additional-resources

Weitere Informationen finden Sie im Abschnitt Oracle Eloqua Dokumentation:

Ä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 Aktualisierung der Dokumentation
  • Wir haben die Anwendungsfälle mit einem klareren Beispiel dafür, wann Kunden von der Verwendung dieses Ziels profitieren würden.
  • Wir haben die Mapping mit klaren Beispielen für obligatorische und optionale Zuordnungen.
  • Wir haben die Mit Ziel verbinden -Abschnitt mit einem Beispiel zum Erstellen des verketteten Werts für die Benutzername -Feld mithilfe des Oracle Eloqua Firmenname und Oracle Eloqua Benutzername. (PLATIR-28343)
  • Wir haben die Gather Oracle Eloqua Anmeldeinformationen und Zieldetails ausfüllen Abschnitte mit Anleitungen Oracle Eloqua Pod auswählen. Die "Pod" -Wert wird vom Ziel verwendet, um die Basis-URL für die API-Aufrufe zu erstellen. Die Oracle Eloqua Voraussetzungen wurde auch mit Anleitungen zum Zuweisen von "Erweiterte Benutzer - Marketing-Berechtigungen" als erforderlich "Sicherheitsgruppen" für Ihre Oracle Eloqua -Instanz.
März 2023 Erstmalige Veröffentlichung Erste Zielversion und Veröffentlichung der Dokumentation.
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6