Uma origem de dados é um contentor que armazena os dados que carrega para o Analytics. Inclui a base de dados, o serviço ou o ficheiro CSV carregado e um mapeamento dos campos do Analytics para os campos na base de dados, no serviço ou no CSV externo. As origens de dados controlam o modo como os dados carregados são associados aos dados existentes. Pode configurar as origens de dados ao nível da propriedade.
Para gerir as origens de dados de uma propriedade, clique em Administração e, de seguida, clique em Importação de dados em Recolha e modificação de dados.
Tipos de origens de dados
Um tipo de origem de dados corresponde ao tipo específico de dados que quer importar. Por exemplo, existem tipos de origens de dados para:
Para cada tipo, dispõe de opções diferentes de dimensões e métricas (o esquema) das quais pode carregar dados. Consoante a origem de dados, pode optar por:
- Carregar um CSV
- Usar o SFTP
- Ligar-se ao Salesforce (saiba mais).
Esta secção destina-se aos utilizadores que querem importar dados de eventos offline do Salesforce no Google Analytics 4. A importação do Salesforce usa o tipo de Importação de dados de eventos offline. Saiba como importar dados de eventos offline.
- Tem de ter a função de Editor para a propriedade do Analytics que vai usar para importar os dados.
- Os exemplos de código nesta secção são fornecidos como referência. Os seus detalhes de implementação específicos podem requerer código adicional ou abordagens diferentes.
Passo 1: decida como identificar os seus utilizadores
O Analytics oferece 2 formas de identificar os seus utilizadores de forma programática: Client-ID e User-ID. Para suportar a Importação de dados para o Salesforce, tem de implementar o Client-ID. Pode optar por implementar também o User-ID.
O Client-ID identifica de forma pseudonimizada uma instância do navegador. Trata-se de um identificador baseado em cookies não autenticado que é criado automaticamente por um site compatível com o Analytics na primeira visita de um utilizador.
O User-ID permite a análise de grupos de sessões em vários dispositivos através de uma string de ID única, persistente e sem informações de identificação pessoal que representa um utilizador.
Tem de adicionar o Client-ID e, opcionalmente, o User-ID à página do formulário de leads e a quaisquer outras páginas que queira medir. Pode fazê-lo através do Gestor de Etiquetas da Google ou de uma variável JavaScript.
Passo 2: configure o acesso a objetos e campos do Salesforce
Para configurar a integração do Salesforce com o Analytics, tem de ter acesso total aos seguintes objetos e campos do Salesforce. É possível que uma conta de utilizador do Salesforce com acesso de administrador do sistema já tenha acesso a estes campos.
Além disso, certifique-se de que concede a autorização Modify All Data ao utilizador que está a associar as suas contas do Salesforce e Analytics. Isto é exigido pela Salesforce Metadata API para permitir que a Google obtenha dados de definições de conversão de potenciais clientes. Esta integração não modifica a sua conta do Salesforce e a API Metadata é usada em modo só de leitura.
Veja a lista de campos obrigatórios
| Objeto | Campos obrigatórios | |
|---|---|---|
| LeadStatus |
ID MasterLabel SortOrder |
|
| OpportunityStage |
ID MasterLabel SortOrder IsActive |
|
| LeadHistory |
CreatedDate OldValue NewValue Campo |
|
| Lead |
Estado GACLIENTID* GAUSERID* GAMEASUREMENTID* |
|
| OpportunityFieldHistory |
CreatedDate OldValue NewValue Campo |
|
| Oportunidade |
Valor StageName GACLIENTID* GAUSERID* GAMEASUREMENTID* |
|
| OpportunityLineItem | Todos os campos | |
| Product2 (produtos) | Todos os campos | |
| Pricebook2 (tabelas de preços) | Todos os campos | |
* Campos personalizados criados no passo 3 abaixo.
Se utilizar a Group Edition ou a Professional Edition do Salesforce, o acesso aos campos é concedido ao adicionar os campos necessários aos esquemas de páginas Lead e Opportunity. Saiba mais acerca de como definir esquemas de páginas e segurança ao nível do campo no Salesforce.
Passo 3: crie novos campos personalizados no Salesforce
Siga estas instruções para criar três campos personalizados no Salesforce para armazenar as suas informações do Analytics. Pode atribuir o nome que pretender aos campos. Os nomes seguintes são apenas recomendações, mas sugerimos estes nomes recomendados, uma vez que podem ajudar na implementação e na depuração futura (se necessário).
| Nome do campo | Nome da API | Comprimento do campo |
|---|---|---|
| GACLIENTID | GACLIENTID__c |
255 |
| GAUSERID | GAUSERID__c |
255 |
| GAMEASUREMENTID | GAMEASUREMENTID__c |
255 |
- Tem de implementar o Client-ID e, opcionalmente, pode implementar o User-ID.
- Os nomes dos campos TÊM de estar em maiúsculas. As etiquetas dos campos podem ser o que pretender.
- Torne estes campos só de leitura para evitar alterações indesejadas.
- Estes campos TÊM de ser criados nos objetos Lead e Opportunity.
Passo 4: configure os objetos Lead e Opportunity
No caso do objeto Lead, ative a opção Field History Tracking para o campo Lead status. No caso do objeto Opportunity, ative a opção Field History Tracking para o campo Stage. Isto garante que qualquer atualização destes campos gera um evento.
Faça o mapeamento entre os campos em cada objeto e o campo correspondente no outro objeto:
- Lead.GACLIENTID com Opportunity.GACLIENTID
- Lead.GAUSERID com Opportunity.GAUSERID
- Lead.GAMEASUREMENTID com Opportunity.GAMEASUREMENTID
Passo 5: edite o formulário de leads
Modifique o formulário de leads para captar e armazenar as informações de acompanhamento necessárias. Tem de saber o seu ID de medição. Saiba mais acerca do ID de medição.
Por que motivo é necessário o meu ID de medição?
Adicione os campos de acompanhamento personalizados
Os exemplos seguintes mostram como pode adicionar os campos personalizados criados acima ao formulário de leads através de JavaScript.
<form action="" name="myForm">
Phone: <input type="text" name="phone_number">
<input type="hidden" id="GACLIENTID" name="GACLIENTID" value="">
<input type="hidden" id="GAUSERID" name="GAUSERID" value="">
<input type="hidden" id="GAMEASUREMENTID" name="GAMEASUREMENTID" value="G-XXXXX">
<input type="submit">
</form>G-XXXXX pelo ID de medição.Defina os valores dos campos de acompanhamento personalizados
Adicione este código ao formulário de leads para preencher os valores do Client-ID e User-ID.
<script type="text/javascript">
document.getElementById('FORM_ID').addEventListener(
'submit', function(event) {
ga(function() {
var tracker = ga.getAll()[0];
var clientId = tracker.get('clientId');
document.getElementById('GACLIENTID').value = clientId;
var userId = tracker.get('userId');
document.getElementById('GAUSERID').value = userId;
});
});
</script>Passo 6: associe o Analytics à sua conta do Salesforce
Associe o Analytics à sua conta do Salesforce ao criar uma nova configuração da Importação de dados e ao autenticar o acesso à sua conta do Salesforce.
Um tipo de origem de dados corresponde ao tipo específico de dados que quer importar. Por exemplo, existem tipos de origens de dados para dados de custos, dados dos artigos, dados do utilizador e dados de eventos offline. Para cada tipo, dispõe de opções diferentes de dimensões e métricas (o esquema) das quais pode carregar dados. A importação do Salesforce usa o tipo de Importação de dados de eventos offline. Saiba mais acerca da importação de dados de eventos offline.
Importe dados do Salesforce
Para importar dados offline do Salesforce em Leads e Oportunidades com a Importação de dados, conclua os seguintes passos:
- Em Administrador e, de seguida, em Recolha e modificação de dados, clique em Importação de dados.
O link anterior abre a última propriedade do Analytics a que acedeu. Pode alterar a propriedade com o seletor de propriedades.
- Clique em Criar origem de dados.
- Introduza um nome para a origem de dados.
- Selecione Dados de eventos offline como tipo de dados.
- Clique em Rever os termos se lhe for pedido e aceite a Confirmação de recolha de dados dos utilizadores. Este é um pré-requisito para carregar eventos offline e/ou dados do utilizador.
- Em Carregar dados para importação, selecione Salesforce como a Origem de importação.
- Autentique com o Salesforce na janela pop-up apresentada.
- Selecione a Programação de importações. Tenha em atenção que as propriedades padrão suportam a importação diária, ao passo que os clientes do Analytics 360 podem selecionar de hora a hora.
- Clique em Seguinte.
- Escolha as conquistas e os campos do Salesforce que quer medir como eventos do Analytics. Consulte os passos 7, 8 e 9 abaixo.
- Clique em Importar. Após a importação inicial, os dados são importados conforme programado.
Passo 7: configure os leads
Selecione chaves, conquistas e campos opcionais para os leads que quer recolher como eventos.
Passo 8: configure as oportunidades
Selecione chaves, marcos e campos opcionais para as oportunidades que quer recolher como eventos.
Se quiser que os eventos de conversão Opportunity afetem as estatísticas da receita e do LTV (valor do cliente), recomendamos que mapeie o seguinte:
- Mapeie o marco da conversão final (marco de oportunidade conquistada) para o evento "purchase". Isto permite que a receita seja acumulada adequadamente para os eventos que possam conter receita.
- Mapeie "amount" (isto retém o valor da receita da oportunidade vencedora) para o parâmetro "value" (o parâmetro do qual o GA4 recolhe dados de receita).
- Por fim, pode mapear "Id" (ou outro campo que represente o ID da transação de forma mais adequada) para o campo "transaction id" do GA4.
Campos padrão suportados
Pode importar atributos a partir dos seguintes campos Lead padrão do Salesforce:
- ID
- Indústria
- NumberOfEmployees
- Classificação
- ScoreIntelligenceId (se disponível na sua edição do Salesforce)
Também pode importar os seguintes campos Opportunity padrão:
- Valor
- CampaignId
- ContractId
- ExpectedRevenue
- ID
- LeadSource
- Nome
- Probabilidade
- TotalOpportunityQuantity
Formatos suportados
Além dos campos padrão listados acima, pode importar todos os campos de atributos personalizados com os seguintes formatos de campos do Salesforce:
- booleano
- currency
- data
- datetime
- dateTime (camelCase)
- double
- int
- percentagem
- picklist
- string
- textarea
- hora
Para importar atributos:
- Selecione as dimensões personalizadas e/ou as métricas personalizadas do Analytics que quer que contenham os dados dos atributos.
- Certifique-se de que as dimensões personalizadas selecionadas têm o âmbito correto. Na maioria dos casos, trata-se de propriedades do utilizador. Saiba como compreender os âmbitos do GA4.
- Use o menu pendente na coluna com o nome do campo do Salesforce para fazer o mapeamento entre os campos do Analytics e os do Salesforce.
Exemplo de configuração
Segue-se um exemplo do mapeamento entre campos padrão do Salesforce suportados e campos personalizados do Analytics.
| Campo personalizado do Analytics: âmbito | Nome do campo do Salesforce |
|---|---|
| Dimensão: evento OU utilizador | Lead: Lead ID |
| Dimensão: evento OU utilizador | Lead: Lead Score (pontuação prevista pelo Salesforce Einstein) |
| Dimensão: utilizador | Lead: Industry |
| Dimensão: evento OU utilizador | Lead: Rating |
| Dimensão: evento OU utilizador | Opportunity: Opportunity ID |
| Métrica: evento | Oportunidade: Amount |
| Dimensão: evento OU utilizador | Opportunity: Probability (%) |
| Métrica: evento | Opportunity: Expected Amount |
| Dimensão: evento OU utilizador | Opportunity: Order Number |
Que âmbito devo usar?
Passo 9: teste a configuração
Teste a configuração ao verificar se os dados importados do Salesforce estão visíveis nos relatórios do Analytics (por exemplo, no relatório Eventos ou no relatório Tempo real) e nas Explorações.
Para verificar o estado da importação mais recente, aceda a Administração e, de seguida, em Recolha e modificação de dados, clique em Importação de dados.
Notas e limites
- Certifique-se de que cumpre os Termos de Utilização e a Política de Privacidade do Analytics.
- Não importe informações de identificação pessoal (PII).
- Os dados importados usam a moeda (ou moedas, se tiver a opção ativada para várias moedas) configurada na sua conta do Salesforce.
- Os dados dos artigos do Salesforce são importados para o objeto Opportunity, e não para os dados do objeto Lead.
- Os campos vazios são removidos no momento da importação.
- Os dados dos artigos estão limitados a 200 índices de artigos únicos.
Esquema da origem de dados
Quando cria uma origem, define um esquema, a estrutura que associa os dados que carrega aos dados de eventos do Analytics existentes. Um esquema simples consiste numa dimensão de chave de junção (a "chave") e nas dimensões ou métricas de importação. Para importar dados, o Analytics procura valores de chave nos dados de eventos que correspondam aos valores de chave nos dados carregados. Quando encontra uma correspondência, adiciona (ou substitui se os dados já tinham sido recolhidos) os valores de dimensão e métrica adicionais associados a essa chave aos dados de eventos existentes. Alguns tipos de origens de dados permitem usar várias dimensões para definir a chave e a maioria pode usar várias dimensões/métricas para os campos de importação.
A chave de junção é composta por, pelo menos, uma dimensão do Analytics e pode ter, no máximo, três.
As dimensões de chave variam com base no tipo de conjunto de dados escolhido.
É fornecida uma lista de dimensões de chave disponíveis no menu pendente no construtor de esquemas da origem de dados.
Pode carregar dados através da mesma origem de dados várias vezes, desde que esteja apenas a adicionar valores aos campos existentes. Se quiser adicionar campos a uma origem de dados, tem de eliminar a origem de dados existente e, em seguida, criar uma nova. Depois de guardar uma origem de dados, não pode alterar o mapeamento dos campos do Analytics para os campos no seu CSV.