(API) Oracle Eloqua conexão

Oracle Eloqua permite que os profissionais de marketing planejem e executem campanhas enquanto fornecem uma experiência personalizada para seus clientes potenciais. Com o gerenciamento integrado de leads e a fácil criação de campanhas, o modelo ajuda os profissionais de marketing a engajarem o público-alvo certo na hora certa da jornada do comprador e é dimensionado elegantemente para alcançar os públicos-alvo em todos os canais, incluindo email, pesquisa de exibição, vídeo e dispositivos móveis. As equipes de vendas podem fechar mais negócios a uma taxa mais rápida, aumentando o ROI do marketing por meio de insights em tempo real.

Este Adobe Experience Platform destino aproveita a operação Atualizar um contato da API REST Oracle Eloqua, que permite atualizar identidades de um público para Oracle Eloqua.

Oracle Eloqua usa Autenticação Básica para se comunicar com a API REST Oracle Eloqua. As instruções para autenticar na sua instância do Oracle Eloqua estão mais abaixo, na seção Autenticar no destino.

Casos de uso use-cases

O departamento de marketing de uma plataforma online deseja transmitir uma campanha de marketing por email para um público-alvo com curadoria de clientes potenciais. A equipe de marketing da plataforma pode atualizar as informações de clientes potenciais existentes por meio do Adobe Experience Platform, criar públicos a partir de seus próprios dados offline e enviar esses públicos para Oracle Eloqua, que pode ser usado para enviar o email da campanha de marketing.

Pré-requisitos prerequisites

Pré-requisitos do Experience Platform prerequisites-in-experience-platform

Antes de ativar dados para o destino Oracle Eloqua, você deve ter um esquema, um conjunto de dados e segmentos criados em Experience Platform.

Consulte a documentação do Experience Platform para Grupo de campos do esquema de Detalhes da associação do público-alvo se precisar de orientação sobre os status do público-alvo.

Oracle Eloqua pré-requisitos prerequisites-destination

Para exportar dados da Platform para sua conta Oracle Eloqua, é necessário ter uma conta Oracle Eloqua.

Além disso, você precisa, no mínimo, dos "Usuários avançados - Permissões de marketing" para sua instância do Oracle Eloqua. Consulte a seção "Grupos de Segurança" na página Acesso de usuário protegido para obter orientação. O acesso é exigido pelo destino para determinar programaticamente a URL base ao invocar a API Oracle Eloqua.

Obter credenciais de Oracle Eloqua gather-credentials

Anote os itens abaixo antes de autenticar no destino Oracle Eloqua:

Consulte Entrando em Oracle Eloqua para obter orientação.

Medidas de proteção guardrails

Identidades suportadas supported-identities

Oracle Eloqua oferece suporte à atualização de identidades descritas na tabela abaixo. Saiba mais sobre identidades.

Tipo e frequência de exportação export-type-frequency

Consulte a tabela abaixo para obter informações sobre o tipo e a frequência da exportação de destino.

Conectar ao destino connect

Para se conectar a este destino, siga as etapas descritas no tutorial de configuração de destino. No workflow de configuração de destino, preencha os campos listados nas duas seções abaixo.

Em Destinos > Catálogo, pesquise por (API) Oracle Eloqua. Como alternativa, você pode localizá-lo na categoria Email Marketing.

Autenticar para o destino authenticate

Preencha os campos obrigatórios abaixo. Consulte a seção Coletar Oracle Eloqua credenciais para obter qualquer orientação.

Para autenticar no destino, selecione Conectar ao destino.

Se os detalhes fornecidos forem válidos, a interface exibirá um status Conectado com uma marca de seleção verde. Você pode prosseguir para a próxima etapa.

Preencher detalhes do destino destination-details

Para configurar detalhes para o destino, preencha os campos obrigatórios e opcionais abaixo. Um asterisco ao lado de um campo na interface do usuário indica que o campo é obrigatório.

Ativar alertas enable-alerts

Você pode ativar os alertas para receber notificações sobre o status do fluxo de dados para o seu destino. Selecione um alerta na lista para assinar e receber notificações sobre o status do seu fluxo de dados. Para obter mais informações sobre alertas, consulte o manual sobre assinatura de alertas de destinos usando a interface.

Quando terminar de fornecer detalhes da conexão de destino, selecione Avançar.

Ativar públicos-alvo para esse destino activate

Leia Ativar perfis e públicos-alvo para destinos de exportação de público-alvo de streaming para obter instruções sobre como ativar públicos-alvo para este destino.

Considerações e exemplo de mapeamento mapping-considerations-example

Para enviar corretamente seus dados de público-alvo do Adobe Experience Platform para o destino Oracle Eloqua, é necessário passar pela etapa de mapeamento de campos. O mapeamento consiste em criar um link entre os campos do esquema do Experience Data Model (XDM) na sua conta da Platform e seus equivalentes correspondentes no destino.

Para mapear seus campos XDM para os campos de destino Oracle Eloqua, siga estas etapas:

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

Quando terminar de fornecer os mapeamentos para sua conexão de destino, selecione Avançar.

Validar exportação de dados exported-data

Para validar se você configurou o destino corretamente, siga as etapas abaixo:

Uso e governança de dados data-usage-governance

Todos os destinos do Adobe Experience Platform são compatíveis com as políticas de uso de dados ao manipular seus dados. Para obter informações detalhadas sobre como o Adobe Experience Platform impõe a governança de dados, consulte a visão geral da Governança de Dados.

Erros e solução de problemas errors-and-troubleshooting

Ao criar o destino, você pode receber uma das seguintes mensagens de erro: 400: There was a validation error ou 400 BAD_REQUEST. Isso acontece quando você excede o limite de 250 campos de contato personalizados, conforme descrito na seção medidas de proteção. Para corrigir esse erro, verifique se você não está excedendo o limite do campo de contato personalizado em Oracle Eloqua.

Consulte as páginas Oracle Eloqua Códigos de status HTTP e Oracle Eloqua Erros de validação para obter uma lista abrangente de códigos de status e de erro com explicações.

Recursos adicionais additional-resources

Para obter detalhes adicionais, consulte a documentação do Oracle Eloqua:

Changelog

Esta seção captura a funcionalidade e as atualizações de documentação significativas feitas neste conector de destino.