Conexão com o (API) Oracle Eloqua

Oracle Eloqua O 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 utiliza o Atualizar um contato operação a partir do Oracle Eloqua REST API, que permite atualizar identidades em um público-alvo para Oracle Eloqua.

Oracle Eloqua usos Autenticação básica para se comunicar com a Oracle Eloqua API REST. Instruções para autenticar em seu Oracle Eloqua exemplo, são apresentados mais abaixo, no Autenticar para destino seção.

Casos de uso

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 o Oracle Eloqua, que pode ser usado para enviar o email da campanha de marketing.

Pré-requisitos

Pré-requisitos do Experience Platform

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

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

Oracle Eloqua pré-requisitos

Para exportar dados da Platform para o seu Oracle Eloqua conta que você precisa ter Oracle Eloqua conta.

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

Coletar Oracle Eloqua credenciais

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

Consulte a Fazendo login no Oracle Eloqua para obter orientação.

Medidas de proteção

• Oracle Eloqua tem um limite máximo de 250 campos de contato personalizados.

• Antes de exportar novos públicos, verifique se o número de públicos da Platform e o número de públicos existentes no Oracle Eloqua não excedam esse limite.

• Se esse limite for excedido, você encontrará um erro no Experience Platform. Isso ocorre porque a variável Oracle Eloqua A API não valida a solicitação e responde com um - 400: Erro de validação - mensagem de erro descrevendo o problema.

• Se tiver atingido o limite especificado acima, será necessário remover os mapeamentos existentes do destino e excluir os campos de contato personalizados correspondentes no Oracle Eloqua antes de poder exportar mais segmentos.

• Consulte a Oracle Eloqua Criando campos de contato para obter informações sobre limites adicionais.

Identidades suportadas

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

Tipo e frequência de exportação

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

Conectar ao destino

Para se conectar a esse 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.

Dentro de Destinos > Catálogo pesquisar (API) Oracle Eloqua. Como alternativa, você pode localizá-lo na Marketing por email categoria.

Autenticar para o destino

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

• Senha: A senha do Oracle Eloqua conta.
• Nome de usuário: uma string concatenada composta por Oracle Eloqua Nome da empresa e o Oracle Eloqua Nome de usuário.
  O valor concatenado assume a forma de {COMPANY_NAME}\{USERNAME}.
  Observe que não use chaves ou espaços e preserve as \.
  Por exemplo, se seu Oracle Eloqua O nome da empresa é MyCompany e Oracle Eloqua O nome de usuário é Username, o valor concatenado que será usado no Nome de usuário o campo é MyCompany\Username.

Para autenticar no destino, selecione Conectar ao destino.

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

Preencher detalhes do destino

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.

• Nome: um nome pelo qual você reconhecerá esse destino no futuro.
• Descrição: uma descrição que ajudará você a identificar esse destino no futuro.
• Pod: Para obter quais pod você está em, faça logon em Oracle Eloqua e observe o URL no navegador depois de fazer logon com êxito. Por exemplo, se o URL do navegador for secure.p01.eloqua.com o pod o valor que você precisa selecionar é p01. Consulte a Coletar Oracle Eloqua credenciais para obter orientação adicional.

Ativar alertas

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

Quando terminar de fornecer detalhes da conexão de destino, selecione Próxima.

Ativar públicos-alvo para esse destino

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

Considerações e exemplo de mapeamento

Para enviar corretamente os dados do público-alvo do Adobe Experience Platform para a Oracle Eloqua destino, é 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 os campos XDM para a variável Oracle Eloqua campos de destino, siga estas etapas:

1. No Mapeamento etapa, selecione Adicionar novo mapeamento. Você verá uma nova linha de mapeamento na tela.
2. No Selecionar campo de origem escolha a Selecionar atributos e selecione o atributo XDM ou escolha o atributo Selecionar namespace de identidade e selecione uma identidade.
3. No Selecionar campo de destino escolha Selecionar namespace de identidade e selecione uma identidade ou escolha Selecionar atributos personalizados e digite o nome do atributo desejado no campo Nome do atributo campo. O nome do atributo fornecido deve corresponder a um atributo de contato existente no Oracle Eloqua. Consulte create a contact para obter os nomes exatos dos atributos que você pode usar no Oracle Eloqua.

   • Repita essas etapas para adicionar os mapeamentos de atributos necessários e desejados entre seu esquema de perfil XDM e Oracle Eloqua: | Campo de origem | Campo de destino | Obrigatório | |—|—|—| |IdentityMap: Eid|Identity: EloquaId| Sim | |xdm: personalEmail.address|Attribute: emailAddress| Sim | |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| |

   • Um exemplo com os mapeamentos acima é mostrado abaixo:

     

{
     "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 Próxima.

Validar exportação de dados

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

1. Selecionar Destinos > Procurar e navegue até a lista de destinos.

2. Em seguida, selecione o destino e alterne para a guia Dados de ativação e selecione um nome de público-alvo.
   

3. Monitore o resumo do público-alvo e verifique se a contagem de perfis corresponde à contagem no segmento.
   

4. Faça logon no Oracle Eloqua site e, em seguida, navegue até o Visão geral dos contatos página para verificar se os perfis do público-alvo foram adicionados. Para ver o status do público-alvo, analise detalhadamente um Detalhes de contato e verifique se o campo de contato com o nome de público selecionado como prefixo foi criado.

Uso e governança de dados

Todos Adobe Experience Platform os destinos estão em conformidade com as políticas de uso de dados ao manipular seus dados. Para obter informações detalhadas sobre como Adobe Experience Platform fiscaliza a governança de dados, consulte o Visão geral da governança de dados.

Erros e solução de problemas

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 grades de proteção seção. Para corrigir esse erro, verifique se você não está excedendo o limite do campo de contato personalizado em Oracle Eloqua.

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

Recursos adicionais

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

• Automação de marketing do Oracle Eloqua
• API REST para o serviço de Marketing Cloud Oracle Eloqua

Changelog

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