Connessione (API) Oracle Eloqua

Oracle Eloqua consente agli addetti marketing di pianificare ed eseguire campagne durante la distribuzione di un'esperienza cliente personalizzata per i loro potenziali clienti. Grazie alla gestione integrata dei lead e alla facile creazione delle campagne, gli esperti di marketing possono coinvolgere il pubblico giusto al momento giusto nel percorso dell’acquirente e scalare in modo elegante, per raggiungere il pubblico su tutti i canali, comprese e-mail, ricerche per display, video e dispositivi mobili. I team di vendita possono chiudere più offerte a una velocità più elevata, aumentando il ROI del marketing attraverso approfondimenti in tempo reale.

Questa Adobe Experience Platform destinazione sfrutta l'operazione Aggiorna un contatto dall'API REST Oracle Eloqua, che consente di aggiornare le identità all'interno di un pubblico in Oracle Eloqua.

Oracle Eloqua utilizza l'autenticazione di base 🔗 per comunicare con l'API REST Oracle Eloqua. Le istruzioni per l'autenticazione nell'istanza Oracle Eloqua sono riportate di seguito, nella sezione Autentica nella destinazione.

Casi d’uso use-cases

Il reparto marketing di una piattaforma online desidera trasmettere una campagna di marketing basata su e-mail a un pubblico curato di lead. Il team marketing della piattaforma può aggiornare le informazioni sui lead esistenti tramite Adobe Experience Platform, creare tipi di pubblico dai propri dati offline e inviarli a Oracle Eloqua, che può quindi essere utilizzato per inviare l'e-mail della campagna di marketing.

Prerequisiti prerequisites

Experience Platform prerequisiti prerequisites-in-experience-platform

Prima di attivare i dati nella destinazione Oracle Eloqua, è necessario disporre di uno schema, un set di dati e segmenti creati in Experience Platform.

Se hai bisogno di indicazioni sugli stati del pubblico, consulta la documentazione dell'Experience Platform per il gruppo di campi Dettagli appartenenza pubblico.

Oracle Eloqua prerequisiti prerequisites-destination

Per esportare i dati da Platform all'account Oracle Eloqua, è necessario disporre di un account Oracle Eloqua.

Inoltre, è necessario almeno "Advanced Users - Marketing permissions" per l'istanza Oracle Eloqua. Consultare la sezione "Gruppi di sicurezza" nella pagina Accesso utente protetto per ulteriori informazioni. L'accesso è richiesto dalla destinazione per determinare a livello di programmazione l'URL di base quando si richiama l'API Oracle Eloqua.

Raccogli Oracle Eloqua credenziali gather-credentials

Annotare gli elementi riportati di seguito prima di eseguire l'autenticazione nella destinazione Oracle Eloqua:

Credenziali
Descrizione
Company Name
Il nome società associato al tuo account Oracle Eloqua.
In seguito, utilizzerai Company Name e Oracle Eloqua Username come stringa concatenata da utilizzare come Nome utente durante l'autenticazione nella destinazione.
Username
Il nome utente dell'account Oracle Eloqua.
Password
La password del tuo account Oracle Eloqua.
Pod
Oracle Eloqua supporta più data center, ciascuno con un nome di dominio univoco. Oracle Eloqua si riferisce a questi come "pod", sono attualmente sette in totale: p01, p02, p03, p04, p06, p07 e p08. Per ottenere il POD a cui accedi, accedi a Oracle Eloqua e annota l'URL nel browser dopo aver effettuato l'accesso. Ad esempio, se l'URL del browser è secure.p01.eloqua.com, pod è p01. Per ulteriori informazioni, consultare la pagina determinazione del POD.

Consulta Accesso a Oracle Eloqua per maggiori informazioni.

Guardrail guardrails

