(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:

Autentiseringsuppgifter
Beskrivning
Company Name
Det företagsnamn som är associerat med ditt 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 vid autentisering till målet.
Username
Användarnamnet för ditt Oracle Eloqua-konto.
Password
Lösenordet för ditt Oracle Eloqua-konto.
Pod
Oracle Eloqua har stöd för flera datacenter, där vart och ett har ett unikt domännamn. Oracle Eloqua refererar till dessa som"pods", det finns för närvarande sju totalt - p01, p02, p03, p04, p06, p07 och p08. Om du vill ta reda på vilken POD du är på loggar du in på Oracle Eloqua och noterar URL:en i webbläsaren när du har loggat in. Om webbläsarens URL är 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

NOTE
  • 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.

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

Exportera typ och frekvens export-type-frequency

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 (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.
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 direktuppspelningsmål.

Anslut till målet connect

IMPORTANT
Om du vill ansluta till målet behöver du behörigheterna View Destinations och Manage Destinations åtkomstkontroll. Läs åtkomstkontrollsöversikten eller kontakta produktadministratören för att få den behörighet som krävs.

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 är MyCompany och Oracle Eloqua användarnamn är Username är det sammanfogade värde som du kommer att använda i fältet Username MyCompany\Username.

Om du vill autentisera till målet väljer du Connect to destination.
Skärmbild av användargränssnittet för plattformen som visar hur du autentiserar.

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.
Skärmbild för plattformsgränssnitt 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: 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 är secure.p01.eloqua.com är det pod-värde som du måste välja p01. 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

IMPORTANT
  • 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.

    Markera identitetsnamnområdet som är markerat i arbetsflödet för att aktivera målgrupper till mål. {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:

  1. Välj Add new mapping i steget Mapping. En ny mappningsrad visas på skärmen.

  2. 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.

  3. 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:

      Exempel på skärmbild för plattformsgränssnitt med attributmappningar.

IMPORTANT
  • 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
{
     "type":"ObjectValidationError",
     "container":{
           "type":"ObjectKey",
           "objectType":"Contact"
     },
     "property":"emailAddress",
     "requirement":{
           "type":"EmailAddressRequirement"
     },
     "value":"<null>"
}

Välj Next när du är klar med mappningarna för målanslutningen.

NOTE
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 skärmbilden Validera dataexport för en Oracle Eloqua kontaktinformationssida med ett anpassat kontaktfält som skapats med målgruppsnamnen.

Validera dataexport exported-data

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

  1. Välj Destinations > Browse och navigera till listan med mål.

  2. Välj sedan målet, växla till fliken Activation data och välj sedan ett målgruppsnamn.
    Exempel på skärmbild för användargränssnittet för plattformen som 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å 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.

Oraclet Eloqua UI, bild som visar kontaktinformationssidan med ett anpassat kontaktfält som skapats med målgruppens namn.

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.
Skärmbild för plattformsgränssnitt visar ett fel.

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.

Visa ändringslogg
table 0-row-3 1-row-3 2-row-3 layout-auto
Releasamånad Uppdateringstyp Beskrivning
April 2023 Dokumentation - uppdatering
  • Vi uppdaterade avsnittet use-cases med ett tydligare exempel på när kunder skulle kunna dra nytta av det här målet.
  • Vi uppdaterade avsnittet mapping med tydliga exempel på både obligatoriska och valfria mappningar.
  • Vi uppdaterade avsnittet Anslut till målet med ett exempel på hur du skapar det sammanfogade värdet för fältet Username med hjälp av företagsnamnet Oracle Eloqua och användarnamnet för Oracle Eloqua. (PLATIR-28343)
  • Vi uppdaterade avsnitten Samla Oracle Eloqua in och Fyll i målinformation med vägledning om Oracle Eloqua Pod-val. Värdet "Pod" används av målet för att skapa bas-URL:en för API-anropen. Avsnittet Oracle Eloqua Krav uppdaterades också med vägledning om hur du tilldelar "Avancerade användare - marknadsföringsbehörigheter" som en obligatorisk "Säkerhetsgrupper" för din Oracle Eloqua-instans.
Mars 2023 Inledande version Ursprunglig målversion och dokumentationspublicering.
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6