(API) Oracle Eloqua connessione

Oracle Eloqua consente agli addetti al marketing di pianificare ed eseguire campagne offrendo al contempo ai potenziali clienti un’esperienza personalizzata. 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.

Questo Adobe Experience Platform destinazione sfrutta Aggiornare un contatto operazione da Oracle Eloqua REST API, che consente di: aggiorna identità all’interno di un pubblico in Oracle Eloqua.

Oracle Eloqua utilizza Autenticazione di base per comunicare con Oracle Eloqua API REST. Istruzioni per l’autenticazione Oracle Eloqua sono riportati di seguito, nella Autentica nella destinazione sezione.

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 in Oracle Eloqua destinazione, è necessario disporre di un schema, a set di dati, e segmenti creato in Experience Platform.

Consulta la documentazione dell’Experience Platform per Gruppo di campi schema Dettagli appartenenza pubblico per informazioni sugli stati del pubblico.

Oracle Eloqua prerequisiti prerequisites-destination

Per esportare i dati da Platform al tuo Oracle Eloqua account necessario disporre di un Oracle Eloqua account.

Inoltre, è necessario, come minimo, "Utenti avanzati - Autorizzazioni di marketing" per Oracle Eloqua dell'istanza. Consulta la sezione "Gruppi di sicurezza" sezione sul Accesso utente protetto per una guida. L’accesso è richiesto dalla destinazione per essere programmaticamente determinare l’URL di base quando si richiama Oracle Eloqua API.

Raccogli Oracle Eloqua credenziali gather-credentials

Annota gli elementi riportati di seguito prima di eseguire l’autenticazione in Oracle Eloqua destinazione:

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

Consulta la sezione Accesso a Oracle Eloqua a titolo indicativo.

Guardrail guardrails

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

  • Prima di esportare nuovi tipi di pubblico, assicurati che il numero di tipi di pubblico di Platform e quello esistente in Oracle Eloqua non superi questo limite.

  • Se questo limite viene superato, si verifica un errore in Experienci Platform. Questo perché il Oracle Eloqua L’API non riesce a convalidare la richiesta e risponde con un segno - 400: errore di convalida - messaggio di errore che descrive il problema.

  • Se hai raggiunto il limite specificato sopra, devi rimuovere le mappature esistenti dalla destinazione ed eliminare i campi dei contatti personalizzati corrispondenti nel tuo Oracle Eloqua prima di esportare altri segmenti.

  • Consulta la sezione Oracle Eloqua Creazione di campi contatto per informazioni sui limiti aggiuntivi.

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 schema desiderati ad esempio: indirizzo e-mail, numero di telefono, cognome, in base alla mappatura del campo.
  • Per ogni pubblico selezionato in Platform, la Oracle Eloqua Lo stato del segmento viene aggiornato con il relativo stato del pubblico da Platform.
Frequenza di esportazione
Streaming
  • Le destinazioni di streaming sono connessioni "sempre attive" basate su API. Non appena un profilo viene aggiornato in Experienci Platform in base alla valutazione del pubblico, il connettore invia l’aggiornamento a valle alla piattaforma di destinazione. Ulteriori informazioni su destinazioni di streaming.

Connetti alla destinazione connect

IMPORTANT
Per connettersi alla destinazione, è necessario Visualizza destinazioni e Gestire le destinazioni autorizzazioni di controllo degli accessi. Leggi le panoramica sul controllo degli accessi oppure contatta l’amministratore del prodotto per ottenere le autorizzazioni necessarie.

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

Entro Destinazioni > Catalogo cerca (API) Oracle Eloqua. In alternativa, è possibile posizionarlo sotto il E-mail marketing categoria.

Autentica nella destinazione authenticate

Compila i campi obbligatori di seguito. Consulta la sezione Raccogli Oracle Eloqua credenziali sezione per eventuali indicazioni.

  • Password: password del Oracle Eloqua account.
  • Nome utente: stringa concatenata composta da Oracle Eloqua Nome dell’azienda e Oracle Eloqua Nome utente.
    Il valore concatenato assume la forma di {COMPANY_NAME}\{USERNAME}.
    Non utilizzare parentesi graffe o spazi e conserva \.
    Ad esempio, se Oracle Eloqua Il nome dell’azienda è MyCompany e Oracle Eloqua Il nome utente è Username, il valore concatenato che utilizzerai nel Nome utente il campo è MyCompany\Username.

Per eseguire l’autenticazione nella destinazione, seleziona Connetti alla destinazione.
Schermata dell’interfaccia utente di Platform che mostra come eseguire l’autenticazione.

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

Inserisci 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 dell’interfaccia utente di Platform che mostra i dettagli della destinazione.

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

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 agli avvisi sulle destinazioni tramite l’interfaccia utente.

Una volta completate le informazioni sulla connessione di destinazione, seleziona Successivo.

Attiva il pubblico in questa destinazione activate

IMPORTANT

