(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:

Credencial
Descrição
Company Name
O nome da empresa associado à sua conta Oracle Eloqua.
Posteriormente, você usará Company Name e Oracle Eloqua Username como uma cadeia de caracteres concatenada a ser usada como Nome de Usuário ao autenticar no destino.
Username
O nome de usuário da sua conta Oracle Eloqua.
Password
A senha da sua conta Oracle Eloqua.
Pod
O Oracle Eloqua oferece suporte a vários data centers, cada um com um nome de domínio exclusivo. Oracle Eloqua refere-se a eles como "pods", existem atualmente sete no total - p01, p02, p03, p04, p06, p07 e p08. Para obter o POD em que você está, faça logon no Oracle Eloqua e anote a URL no navegador depois de fazer logon com êxito. Por exemplo, se a URL do navegador for secure.p01.eloqua.com, pod será p01. Consulte a página determinando seu POD para obter orientação adicional.

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

Medidas de proteção guardrails

NOTE
  • Oracle Eloqua campos de contato personalizados são criados automaticamente usando os nomes dos públicos selecionados durante a etapa Selecionar segmentos.
  • Oracle Eloqua tem um limite máximo de 250 campos de contatos 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 em Oracle Eloqua não excedem esse limite.

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

  • Se você atingiu o limite especificado acima, é necessário remover os mapeamentos existentes do destino e excluir os campos de contato personalizados correspondentes na conta do Oracle Eloqua antes de exportar mais segmentos.

  • Consulte a página Oracle Eloqua Criando Campos de Contato para obter informações sobre limites adicionais.

Identidades suportadas supported-identities

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

Identidade de destino
Descrição
Obrigatório
EloquaId
Identificador exclusivo do contato.
Sim

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.

Item
Tipo
Notas
Tipo de exportação
Baseado em perfil
  • Você está exportando todos os membros de um segmento, juntamente com os campos de esquema desejados (por exemplo: endereço de email, número de telefone, sobrenome), de acordo com o mapeamento de campos.
  • Para cada público selecionado na Platform, o status de segmento Oracle Eloqua correspondente é atualizado com seu status de público da Platform.
Frequência de exportação
Streaming
  • Os destinos de transmissão são conexões baseadas em API "sempre ativas". Assim que um perfil é atualizado em Experience Platform com base na avaliação do público-alvo, o conector envia a atualização downstream para a plataforma de destino. Leia mais sobre destinos de streaming.

Conectar ao destino connect

IMPORTANT
Para se conectar ao destino, você precisa de Exibir Destinos e Gerenciar Destinos permissões de controle de acesso. Leia a visão geral do controle de acesso ou contate o administrador do produto para obter as permissões necessárias.

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.

  • Senha: a senha da sua conta Oracle Eloqua.
  • Nome de Usuário: uma cadeia de caracteres concatenada composta pelo Nome da Empresa Oracle Eloqua e pelo Nome de Usuário Oracle Eloqua.
    O valor concatenado assume a forma de {COMPANY_NAME}\{USERNAME}.
    Observe que não use chaves ou espaços e preserve a \.
    Por exemplo, se o Nome da Empresa Oracle Eloqua for MyCompany e o Nome de Usuário Oracle Eloqua for Username, o valor concatenado que você usará no campo Nome de Usuário será MyCompany\Username.

Para autenticar no destino, selecione Conectar ao destino.
Captura de tela da interface do usuário da plataforma mostrando como autenticar.

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.
Captura de tela da Interface do Usuário da Plataforma mostrando os detalhes de destino.

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

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

IMPORTANT

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:

  1. Na etapa Mapeamento, selecione Adicionar novo mapeamento. Você verá uma nova linha de mapeamento na tela.

  2. Na janela Selecionar campo de origem, escolha a categoria Selecionar atributos e selecione o atributo XDM ou escolha o Selecionar namespace de identidade e selecione uma identidade.

  3. Na janela 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. O nome do atributo fornecido deve corresponder a um atributo de contato existente em Oracle Eloqua. Consulte create a contact para obter os nomes de atributos exatos que você pode usar em 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 do Source | 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:

      Exemplo de captura de tela da interface do usuário da plataforma com mapeamentos de atributos.

IMPORTANT
  • Os atributos especificados no campo de Destino devem ser nomeados exatamente como especificado em Create a contact, pois esses atributos formarão o corpo da solicitação.
  • Os atributos especificados no campo Source não seguem nenhuma restrição desse tipo. Você pode mapeá-lo com base na sua necessidade. No entanto, se o formato dos dados não estiver correto quando enviado para o Oracle Eloqua, ocorrerá um erro. Por exemplo, você pode mapear o campo do Source namespace de identidade contact key, ABC ID etc. para Campo de destino: EloquaId depois de verificar se os valores de ID correspondem ao formato aceito por Oracle Eloqua.
  • O mapeamento EloquaID é obrigatório para atualizar atributos correspondentes à identidade.
  • O mapeamento emailAddress é necessário. Sem ela, a API lança um erro, como mostrado abaixo:
code language-json
{
     "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.

NOTE
O destino coloca automaticamente um identificador exclusivo entre os nomes de público selecionados em cada execução ao enviar as informações do campo de contato para Oracle Eloqua. Isso garante que os nomes de campo de contato correspondentes aos nomes de público-alvo não se sobreponham. Consulte o exemplo de tela da seção Validar exportação de dados de uma página de Detalhes do Contato Oracle Eloqua com um campo de contato personalizado criado usando os nomes de público-alvo.

Validar exportação de dados exported-data

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

  1. Selecione 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.
    Exemplo de captura de tela da interface do usuário da plataforma mostrando Dados de Ativação de Destinos.

  3. Monitore o resumo do público-alvo e verifique se a contagem de perfis corresponde à contagem no segmento.
    Exemplo de captura de tela da Interface do Usuário da Plataforma mostrando o Segmento.

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

Captura de tela da interface do usuário do Oracle Eloqua mostrando a página Detalhes do Contato com o campo de contato personalizado criado com o nome do público-alvo.

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.
Captura de tela da Interface do Usuário da Plataforma mostrando erro.

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.

Exibir changelog
table 0-row-3 1-row-3 2-row-3 layout-auto
Mês de lançamento Tipo de atualização Descrição
Abril de 2023 Atualização da documentação
  • Atualizamos a seção casos de uso com um exemplo mais claro de quando os clientes se beneficiariam com o uso desse destino.
  • Atualizamos a seção mapping com exemplos claros de mapeamentos obrigatórios e opcionais.
  • Atualizamos a seção Conectar ao destino com um exemplo sobre como construir o valor concatenado para o campo Nome de Usuário usando o Nome da Empresa Oracle Eloqua e o Nome de Usuário Oracle Eloqua. (PLATIR-28343)
  • Atualizamos as seções Coletar Oracle Eloqua credenciais e Preencher detalhes do destino com orientações sobre a seleção do Oracle Eloqua Pod. O valor "Pod" é usado pelo destino para construir a URL base para as chamadas de API. A seção Oracle Eloqua pré-requisitos também foi atualizada com orientação sobre como atribuir "Usuários Avançados - Permissões de marketing" como um "Grupos de segurança" necessário para sua instância Oracle Eloqua.
Março de 2023 Versão inicial Versão inicial de destino e publicação da documentação.
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6