Programar uma transferência do Salesforce Marketing Cloud

Visualização

Esse recurso está sujeito aos "Termos de ofertas pré-GA" na seção "Termos de Serviço gerais" dos Termos específicos de serviço. Os recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

Observação :para receber suporte ou enviar feedback sobre esse recurso, entre em contato com [e-mail].

Com o serviço de transferência de dados do BigQuery para o conector do Salesforce Marketing Cloud, é possível programar e gerenciar automaticamente jobs de carregamento recorrentes do Salesforce Marketing Cloud para o BigQuery.

Antes de começar

Nas seções a seguir, descrevemos as etapas que você precisa seguir antes de criar uma transferência do Salesforce Marketing Cloud.

Pré-requisitos do Salesforce Marketing Cloud

Você precisa ter as seguintes informações ao criar uma transferência do Salesforce Marketing Cloud:

Nome do parâmetro	Descrição
subdomain	O subdomínio da API
instance	A instância do servidor de API
clientId	O ID do cliente de integração do app
clientSecret	A chave secreta do cliente de integração do app

As etapas a seguir mostram como conseguir as informações necessárias para criar uma transferência do Salesforce Marketing Cloud:

1. Instalar um pacote de integração de API do tipo servidor para servidor. Anote o ID e a chave secreta do cliente e o subdomínio na seção Componentes da página de detalhes do pacote.
   • O subdomínio faz parte do URI base. Por exemplo, no URI da base de autenticação https://SUBDOMAIN.auth.marketingcloudapis.com/, SUBDOMAIN é o valor do subdomínio.
   • Para mais informações, consulte Integrações de servidor para servidor com tipo de concessão de credenciais do cliente.
2. Encontre a instância do servidor de API no URL depois de fazer login no aplicativo Salesforce Marketing Cloud. O valor da instância inclui s seguido por um valor numérico. Por exemplo, no URL https://mc.s4.exacttarget.com/, o valor da instância é s4. Para mais informações, acesse Encontrar o local da pilha de uma conta do Marketing Cloud.

Também é preciso definir as configurações de permissões de escopo para permitir uma transferência do Salesforce Marketing Cloud:

1. Faça login no aplicativo Salesforce Marketing Cloud.

2. Expanda o menu suspenso do seu perfil e clique em Configuração.

   

3. Na barra de navegação em Ferramentas da plataforma, clique em Apps > Pacotes instalados.

4. Selecione um pacote instalado para modificar as configurações.

5. Na seção Componentes, clique em Editar.

6. Selecione a opção Leitura para os seguintes escopos:

   • E-mail
   • Conteúdo salvo
   • Jornadas
   • Retornos de chamada
   • Campaign

7. Clique em Salvar.

Pré-requisitos do BigQuery

• Verifique se você realizou todas as ações necessárias para ativar o serviço de transferência de dados do BigQuery.
• Crie um conjunto de dados do BigQuery para armazenar os dados.
• Se quiser configurar notificações de execução de transferência do Pub/Sub, verifique se você tem a permissão pubsub.topics.setIamPolicy do Identity and Access Management (IAM). As permissões do Pub/Sub não serão necessárias caso você configure notificações por e-mail. Para mais informações, consulte Notificações de execução do serviço de transferência de dados do BigQuery.

Papéis obrigatórios do BigQuery

Para receber as permissões necessárias para criar um conjunto de dados federado, peça ao administrador para conceder a você o papel do IAM Administrador do BigQuery (roles/bigquery.admin). Para mais informações sobre como conceder papéis, consulte Gerenciar acesso.

Esse papel predefinido contém as permissões necessárias para criar uma transferência. Para conferir as permissões exatas necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

As seguintes permissões são necessárias para criar uma transferência:

• bigquery.transfers.update no usuário
• bigquery.datasets.get no conjunto de dados de destino
• bigquery.datasets.update no conjunto de dados de destino

Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.

Configurar uma transferência de dados do Salesforce Marketing Cloud

Para criar uma transferência de dados do Salesforce Marketing Cloud:

Console

1. Acesse a página do BigQuery no console do Google Cloud.

   Acessar a página do BigQuery

2. No painel de navegação, clique em Transferências de dados > Criar uma transferência.

3. Na seção Tipo de origem, em Origem, selecione Salesforce Marketing Cloud.

4. No campo Nome de exibição, na seção Nome de configuração da transferência, insira um nome para a transferência.

5. Na seção Opções de programação, realize estas ações:

   • Na lista Frequência de repetição, selecione uma opção para especificar com que frequência essa transferência é executada. Para especificar uma frequência de repetição personalizada, selecione Personalizada. Se você selecionar Sob demanda, essa transferência vai ser executada quando você acionar manualmente a transferência.

   • Se aplicável, selecione Começar agora ou Começar no horário definido e forneça uma data de início e um horário de execução.

6. Na seção Configurações de destino, em Conjunto de dados, escolha o conjunto criado para armazenar seus dados.

