(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 :
Company Name
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
Password
Pod
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
- 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.
EloquaId
Type en frequentie exporteren export-type-frequency
Raadpleeg de onderstaande tabel voor informatie over het exporttype en de exportfrequentie van de bestemming.
- 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.
- 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
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 BedrijfsnaamMyCompany
is en Oracle Eloqua GebruikersnaamUsername
is, is de samengevoegde waarde u in het Username gebied zult gebruikenMyCompany\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 bijvoorbeeldsecure.p01.eloqua.com
is, moet u de waardepod
selecterenp01
. 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
-
Om gegevens te activeren, hebt u View Destinations, Activate Destinations, View Profiles, en View Segments toegangsbeheertoestemmingennodig. Lees het overzicht van de toegangscontroleof contacteer uw productbeheerder om de vereiste toestemmingen te verkrijgen.
-
Om identiteiten uit te voeren, hebt u de View Identity Graph toegangsbeheertoestemmingnodig.
{width="100" modal="regular"}
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:
-
Selecteer Add new mapping in de stap Mapping . Er verschijnt een nieuwe toewijzingsrij op het scherm.
-
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.
-
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:
-
- 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 |
---|
|
Wanneer u klaar bent met het opgeven van de toewijzingen voor uw doelverbinding, selecteert u Next .
Gegevens exporteren valideren exported-data
Volg onderstaande stappen om te controleren of u de bestemming correct hebt ingesteld:
-
Selecteer Destinations > Browse en navigeer naar de lijst met doelen.
-
Selecteer vervolgens het doel en schakel over naar het tabblad Activation data en selecteer een publieksnaam.
-
Controleer het publieksoverzicht en zorg ervoor dat de telling van profielen aan de telling binnen het segment beantwoordt.
-
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.
table 0-row-3 1-row-3 2-row-3 layout-auto | ||
---|---|---|
Releasedatum | Type bijwerken | Beschrijving |
April 2023 | Documentatie bijwerken |
|
Maart 2023 | Eerste release | Oorspronkelijke doelversie en documentatie publiceren. |