Ir para o conteúdo principal
Isenção de responsabilidade de tradução: esse conteúdo foi traduzido para sua conveniência com o uso de software e pode não ter sido revisado por uma pessoa. O texto oficial é a versão em inglês e sempre será o texto mais atualizado. Para ver a versão em inglês, clique aqui.

Criar e utilizar conjuntos de dados

Ultima atualização: Novembro 17, 2021

Disponível para

Operations Hub Enterprise

Um conjunto de dados é uma coleção de dados de toda a sua conta HubSpot que pode então ser usada em relatórios personalizados. Um conjunto de dados pode incluir propriedades para objetos CRM e ativos HubSpot, juntamente com fórmulas para calcular seus dados conforme necessário. Por exemplo, é possível criar um campo para calcular a receita anual recorrente com base na propriedade do montante da transação. 

Criar múltiplos conjuntos de dados para suas equipes significa que os criadores de relatórios não terão que selecionar suas fontes de dados toda vez que precisarem criar um relatório. Um conjunto de dados também pode ser atualizado após a criação, tornando possível atualizar todos os relatórios usando esse conjunto de dados ao mesmo tempo.

Abaixo, aprenda como criar um conjunto de dados, como usar o conjunto de dados no relatório e as definições das funções disponíveis dentro da ferramenta de conjuntos de dados.

Criar um conjunto de dados

Para criar um conjunto de dados:

  • Na sua conta HubSpot, navegue para Relatórios > Datasets.
  • No canto superior direito, clique em Criar conjunto de dados.

Você será então direcionado para a aba Join do construtor do conjunto de dados.

Conexão

Primeiro, seleccione as fontes de dados a incluir no seu conjunto de dados. As fontes de dados são objetos, ativos e eventos para os quais você deseja gerar relatórios. Isso inclui todos os objetos de CRM, como contatos ou objetos personalizados, e ativos como páginas do site e e-mails, conversas, atividades de vendas, e muito mais. Você pode selecionar até 5 fontes de dados por conjunto de dados.

A fonte de dados primária será o foco do conjunto de dados, com todas as outras fontes de dados relacionados com essa fonte primária. Para conectar essas fontes de dados, o HubSpot junta os dados em segundo plano usando o caminho mais curto possível. Contactos e negócios, por exemplo, estão directamente relacionados e podem ser seleccionados sem necessidade de qualquer junta adicional. 

Entretanto, outras fontes de dados não podem ser associadas diretamente e requerem fontes adicionais para unir os dados. Por exemplo, se a sua fonte principal for Deals e você quiser incluir dados de postagens no blog no relatório, o HubSpot só pode ligar essas fontes através dos Contactos e das fontes de actividades Web. Estas outras fontes serão seleccionadas automaticamente para se juntarem aos dados.

  • Para selecionar a fonte de dados primários, clique no menu suspenso Fonte de dados primários e, em seguida, selecione uma fonte de dados  

    conjuntos de dados-join-tab0
  • Continuar selecionando fontes de dados adicionais. No painel direito, você pode visualizar as relações entre as fontes de dados atuais selecionadas.
  • Ao seleccionar as fontes, visualize o painel de Pré-visualização na parte inferior do ecrã para uma pré-visualização dos seus dados. 
  • Após seleccionar as suas fontes de dados, no canto superior direito, clique em Next.

Preparar

Selecione os campos a serem incluídos no conjunto de dados. Você pode adicionar propriedades HubSpot existentes ao conjunto de dados, bem como campos de fórmula personalizados.

Adicionar propriedades

  • Para adicionar propriedades ao conjunto de dados, arraste e solte as propriedades da barra lateral esquerda para a seção Construir seu conjunto de dados.

2021-10-28_11-28-34 (1)

  • Para renomear uma propriedade ou visualizar uma pré-visualização dos seus dados, clique na propriedade em Construir o seu conjunto de dados, depois introduza um novo nome no campo do nome à direita. A renomeação de um imóvel actualizará o seu nome apenas neste conjunto de dados. Isto permite-lhe personalizar a forma como estes campos aparecem no construtor do relatório, mas não terá impacto no nome da propriedade existente.

Adicionar campos de fórmula

