Envio de dados para campanhas do Salesforce

Pode usar a integração de campanhas do Salesforce do Looker para criar campanhas no Salesforce e preencher os membros da campanha com leads e contactos de uma análise detalhada ou um Look do Looker. Pode optar por criar uma nova campanha ou anexar utilizadores a uma campanha existente no Looker.

Requisitos de configuração

  • API Salesforce v42.0 e posterior (lançada na primavera de 2018)
  • Os utilizadores precisam de autorizações de "Criação" e "Edição" no objeto Campaigns (isto está associado ao perfil "Utilizador de marketing" por predefinição), bem como a caixa de verificação "Utilizador de marketing" selecionada no respetivo perfil de utilizador
    • Se não tiver autorizações suficientes, pode ver a seguinte mensagem de erro: entity type cannot be inserted...

Instruções de configuração

  1. Crie um atributo do utilizador para controlar o acesso à ação e especifique o domínio do Salesforce. Na página Atributos do utilizador, na secção Utilizadores do menu Administração, clique em Criar atributo do utilizador. Defina o novo atributo do utilizador:

    • Nome: salesforce_campaigns_action_domain
    • Etiqueta: Domínio de ação das campanhas do Salesforce
    • Tipo de dados: string
    • Acesso do utilizador: Ver
    • Ocultar valores: Não
    • Nenhum valor predefinido

    Selecione Guardar.

  2. Depois de definir um atributo do utilizador, pode atribuir o domínio do Salesforce (por exemplo, "https://MyDomainName.my.salesforce.com") como um valor aos utilizadores individuais e aos grupos de utilizadores que vão usar a ação. Selecione os separadores Valores do utilizador e Valores do grupo na parte superior da página Atributos do utilizador para atribuir valores a utilizadores individuais e grupos de utilizadores, respetivamente.

    • Os diferentes utilizadores podem segmentar domínios diferentes (por exemplo, uma instância do Salesforce de preparação ou desenvolvimento) e pode atualizar o valor do domínio em qualquer altura.
    • Os utilizadores que não tenham um valor atribuído não veem a ação como uma opção de destino.

  3. Em seguida, ative a ação. Aceda à página Ações na secção Plataforma do menu Administração e selecione Ativar junto à ação Domínio de ação das campanhas do Salesforce. Na página Domínio de ação das campanhas do Salesforce, ative o botão Ativado e selecione o atributo do utilizador Domínio de ação das campanhas do Salesforce para o campo Domínio do Salesforce. Clique em Guardar.

  4. Opcionalmente, configure as etiquetas LookML sfdc_contact_id e sfdc_lead_id para os campos de contactos e leads, respetivamente. Em alternativa, a ação tenta fazer a correspondência da etiqueta do campo com as seguintes expressões regulares: /contact id/i e /lead id/i (sem distinção entre maiúsculas e minúsculas).

Usar a ação de campanhas do Salesforce

Depois de configurar a ação Salesforce Campaigns, pode usá-la no programador do Looker:

  1. A partir de uma análise detalhada ou de uma exploração, crie um agendamento ou selecione a opção para enviar uma entrega única.
  2. Em Para onde devem ir estes dados?, selecione a ação Campanhas do Salesforce.
  3. Na primeira vez que usar a ação, é-lhe pedido que inicie sessão no Salesforce. Clique em Iniciar sessão.
  4. No ecrã de consentimento OAuth, clique em Permitir e volte à janela do Looker Scheduler.

  5. Selecione Validar credenciais. Depois de iniciar sessão no Salesforce no programador do Looker, preencha o formulário de ação Campanhas do Salesforce para configurar os detalhes da entrega do Look ou da exploração:

    1. Criar ou acrescentar: selecione Criar para criar uma nova campanha ou Acrescentar para modificar uma campanha existente.
    2. Nome da campanha: introduza o nome da nova campanha ou selecione uma campanha existente.
    3. Estado do membro: selecione o estado dos membros da campanha. Esta lista é preenchida com os estados disponíveis da sua instância do Salesforce.
    4. Apresentar erros do Salesforce no Looker: defina esta opção como Sim para apresentar erros do Salesforce com a definição de membros da campanha nos detalhes do estado da tarefa agendada do Looker. Isto regista um Erro no estado da tarefa agendada do Looker na página Histórico de agendamentos no menu Administração, o que é útil para resolver problemas de erros ao nível do membro. Defina esta opção como Não para ignorar todos os erros relacionados com membros da campanha (predefinição). Isto regista o estado Concluído, independentemente de quaisquer erros que possam ter ocorrido quando configurou os membros da campanha.

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

  7. Selecione Enviar.

Remover a ação de campanhas do Salesforce

Se quiser mudar a instância do Salesforce ligada ou desligar a ação do Looker da sua instância do Salesforce, pode revogar a ligação à aplicação Looker a partir da sua conta do Salesforce.

Limitações

  • Esta ação está limitada a um máximo de 5000 linhas. A funcionalidade para enviar todos os resultados está atualmente em desenvolvimento.
  • Cada edição do Salesforce tem um limite para o número de chamadas API permitidas num período de 24 horas. Consulte a documentação Limites e atribuições de pedidos de API do Salesforce para saber os limites de API da sua instância. Esta ação tira partido dos pedidos POST com sObject Collections para executar vários registos (200 registos por chamada de API) num único pedido.