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 tramite insight 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

Prerequisiti di Experience Platform 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 di Experience Platform per il gruppo di campi dello schema Dettagli sull'iscrizione al pubblico.

Oracle Eloqua prerequisiti prerequisites-destination

Per esportare dati da Experience 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:

Consulta Accesso a Oracle Eloqua per maggiori informazioni.

Guardrail guardrails

Identità supportate supported-identities

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

Tipo e frequenza di esportazione export-type-frequency

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

Connettersi alla destinazione connect

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.

Entro Destinations > Catalog, cerca (API) Oracle Eloqua. In alternativa, è possibile individuarlo nella categoria Email Marketing.

Autenticarsi nella destinazione authenticate

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

Per eseguire l'autenticazione nella destinazione, selezionare Connect to destination.

Se i dettagli forniti sono validi, nell'interfaccia utente viene visualizzato lo stato Connected 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.

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 della connessione di destinazione, selezionare Next.

Attivare tipi di pubblico in questa destinazione activate

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 Experience Platform e i corrispondenti equivalenti dalla destinazione.

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

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

Al termine della fornitura delle mappature per la connessione di destinazione, selezionare Next.

Convalidare l’esportazione dei dati exported-data

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

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.

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.