Os campos de fórmula são específicos para o conjunto de dados e podem ser usados para calcular valores com base nas propriedades do conjunto de dados. Saiba mais sobre como construir fórmulas usando expressões flexíveis.

  • Para criar um campo de fórmula, clique em Criar campo de fórmula

    dados-criar-formula-campo0
  • À direita, introduza um nome para o campo.
  • No campo Fórmula, introduza a sua fórmula. Você pode referenciar propriedades que você adicionou ao conjunto de dados, bem como outras propriedades do HubSpot fora do conjunto de dados, e usar funções para calcular com base na propriedade e dados literais. Saiba mais sobre a sintaxe da fórmula e definições abaixo.
    • Para entrar manualmente a fórmula, comece a digitar no campo Fórmula. Por padrão, o HubSpot exibirá opções de auto-completar à medida que você digitar o texto. Para desativar o auto-completar, desmarque a caixa de seleção Mostrar guia de fórmula

      conjunto de dados-formula-field-auto-completo0
    • Para inserir uma propriedade que você adicionou ao conjunto de dados, clique no menu suspenso do campo Criado e selecione a propriedade.
    • Para inserir uma propriedade que não esteja no conjunto de dados, clique no menu suspenso de propriedades do HubSpot e selecione a propriedade.
    • Para inserir uma função, clique no menu suspenso Função e, em seguida, selecione uma função.
fórmulas-field-opções0
  • Ao criar as fórmulas, o campo Fórmula exibirá um status de validação. Quando uma fórmula é inválida, um indicador vermelho de status será exibido e você pode clicar em Validação para visualizar os detalhes do erro
    conjunto de dados-formula-validação de campo0
  • Depois de configurar os seus campos, clique em Next no canto superior direito.

Filtro

Refine mais os seus dados adicionando filtros aos seus campos.

Para adicionar um filtro:

  • A partir da barra lateral esquerda, clique e arraste campos no Filtros inativos secção.
  • Clique num campo para ver as suas opções de filtro. Selecione um filtro e, em seguida, clique em Candidate-se.
  • Você pode agrupar os filtros clicando em um campo e, em seguida, clicando no menu suspensoGrupo com outro filtro. Selecione outro filtro ativo e, em seguida, clique em Candidate-se.

conjuntos de dados-filtros de grupo0

    • Você pode alterar se os filtros são agrupados por e/ou ou lógica clicando no seletor de lógica entre os filtros, depois selecionando e/ou ou

      conjuntos de dados-e-ou-filtro0
    • Para desagrupar filtros, clique em um filtro e, em seguida, clique no menu suspenso Grupo com outro filtro. Selecione Nenhum e, em seguida, clique em Aplicar.
  • Após configurar os seus filtros, clique em Próximo.

Revisão

Reveja o seu conjunto de dados antes de o guardar. 

  • Em Fontes, veja as fontes de dados que você selecionou. 
  • Em Campos, visualizar os campos no conjunto de dados. Isso inclui:
    • Campo: o nome do campo.
    • Derivado: se o campo é um campo HubSpot standard ou um campo calculado à medida.
    • Tipo de dados: o tipo de dados contidos no campo.
    • Input: a expressão do campo.
    • Fonte: a fonte dos dados (por exemplo, Contactos).
  • No painel de Pré-visualização, veja a pré-visualização dos seus dados. Você pode clicar em Ver relações de tabela para ver como os dados estão conectados.
  • Após rever seus dados, salve o conjunto de dados, clicando em Salvar.
  • No painel direito, introduza um nome e uma descrição para o conjunto de dados.
  • Clique em Aplicar.

Você será então levado para o construtor do relatório onde poderá criar um relatório com base no seu conjunto de dados.

Ver e gerir conjuntos de dados

No painel do conjunto de dados, você pode visualizar e editar os conjuntos de dados existentes.

  • Na sua conta HubSpot, navegue para Relatórios > Datasets.
  • Você pode filtrar seus conjuntos de dados existentes usando os filtros na parte superior da tabela.
  • Para editar um conjunto de dados, passe o mouse sobre o conjunto de dados e, em seguida, clique em Editar. Você será então levado para a página de detalhes do conjunto de dados.
    • No separador Preview, veja uma pré-visualização dos dados do conjunto de dados. 
    • No separador Metadados, visualizar as fontes de dados e os campos incluídos no conjunto de dados. Isso inclui:
      • Campo: o nome do campo.
      • Derivado: se o campo é um campo HubSpot standard ou um campo calculado à medida.
      • Tipo de dados: o tipo de dados contidos no campo.
      • Input: a string usada para trazer dados para o campo.
      • Fonte: a fonte dos dados (por exemplo, Contactos).
    • No separador Relatórios, veja os relatórios que foram criados utilizando o conjunto de dados.
    • A partir da página de detalhes do conjunto de dados, você também pode criar um novo relatório usando o conjunto de dados, clicando em Construir relatório.