Letto Attiva profili e tipi di pubblico nelle destinazioni di esportazione del pubblico in streaming per 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 a Oracle Eloqua destinazione, devi passare attraverso 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 su Oracle Eloqua campi di destinazione, effettua le seguenti operazioni:

  1. In Mappatura passaggio, seleziona Aggiungi nuova mappatura. Viene visualizzata una nuova riga di mappatura.

  2. In Seleziona campo di origine finestra, scegli la Seleziona attributi e selezionare l'attributo XDM o scegliere il Seleziona lo spazio dei nomi dell’identità e seleziona un’identità.

  3. In Seleziona campo di destinazione finestra, scegli Seleziona lo spazio dei nomi dell’identità e seleziona un’identità, oppure scegli Seleziona attributi personalizzati e digita il nome dell’attributo desiderato nella Nome attributo campo. Il nome attributo fornito deve corrispondere a un attributo contatto esistente in Oracle Eloqua. Consulta create a contact per i nomi di attributo esatti che è possibile utilizzare in Oracle Eloqua.

    • Ripeti questi passaggi per aggiungere le mappature di attributi richieste e desiderate tra lo schema di profilo XDM e Oracle Eloqua: | Campo di origine | 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 dell’interfaccia utente di Platform con mappature di attributi.

IMPORTANT
  • Attributi specificati in Campo di destinazione deve essere denominato esattamente come specificato nella Create a contact poiché questi attributi formeranno il corpo della richiesta.
  • Attributi specificati in Campo di origine non seguire tali restrizioni. Puoi mapparlo in base alle tue esigenze, ma se il formato dei dati non è corretto quando viene inviato a Oracle Eloqua si verificherà un errore. Ad esempio, puoi mappare il Campo di origine spazio dei nomi delle identità contact key, ABC ID ecc. a Campo di destinazione : EloquaId dopo aver verificato che i valori ID corrispondano al formato accettato da Oracle Eloqua.
  • Il EloquaID la mappatura è obbligatoria per aggiornare gli attributi corrispondenti all’identità.
  • Il emailAddress è richiesta la mappatura. 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>"
}

Una volta completate le mappature per la connessione di destinazione, seleziona Successivo.

NOTE
La destinazione aggiunge automaticamente un identificatore univoco ai nomi del pubblico selezionato a 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 la sezione Convalidare l’esportazione dei dati esempio di schermata di sezione di un Oracle Eloqua Pagina Dettagli contatto con il 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 al Dati di attivazione , quindi seleziona un nome per il pubblico.
    Esempio di schermata dell’interfaccia 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 dell’interfaccia utente di Platform che mostra il segmento.

  4. Accedi a Oracle Eloqua , quindi passare al Panoramica dei contatti per verificare se i profili del pubblico sono stati aggiunti. Per visualizzare lo stato del pubblico, approfondisci in Dettagli contatto e verificare se è stato creato il campo contatto con il nome del pubblico selezionato come prefisso.

Oracle di schermata dell’interfaccia utente Eloqua 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

Tutti Adobe Experience Platform le destinazioni 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, consulta la sezione Panoramica sulla governance dei dati.

Errori e risoluzione problemi errors-and-troubleshooting

Quando crei la destinazione, potresti ricevere uno dei seguenti messaggi di errore: 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 in guardrail sezione. Per risolvere questo errore, assicurati di non superare il limite del campo contatto personalizzato in Oracle Eloqua.
La schermata dell’interfaccia utente di Platform mostra l’errore.

Consulta la sezione Oracle Eloqua Codici di stato HTTP e Oracle Eloqua Errori di convalida pagine per un elenco completo di codici di stato e di errore con spiegazioni.

Risorse aggiuntive additional-resources

Per ulteriori dettagli, vedi Oracle Eloqua documentazione:

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 il casi d’uso sezione con un esempio più chiaro di quando i clienti trarrebbero vantaggio dall’utilizzo di questa destinazione.
  • Abbiamo aggiornato il mappatura sezione con chiari esempi di mappature obbligatorie e facoltative.
  • Abbiamo aggiornato il Connetti alla destinazione sezione con un esempio su come creare il valore concatenato per il Nome utente campo utilizzando Oracle Eloqua Nome dell’azienda e Oracle Eloqua Nome utente. (PLATIR-28343)
  • Abbiamo aggiornato il Raccogli Oracle Eloqua credenziali e Inserisci i dettagli della destinazione sezioni con istruzioni su Oracle Eloqua Pod selezione. Il "Pod" viene utilizzato dalla destinazione per creare l’URL di base per le chiamate API. Il Oracle Eloqua prerequisiti è stata aggiornata anche con indicazioni sull’assegnazione "Utenti avanzati - Autorizzazioni di marketing" come obbligatorio "Gruppi di sicurezza" per Oracle Eloqua dell'istanza.
Marzo 2023 Versione iniziale Versione di destinazione iniziale e pubblicazione della documentazione.
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6