7. Na seção Detalhes da fonte de dados, faça o seguinte:

   • Em Subdomain da API, digite o subdomínio da API.
   • Em Instância da API, insira o valor da instância da API.
   • Em ID do cliente, digite o ID do cliente da integração com o app.
   • Em Chave secreta do cliente, digite a chave secreta do cliente de integração com o app.

8. No menu Conta de serviço, selecione uma conta de serviço associada ao seu projeto do Google Cloud. A conta de serviço selecionada precisa ter os papéis necessários para executar a transferência.

   Se você fez login com uma identidade federada, é necessário uma conta de serviço para criar uma transferência. Se você fez login com uma Conta do Google, uma conta de serviço para a transferência é opcional.

   Para mais informações sobre o uso de contas de serviço com transferências de dados, consulte Usar contas de serviço.

9. Opcional: na seção Opções de notificação, faça o seguinte:

   • Para ativar as notificações por e-mail, clique no botão de alternância Notificação por e-mail. Quando essa opção está ativada, o administrador de transferência recebe uma notificação por e-mail quando uma execução de transferência falha.
   • Para ativar as notificações de execução de transferência do Pub/Sub para essa transferência, clique no botão de alternância Notificações do Pub/Sub. Selecione o nome do tópico ou clique em Criar um tópico.

10. Clique em Salvar.

Quando essa transferência é executada, o serviço de transferência de dados do BigQuery preenche automaticamente as tabelas a seguir com base na interface REST.

• Campaigns
• Categories
• EventDefinitions
• Journeys
• JourneyActivities
• SendDefinitions
• Subscriptions

bq

Insira o comando bq mke forneça a sinalização de execução da transferência --transfer_config.

bq mk \
    --transfer_config \
    --project_id=PROJECT_ID \
    --data_source=DATA_SOURCE \
    --display_name=DISPLAY_NAME \
    --target_dataset=DATASET \
    --params='PARAMETERS'

Substitua:

• PROJECT_ID (opcional): o ID do projeto do Google Cloud. Se --project_id não for fornecido para especificar um projeto determinado, o projeto padrão será usado;
• DATA_SOURCE: a fonte de dados (por exemplo, saphana).
• DISPLAY_NAME: o nome de exibição da configuração da transferência. O nome da transferência pode ser qualquer valor que permita identificá-la, caso você precise modificá-la mais tarde.
• DATASET: o conjunto de dados de destino na configuração da transferência.
• PARAMETERS é o parâmetro da configuração de transferência criada no formato JSON. Por exemplo, --params='{"param":"param_value"}'. Confira a seguir os parâmetros de uma transferência do Salesforce Marketing Cloud:
  • connector.subdomain: o subdomínio da API.
  • connector.instance: o valor da instância da API.
  • connector.authentication.oauth.clientId: o nome do ID do app para o cliente OAuth.
  • connector.authentication.oauth.clientSecret: a chave secreta do app para o cliente OAuth.

Por exemplo, o comando a seguir cria uma transferência do Salesforce Marketing Cloud no projeto padrão com todos os parâmetros necessários:

  bq mk \
      --transfer_config \
      --target_dataset=mydataset \
      --data_source=salesforce_marketing \
      --display_name='My Transfer' \
      --params='{"connector.subdomain": "abcd",
      "connector.instance": "x",
      "connector.authentication.oauth.clientId": "1234567890",
      "connector.authentication.oauth.clientSecret":"ABC12345"}'

API

Use o método projects.locations.transferConfigs.create e forneça uma instância do recurso TransferConfig.

Resolver problemas na configuração da transferência

Se você estiver com problemas para configurar uma transferência do Salesforce Marketing Cloud, tente as seguintes etapas de solução de problemas:

• Verifique se a autenticação configurada para o pacote de integração da API está configurada como De servidor para servidor.
• Verifique se o app de autenticação está configurado com as permissões necessárias em Escopo.

Mensagens de erro

Erro: invalid_grant. The client's IP address is unauthorized for this account. Allowlist the client's IP address in Marketing Cloud Administration.

Resolução: tente uma das seguintes etapas:

• Ative todos os endereços IP disponíveis para recursos do Google Cloud.
• Desative a lista de permissões de IP. Para isso, faça login no aplicativo Salesforce Marketing Cloud e navegue até a página Configuração > Configurações de segurança. Clique em Editar e configure a configuração Restringir logins por endereço IP (lista de permissões de IP) como Lista de permissões de IP desativada.

Preços

Não há custo para transferir dados do Salesforce Marketing Cloud para o BigQuery enquanto esse recurso está em Pré-lançamento.

A seguir

• Para uma visão geral do serviço de transferência de dados do BigQuery, consulte Introdução ao serviço de transferência de dados do BigQuery.
• Para mais informações sobre o uso de transferências, incluindo detalhes sobre a configuração de transferência, como listar configurações e como visualizar o histórico de execução de uma transferência, consulte Como trabalhar com transferências.
• Saiba como carregar dados com operações entre nuvens.