(API) Oracle Eloqua conexão

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 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 o 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 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 prerequisites-destination

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 gather-credentials

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

Credencial
Descrição
Company Name
O nome da empresa associado à Oracle Eloqua conta.
Posteriormente, você usará o Company Name e Oracle Eloqua Username como uma sequência de caracteres concatenada a ser usada como Nome de usuário quando autenticando no destino.
Username
O nome de usuário do seu Oracle Eloqua conta.
Password
A senha do seu Oracle Eloqua conta.
Pod
Oracle Eloqua O suporta 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 em qual POD você está, faça logon no 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 seu pod é p01. Consulte a determinação do POD para obter orientação adicional.

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

Medidas de proteção guardrails

NOTE
  • Oracle Eloqua os campos de contato personalizados são criados automaticamente usando os nomes dos públicos selecionados durante a Selecionar segmentos etapa.
  • 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 supported-identities

Oracle Eloqua O 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 campo.
  • Para cada público selecionado na Platform, a variável correspondente Oracle Eloqua O status do segmento é atualizado com o status de público-alvo 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 transmissão.

Conectar ao destino connect

IMPORTANT
Para se conectar ao destino, você precisa da variável Exibir destinos e Gerenciar destinos permissões de controle de acesso. Leia o visão geral do controle de acesso ou entre em contato com o administrador do produto para obter as permissões necessárias.

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 authenticate

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.
Captura de tela da interface do usuário da plataforma mostrando como autenticar.

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

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

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

Ativar públicos-alvo para esse destino activate

IMPORTANT

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 mapping-considerations-example

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:

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

IMPORTANT
  • Atributos especificados na variável Campo de destino deve ser nomeado exatamente conforme especificado na Create a contact já que esses atributos formarão o corpo da solicitação.
  • Atributos especificados na variável Campo de origem 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 isso resultará em um erro. Por exemplo, é possível mapear a variável Campo de origem namespace de identidade contact key, ABC ID etc. para Campo de destino : EloquaId após garantir que os valores de ID correspondam ao formato aceito pelo Oracle Eloqua.
  • A variável EloquaID o mapeamento é obrigatório para atualizar atributos correspondentes à identidade.
  • A variável emailAddress o mapeamento é obrigató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 Próxima.

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 o Oracle Eloqua. Isso garante que os nomes de campo de contato correspondentes aos nomes de público-alvo não se sobreponham. Consulte a Validar exportação de dados seção captura de tela exemplo de um Oracle Eloqua Página de detalhes do contato com campo de contato personalizado criado usando os nomes do público-alvo.

Validar exportação de dados exported-data

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.
    Exemplo de captura de tela da interface do Platform 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 Platform mostrando o 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.

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 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 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 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.
Captura de tela da interface do usuário da plataforma mostrando erro.

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 additional-resources

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

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 o casos de uso com um exemplo mais claro de quando os clientes se beneficiariam de usar esse destino.
  • Atualizamos o mapeamento com exemplos claros de mapeamentos obrigatórios e opcionais.
  • Atualizamos o Conectar ao destino com um exemplo sobre como construir o valor concatenado para a variável Nome de usuário campo usando o Oracle Eloqua Nome da empresa e o Oracle Eloqua Nome de usuário. (PLATIR-28343)
  • Atualizamos o Coletar Oracle Eloqua credenciais e a variável Preencher detalhes do destino seções com orientações sobre Oracle Eloqua Pod seleção. A variável "Pod" O valor de é usado pelo destino para construir o URL base para as chamadas de API. A variável Oracle Eloqua pré-requisitos A seção também foi atualizada com orientações sobre atribuição "Usuários avançados - Permissões de marketing" como obrigatório "Grupos de segurança" para seu Oracle Eloqua instância.
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