Sincronizar dados entre o Campaign e seu CRM

A sincronização de dados entre o Adobe Campaign e seu CRM é gerenciada pela Conector CRM atividade do workflow.

Por exemplo, para importar os dados do Microsoft Dynamics para o Adobe Campaign, crie o seguinte tipo de fluxo de trabalho:

Esse fluxo de trabalho importa contatos por meio do Microsoft Dynamics, sincroniza com os dados existentes do Adobe Campaign, exclui os contatos duplicados e atualiza o banco de dados do Adobe Campaign.

A atividade CRM Connector precisa ser configurada para sincronizar dados.

Com essa atividade, você pode:

Selecione a conta externa que corresponde ao CRM que deseja configurar a sincronização e selecione o objeto a ser sincronizado: contas, oportunidades, clientes potenciais, contatos, etc.

A configuração dessa atividade depende do processo a ser executado. Várias configurações são detalhadas abaixo.

Importar do CRM

Para importar dados por meio do CRM no Adobe Campaign, você precisa criar o seguinte tipo de fluxo de trabalho:

  1. Selecione uma operação Import from the CRM.

  2. No Remote object selecione o objeto a ser importado. Esse objeto corresponde a uma das tabelas criadas no Adobe Campaign durante a configuração do conector.

  3. No Remote fields digite os campos a serem importados.

    Para adicionar um campo, clique no botão Add na barra de ferramentas e, em seguida, clique no ícone Edit expression.

    Se necessário, altere o formato dos dados usando a lista suspensa da variável Conversion colunas. Os possíveis tipos de conversão são detalhados em esta seção.

    ATENÇÃO

    O identificador do registro no CRM é obrigatório para vincular objetos no CRM e no Adobe Campaign. Ele é adicionado automaticamente quando a caixa é aprovada.

    A última data de modificação no lado do CRM também é obrigatória para importações de dados incrementais.

  4. Você pode filtrar os dados a serem importados com base nas suas necessidades. Para fazer isso, clique em Edit the filter….

    No exemplo a seguir, o Adobe Campaign só importará contatos nos quais algumas atividades foram registradas desde 1º de novembro de 2021.

    ATENÇÃO

    As limitações relacionadas aos modos do filtro de dados são detalhadas em esta seção.

  5. Selecione o Use automatic index… para gerenciar automaticamente a sincronização de objetos incrementais entre o CRM e o Adobe Campaign, dependendo da data e da última modificação.

    Para obter mais informações, consulte esta seção.

Gerenciar variáveis

Ative o Automatic index para coletar apenas objetos modificados desde a última importação.

A data da última sincronização é armazenada em uma opção especificada na janela de configuração, por padrão: LASTIMPORT_<%=instance.internalName%>_<%=activityName%>.

OBSERVAÇÃO

Essa nota se aplica somente à atividade genérica CRM Connector. Para outras atividades do CRM, o processo é automático.

Essa opção deve ser criada e preenchida manualmente em Administration > Platform > Options. Deve ser uma opção de texto e seu valor deve corresponder ao seguinte formato: aaaa/MM/dd hh:mm:ss.

Você precisa atualizar essa opção manualmente para qualquer outra importação.

É possível especificar o campo do CRM remoto que será levado em consideração para identificar as alterações mais recentes.

Por padrão, os seguintes campos são usados (na ordem especificada):

  • Para o Microsoft Dynamics: modifiedon,
  • Para o Salesforce.com: LastModifiedDate, SystemModstamp.

A ativação da opção Automatic index gera três variáveis que podem ser usadas no fluxo de trabalho de sincronização por meio de uma atividade do tipo JavaScript code. Essas atividades são:

  • vars.crmOptionName: nome da opção que contém a data da última importação.

  • vars.crmStartImport: data de início (incluída) da última importação de dados.

  • vars.crmEndDate: data final (excluída) da última importação de dados.

    OBSERVAÇÃO

    Essas datas são exibidas no seguinte formato: aaaa/MM/dd hh:mm:ss.

Filtrar dados

Para garantir uma operação eficiente com os vários CRMs, os filtros precisam ser criados com as seguintes regras:

  • Cada nível de filtragem só pode usar um tipo de operador.
  • O operador AND NOT não é suportado.
  • Comparações podem dizer respeito somente a valores nulos (tipo "está vazio"/"não está vazio") ou números. Isso significa que o valor (coluna à direita) é avaliado e o resultado dessa avaliação deve ser um número. Portanto, as comparações do tipo JOIN não são compatíveis.
  • O valor contido na coluna à direita é avaliado em JavaScript.
  • Não há suporte para comparações JOIN.
  • A expressão na coluna à esquerda deve ser um campo. Ele não pode ser uma combinação de várias expressões, um número, etc.