NOTE
  • Oracle Eloqua campi di contatto personalizzati vengono creati automaticamente utilizzando i nomi dei tipi di pubblico selezionati durante il passaggio Seleziona segmenti.
  • Oracle Eloqua ha un limite massimo di 250 campi contatto personalizzati.

  • Prima di esportare nuovi tipi di pubblico, assicurati che il numero di tipi di pubblico di Platform e il numero di tipi di pubblico esistenti entro Oracle Eloqua non superino questo limite.

  • Se questo limite viene superato, si verifica un errore in Experience Platform. L'API Oracle Eloqua non riesce a convalidare la richiesta e risponde con - 400: si è verificato un errore di convalida - messaggio di errore che descrive il problema.

  • Se è stato raggiunto il limite specificato in precedenza, è necessario rimuovere le mappature esistenti dalla destinazione ed eliminare i campi dei contatti personalizzati corrispondenti nell'account Oracle Eloqua prima di poter esportare altri segmenti.

  • Per informazioni sui limiti aggiuntivi, vedere la pagina Oracle Eloqua Creazione dei campi contatto.

Identità supportate supported-identities

Oracle Eloqua supporta l'aggiornamento delle identità descritte nella tabella seguente. Ulteriori informazioni su identità.

Identità di destinazione
Descrizione
Obbligatorio
EloquaId
Identificatore univoco del contatto.

Tipo e frequenza di esportazione export-type-frequency

Per informazioni sul tipo e sulla frequenza di esportazione della destinazione, consulta la tabella seguente.

Elemento
Tipo
Note
Tipo di esportazione
Basato su profilo
  • Stai esportando tutti i membri di un segmento, insieme ai campi dello schema desiderati (ad esempio: indirizzo e-mail, numero di telefono, cognome), in base al mapping dei campi.
  • Per ogni pubblico selezionato in Platform, lo stato del segmento Oracle Eloqua corrispondente viene aggiornato da Platform in base allo stato del pubblico.
Frequenza di esportazione
Streaming
  • Le destinazioni di streaming sono connessioni "sempre attive" basate su API. Non appena un profilo viene aggiornato in Experience Platform in base alla valutazione del pubblico, il connettore invia l’aggiornamento a valle alla piattaforma di destinazione. Ulteriori informazioni sulle destinazioni di streaming.

Connettersi alla destinazione connect

IMPORTANT
Per connettersi alla destinazione, sono necessarie le Destinazioni visualizzazione e le Autorizzazioni di gestione delle destinazioni per il controllo degli accessi. Leggi la panoramica sul controllo degli accessi o contatta l'amministratore del prodotto per ottenere le autorizzazioni necessarie.

Per connettersi a questa destinazione, seguire i passaggi descritti nell'esercitazione sulla configurazione della destinazione. Nel flusso di lavoro di configurazione della destinazione, compila i campi elencati nelle due sezioni seguenti.

All'interno di Destinazioni > Catalogo, cerca (API) Oracle Eloqua. In alternativa, puoi trovarlo nella categoria E-mail marketing.

Autenticarsi nella destinazione authenticate

Compila i campi obbligatori di seguito. Per ulteriori informazioni, consulta la sezione Raccogli Oracle Eloqua credenziali.

  • Password: la password del tuo account Oracle Eloqua.
  • Nome utente: una stringa concatenata composta dal nome dell'azienda Oracle Eloqua e dal nome utente Oracle Eloqua.
    Il valore concatenato è {COMPANY_NAME}\{USERNAME}.
    Nota: non utilizzare parentesi graffe o spazi e mantenere \.
    Ad esempio, se il nome società Oracle Eloqua è MyCompany e il nome utente Oracle Eloqua è Username, il valore concatenato che utilizzerai nel campo Nome utente è MyCompany\Username.

Per eseguire l'autenticazione nella destinazione, selezionare Connetti alla destinazione.
Schermata dellinterfaccia utente di Platform che mostra come eseguire lautenticazione.

Se i dettagli forniti sono validi, nell'interfaccia utente viene visualizzato lo stato Connesso con un segno di spunta verde. A questo punto è possibile procedere al passaggio successivo.

Inserire i dettagli della destinazione destination-details

Per configurare i dettagli per la destinazione, compila i campi obbligatori e facoltativi seguenti. Un asterisco accanto a un campo nell’interfaccia utente indica che il campo è obbligatorio.
Schermata dellinterfaccia utente di Platform che mostra i dettagli della destinazione.

  • Nome: un nome con cui riconoscerai questa destinazione in futuro.
  • Descrizione: una descrizione che ti aiuterà a identificare questa destinazione in futuro.
  • Pod: per ottenere i pod a cui sei connesso, accedi a Oracle Eloqua e annota l'URL nel browser dopo aver effettuato l'accesso. Ad esempio, se l'URL del browser è secure.p01.eloqua.com il valore pod da selezionare è p01. Consulta la sezione Raccogliere Oracle Eloqua credenziali per ulteriori informazioni.

