(API) Oracle Eloqua verbinding

Oracle Eloqualaat marketers toe om campagnes te plannen en uit te voeren terwijl het leveren van een gepersonaliseerde klantenervaring voor hun vooruitzichten. Dankzij geïntegreerd beheer van leads en het eenvoudig maken van campagnes, kunnen marketers op het juiste moment het juiste publiek betrekken bij de reis van hun koper en schalen ze elegant om het publiek te bereiken via verschillende kanalen, zoals e-mail, display, search, video en mobile. Verkoopteams kunnen meer deals sluiten in een sneller tempo, waardoor het marketingrendement toeneemt dankzij realtime inzicht.

Dit Adobe Experience Platform doelhefboomwerkingen werkt een contactverrichting van Oracle Eloqua REST API bij, die u toestaat om identiteiten binnen een publiek in Oracle Eloqua bij te werken.

Oracle Eloqua gebruikt Basisauthentificatieom met Oracle Eloqua REST API te communiceren. De instructies om aan uw Oracle Eloqua instantie voor authentiek te verklaren zijn verder hieronder, in voor authentiek verklaren aan bestemmingssectie.

Gebruiksscenario’s use-cases

De marketingafdeling van een onlineplatform wil een marketingcampagne op basis van e-mail uitzenden naar een publiek met nieuwsberichten. Het marketingteam van het platform kan bestaande informatie over leads bijwerken via Adobe Experience Platform, een publiek opbouwen op basis van hun eigen offline gegevens en deze soorten publiek doorsturen naar Oracle Eloqua , die vervolgens kan worden gebruikt om de marketingcampagne per e-mail te verzenden.

Vereisten prerequisites

Voorwaarden voor Experience Platforms prerequisites-in-experience-platform

Alvorens gegevens aan de Oracle Eloqua bestemming te activeren, moet u a schema, a datasethebben, en segmentendie in Experience Platform worden gecreeerd.

Verwijs naar de documentatie van het Experience Platform voor het schemagroep van de Details van het Lidmaatschap van het Publiekals u begeleiding op publiekstoestanden nodig hebt.

Oracle Eloqua voorwaarden prerequisites-destination

Als u gegevens wilt exporteren van Platform naar uw Oracle Eloqua -account, hebt u een Oracle Eloqua -account nodig.

Bovendien, moet u, bij een minimum, "Geavanceerde Gebruikers - de toestemmingen van de Marketing" voor uw Oracle Eloqua instantie. Verwijs naar de "Groepen van de Veiligheid" sectie op de Beveiligde gebruikerstoegangpagina voor begeleiding. De toegang wordt vereist door de bestemming programmatically uw basis URLbepalen wanneer het aanhalen van Oracle Eloqua API.

Oracle Eloqua gebruikersgegevens verzamelen gather-credentials

Noteer de onderstaande items voordat u de verificatie uitvoert naar het doel van Oracle Eloqua :

Credentials
Beschrijving
Company Name
De bedrijfsnaam die aan uw Oracle Eloqua account is gekoppeld.
u zult later Company Name en Oracle Eloqua Username als samengevoegde koord gebruiken dat als Username moet worden gebruikt wanneer voor authentiek verklaren aan de bestemming.
Username
De gebruikersnaam van uw Oracle Eloqua -account.
Password
Het wachtwoord van uw Oracle Eloqua -account.
Pod
Oracle Eloqua ondersteunt meerdere datacenters, elk met een unieke domeinnaam. Oracle Eloqua noemt deze als "pods", er zijn momenteel zeven in totaal - p01, p02, p03, p04, p06, p07 en p08. Als u wilt weten welke POD u hebt ingeschakeld, meldt u zich aan bij Oracle Eloqua en noteert u de URL in uw browser nadat u zich met succes hebt aangemeld. Als de URL van uw browser bijvoorbeeld secure.p01.eloqua.com is, pod is p01 . Verwijs naar bepalend uw PODpagina voor extra begeleiding.

Verwijs naar het Ondertekenen binnen aan Oracle Eloquavoor begeleiding.

Guardrails guardrails