Ordenar por

No Microsoft Dynamics e no Salesforce.com, você pode classificar os campos remotos a serem importados em ordem crescente ou decrescente.

Para fazer isso, clique no link Order by e adicione as colunas à lista.

A ordem das colunas na lista é a ordem de classificação:

Identificação de registro

Em vez de importar elementos incluídos (e possivelmente filtrados) no seu CRM, você pode usar uma população calculada anteriormente no workflow.

Para fazer isso, selecione a opção Use the population calculated upstream e especifique o campo que contém o identificador remoto.

Em seguida, selecione os campos da população de entrada que deseja importar, conforme mostrado abaixo:

Exportar para o CRM

Exporte os dados do Adobe Campaign para o seu CRM para copiar todo o conteúdo para o banco de dados do CRM.

Para exportar dados para seu CRM, crie o seguinte tipo de workflow:

  1. Selecione uma operação Export to CRM.

  2. Vá para o Remote object e selecione o objeto a ser exportado. Esse objeto corresponde a uma das tabelas criadas no Adobe Campaign durante a configuração do conector.

    ATENÇÃO

    A função de exportação da variável CRM Connector pode inserir ou atualizar campos no seu CRM. Para ativar atualizações de campo no CRM, especifique a chave primária da tabela remota. Se a chave estiver ausente, os dados serão inseridos, em vez de serem atualizados.

  3. Se precisar realizar exportações mais rápidas, verifique a Export in Batches opção.

  4. No Mapping seção , clique em New para especificar os campos a serem exportados e o mapeamento no CRM.

    Para adicionar um campo, clique no botão Add na barra de ferramentas e, em seguida, clique no ícone Edit expression.

    OBSERVAÇÃO

    Se nenhuma correspondência for definida para um campo, os valores não poderão ser atualizados: eles são inseridos diretamente no seu CRM.

    Se necessário, altere o formato dos dados usando a lista suspensa da variável Conversion colunas. Os possíveis tipos de conversão são detalhados em esta seção.

    OBSERVAÇÃO

    A lista de registros a serem exportados e o resultado da exportação são salvas em um arquivo temporário que permanece acessível até que o workflow seja concluído ou reiniciado. Isso permite que você inicie o processo com segurança em caso de erros.

Configurações adicionais

Formato dos dados

É possível converter o formato dos dados de forma instantânea ao importá-los para ou a partir do seu CRM.

Para fazer isso, selecione a conversão a ser aplicada na coluna correspondente.

O modo Default aplica conversão automática de dados, que na maioria dos casos é igual a copiar/colar os dados. No entanto, o gerenciamento de fuso horário é aplicado.

Outras conversões possíveis são:

  • Date only: exclui os campos do tipo Data + Hora.
  • Without time offset: cancela o gerenciamento de fuso horário aplicado no modo padrão.
  • Copy/Paste: O usa dados brutos como cadeias de caracteres (sem conversão).

Processamento de erros

Dentro da estrutura de importações ou exportações de dados, é possível aplicar um processo específico a erros e rejeições. Para fazer isso, selecione as opções Keep the rejections in a file e Process errors na guia Behavior.

Essas opções adicionam as transições de saída relacionadas.

Em seguida, insira as atividades relevantes para processar dados. Por exemplo, adicione uma Aguardar atividade e agendar novas tentativas para erros.

A transição Reject de saída permite que você acesse o schema de saída que contém as colunas específicas relevantes para mensagens e códigos de erro. Para o Salesforce.com, essa coluna é errorSymbol (símbolo de erro, diferente do código de erro), errorMessage (descrição do contexto de erro).

Importar objetos excluídos no CRM

É possível importar objetos excluídos em seu CRM para o Adobe Campaign.

  1. Selecione uma operação Import objects deleted in the CRM.

  2. Vá até a lista suspensa Remote object e selecione o objeto relacionado ao processo. Esse objeto corresponde a uma das tabelas criadas no Adobe Campaign durante a configuração do conector.

  3. Especifique o período de exclusão que será considerado no Start date e End date campos (as datas são incluídas).

    ATENÇÃO

    O período de exclusão deve coincidir com as limitações específicas do CRM. Por exemplo, para Salesforce.com, elementos excluídos há mais de 30 dias não podem ser recuperados.

Excluir objetos no CRM

Para excluir objetos em seu CRM, especifique a chave primária dos elementos remotos a serem excluídos.

A guia Behavior permite habilitar o processamento de rejeições. Essa opção gera uma segunda transição de saída para a atividade CRM connector. Para obter mais informações, consulte Processamento de erros.

Nesta página