Abilita avvisi enable-alerts

Puoi abilitare gli avvisi per ricevere notifiche sullo stato del flusso di dati verso la tua destinazione. Seleziona un avviso dall’elenco per abbonarti e ricevere notifiche sullo stato del flusso di dati. Per ulteriori informazioni sugli avvisi, consulta la guida su abbonamento a destinazioni avvisi tramite l'interfaccia utente.

Dopo aver fornito i dettagli per la connessione di destinazione, seleziona Avanti.

Attivare tipi di pubblico in questa destinazione activate

IMPORTANT

Leggi Attivare profili e tipi di pubblico nelle destinazioni di esportazione del pubblico di streaming per le istruzioni sull'attivazione dei tipi di pubblico in questa destinazione.

Considerazioni sulla mappatura ed esempio mapping-considerations-example

Per inviare correttamente i dati sul pubblico da Adobe Experience Platform alla destinazione Oracle Eloqua, è necessario eseguire il passaggio di mappatura dei campi. La mappatura consiste nella creazione di un collegamento tra i campi dello schema Experience Data Model (XDM) nell’account Platform e i corrispondenti equivalenti dalla destinazione.

Per mappare i campi XDM ai campi di destinazione Oracle Eloqua, effettua le seguenti operazioni:

  1. Nel passaggio Mapping, seleziona Aggiungi nuovo mapping. Viene visualizzata una nuova riga di mappatura.

  2. Nella finestra Seleziona campo di origine, scegli la categoria Seleziona attributi e seleziona l'attributo XDM oppure scegli lo spazio dei nomi Seleziona identità e seleziona un'identità.

  3. Nella finestra Seleziona campo di destinazione, scegli Seleziona spazio dei nomi identità e seleziona un'identità oppure scegli Seleziona attributi personalizzati e digita il nome dell'attributo desiderato nel campo Nome attributo. Il nome attributo specificato deve corrispondere a un attributo contatto esistente in Oracle Eloqua. Vedere create a contact per i nomi di attributo esatti utilizzabili in Oracle Eloqua.

    • Ripeti questi passaggi per aggiungere i mapping di attributi richiesti e desiderati tra lo schema del profilo XDM e Oracle Eloqua:
      | Campo Source | Campo di destinazione | Obbligatorio |
      |—|—|—|
      |IdentityMap: Eid|Identity: EloquaId| Sì |
      |xdm: personalEmail.address|Attribute: emailAddress| Sì |
      |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| |

    • Di seguito è riportato un esempio con le mappature di cui sopra:

      Esempio di schermata dellinterfaccia utente di Platform con mappature di attributi.

IMPORTANT
  • Gli attributi specificati nel campo Target devono essere denominati esattamente come specificato in Create a contact, in quanto formeranno il corpo della richiesta.
  • Gli attributi specificati nel campo Source non seguono alcuna restrizione di questo tipo. È possibile eseguirne la mappatura in base alle proprie esigenze. Tuttavia, se il formato dei dati non è corretto al momento del push in Oracle Eloqua, si verificherà un errore. Ad esempio, è possibile mappare il campo Source spazio dei nomi dell'identità contact key, ABC ID ecc. al campo di destinazione: EloquaId dopo aver verificato che i valori ID corrispondano al formato accettato da Oracle Eloqua.
  • Il mapping EloquaID è obbligatorio per aggiornare gli attributi corrispondenti all'identità.
  • Il mapping emailAddress è obbligatorio. Senza di esso, l’API genera un errore come mostrato di seguito:
code language-json
{
     "type":"ObjectValidationError",
     "container":{
           "type":"ObjectKey",
           "objectType":"Contact"
     },
     "property":"emailAddress",
     "requirement":{
           "type":"EmailAddressRequirement"
     },
     "value":"<null>"
}

Al termine della fornitura dei mapping per la connessione di destinazione, selezionare Avanti.

