(API) Oracle Eloqua anslutning

Oracle Eloqua gör det möjligt för marknadsförare att planera och genomföra kampanjer samtidigt som de levererar en personaliserad kundupplevelse till sina presumtiva 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 Uppdatera en kontakt åtgärd från Oracle Eloqua REST API, som gör att du kan uppdatera identiteter inom en viss målgrupp Oracle Eloqua.

Oracle Eloqua använder Grundläggande autentisering att kommunicera med Oracle Eloqua REST API. Instruktioner för hur du autentiserar Oracle Eloqua -instansen är längre ned, i Autentisera till mål -avsnitt.

Användningsfall

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 Eloquasom sedan kan användas för att skicka marknadsföringskampanjens e-post.

Förutsättningar

Förutsättningar för Experience Platform

Innan du aktiverar data för Oracle Eloqua mål, du måste ha schema, a datauppsättningoch segment som Experience Platform.

Se dokumentationen för Experience Platform för Schemafältgrupp för målgruppsmedlemskapsdetaljer om ni behöver vägledning om målgruppsstatus.

Oracle Eloqua krav

För att kunna exportera data från Platform till Oracle Eloqua konto du behöver ha Oracle Eloqua konto.

Dessutom behöver du åtminstone "Avancerade användare - marknadsföringsbehörigheter" för Oracle Eloqua -instans. Se "Säkerhetsgrupper" i Skyddad användaråtkomst sida för vägledning. Åtkomsten krävs för att målet ska kunna programmera fastställa din bas-URL när du anropar Oracle Eloqua API.

Samla Oracle Eloqua autentiseringsuppgifter

Anteckna nedanstående innan du autentiserar dig för Oracle Eloqua mål:

Se Logga in på Oracle Eloqua för vägledning.

Guardrails

• 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. Det beror på att Oracle Eloqua API:t kan inte validera begäran och svarar med en - 400: Ett valideringsfel uppstod - 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 Oracle Eloqua innan du kan exportera fler segment.

• Se Oracle Eloqua Skapa kontaktfält sida för information om ytterligare begränsningar.

Identiteter som stöds

Oracle Eloqua har stöd för uppdatering av identiteter som beskrivs i tabellen nedan. Läs mer om identiteter.

Exportera typ och frekvens

Se tabellen nedan för information om exporttyp och frekvens för destinationen.

Anslut till målet

Om du vill ansluta till det här målet följer du stegen som beskrivs i självstudiekurs om destinationskonfiguration. I arbetsflödet för att konfigurera mål fyller du i fälten som listas i de två avsnitten nedan.

Inom Destinations > Catalog sök efter (API) Oracle Eloqua. Du kan även hitta den under Email Marketing kategori.

Autentisera till mål

Fyll i de obligatoriska fälten nedan. Se Samla Oracle Eloqua autentiseringsuppgifter för vägledning.

• Password: Lösenordet för Oracle Eloqua konto.
• Username: En sammanfogad sträng som består av Oracle Eloqua Företag och Oracle Eloqua Användarnamn.
  Det sammanfogade värdet har formen av {COMPANY_NAME}\{USERNAME}.
  Observera att du inte ska använda klammerparenteser eller mellanslag och bevara \.
  Om du till exempel Oracle Eloqua Företagsnamnet är MyCompany och Oracle Eloqua Användarnamnet är Username, det sammanfogade värde som du kommer att använda i Username fältet är MyCompany\Username.

Om du vill autentisera mot målet väljer du Connect to destination.

Om den angivna informationen är giltig visas en Connected status med en grön bockmarkering. Du kan sedan gå vidare till nästa steg.

Fyll i målinformation

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: För att få fram pod du är på, logga in på Oracle Eloqua och notera URL:en i webbläsaren när du har loggat in. Om webbläsarens URL-adress till exempel är secure.p01.eloqua.com den pod värdet du måste välja är p01. Se Samla Oracle Eloqua autentiseringsuppgifter för ytterligare vägledning.

Aktivera aviseringar

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 på prenumerera på destinationsvarningar med användargränssnittet.

När du är klar med informationen för målanslutningen väljer du Next.

Aktivera målgrupper till det här målet

Läs Aktivera profiler och målgrupper för att strömma målgruppernas exportdestinationer för instruktioner om hur du aktiverar målgrupper till det här målet.

Mappa överväganden och exempel

Så här skickar du målgruppsdata från Adobe Experience Platform till Oracle Eloqua mål 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.

Så här mappar du XDM-fält till Oracle Eloqua målfält, följ dessa steg:

1. I Mapping steg, välja Add new mapping. En ny mappningsrad visas på skärmen.
2. I Select source field väljer du Select attributes och välj XDM-attributet eller välj Select identity namespace och välj en identitet.
3. I Select target field fönster, välja Select identity namespace och välja en identitet, eller välja Select custom attributes och skriv attributnamnet i Attribute name fält. Attributnamnet som du anger ska matcha ett befintligt kontaktattribut i Oracle Eloqua. Se create a contact för 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 attributkopplingar mellan XDM-profilschemat och Oracle Eloqua: | Källfält | 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:

     

{
     "type":"ObjectValidationError",
     "container":{
           "type":"ObjectKey",
           "objectType":"Contact"
     },
     "property":"emailAddress",
     "requirement":{
           "type":"EmailAddressRequirement"
     },
     "value":"<null>"
}

När du är klar med mappningarna för målanslutningen väljer du Next.

Validera dataexport

Följ stegen nedan för att verifiera att du har konfigurerat målet korrekt:

1. Välj Destinations > Browse och navigera till listan över destinationer.

2. Välj sedan målet och växla till Activation data väljer du ett målgruppsnamn.
   

3. Övervaka målgruppssammanfattningen och kontrollera att antalet profiler motsvarar antalet inom segmentet.
   

4. Logga in på Oracle Eloqua webbplatsen och sedan navigera till Contacts Overview sida för att kontrollera om profilerna från målgruppen har lagts till. Om du vill se målgruppens status kan du gå ned till en Contact Detail och kontrollera om kontaktfältet med det valda målgruppsnamnet som prefix har skapats.

Dataanvändning och styrning

Alla Adobe Experience Platform destinationerna är kompatibla med dataanvändningsprinciper när data hanteras. Detaljerad information om hur Adobe Experience Platform använder datastyrning, se Datastyrning - översikt.

Fel och felsökning

När du skapar målet kan du få 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 skyddsräcken -avsnitt. Kontrollera att du inte överskrider gränsen för anpassade kontaktfält i Oracle Eloqua.

Se Oracle Eloqua HTTP-statuskoder och Oracle Eloqua Valideringsfel sidor med en omfattande lista över status- och felkoder med förklaringar.

Ytterligare resurser

Mer information finns i Oracle Eloqua dokumentation:

• Oracle Eloqua Marketing Automation
• REST API för tjänsten Oracle Eloqua Marketing Cloud

Changelog

I det här avsnittet beskrivs funktionaliteten och viktiga dokumentationsuppdateringar för den här målanslutningen.