Criar um relatório usando um conjunto de dados

Uma vez criado um conjunto de dados, você pode criar um relatório com base no conjunto de dados do construtor do relatório ou da ferramenta de conjuntos de dados.

  • Para criar um relatório de dentro de um conjunto de dados:
  • Para criar um relatório a partir do criador de relatórios personalizados:
    • Na sua conta da HubSpot, navegue até Relatórios > Relatórios.
    • No canto superior direito, clique em Criar relatório personalizado.
    • Na barra lateral esquerda, selecione Custom Report Builder.
    • À direita, clique na guia Procurar conjuntos de dados para visualizar os conjuntos de dados existentes

      pesquisar dados-tab0
    • Seleccione o conjunto de dados que pretende utilizar e, em seguida, clique em Next.

Referência

Sintaxe

Dentro de uma função, é possível usar dados de propriedades e campos ou dados literais. Os dados de propriedade e de campo serão dinâmicos com base nas fontes de dados individuais, enquanto que os dados literais são constantes. Por exemplo:

  • 2021-03-05 é uma data literal, que é constante.
  • [CONTACT.create date] é uma data baseada na propriedade, que é dinâmica para cada registro de contato.

As funções podem incluir dados literais e dados de propriedade/de campo, desde que os tipos de dados sejam compatíveis com os argumentos necessários da função. Por exemplo:

DATEDIFF("MONTH", "2021-01-01", "[CONTACT.createdate]")

Abaixo, aprenda sobre a sintaxe para literals e dados de propriedade/campo, e como incorporá-los em fórmulas.

Sintaxe literária

Use literals para adicionar strings específicas e estáticas de texto, números, valores verdadeiros ou falsos, e datas nos seus cálculos.

  • String literal: texto rodeado de aspas. Por exemplo, "O meu fio fixe".
  • Número literal: números sem aspas. Por exemplo, 42.
  • Booleano literal: verdadeiro ou falso.
  • Data literal: uma string formatada como "AAAA-MM-DD", ou um número de data e hora (por exemplo, 1635715904). 

Sintaxe do imóvel

As referências de propriedades permitem-lhe incluir directamente os valores das propriedades das suas fontes de dados seleccionadas. Você não precisa adicionar a propriedade como um campo de conjunto de dados para referenciá-la. 

Use a seguinte sintaxe ao fazer referência a propriedades:

  • As expressões de referência são sempre rodeadas por parênteses rectos ( [ e ] ).
  • As referências de propriedade especificam o nome do objeto ou evento, seguido por um ponto e o nome da propriedade interna. Por exemplo:
    • [CONTACT.lifecyclestage]
    • [EMPRESA.nome]
    • [e_hs_scheled_email_v2.__hs_event_native_timestamp]

Sintaxe de referência de campo

Você pode fazer referência a campos em uma fórmula circundando o nome do campo com colchetes. Por exemplo:

    • [Campo 1]
    • [Meu fantástico campo personalizado]

É possível fazer referência a campos em fórmulas, desde que os operadores e funções da fórmula aceitem o tipo de dados do campo. Por exemplo, se o usuário criar um novo campo que contenha uma cadeia, pode referenciar o campo em uma função que aceite cadeias de caracteres:

  • Se o Campo 1 for [DEAL.name], ele contém um valor de string (o nome do negócio).
  • CONCAT([Campo 1], "Q4") seria válido porque contém dois valores de string.
  • CONCAT([DEAL.name], 2012) não seria válido porque contém tanto uma string como um valor numérico.

Operadores

É possível usar operadores com valores literais e de propriedade/de campo, e os operadores são avaliados na ordem padrão de operações PEMDAS. Isto permite-lhe aninhar operadores usando parênteses. Por exemplo:

  • Adicionando um número com uma referência de propriedade: 1 + [DEAL.montante]
  • Usando parênteses para nidificar operações: (1 + 2) * (3 + 4)
Operador Descrição Exemplo de uso

+

Adicione números. Devolve um número.

1 + 1
= 2

[DEAL.montante] + 100

-

Subtrair números. Devolve um número.

100 - 1
= 99

EXP(1) - EXP(1)
= 0

WEEKNUM([DEAL.closedate]) - WEEKNUM([DEAL.createdate])

*

Multiplique os números. Devolve um número.

2 * 2
= 4

POW(10, 2) * -1
= -100

[DEAL.montante] * 0.5

/

Dividir números. Devolve um número.

10/ 2
= 5

[DEAL.amount] / DATEDIFF("DIA", [DEAL.createdate], [DEAL.closedate])