NOTE
La destinazione aggiunge automaticamente un identificatore univoco ai nomi del pubblico selezionato in ogni esecuzione durante l'invio delle informazioni del campo del contatto a Oracle Eloqua. In questo modo i nomi dei campi contatto corrispondenti ai nomi del pubblico non si sovrappongono. Consulta l'Esempio di schermata della sezione Convalida esportazione dati di una pagina Dettagli contatto Oracle Eloqua con un campo contatto personalizzato creato utilizzando i nomi del pubblico.

Convalidare l’esportazione dei dati exported-data

Per verificare di aver impostato correttamente la destinazione, segui i passaggi seguenti:

  1. Seleziona Destinazioni > Sfoglia e passa all'elenco delle destinazioni.

  2. Quindi, seleziona la destinazione e passa alla scheda Dati attivazione, quindi seleziona un nome di pubblico.
    Esempio di schermata dellinterfaccia utente di Platform che mostra i dati di attivazione delle destinazioni.

  3. Controlla il riepilogo del pubblico e assicurati che il conteggio dei profili corrisponda al conteggio all’interno del segmento.
    Esempio di schermata dellinterfaccia utente di Platform che mostra il segmento.

  4. Accedi al sito Web Oracle Eloqua, quindi passa alla pagina Panoramica contatti per verificare se i profili del pubblico sono stati aggiunti. Per visualizzare lo stato del pubblico, approfondisci una pagina Dettagli contatto e verifica se il campo del contatto con il nome del pubblico selezionato come prefisso è stato creato.

Schermata dellinterfaccia utente Eloqua di Oracle che mostra la pagina Dettagli contatto con il campo contatto personalizzato creato con il nome del pubblico.

Utilizzo dei dati e governance data-usage-governance

Tutte le destinazioni Adobe Experience Platform sono conformi ai criteri di utilizzo dei dati durante la gestione dei dati. Per informazioni dettagliate su come Adobe Experience Platform applica la governance dei dati, vedi Panoramica sulla governance dei dati.

Errori e risoluzione problemi errors-and-troubleshooting

Durante la creazione della destinazione, è possibile che venga visualizzato uno dei messaggi di errore seguenti: 400: There was a validation error o 400 BAD_REQUEST. Ciò si verifica quando si supera il limite di 250 campi contatto personalizzati, come descritto nella sezione guardrail. Per correggere l'errore, assicurarsi di non superare il limite del campo contatto personalizzato in Oracle Eloqua.
Schermata dellinterfaccia utente di Platform che mostra lerrore.

Per un elenco completo dei codici di stato e di errore con relative spiegazioni, consultare le pagine Oracle Eloqua Codici di stato HTTP e Oracle Eloqua Errori di convalida.

Risorse aggiuntive additional-resources

Per ulteriori dettagli, vedere la documentazione di Oracle Eloqua:

Changelog

Questa sezione acquisisce le funzionalità e i significativi aggiornamenti alla documentazione apportati al connettore di destinazione.

Visualizza changelog
table 0-row-3 1-row-3 2-row-3 layout-auto
Mese di rilascio Tipo di aggiornamento Descrizione
Aprile 2023 Aggiornamento della documentazione
  • Abbiamo aggiornato la sezione casi d'uso con un esempio più chiaro di quando i clienti trarrebbero vantaggio dall'utilizzo di questa destinazione.
  • La sezione mapping è stata aggiornata con chiari esempi di mapping obbligatori e facoltativi.
  • La sezione Connetti alla destinazione è stata aggiornata con un esempio su come creare il valore concatenato per il campo Nome utente utilizzando il nome società Oracle Eloqua e il nome utente Oracle Eloqua. (PLATIR-28343)
  • Sono state aggiornate le sezioni Gather Oracle Eloqua credentials e Fill in destination details con indicazioni sulla selezione di Oracle Eloqua Pod. Il valore "Pod" viene utilizzato dalla destinazione per creare l'URL di base per le chiamate API. La sezione Oracle Eloqua prerequisiti è stata inoltre aggiornata con indicazioni sull'assegnazione di "Utenti avanzati - Autorizzazioni di marketing" come "Gruppi di sicurezza" obbligatori per l'istanza Oracle Eloqua.
Marzo 2023 Versione iniziale Versione di destinazione iniziale e pubblicazione della documentazione.
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6