(API) Oracle Eloqua-anslutning
Med Oracle Eloqua kan marknadsförare planera och köra kampanjer samtidigt som de levererar en personaliserad kundupplevelse för sina potentiella kunder. Tack vare integrerad hantering av leads och enkel kampanjframtagning kan marknadsförarna engagera rätt målgrupp vid rätt tidpunkt i köparens resa och på ett elegant sätt skala nå målgrupper över olika kanaler, inklusive e-post, webbannonsering, video och mobiler. Säljarna kan sluta fler avtal snabbare och öka avkastningen på marknadsföringen genom realtidsinsikter.
Detta Adobe Experience Platform mål utnyttjar åtgärden Uppdatera en kontakt från Oracle Eloqua REST API, som gör att du kan uppdatera identiteter inom en målgrupp till Oracle Eloqua.
Oracle Eloqua använder Grundläggande autentisering för att kommunicera med REST API:t Oracle Eloqua. Instruktioner för autentisering till din Oracle Eloqua-instans finns längre ned i avsnittet Autentisera till mål.
Användningsfall use-cases
Marknadsföringsavdelningen på en onlineplattform vill sända en e-postbaserad marknadsföringskampanj till en välstrukturerad publik med leads. Plattformens marknadsföringsteam kan uppdatera befintlig huvudinformation via Adobe Experience Platform, bygga målgrupper utifrån sina egna offlinedata och skicka dessa målgrupper till Oracle Eloqua, som sedan kan användas för att skicka marknadsföringskampanjens e-post.
Förhandskrav prerequisites
Förutsättningar för Experience Platform prerequisites-in-experience-platform
Innan du aktiverar data till målet Oracle Eloqua måste du ha ett schema, en datamängd och segment som skapats i Experience Platform.
Se Experience Platform-dokumentationen för schemafältgruppen Information om målgruppsmedlemskap om du behöver vägledning om målgruppsstatus.
Krav för Oracle Eloqua prerequisites-destination
Du måste ha ett Oracle Eloqua-konto för att kunna exportera data från Platform till ditt Oracle Eloqua-konto.
Dessutom behöver du minst "Avancerade användare - marknadsföringsbehörigheter" för din Oracle Eloqua-instans. Mer information finns i avsnittet "Säkerhetsgrupper" på sidan Skyddad användaråtkomst . Målet kräver åtkomst för att avgöra din bas-URL programmatiskt när Oracle Eloqua-API:t anropas.
Samla in inloggningsuppgifter för Oracle Eloqua gather-credentials
Observera objekten nedan innan du autentiserar till målet Oracle Eloqua:
Company Name
Du kommer senare att använda
Company Name
och Oracle Eloqua Username
som en sammanfogad sträng som ska användas som Username vid autentisering till målet.Username
Password
Pod
secure.p01.eloqua.com
är till exempel pod
p01
. Mer information finns på sidan Bestämma POD.Mer information finns i Logga in på Oracle Eloqua.
Guardrails guardrails
- Oracle Eloqua anpassade kontaktfält skapas automatiskt med namnen på de målgrupper som valts under Select segments -steget.
-
Oracle Eloqua har en maxgräns på 250 anpassade kontaktfält.
-
Innan du exporterar nya målgrupper ser du till att antalet plattformsmålgrupper och antalet befintliga målgrupper inom Oracle Eloqua inte överskrider denna gräns.
-
Om denna gräns överskrids kommer ett fel att uppstå i Experience Platform. Detta beror på att Oracle Eloqua-API:t inte kan validera begäran och svarar med ett - 400: Det fanns ett valideringsfel - felmeddelande som beskriver problemet.
-
Om du har nått gränsen ovan måste du ta bort befintliga mappningar från målet och ta bort motsvarande anpassade kontaktfält i ditt Oracle Eloqua-konto innan du kan exportera fler segment.
-
Mer information om ytterligare begränsningar finns på sidan Oracle Eloqua Skapa kontaktfält.
Identiteter som stöds supported-identities
Oracle Eloqua har stöd för uppdatering av identiteter som beskrivs i tabellen nedan. Läs mer om identiteter.
EloquaId
Exportera typ och frekvens export-type-frequency
Se tabellen nedan för information om exporttyp och frekvens för destinationen.
- Du exporterar alla medlemmar i ett segment, tillsammans med de önskade schemafälten (till exempel e-postadress, telefonnummer, efternamn), enligt fältmappningen.
- För varje vald målgrupp i Platform uppdateras motsvarande Oracle Eloqua-segmentstatus med målgruppsstatus från Platform.
- Direktuppspelningsmål är alltid på API-baserade anslutningar. Så snart en profil uppdateras i Experience Platform baserat på målgruppsutvärdering skickar anslutningsprogrammet uppdateringen nedströms till målplattformen. Läs mer om direktuppspelningsmål.
Anslut till målet connect
Om du vill ansluta till det här målet följer du stegen som beskrivs i självstudiekursen för destinationskonfiguration. I arbetsflödet för att konfigurera mål fyller du i fälten som listas i de två avsnitten nedan.
I Destinations > Catalog söker du efter (API) Oracle Eloqua. Du kan också hitta den under kategorin Email Marketing.
Autentisera till mål authenticate
Fyll i de obligatoriska fälten nedan. Mer information finns i avsnittet Samla Oracle Eloqua inloggningsuppgifter.
- Password: Lösenordet för ditt Oracle Eloqua-konto.
- Username: En sammanfogad sträng som består av ditt Oracle Eloqua företagsnamn och Oracle Eloqua användarnamn.
Det sammanfogade värdet har formen{COMPANY_NAME}\{USERNAME}
.
Obs! Använd inte klammerparenteser eller mellanslag och bevara\
.
Om ditt Oracle Eloqua företagsnamn till exempel ärMyCompany
och Oracle Eloqua användarnamn ärUsername
är det sammanfogade värde som du kommer att använda i fältet UsernameMyCompany\Username
.
Om du vill autentisera till målet väljer du Connect to destination.
Om den angivna informationen är giltig visas statusen Connected med en grön bockmarkering. Du kan sedan gå vidare till nästa steg.
Fyll i målinformation destination-details
Om du vill konfigurera information för målet fyller du i de obligatoriska och valfria fälten nedan. En asterisk bredvid ett fält i användargränssnittet anger att fältet är obligatoriskt.
- Name: Ett namn som du känner igen det här målet med i framtiden.
- Description: En beskrivning som hjälper dig att identifiera det här målet i framtiden.
- Pod: Om du vill ta reda på vilken
pod
du är inloggad loggar du in på Oracle Eloqua och noterar URL:en i webbläsaren när du har loggat in. Om webbläsarens URL till exempelvis ärsecure.p01.eloqua.com
är detpod
-värde som du måste väljap01
. Mer information finns i avsnittet Samla Oracle Eloqua inloggningsuppgifter.
Aktivera aviseringar enable-alerts
Du kan aktivera varningar för att få meddelanden om dataflödets status till ditt mål. Välj en avisering i listan om du vill prenumerera och få meddelanden om statusen för ditt dataflöde. Mer information om varningar finns i guiden prenumerera på destinationsvarningar med användargränssnittet.
Välj Next när du är klar med att ange information för målanslutningen.
Aktivera målgrupper till det här målet activate
-
För att aktivera data behöver du behörigheterna View Destinations, Activate Destinations, View Profiles och View Segments åtkomstkontroll. Läs åtkomstkontrollsöversikten eller kontakta produktadministratören för att få den behörighet som krävs.
-
Om du vill exportera identiteter måste du ha View Identity Graph åtkomstkontrollbehörighet.
{width="100" modal="regular"}
Läs Aktivera profiler och målgrupper för att direktuppspela målgruppsexportdestinationer för instruktioner om hur du aktiverar målgrupper till det här målet.
Mappa överväganden och exempel mapping-considerations-example
Om du vill skicka målgruppsdata från Adobe Experience Platform till målet Oracle Eloqua måste du gå igenom fältmappningssteget. Mappningen består av att skapa en länk mellan XDM-schemafälten (Experience Data Model) i ditt plattformskonto och motsvarande motsvarigheter från målmålet.
Följ de här stegen för att mappa dina XDM-fält till Oracle Eloqua-målfälten:
-
Välj Add new mapping i steget Mapping. En ny mappningsrad visas på skärmen.
-
Välj kategorin Select attributes i fönstret Select source field och markera XDM-attributet eller välj Select identity namespace och välj en identitet.
-
I fönstret Select target field väljer du Select identity namespace och väljer en identitet, eller väljer Select custom attributes och skriver det önskade attributnamnet i fältet Attribute name. Attributnamnet som du anger ska matcha ett befintligt kontaktattribut i Oracle Eloqua. I create a contact finns de exakta attributnamnen som du kan använda i Oracle Eloqua.
-
Upprepa dessa steg för att lägga till både nödvändiga och önskade attributmappningar mellan XDM-profilschemat och 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 Field Målfält Obligatoriskt 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
-
Ett exempel med mappningarna ovan visas nedan:
-
- Attribut som anges i Target field ska ha exakt samma namn som anges i Create a contact eftersom dessa attribut kommer att bilda begärandetexten.
- Attribut som anges i Source field följer inte någon sådan begränsning. Du kan mappa den baserat på dina behov, men om dataformatet inte är korrekt när det skickas till Oracle Eloqua resulterar det i ett fel. Du kan till exempel mappa Source field-identitetsnamnutrymmet
contact key
,ABC ID
osv. till Target field :EloquaId
efter att du kontrollerat att ID-värdena matchar det format som accepteras av Oracle Eloqua. - Mappningen
EloquaID
är obligatorisk för att uppdatera attribut som motsvarar identiteten. - Mappningen
emailAddress
krävs. Utan det genererar API:t ett fel enligt nedan:
code language-json |
---|
|
Välj Next när du är klar med mappningarna för målanslutningen.
Validera dataexport exported-data
Följ stegen nedan för att verifiera att du har konfigurerat målet korrekt:
-
Välj Destinations > Browse och navigera till listan med mål.
-
Välj sedan målet, växla till fliken Activation data och välj sedan ett målgruppsnamn.
-
Övervaka målgruppssammanfattningen och kontrollera att antalet profiler motsvarar antalet inom segmentet.
-
Logga in på webbplatsen Oracle Eloqua och navigera sedan till sidan Contacts Overview för att kontrollera om profilerna från målgruppen har lagts till. Om du vill visa målgruppens status går du ned till en Contact Detail-sida och kontrollerar om kontaktfältet med det valda målgruppsnamnet som prefix har skapats.
Dataanvändning och styrning data-usage-governance
Alla Adobe Experience Platform-mål är kompatibla med dataanvändningsprinciper när data hanteras. Mer information om hur Adobe Experience Platform använder datastyrning finns i Datastyrningsöversikten.
Fel och felsökning errors-and-troubleshooting
När du skapar målet kanske du får något av följande felmeddelanden: 400: There was a validation error
eller 400 BAD_REQUEST
. Detta inträffar när du överskrider gränsen på 250 anpassade kontaktfält, vilket beskrivs i avsnittet skyddsutkast. Kontrollera att du inte överskrider gränsen för anpassade kontaktfält i Oracle Eloqua för att åtgärda det här felet.
På sidorna Oracle Eloqua HTTP-statuskoder och Oracle Eloqua Valideringsfel finns en omfattande lista med status- och felkoder med förklaringar.
Ytterligare resurser additional-resources
Mer information finns i Oracle Eloqua-dokumentationen:
Changelog
I det här avsnittet beskrivs funktionaliteten och viktiga dokumentationsuppdateringar för den här målanslutningen.
table 0-row-3 1-row-3 2-row-3 layout-auto | ||
---|---|---|
Releasamånad | Uppdateringstyp | Beskrivning |
April 2023 | Dokumentation - uppdatering |
|
Mars 2023 | Inledande version | Ursprunglig målversion och dokumentationspublicering. |