-

Nega um número.

-100
= -100

-[DEAL.montante]

&&

Verifica se ambos os dois valores booleanos são verdadeiros. Devolve um booleano.

verdadeiro && falso
= falso

CONTAINS("HubSpot", "Hub") && CONTAINS("HubSpot", "Spot")
= verdadeiro

CONTAINS("HubSpot", "Hub") && CONTAINS("HubSpot", "CRM")
= falso

||

Verifique se algum dos dois valores booleanos é verdadeiro. Devolve um booleano.

verdadeiro || falso
= verdadeiro

CONTAINS("HubSpot", "Hub") || CONTAINS("HubSpot", "CRM")
= verdadeiro

CONTAINS("HubSpot", "Vendas") && CONTAINS("HubSpot", "Marketing")
= falso

!

Nega um valor booleano. Devolve outro valor booleano.

!true
= falso

==

Operador de igualdade. Devolve um valor booleano.

==verdadeiro
= verdadeiro

Funções numéricas

Função Definição Argumentos Exemplo de uso

ABS

Calcule o valor absoluto de um número. Devolve um número.

ABS(número)

número: o número para tomar o valor absoluto de.

ABS(-10)
= 10

ABS(10)
= 10

CEIL

Arredondar um valor decimal até ao número inteiro mais próximo. Devolve um número.

CEIL(número)

número: o número para levar o tecto de.

CEIL(3.14)
= 4

CEIL(EXP(1))
= 3

CEIL(LN([DEAL.amount]))

DIV0

Dividir um número, mas retornar zero quando o divisor for zero. Devolve um número.

DIV0(dividendo, divisor)

dividendo: o número a usar como dividendo na operação de divisão.

divisor: o número a usar como divisor na operação de divisão, com zero resultando em um valor global zero

DIV0(5, 2)
= 2,5

DIV0(5, 0)
= 0

DIV0([DEAL.amount], DATEDIFF("DIA", [DEAL.createdate], [DEAL.closedate]))

EXP

O número do computador Euler aumentou para um valor. Devolve um número.

EXP(expoente)

expoente: o expoente a quem elevar o número do Euler.

EXP(1)
= 2.71828182845459045

EXP(0)
= 1

PISO

Arredondar um valor decimal para o número inteiro mais próximo. Devolve um número

PISO(número)

número: o expoente a quem elevar o número de Euler.

PISO(3.14)
= 3

CEIL(EXP(1))
= 2

FLOOR(LN([DEAL.amount]))

LN

Calcule o logaritmo natural de um valor. Devolve um número.

LN(número)

número: o valor a tomar o logaritmo natural de.

LN(1)
= 0

LN(EXP(1))
= 1

LN([DEAL.montante])

LOG

Calcule o logaritmo de um valor dentro de uma base especificada. Devolve um número.

LOG(base, valor)

base: a base a ser utilizada no cálculo do logaritmo do valor.

valor: o número para tirar o logaritmo de.

LOG(10, 1)
= 0

LOG(10, 10)
= 1

LOG(10, [DEAL.montante])

PODER

Aumentar um valor base para uma potência especificada. Devolve um número.

POWER(base, expoente)

base: o número para calcular o poder de.

expoente: o número para elevar a base até.

POTÊNCIA(2, 10)
= 1024

POTÊNCIA(100, 0,5)
= 10

POWER([DEAL.hs_arr], 2)

SQRT

Pegue a raiz quadrada de um número não-negativo. Devolve um número.

SQRT(número)

número: o número para tirar a raiz quadrada de.

SQRT(100)
= 10

SQRT([DEAL.hs_arr])

WIDTH_BUCKET

Valores numéricos de posição em baldes de largura igual. Retorna o número do balde no qual o valor cai.

Se o valor retornado for inferior ao mínimo, retorna zero. Se o valor retornado estiver acima do máximo, retorna o número de baldes +1.

WIDTH_BUCKET(valor, minValue, maxValue, bucketCount)

valor: o número a calcular no número do caixote do lixo.

minValue: o valor mínimo a partir do qual se pode começar a descaroçar.

maxValue: o valor máximo para o depósito.

baldeCount: o número desejado de baldes de igual largura para valores entre o valor mínimo e o valor máximo. 

WIDTH_BUCKET(25, 0, 100, 10)
= 3

WIDTH_BUCKET(95, 0, 100, 10)
= 10

WIDTH_BUCKET(-1000, 0, 100, 10)
= 0

WIDTH_BUCKET(9999, 0, 100, 10)
= 11