NOTE
  • Oracle Eloqua aangepaste contactvelden worden automatisch gemaakt met de namen van het publiek dat tijdens de stap Select segments is geselecteerd.
  • Oracle Eloqua heeft een maximale limiet van 250 aangepaste contactvelden.

  • Voordat u nieuwe doelgroepen exporteert, moet u ervoor zorgen dat het aantal doelgroepen van het platform en het aantal bestaande doelgroepen binnen Oracle Eloqua deze limiet niet overschrijden.

  • Als deze limiet wordt overschreden, treedt er een fout op in het Experience Platform. Dit is omdat Oracle Eloqua API er niet in slaagt om het verzoek te bevestigen, en met a - 400 antwoordt: Er was een bevestigingsfout - foutenmelding beschrijvend de kwestie.

  • Als u de hierboven opgegeven limiet hebt bereikt, moet u bestaande toewijzingen verwijderen van uw bestemming en de bijbehorende aangepaste contactvelden in uw Oracle Eloqua -account verwijderen voordat u meer segmenten kunt exporteren.

  • Verwijs naar Oracle Eloqua Creërend de pagina van de Gebieden van het Contactvoor informatie over extra grenzen.

Ondersteunde identiteiten supported-identities

Oracle Eloqua ondersteunt het bijwerken van de identiteiten die in de onderstaande tabel worden beschreven. Leer meer over identiteiten.

Doelidentiteit
Beschrijving
Verplicht
EloquaId
Unieke id van het contact.
Ja

Type en frequentie exporteren export-type-frequency

Raadpleeg de onderstaande tabel voor informatie over het exporttype en de exportfrequentie van de bestemming.

Item
Type
Notities
Exporttype
Profile-based
  • U exporteert alle leden van een segment samen met de gewenste schemavelden (bijvoorbeeld: e-mailadres, telefoonnummer, achternaam) volgens uw veldtoewijzing.
  • Voor elk geselecteerd publiek in Platform, wordt de overeenkomstige Oracle Eloqua segmentstatus bijgewerkt met zijn publieksstatus van Platform.
Exportfrequentie
Streaming
  • Streaming doelen zijn "altijd aan" API-verbindingen. Zodra een profiel in Experience Platform wordt bijgewerkt dat op publieksevaluatie wordt gebaseerd, verzendt de schakelaar de update stroomafwaarts naar het bestemmingsplatform. Lees meer over het stromen bestemmingen.

Verbinden met de bestemming connect

IMPORTANT
Om met de bestemming te verbinden, hebt u View Destinations en Manage Destinations toegangsbeheertoestemmingennodig. Lees het overzicht van de toegangscontroleof contacteer uw productbeheerder om de vereiste toestemmingen te verkrijgen.

Om met deze bestemming te verbinden, volg de stappen die in het leerprogramma van de bestemmingsconfiguratieworden beschreven. In vormen bestemmingswerkschema, vul de gebieden in die in de twee hieronder secties worden vermeld.

Kies in Destinations > Catalog Zoeken naar (API) Oracle Eloqua . U kunt de locatie ook in de categorie Email Marketing vinden.

Verifiëren voor bestemming authenticate

Vul de vereiste velden hieronder in. Verwijs naar de Gather Oracle Eloqua geloofsbrievensectie voor om het even welke begeleiding.

  • Password: Het wachtwoord van uw Oracle Eloqua -account.
  • Username: Een samengevoegde tekenreeks die bestaat uit uw Oracle Eloqua bedrijfsnaam en de Oracle Eloqua gebruikersnaam.
    de samengevoegde waarde neemt de vorm van {COMPANY_NAME}\{USERNAME}.
    Opmerking: gebruik geen accolades of spaties en zorg dat de \ behouden blijft.
    Bijvoorbeeld als uw Oracle Eloqua Bedrijfsnaam MyCompany is en Oracle Eloqua Gebruikersnaam Username is, is de samengevoegde waarde u in het Username gebied zult gebruiken MyCompany\Username.

