(API) Oracle Eloqua verbinding
Oracle Eloqua laat 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 doel gebruikt de Een contactpersoon bijwerken van de Oracle Eloqua REST API, waarmee u identiteiten bijwerken binnen een publiek in Oracle Eloqua.
Oracle Eloqua gebruik Basisverificatie om te communiceren met Oracle Eloqua REST API. Instructies voor verificatie aan uw Oracle Eloqua de instantie is verder onderaan, in de Verifiëren voor bestemming sectie.
Gebruik hoofdletters 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 doelgroep naar sturen 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
Voordat u gegevens activeert naar de Oracle Eloqua doel, u moet een schema, gegevensset, en segmenten gemaakt in Experience Platform.
Raadpleeg de documentatie bij het Experience Platform voor Publiek Lidmaatschap Details schema groep als u hulp over publieksstatus nodig hebt.
Oracle Eloqua voorwaarden prerequisites-destination
Als u gegevens van Platform naar uw wilt exporteren Oracle Eloqua account die u nodig hebt Oracle Eloqua account.
Bovendien hebt u minimaal de "Advanced Users - Marketing permissions" voor uw Oracle Eloqua -instantie. Zie de "Beveiligingsgroepen" de Beveiligde gebruikerstoegang pagina voor hulp. De toegang wordt vereist door de bestemming programmatically de basis-URL bepalen wanneer het aanroepen van Oracle Eloqua API.
Gather Oracle Eloqua geloofsbrieven gather-credentials
Noteer de onderstaande items voordat u deze verifieert voor de Oracle Eloqua bestemming:
Company Name
U gebruikt later de
Company Name
en Oracle Eloqua Username
als een samengevoegde tekenreeks die als de Username wanneer authenticeren aan de bestemming.Username
Password
Pod
secure.p01.eloqua.com
uw pod
is p01
. Zie de de POD bepalen pagina voor aanvullende instructies.Zie de Aanmelden bij Oracle Eloqua ter begeleiding.
Guardrails guardrails
- Oracle Eloqua aangepaste contactvelden worden automatisch gemaakt met de namen van de doelgroepen die tijdens het Select segments stap.
-
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 komt omdat de Oracle Eloqua API kan de aanvraag niet valideren en reageert met een - 400: Er is een validatiefout opgetreden - foutbericht met een beschrijving van het probleem.
-
Als u de hierboven opgegeven limiet hebt bereikt, moet u bestaande toewijzingen verwijderen uit uw bestemming en de bijbehorende aangepaste contactvelden in uw Oracle Eloqua voordat u meer segmenten kunt exporteren.
-
Zie de Oracle Eloqua Contactvelden maken pagina voor informatie over extra limieten.
Ondersteunde identiteiten supported-identities
Oracle Eloqua ondersteunt het bijwerken van de identiteiten die in de onderstaande tabel worden beschreven. Meer informatie 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), op basis van uw veldtoewijzing.
- Voor elk geselecteerd publiek in Platform, het overeenkomstige Oracle Eloqua de segmentstatus wordt bijgewerkt met de 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. Meer informatie over streaming doelen.
Verbinden met de bestemming connect
Als u verbinding wilt maken met dit doel, voert u de stappen uit die in het dialoogvenster zelfstudie over doelconfiguratie. In vormen bestemmingswerkschema, vul de gebieden in die in de twee hieronder secties worden vermeld.
Within Destinations > Catalog zoeken naar (API) Oracle Eloqua. U kunt de locatie ook onder de Email Marketing categorie.
Verifiëren voor bestemming authenticate
Vul de vereiste velden hieronder in. Zie de Gather Oracle Eloqua geloofsbrieven voor eventuele richtsnoeren.
- 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 bestaat uit:{COMPANY_NAME}\{USERNAME}
.
Let op: gebruik geen accolades of spaties en bewaar de\
.
Als u bijvoorbeeld Oracle Eloqua Bedrijfsnaam isMyCompany
en Oracle Eloqua Gebruikersnaam isUsername
, de samengevoegde waarde die u in het dialoogvenster Username field isMyCompany\Username
.
Om voor authentiek te verklaren aan de bestemming, uitgezocht Connect to destination.
Als de verstrekte gegevens geldig zijn, geeft de interface een Connected status 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.
- Name: Een naam waarmee u dit doel in de toekomst wilt herkennen.
- Description: Een beschrijving die u zal helpen deze bestemming in de toekomst identificeren.
- Pod: te verkrijgen
pod
u bent aan, login aan Oracle Eloqua en noteer de URL in uw browser nadat u zich met succes hebt aangemeld. Als de URL van uw browser bijvoorbeeldsecure.p01.eloqua.com
depod
waarde die u moet selecteren, isp01
. Zie de Gather Oracle Eloqua geloofsbrieven voor aanvullende richtsnoeren.
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. Zie de handleiding voor meer informatie over waarschuwingen abonneren op bestemmingen die het alarm gebruiken UI.
Wanneer u klaar bent met het opgeven van details voor uw doelverbinding, selecteert u Next.
Soorten publiek naar dit doel activeren activate
- Als u gegevens wilt activeren, hebt u de opdracht View Destinations, Activate Destinations, View Profiles, en View Segments toegangsbeheermachtigingen. Lees de toegangsbeheeroverzicht of neem contact op met de productbeheerder om de vereiste machtigingen te verkrijgen.
- Om te exporteren identiteiten, hebt u de View Identity Graph toegangsbeheermachtiging.
Lezen Profielen en doelgroepen activeren voor het streamen van doelgroepen voor het exporteren van bestanden voor instructies voor het activeren van het publiek naar deze bestemming.
Afbeeldingsoverwegingen en voorbeeld mapping-considerations-example
Als u uw publieksgegevens correct vanuit Adobe Experience Platform naar de Oracle Eloqua doel, moet u door de stap van de gebiedstoewijzing gaan. 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.
Uw XDM-velden toewijzen aan de Oracle Eloqua doelvelden, voer de volgende stappen uit:
-
In de Mapping stap, selecteren Add new mapping. Er verschijnt een nieuwe toewijzingsrij op het scherm.
-
In de Select source field venster, kiest u de Select attributes en selecteer het XDM-kenmerk of kies de Select identity namespace en selecteer een identiteit.
-
In de Select target field venster, kiest u Select identity namespace en selecteer een identiteit of kies Select custom attributes en typ de gewenste kenmerknaam in het dialoogvenster Attribute name veld. De kenmerknaam die u opgeeft, moet overeenkomen met een bestaand contactkenmerk in Oracle Eloqua. Zie create a contact voor de exacte kenmerknamen die u kunt gebruiken in Oracle Eloqua.
-
Herhaal deze stappen om de vereiste en gewenste kenmerktoewijzingen toe te voegen tussen uw XDM-profielschema en Oracle Eloqua: | Bronveld | 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:
-
- Kenmerken die zijn opgegeven in het dialoogvenster Target field moet een naam hebben die exact overeenkomt met de naam die is opgegeven in het Create a contact aangezien deze kenmerken de aanvraaginstantie vormen.
- Kenmerken die zijn opgegeven in het dialoogvenster Source field zich niet aan een dergelijke beperking houden. U kunt deze toewijzen op basis van uw behoefte, maar als de gegevensindeling niet correct is wanneer u naar Oracle Eloqua resulteert in een fout. U kunt bijvoorbeeld de Source field naamruimte identity
contact key
,ABC ID
enz. tot Target field :EloquaId
nadat de id-waarden overeenkomen met de indeling die is geaccepteerd door Oracle Eloqua. - De
EloquaID
toewijzen is verplicht om kenmerken bij te werken die overeenkomen met de identiteit. - De
emailAddress
toewijzing 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:
-
Selecteren Destinations > Browse en navigeer naar de lijst met bestemmingen.
-
Selecteer vervolgens de bestemming en schakel over naar de Activation data en selecteert u vervolgens de naam van een publiek.
-
Controleer het publieksoverzicht en zorg ervoor dat de telling van profielen aan de telling binnen het segment beantwoordt.
-
Aanmelden bij de Oracle Eloqua website, navigeer vervolgens naar de Contacts Overview pagina om te controleren of de profielen van het publiek zijn toegevoegd. Als u de status van het publiek wilt zien, gaat u naar een Contact Detail pagina en controleer of het contactveld met het geselecteerde publiek als voorvoegsel is gemaakt.
Gegevensgebruik en -beheer data-usage-governance
Alles Adobe Experience Platform de bestemmingen zijn volgzaam met het beleid van het gegevensgebruik wanneer het behandelen van uw gegevens. Voor gedetailleerde informatie over hoe Adobe Experience Platform handhaaft gegevensbeheer, zie Overzicht van gegevensbeheer.
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 limiet van 250 aangepaste contactvelden overschrijdt, zoals wordt beschreven in het dialoogvenster guardrails sectie. Als u deze fout wilt corrigeren, moet u ervoor zorgen dat u de limiet van het aangepaste contactveld niet overschrijdt in Oracle Eloqua.
Zie de Oracle Eloqua HTTP-statuscodes en Oracle Eloqua Validatiefouten pagina's voor een uitgebreide lijst met status- en foutcodes met uitleg.
Aanvullende bronnen additional-resources
Zie voor meer informatie de Oracle Eloqua documentatie:
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. |