WIDTH_BUCKET([DEAL.amount], 0, 10000, 1000)

Funções das cordas

Função Definição Argumentos Exemplo de uso

CONTENHA

Determinar se uma corda contém um substrato. Devolve um valor booleano.

CONTAINS("string", "substring")

string: o valor da string a testar.

substring: o valor a verificar dentro da string.

CONTAINS("HubSpot", "Hub")
= verdadeiro

CONTAINS("foo", "bar")
= falso

CONTAINS([CONTACT.firstname], "Mike")

CONCAT

Concatena duas cordas. Devolve um fio.

CONCAT("string1", "string2")

string1: o valor da string a que a string2 será anexada.

string2: o valor da string a anexar à string1.

CONCAT("Hub", "Spot")
= "HubSpot"

CONCAT([CONTACT.firstname], CONCAT(" ", [CONTACT.lasttname]))

COMPRIMENTO

Calcule o comprimento de um fio. Devolve um número.

COMPRIMENTO("string")

string: o valor da string para calcular o comprimento de.

COMPRIMENTO("HubSpot")
= 7

LENGTH([FEEDBACK_SUBMISSION.hs_content])

TRIM

Remover o líder e o espaço em branco de um fio. Devolve um fio.

TRIM(" cadeia ")

string: o valor da string para aparar o espaço em branco.

TRIM(" Os gatos são ótimos ")
= "Os gatos são óptimos"

Funções de data

Função Definição Argumentos Exemplo de uso

DATA_DE_PARTES

Crie um valor de data a partir do ano, mês e partes do dia. Devolve uma data.

DATA_FROM_PARTS(ano, mês, dia)

ano: o ano que faz parte da data desejada.

mês: o mês que faz parte da data desejada.

dia: a parte do dia da data desejada.

DATA_DE_PARTES(2021, 1, 1)
= 2021-01-01

DATEDIFF

Devolver o número de unidades de tempo entre o primeiro valor da data e o segundo para uma unidade de tempo especificada. Devolve um número.

DATEDIFF("datePart", "date1", "date2")

dataParte: o ano, trimestre, mês, semana ou unidade do dia a usar no cálculo da diferença. 

data1: o valor da data de início a subtrair da data2.

data2: o valor da data final da qual essa data1 será subtraída.

DATEDIFF("DIA", "2021-01-01-01", "2021-02-01")
= 31

DATEDIFF("MÊS", "2021-01-01", DATE_FROM_PARTS(2021, 2, 1))
= 1

DATEDIFF("QUARTER", [DEAL.createdate], [DEAL.closedate])

DATEPART

Extrair o ano, trimestre, mês, semana ou dia de um valor de data. Devolve um número.

DATEPART("datePart", "date")

dataParte: o ano, trimestre, mês, semana ou unidade de dia a extrair.

data: o valor da data a partir da qual se deve extrair uma parte da data.

DATEPART("DIA", "2021-03-15")
= 15

DATEPART("MONTH", DATE_FROM_PARTS(2021, 3, 15))
= 3

DATEPART("YEAR", [DEAL.createdate])

DATETRUNC

Truncar um valor de data ao seu ano, trimestre, mês, semana, ou dia.

DATETRUNC("datePart", "date")

dataParte: o ano, trimestre, mês, semana ou unidade do dia para truncar.

data: o valor da data a truncar.

DATETRUNC("ANO", DATA_DE_PARTES(2021, 3, 15))
= 2021-01-01

DATETRUNC("MÊS", "2021-03-15")
= 2021-03-01

DATETRUNC("DIA", [e_visited_page.__hs_event_native_timestamp])

TIMESTAMP_FROM_PARTS

Criar um valor de carimbo da hora a partir do ano, mês, dia, hora, minuto e segunda parte. Devolve um valor de data/hora.

TIMESTAMP_FROM_PARTS(ano, mês, dia)

ano: o ano que faz parte da data desejada.

mês: o mês que faz parte da data desejada.

dia: a parte do dia do dia desejado. 

TIMESTAMP_FROM_PARTS(2021, 1, 1)
= 2021-01-01

WEEKNUM

Calcule o número da semana dentro de um ano para uma data. Devolve um número.

WEEKNUM("data")

data: o valor de data e hora com que se deve calcular o número da semana dentro de um ano.

WEEKNUM("2021-03-15")
= 11

WEEKNUM("1609459200")
= 11

WEEKNUM("[deal.createdate]")

AGORA

Retorna a hora atual com base no fuso horário da sua conta. Devolve um valor de data/hora.

AGORA()

 

AGORA()
= 1633611966314