Selecteer Connect to destination als u wilt verifiëren bij het doel.
{het schermschot van het platform UI die tonen hoe te voor authentiek te verklaren.

Als de opgegeven gegevens geldig zijn, geeft de gebruikersinterface de status Connected weer met een groen vinkje. Vervolgens kunt u verdergaan met de volgende stap.

Doelgegevens invullen destination-details

Als u details voor de bestemming wilt configureren, vult u de vereiste en optionele velden hieronder in. Een sterretje naast een veld in de gebruikersinterface geeft aan dat het veld verplicht is.
{het schermschot van het platform UI die de bestemmingsdetails toont.

  • Name: Een naam waarmee u dit doel in de toekomst herkent.
  • Description: Een beschrijving die u zal helpen deze bestemming in de toekomst identificeren.
  • Pod: Als u wilt weten welke pod u bent ingeschakeld, meldt u zich aan bij Oracle Eloqua en noteert u de URL in uw browser nadat u zich hebt aangemeld. Als de URL van uw browser bijvoorbeeld secure.p01.eloqua.com is, moet u de waarde pod selecteren p01 . Verwijs naar de Gather Oracle Eloqua geloofsbrievensectie voor extra begeleiding.

Waarschuwingen inschakelen enable-alerts

U kunt alarm toelaten om berichten over de status van dataflow aan uw bestemming te ontvangen. Selecteer een waarschuwing in de lijst om u te abonneren op meldingen over de status van uw gegevensstroom. Voor meer informatie over alarm, zie de gids bij het intekenen aan bestemmingsalarm gebruikend UI.

Wanneer u klaar bent met het opgeven van details voor uw doelverbinding, selecteert u Next .

Soorten publiek naar dit doel activeren activate

IMPORTANT

Lees activeer profielen en publiek aan het stromen publiek uitvoerbestemmingenvoor instructies bij het activeren van publiek aan deze bestemming.

Afbeeldingsoverwegingen en voorbeeld mapping-considerations-example

Als u uw publieksgegevens correct vanuit Adobe Experience Platform naar de Oracle Eloqua -bestemming wilt verzenden, moet u de stap voor veldtoewijzing doorlopen. Toewijzing bestaat uit het maken van een koppeling tussen de schemavelden van uw Experience Data Model (XDM) in uw Platform-account en de bijbehorende equivalenten van de doelbestemming.

Voer de volgende stappen uit om uw XDM-velden toe te wijzen aan de Oracle Eloqua -doelvelden:

  1. Selecteer Add new mapping in de stap Mapping . Er verschijnt een nieuwe toewijzingsrij op het scherm.

  2. Kies in het venster Select source field de categorie Select attributes en selecteer het XDM-kenmerk of kies de categorie Select identity namespace en selecteer een identiteit.

  3. Kies in het venster Select target field de optie Select identity namespace en selecteer een identiteit of kies Select custom attributes en typ in het veld Attribute name de gewenste kenmerknaam. De kenmerknaam die u opgeeft, moet overeenkomen met een bestaand contactkenmerk in Oracle Eloqua . Zie create a contactvoor de nauwkeurige attributennamen die u in Oracle Eloqua kunt gebruiken.

    • Herhaal deze stappen om de vereiste en gewenste kenmerktoewijzingen toe te voegen tussen uw XDM-profielschema en Oracle Eloqua :

      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
      Source-veld Doelveld Verplicht
      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
    • Hieronder ziet u een voorbeeld met de bovenstaande toewijzingen:

      het schermschot van het Platform UI met attributenafbeeldingen.

IMPORTANT
  • Attributen die in Target field worden gespecificeerd zouden precies zoals die in Create a contact worden gespecificeerdmoeten worden genoemd aangezien deze attributen verzoeklichaam zullen vormen.
  • Kenmerken die in Source field worden opgegeven, volgen een dergelijke beperking niet. U kunt deze toewijzen op basis van uw behoefte, maar als de gegevensindeling niet correct is wanneer u naar Oracle Eloqua wordt geduwd, resulteert dit in een fout. U kunt bijvoorbeeld de naamruimte Source field identity contact key , ABC ID enz. toewijzen. to Target field : EloquaId zorgt u ervoor dat de id-waarden overeenkomen met de indeling die wordt geaccepteerd door Oracle Eloqua .
  • De toewijzing EloquaID is verplicht om kenmerken bij te werken die overeenkomen met de identiteit.
  • De toewijzing emailAddress is vereist. Zonder deze API genereert de API een fout zoals hieronder wordt weergegeven:
code language-json
{
     "type":"ObjectValidationError",
     "container":{
           "type":"ObjectKey",
           "objectType":"Contact"
     },
     "property":"emailAddress",
     "requirement":{
           "type":"EmailAddressRequirement"
     },
     "value":"<null>"
}

Wanneer u klaar bent met het opgeven van de toewijzingen voor uw doelverbinding, selecteert u Next .

NOTE
Het doel plaatst automatisch een unieke id achter de geselecteerde publieksnamen bij elke uitvoering wanneer de gegevens van het contactveld naar Oracle Eloqua worden verzonden. Dit zorgt ervoor dat de namen van de contactgebieden die overeenkomen met uw publieksnamen elkaar niet overlappen. Verwijs naar de uitvoer van gegevensvan het sectiescherm van een Oracle Eloqua pagina van de Details van het Contact met het gebied van het douanecontact dat gebruikend de publieksnamen wordt gecreeerd bevestigen.

Gegevens exporteren valideren exported-data

Volg onderstaande stappen om te controleren of u de bestemming correct hebt ingesteld:

  1. Selecteer Destinations > Browse en navigeer naar de lijst met doelen.

  2. Selecteer vervolgens het doel en schakel over naar het tabblad Activation data en selecteer een publieksnaam.
    het schermschot van het Platform UI die de Gegevens van de Activering van Doelen toont.

  3. Controleer het publieksoverzicht en zorg ervoor dat de telling van profielen aan de telling binnen het segment beantwoordt.
    het schermschot van het Platform UI die Segment toont.

  4. Meld u aan bij de Oracle Eloqua -website en navigeer naar de Contacts Overview -pagina om te controleren of de profielen van het publiek zijn toegevoegd. Blader omlaag naar een Contact Detail -pagina en controleer of het contactveld met de naam van het geselecteerde publiek als voorvoegsel is gemaakt om de publieksstatus weer te geven.

{het schermschot UI van het Oracle Eloqua die de pagina van de Details van het Contact met het gebied van het douanecontract toont met de publieksnaam wordt gecreeerd.

Gegevensgebruik en -beheer data-usage-governance

Alle Adobe Experience Platform -doelen zijn compatibel met het beleid voor gegevensgebruik bij het verwerken van uw gegevens. Voor gedetailleerde informatie over hoe Adobe Experience Platform gegevensbeheer afdwingt, zie het overzicht van het Beleid van Gegevens.

Fouten en problemen oplossen errors-and-troubleshooting

Wanneer u het doel maakt, ontvangt u mogelijk een van de volgende foutberichten: 400: There was a validation error of 400 BAD_REQUEST . Dit gebeurt wanneer u de 250 grens van de gebieden van het douanecontact overschrijdt, zoals die in de wordt beschreven guardrailssectie. U kunt deze fout verhelpen door de limiet van het aangepaste contactveld in Oracle Eloqua niet te overschrijden.
{het schermschot van het platform UI die fout toont.

Verwijs naar de Oracle Eloqua de statuscodes van HTTPen Oracle Eloqua fouten van de Bevestigingpagina's voor een uitvoerige lijst van status en foutencodes met verklaringen.

Aanvullende bronnen additional-resources

Zie de documentatie van Oracle Eloqua voor meer informatie:

Changelog

Deze sectie vangt de functionaliteit en de significante documentatieupdates aan deze bestemmingsschakelaar worden aangebracht die.

Wijzigingen weergeven
table 0-row-3 1-row-3 2-row-3 layout-auto
Releasedatum Type bijwerken Beschrijving
April 2023 Documentatie bijwerken
  • Wij hebben de gebruik-gevallensectie met een duidelijker voorbeeld bijgewerkt van wanneer de klanten van het gebruiken van deze bestemming zouden profiteren.
  • Wij hebben de afbeeldingsectie met duidelijke voorbeelden van zowel verplichte als facultatieve afbeeldingen bijgewerkt.
  • Wij hebben bijgewerkt verbind met de bestemmingssectie met een voorbeeld op hoe te om de samengevoegde waarde voor het Username gebied te construeren gebruikend de Oracle Eloqua Naam van het Bedrijf en Oracle Eloqua Gebruikersnaam. (PLATIR-28343)
  • Wij hebben de Oracle Eloqua geloofsbrieven 🔗 van de Vergroting bijgewerkt en vullen in de secties van bestemmingsdetailsmet begeleiding op Oracle Eloqua Pod selectie. De "Pod" waarde wordt gebruikt door de bestemming om de basis URL voor de API vraag te construeren. De Oracle Eloqua eerste vereistensectie werd ook bijgewerkt met begeleiding bij het toewijzen van "Geavanceerde Gebruikers - de toestemmingen van de Marketing" als vereiste "Groepen van de Veiligheid" voor uw Oracle Eloqua instantie.
Maart 2023 Eerste release Oorspronkelijke doelversie en documentatie publiceren.
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6