Como enviar dados para o Salesforce Campaigns

Você pode usar a integração do Looker com as campanhas do Salesforce para criar campanhas no Salesforce e preencher os membros da campanha com leads e contatos de uma análise ou um visualizador do Looker. Você pode criar uma nova campanha ou anexar usuários a uma campanha existente no Looker.

Requisitos de configuração

  • API Salesforce v42.0 e versões mais recentes (lançada na primavera de 2018)
  • Os usuários precisam ter as permissões "Criar" e "Editar" no objeto "Campanhas" (associado ao perfil "Usuário de marketing" por padrão) e a caixa de seleção "Usuário de marketing" selecionada no perfil de usuário.
    • Se você não tiver permissões suficientes, poderá receber a seguinte mensagem de erro: entity type cannot be inserted...

Instruções de configuração

  1. Crie um atributo do usuário para controlar o acesso à ação e especifique o domínio do Salesforce. Na página Atributos do usuário, na seção Usuários do menu Administrador, clique em Criar atributo do usuário. Defina o novo atributo do usuário:

    • Nome: salesforce_campaigns_action_domain
    • Rótulo: Domínio de ação das campanhas do Salesforce
    • Tipo de dados: String
    • Acesso do usuário: visualizar
    • Ocultar valores: Não
    • Nenhum valor padrão

    Selecione Salvar.

  2. Depois de definir um atributo do usuário, você pode atribuir o domínio do Salesforce (por exemplo, "https://MyDomainName.my.salesforce.com") como um valor para os usuários e grupos de usuários que vão usar a ação. Selecione as guias Valores do usuário e Valores do grupo na parte de cima da página Atributos do usuário para atribuir valores a usuários individuais e grupos de usuários, respectivamente.

    • Usuários diferentes podem segmentar domínios diferentes (por exemplo, uma instância de desenvolvimento ou de preparação do Salesforce) e você pode atualizar o valor do domínio a qualquer momento.
    • Os usuários que não tiverem um valor atribuído não vão encontrar a ação como uma opção de destino.

  3. Em seguida, ative a ação. Acesse a página Ações na seção Plataforma do menu Administrador e selecione Ativar ao lado da ação Domínio de ação das campanhas do Salesforce. Na página Domínio de ação das campanhas do Salesforce, ative a opção Ativado e selecione o atributo de usuário Domínio de ação das campanhas do Salesforce para o campo Domínio do Salesforce. Clique em Salvar.

  4. Opcionalmente, configure as tags sfdc_contact_id e sfdc_lead_id do LookML para campos de contato e lead, respectivamente. Como alternativa, a ação vai tentar fazer uma correspondência de regex do rótulo do campo com as seguintes expressões: /contact id/i e /lead id/i (sem distinção entre maiúsculas e minúsculas).

Usar a ação "Campanhas do Salesforce"

Depois de configurar a ação "Campanhas do Salesforce", você pode usá-la no Programador do Looker:

  1. Em um Look ou uma Análise detalhada, crie uma programação ou selecione a opção para enviar uma entrega única.
  2. Em Para onde esses dados devem ser enviados?, selecione a ação Campanhas do Salesforce.
  3. Na primeira vez que você usar a ação, será necessário fazer login no Salesforce. Clique em Fazer login.
  4. Na tela de consentimento do OAuth, clique em Permitir e volte para a janela do Agendador do Looker.

  5. Selecione Verificar credenciais. Depois de fazer login no Salesforce no Looker Scheduler, preencha o formulário de ação Campanhas do Salesforce para configurar os detalhes da entrega do Look ou da Análise detalhada:

    1. Criar ou anexar: selecione Criar para criar uma campanha ou Anexar para modificar uma campanha existente.
    2. Nome da campanha: insira o nome da nova campanha ou selecione uma campanha existente.
    3. Status do membro: selecione o status dos membros da campanha. Essa lista será preenchida com os status disponíveis da sua instância do Salesforce.
    4. Mostrar erros do Salesforce no Looker: defina como Sim para mostrar erros do Salesforce ao definir membros da campanha nos detalhes do status da tarefa programada do Looker. Isso vai registrar um erro no status da tarefa programada do Looker na página Histórico de programação no menu Administrador, o que é útil para resolver problemas no nível do membro. Defina como Não para ignorar todos os erros relacionados aos membros da campanha (padrão). Isso vai registrar um status Concluído, independentemente de erros que possam ter ocorrido ao configurar os membros da campanha.

  6. Especifique outras opções para a entrega.

  7. Selecione Send.

Como remover a ação "Campanhas do Salesforce"

Se você quiser mudar a instância do Salesforce conectada ou desconectar a ação do Looker dela, revogue a conexão com o aplicativo do Looker na sua conta do Salesforce.

Limitações

  • Essa ação é limitada a um máximo de 5.000 linhas. A funcionalidade para enviar todos os resultados está sendo desenvolvida.
  • Cada edição do Salesforce tem um limite para o número de chamadas de API permitidas em um período de 24 horas. Consulte a documentação Limites e alocações de solicitação da API Salesforce para saber os limites da sua instância da API. Essa ação aproveita as solicitações POST com coleções de sObjects para executar vários registros (200 registros por chamada de API) em uma única solicitação.