(API) Oracle Eloqua anslutning

Senaste uppdatering: 2023-11-01
  • Skapat för:
  • Developer
    User
    Admin
    Leader

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:

Autentiseringsuppgifter Beskrivning
Company Name Företagsnamnet som är associerat med din Oracle Eloqua konto.
Du kommer senare att använda Company Name och Oracle Eloqua Username som en sammanfogad sträng som ska användas som Username när autentiserar mot målet.
Username Användarnamnet för Oracle Eloqua konto.
Password Lösenordet för Oracle Eloqua konto.
Pod Oracle Eloqua har stöd för flera datacenter, där var och en har ett unikt domännamn. Oracle Eloqua hänvisar till dessa som"poder", det finns för närvarande sju totalt - p01, p02, p03, p04, p06, p07 och p08. Logga in på för att ta reda på vilken POD du är 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 din pod är p01. Se fastställa din POD sida för ytterligare vägledning.

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

Guardrails

OBSERVERA
  • Oracle Eloqua anpassade kontaktfält skapas automatiskt med namnen på de målgrupper som valts under Select segments steg.
  • 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.

Målidentitet Beskrivning Obligatoriskt
EloquaId Unik identifierare för kontakten. Ja

Exportera typ och frekvens

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

Objekt Typ Anteckningar
Exporttyp Profile-based
  • Du exporterar alla medlemmar i ett segment tillsammans med de önskade schemafälten (t.ex. e-postadress, telefonnummer, efternamn), enligt fältmappningen.
  • För varje vald publik i Platform Oracle Eloqua segmentets status uppdateras med målgruppsstatus från Platform.
Exportfrekvens Streaming
  • 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 mål för direktuppspelning.

Anslut till målet

VIKTIGT

Om du vill ansluta till målet behöver du Manage Destinations behörighet för åtkomstkontroll. Läs åtkomstkontroll - översikt eller kontakta produktadministratören för att få de behörigheter som krävs.

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.
Skärmbild av användargränssnittet för plattformen som visar hur man autentiserar.

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.
Skärmbild för användargränssnittet för plattformen som visar målinformationen.

  • 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

VIKTIGT

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:

      Skärmbild för plattformsgränssnitt med attributmappningar.

VIKTIGT
  • Attribut som anges i Target field ska ha exakt det namn som anges i Create a contact eftersom dessa attribut utgör begärandetexten.
  • Attribut som anges i Source field inte följer 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 det kommer att resultera i ett fel. Du kan till exempel mappa Source field namnutrymme för identitet 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.
  • The EloquaID mappning är obligatoriskt för att uppdatera attribut som motsvarar identiteten.
  • The emailAddress mappning krävs. Utan det genererar API:t ett fel enligt 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.

OBSERVERA

Målet lägger automatiskt till en unik identifierare till de valda målgruppsnamnen vid varje körning när kontaktfältsinformationen skickas till Oracle Eloqua. Detta garanterar att de kontaktfältsnamn som motsvarar målgruppsnamnen inte överlappar varandra. Se Validera dataexport skärmbild av ett avsnitt Oracle Eloqua Kontaktinformationssida med anpassat kontaktfält som skapats med målgruppsnamnen.

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.
    Skärmbild för användargränssnittet för plattformen visar aktiveringsdata för destinationer.

  3. Övervaka målgruppssammanfattningen och kontrollera att antalet profiler motsvarar antalet inom segmentet.
    Exempel på skärmbild för plattformsgränssnitt som visar segment.

  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.

Skärmbilden Oracle Eloqua UI som visar kontaktinformationssidan med ett anpassat kontaktfält som skapats med målgruppens namn.

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.
Skärmbild för användargränssnittet för plattformen visar ett fel.

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:

Changelog

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

 Visa ändringslogg
Releasamånad Uppdateringstyp Beskrivning
April 2023 Dokumentation - uppdatering
  • Vi uppdaterade användningsfall med ett tydligare exempel på när kunderna skulle kunna dra nytta av detta mål.
  • Vi uppdaterade mappning med tydliga exempel på både obligatoriska och valfria mappningar.
  • Vi uppdaterade Anslut till målet med ett exempel på hur det sammanfogade värdet för Username fält med Oracle Eloqua Företag och Oracle Eloqua Användarnamn. (PLATIR-28343)
  • Vi uppdaterade Samla Oracle Eloqua autentiseringsuppgifter och Fyll i målinformation avsnitt med vägledning om Oracle Eloqua Pod markering. The Pod -värdet används av målet för att skapa bas-URL:en för API-anropen. The Oracle Eloqua krav har även uppdaterats med vägledning om tilldelning "Avancerade användare - marknadsföringsbehörigheter" som krävs "Säkerhetsgrupper" för Oracle Eloqua -instans.
Mars 2023 Inledande version Ursprunglig målversion och dokumentationspublicering.

På denna sida