Consultar dados do HubSpot em Snowflake_PT
Ultima atualização: Setembro 27, 2023
Disponível com qualquer uma das seguintes assinaturas, salvo menção ao contrário:
|
Depois de ligar o Snowflake à sua conta HubSpot, pode usar a partilha de dados do Snowflake para consultar os dados do HubSpot da sua conta Snowflake.
Atraso de dados e a sua região de conta Snowflake
Terá acesso ao esquema V2_LIVE que é actualizado a cada 15 minutos, e ao esquema V2_DAILY que é actualizado todos os dias.
Configure seu ambiente no Snowflake
Para consultar os dados do seu HubSpot no Snowflake, é necessário selecionar o warehouse, o banco de dados e o esquema a partir do qual pretende consultar. Você pode defini-los no nível da planilha para incluí-los automaticamente em suas consultas, ou pode adicioná-los manualmente.
Para selecionar seu warehouse, banco de dados e esquema no nível da planilha:
- Na linha superior da planilha, clique na barra Ações da planilha.
- Na janela pop-up:
- Clique no menu suspenso Warehouse e selecione seu warehouse.
- Clique no menu suspenso Banco de dados e selecione seu banco de dados do HubSpot.
- Clique no menu suspenso Esquema e selecione o esquema que você deseja usar:
- V2_DAILY: o esquema diário para consultar dados com base em tabelas. Os dados neste esquema são atualizados uma vez por dia. O uso deste esquema resultará em consultas mais rápidas, e é recomendado para consultas diretamente no Snowflake.
- V2_LIVE: o esquema ao vivo baseado em vistas seguras dos dados do HubSpot. Os dados neste esquema são atualizados até cada 15 minutos. Se você estiver consultando um grande conjunto de dados, as consultas podem ser lentas. Neste caso, é recomendado copiar os dados para sua própria tabela primeiro com um processo ETL e depois consultar essa tabela.
Com o seu ambiente configurado, você pode fazer consultas aos dados do seu HubSpot sem precisar adicionar manualmente seu banco de dados ou tipo de esquema às consultas.
Para adicionar manualmente a sua base de dados e o tipo de esquema às consultas, adicione o nome da base de dados seguido do esquema no início do campo FROM
campo. Por exemplo:
SELECT objectTypeId, property_createddate
FROM hubspot_share_name.V2_LIVE.objects_deals
LIMIT 1
Visão geral dos dados
As consultas são construídas usando SQL, e podem ser usadas para recuperar dados do HubSpot, como por exemplo:
- Objectos: objectos standard e personalizados, tais como contactos, empresas, produtos.
- Registos: registos individuais, tais como um contacto individual ou uma empresa.
- Associações: todos os tipos de associações disponíveis e registos actualmente associados.
- Eventos: dados de eventos para ambos os eventos HubSpot padrão, tais como abertura de email, e eventos comportamentais personalizados.
- Listas: Listas de contactos e empresasHubSpot.
- Proprietários: usuários na sua conta do HubSpot, em relação aos registros dos quais são definidos como proprietário.
- Pipelines: pipelines de negócios e tickets, incluindo as fases dos pipelines.
- Propriedades: propriedades e os seus valores nos registos CRM, incluindo o histórico da propriedade.
Saiba mais sobre O modelo de dados de CRM da HubSpot.
Atenção: À medida que desenvolvemos a partilha de dados, introduziremos alterações, algumas das quais quebrando as alterações. É altamente recomendável subscrever o registo de alterações do desenvolvedor do HubSpot. Estas alterações serão sempre afixadas no registo de alterações com antecedência em relação a qualquer actualização.
Limitação e ordem de dados devolvidos
Ao construir consultas, pode controlar a quantidade de dados devolvidos, juntamente com a ordem pela qual são devolvidos, incluindo LIMIT
e ORDER BY
na sua consulta. Por exemplo, para consultar todos os contatos com as suas propriedades, mas apenas retornar três resultados e ordená-los por ID de contato, você poderia criar a consulta da seguinte forma:
SELECT objectTypeId, updatedAt, ingestedAt
FROM objects_deals
ORDER BY objectId
LIMIT 10;
Tipos de dados de coluna
Ao consultar dados no Snowflake, as colunas que são devolvidas dependem dos dados que você está consultando. Você pode visualizar as colunas disponíveis para uma determinada tabela ou visualização no Snowflake selecionando a visualização na barra lateral esquerda.
Por favor note:para o resto deste documento, utilizamos o termo objecto de base de dados quando o contexto se aplica tanto a tabelas como a vistas.
Para devolver uma coluna específica, inclua essa coluna no campo SELECT
da sua consulta. Por exemplo, a consulta a seguir retornará apenas os OBJECTID
e UpdatedAt
colunas:
SELECTobjectId, updatedAt
FROM objects_contacts
Abaixo estão as definições gerais para as colunas que uma consulta pode retornar. Para outras definições não incluídas abaixo, consulte as definições da visualização individual no artigo acima.
- OBJECTTIPO: um valor VARCHAR que representa o tipo de objecto. Por exemplo, 0-1 representa o objeto contatos, 0-2 representa o objeto empresas, e 2-1232 pode representar um objeto personalizado em sua conta. Em listas, isto se refere ao tipo de lista (por exemplo, contato ou empresa). Você pode consultar todos os IDs de objetos e eventos na sua conta usando a visualização object_and_event_type_definitions.
- OBJECTIDO: um número BIGINT que representa um único registo de um determinado tipo de objecto na sua conta HubSpot. Para identificar um registro, é necessário usar tanto o ID do tipo de objeto quanto o ID do objeto.
- INGESTEDAT: o carimbo temporal de quando uma fila de dados foi adicionada ao Floco de Neve, representado por um valor TIMESTAMP_NTZ. Não está relacionado com a data/hora lógica de uma operação de criação ou atualização no HubSpot.
- Devido ao processamento interno do HubSpot, a data/hora de consumo de uma linha pode ser atualizada, mesmo que nenhuma outra coluna da linha tenha sido alterada.
- Ao construir processos ETL que copiam dados alterados recentemente, é recomendado basear suas consultas na data/hora de consumo. Além disso, se o seu fluxo copia dados diariamente, é recomendado copiar os dados dos dois dias anteriores para contabilizar os atrasos.
- CREATEDAT e UPDATEDAT: o carimbo temporal lógico de quando os dados foram criados ou actualizados no HubSpot, representado por um valor TIMESTAMP_NTZ . Estas datas/horas corresponderão às datas/horas no HubSpot. Por exemplo, a hora exibida no HubSpot para a data de criação de um registro será a mesma da data de criação do registro na coluna CREATEDAT no Snowflake. Estes não estão directamente relacionados com o timestamp de ingestão, e não é recomendado basear os processos de ETL nestas propriedades.
- COMBINEDASSOCIATIONTYPE: um valor VARCHAR que identifica de forma única uma definição de associação.
Transformação de tipos de dados
Por vezes, os dados são devolvidos a partir de uma consulta com colunas VARCHAR quando seria desejável tê-los como um tipo diferente. Em casos como este, recomenda-se a conversão do tipo de dados VARCHAR para os tipos desejados usando as funções Snowflake. Por exemplo, as propriedades de um registo de objecto são armazenadas como tipos de dados VARCHAR na maioria dos objectos da base de dados, mas por vezes contêm valores de número e data/hora. Funções como:
try_to_number, try_to_timestamp_ntz podem ser usadas para converter estes dados VARCHAR para os seus tipos NUMERO e DATETIME respectivamente:
SELECT objectid, value AS amount_str, try_to_number(value) AS amountFROM object_properties
WHERE objecttypeid='0-3' AND name='amount'
LIMIT 1
Consultas de objetos
Abaixo, aprenda como consultar dados de objetos e registros do HubSpot específicos, juntamente com os dados que são devolvidos.
Os dados de objectos de diferentes tipos estão organizados e disponíveis de duas maneiras:
- Individual: Cada tipo de objecto é armazenado na sua própria vista e contém apenas registos do mesmo tipo de objecto, por exemplo, objectos_contactos contém apenas registos de contacto. Isto elimina a necessidade de especificar um tipo de objecto enquanto se faz uma consulta. Estas vistas são mais fáceis de consultar, uma vez que não é necessário conhecer ObjectTypeIds. Também devolvem os dados num formato mais utilizável com cada linha correspondente a um objecto e a versão actual das suas propriedades. Desde que não tenha dúvidas lentas, é aconselhável utilizar estes pontos de vista para recuperar dados de objectos. Ver mais em Objects_X views abaixo.
- Combinados: Todos os registos para todos os tipos de objectos são combinados num único objecto de base de dados. Assim, ao consultar, é necessário especificar um filtro como "WHERE objectTypeId='0-1'". Por exemplo, pode utilizar os seguintes tipos de objectos ao consultar:
Nome do objeto | ObjectTypeId |
Contatos | 0-1 |
Empresas | 0-2 |
Itens de linha | 0-8 |
Será atribuído um ID aos objetos personalizados no momento da criação, e será identificado como 2-unique_ID. Por exemplo, 2-12345. Saiba mais sobre object_and_event_type_definitions.
Estes objectos de base de dados são geralmente adequados se desejar um melhor desempenho de consulta do que o que pode ser obtido a partir de vistas objects_x. Ver mais detalhes em object_with_object_properties, object_properties, objects e object_properties_history abaixo.
objects_x views
Neste objecto de base de dados, cada tipo de objecto disponível, incluindo objectos personalizados, tem a sua própria visão específica com cada visão contendo apenas registos para objectos desse tipo específico de objecto. Estes pontos de vista são nomeados seguindo o formato OBJECTS_<object type name> onde <object type name> é a etiqueta da forma plural do tipo de objecto.(Note-se que se o tipo de objecto não tem forma plural, então <object type name> será simplesmente a etiqueta da forma singular do nome do tipo de objecto concatenado com "S").
As consultas a esta vista devolvem uma fila para cada registo dentro de um objecto com cada propriedade do objecto disponível como uma coluna separada.
Ver abaixo a lista completa dos tipos de objectos HubSpot disponíveis (ou seja, não personalizados), uma breve descrição dos dados que representam e as suas opiniões correspondentes:
Tipo de objecto HubSpot |
ObjectTypeId |
Descrição |
0-1 |
Informação sobre indivíduos que interagem com o seu negócio |
|
0-2 |
Informação sobre empresas ou organizações individuais |
|
0-3 |
Detalhes sobre oportunidades de receitas com um contacto ou empresa. |
|
0-4 |
Armazena dados de acções de CRM, incluindo notas, tarefas, e-mails, reuniões, e chamadas. |
|
0-5 |
Representar pedidos de ajuda ou apoio a clientes. |
|
0-14 |
Utilizado para partilhar informação sobre preços com potenciais compradores. |
|
0-15 |
Pormenores para envios individuais para um formulário HubSpot. |
|
0-8 |
Representam um subconjunto de produtos vendidos no âmbito de um negócio. Quando um produto é anexado a um negócio, ele se torna um item de linha. |
|
0-11 |
Detalhes de mensagens recebidas de múltiplos canais. |
|
0-25 |
Detalhes das suas páginas de aterragem |
|
0-27 |
Lojas de informação sobre listas de afazeres |
|
0-28 |
Utilizado para recolher informação de chumbo sobre os seus visitantes e contactos |
|
0-29 |
Detalhes sobre e-mails do centro de marketing |
|
AD_ACCOUNT |
0-30 |
Armazena informação sobre as suas contas de anúncios no Linkedin, Facebook e Google |
0-31 |
Detalhes sobre as suas campanhas publicitárias. Uma campanha publicitária pode conter um ou mais anúncios |
|
AD_GROUPO |
0-32 |
Agrupamento lógico de anúncios dentro de uma campanha publicitária |
ANÚNCIO |
0-33 |
Detalhes sobre anúncios individuais |
0-35 |
Informação sobre bens e conteúdos de marketing relacionados, para que possa facilmente medir a eficácia dos seus esforços de marketing colectivo. |
|
SITE_PAGE |
0-38 |
Dados sobre páginas individuais nos seus sítios Web |
0-39 |
Dados sobre postagens no blog |
|
LISTA DEOBJECTOS |
0-45 |
Informação sobre agrupamentos de registos de objectos com base nas suas propriedades ou actividades |
0-48 |
Chamadas efectuadas por outros registos CRM, por exemplo, contactos |
|
INVOICE |
0-53 |
Gerir e sincronizar facturas com sistemas de contabilidade externa |
0-57 |
Informação sobre os meios de comunicação importados para o Hubspot |
|
0-58 |
Uma sequência é uma série de modelos de correio electrónico direccionados e cronometrados para alimentar os contactos ao longo do tempo |
|
0-72 |
As divisões de negócio são utilizadas para partilhar o crédito de negócio entre vários utilizadores |
|
0-83 |
Os documentos de vendas constroem uma biblioteca de conteúdos para toda a sua equipa para carregar e partilhar documentos com os seus contactos. |
|
0-19 |
Armazena a informação submetida a um inquérito de feedback. |
|
0-69 |
As subscrições contêm pormenores sobre os pagamentos recorrentes |
|
0-101 |
Contém dados sobre os fundos recolhidos dos clientes |
Cada objecto da base de dados devolverá as seguintes colunas:
Nome da coluna |
Tipo |
Descrição |
OBJECTTYPEID |
Varchar |
O ID do tipo de objeto (por exemplo, contatos é 0-1). |
OBJECTID |
Número |
O ID do registro (por exemplo, um registro de contato com um ID de 123752). |
UPDATEDAT |
Data/hora |
A data e hora da última actualização deste objecto no HubSpot. |
INGESTEDAT |
Data/hora |
A data e hora em que os dados foram consumidos pela última vez pelo Snowflake. |
PROPERTY_* |
Varchar |
Colunas individuais contendo a última versão das propriedades do objecto. Para cada propriedade do objecto que tenha uma data ou tipo de número (como especificado por propriedade_definições), haverá duas colunas:
|
Exemplo 1
Recuperar o primeiro nome, apelido, e fase do ciclo de vida de todos os contactos.
Consulta:
SELECT objectId, property_firstname AS firstname, property_lastname AS lastname,property_lifecyclestage AS lifecyclestageFROM objects_contact
Devoluções:
OBJECTID |
FIRSTNAME |
LASTNAME |
LIFECYCLESTAGE |
54325098 |
Hobbes |
Baron |
lead |
96805401 |
Milo |
Gold |
lead |
6922028 |
Henry |
Riley |
lead |
Exemplo 2
Recuperar o nome do negócio e a fase de até três negócios.
Consulta:
SELECT objectId, property_dealName, property_dealStage,
property_amount AS dealAmountFROM objects_deals
LIMIT 3
Retorna:
OBJECTID |
PROPERTY_DEALNAME |
PROPERTY_DEALSTAGE |
PROPERTY_DEALAMOUNT |
38960439 |
Nome do negócio 1 |
fechado |
34199 |
321740651 |
Test Deal 123 |
14845019 |
8383663 |
98392101 |
Dossel Pop-Up |
fechado |
9309007 |
Exemplo 3
Recuperar o nome do negócio e a fase dos três primeiros negócios por montante.
Consulta:
Uma vez que os dados da quantidade de negócios estão disponíveis como um tipo de dados numéricos, podem ser utilizados para encomendar sem necessidade de fazer conversão ou fundição.
SELECT objectId, property_dealName, property_dealStage,
property_amount AS dealAmountFROM objects_deals
ORDER BY property_amount DESC
LIMIT 3
Retorna:
OBJECTID |
PROPERTY_DEALNAME |
PROPERTY_DEALSTAGE |
PROPERTY_DEALAMOUNT |
98392101 |
Dossel Pop-Up |
fechado |
9309007 |
321740651 |
Test Deal 123 |
14845019 |
8383663 |
38960439 |
Nome do negócio 1 |
fechado |
34199 |
object_with_object_properties
Este objecto de base de dados contém dados dos seus registos HubSpot. As consultas a este objecto de base de dados devolvem uma linha para cada registo dentro de um tipo de objecto (por exemplo, todos os registos de contacto no tipo de objecto de contacto). Todas as propriedades são armazenadas na coluna Propriedades, que é uma Variante do Floco de Neve / coluna JSON.
Esta visualização pode retornar as seguintes colunas:
Nome da coluna | Tipo | Descrição |
OBJECTTYPEID |
Varchar | O ID do tipo de objecto (por exemplo, contactos é 0-1 ). |
OBJECTID |
Número | O ID do registo (por exemplo, um registo de contacto com um ID de 123752 ). |
PROPERTIES |
Variante | Os valores de propriedade dos registros. |
UPDATEDAT |
Data/hora | A data e hora em que o registro foi atualizado pela última vez no HubSpot. Saiba mais sobre os tipos de dados das colunas. |
INGESTEDAT |
Data/hora | A data e hora em que os dados foram consumidos pela última vez pelo Snowflake. |
Nota: Em 25 de Janeiro de 2022, a coluna, carimbo da hora no quadro e vista do objecto_com_objecto_propriedades, que representa a data e hora em que o registo do objecto foi actualizado pela última vez no HubSpot, será actualizadaat. Isto é para alinhar com a forma como os dados de data e hora são representados no resto da partilha de dados.
Uma vez que se trata de uma alteração de ruptura, a nova coluna, actualizadaat foi adicionada à tabela e vista. Durante os próximos 90 dias, estas duas novas colunas irão coexistir com o carimbo da hora, as colunas que procuram substituir. Isto dá-lhe a oportunidade de mudar para utilizar as novas colunas.
Após 90 dias, a 25 de Janeiro de 2022, o carimbo temporal da coluna será removido da tabela e vista. Após esta data, qualquer tentativa de consultar a tabela de propriedades_de_objecto_com_objecto ou visualizar utilizando colunas de carimbos temporais falhará.
Exemplo 1
Recuperar todos os contatos e suas propriedades.
Consulta:
SELECT objectTypeId, objectId, properties
FROM object_with_object_properties
WHERE objectTypeId = '0-1'
Retorna:
OBJECTTYPEID | OBJECTID | PROPERTIES |
0-1 | 38960439 | {"createdate": "1504656970152"...} |
0-1 | 321740651 | {"createdate": "1590183081949"...} |
0-1 | 98392101 | {"createdate": "1533566477279"...} |
... | ... | ... |
Exemplo 2
Recuperar o nome do negócio e a fase de até três negócios.
Consulta:
SELECTobjectId,
properties:dealname::string AS dealname,
properties:dealstage::string AS dealstage,
properties:amount::number AS dealamount
FROM object_with_object_properties
WHERE objectTypeId = '0-3'
LIMIT 3;
Retorna:
OBJECTID | DEALNAME | DEALSTAGE | DEALAMOUNT |
38960439 | Nome do negócio 1 | closedlost | 7488939 |
321740651 | Nome do negócio 1 | fechado | 9292029 |
98392101 | Nome do negócio 1 | closedlost | 62626528 |
objects
Este objecto de base de dados é um subconjunto dos dados do objecto_com_objecto_objecto_objecto_de_base de dados. Cada linha retornada retorna o ID do objeto para cada registro. Este objecto de base de dados apenas devolve registos existentes. Quando um registo é apagado no HubSpot, ele será removido deste objecto da base de dados. Este objecto de base de dados é um subconjunto dos dados da tabela de objectos com propriedades de objectos. Cada linha retornada retorna o ID do objeto para cada registro. Esta visualização apenas devolve registros existentes. Quando um registro for excluído do HubSpot, ele será removido desta visualização.
Este objecto de base de dados pode ser útil se a sua conta tiver uma grande quantidade de dados, levando a que o objecto_com_objecto_propriedades e objectos_x visualizações se realizem lentamente. A utilização deste objecto de base de dados com o objecto de base de dados object_properties torna possível replicar os dados no object_with_object_properties, mantendo ao mesmo tempo o controlo sobre quais as propriedades devolvidas.
Este objecto de base de dados pode devolver as seguintes colunas:
Nome da coluna | Tipo | Descrição |
OBJECTTYPEID |
Varchar | O ID do tipo de objecto (por exemplo, contactos é 0-1 ). |
OBJECTID |
Número | O ID do registo (por exemplo, um registo de contacto com um ID de 123752 ). |
INGESTEDAT |
Data/hora | A data e hora em que os dados foram consumidos pela última vez pelo Snowflake. Saiba mais sobre os tipos de dados das colunas. |
Exemplo 1
Recuperar todos os registros de contato.
Consulta:
SELECT objectTypeId, objectId
FROM objects
WHERE objectTypeId = '0-1'
Retorna:
OBJECTTYPEID | OBJECTID |
0-1 | 36721864 |
0-1 | 103580363 |
0-1 | 56047670 |
... | ... |
object_properties
Este objecto de base de dados é um subconjunto do objecto_com_objecto_objecto_de_base de dados de propriedades. Cada linha contém o valor actual da propriedade estabelecido num dado registo. Por exemplo, um contato terá uma linha para a propriedade Nome e uma linha para a propriedade Sobrenome. Se um registo não tiver um valor para um bem, a fila ou aparece com um fio vazio ou não aparece de todo.
Este objecto de base de dados pode devolver as seguintes colunas:
Nome da coluna | Tipo | Descrição |
OBJECTTYPEID |
Varchar | O ID do tipo de objecto (por exemplo, contactos é 0-1 ). |
OBJECTID |
Número | O ID do registo (por exemplo, um registo de contacto com um ID de 123752 ). |
NAME |
Varchar | O nome da propriedade. |
VALUE |
Data/hora | O valor da propriedade. |
UPDATEDAT |
Data/hora | A data e hora em que o registro foi atualizado pela última vez no HubSpot. Saiba mais sobre os tipos de dados das colunas. |
INGESTEDAT |
Data/hora | A data e hora em que os dados foram consumidos pela última vez pelo Snowflake. |
Exemplo 1
Recuperar propriedades de nome, sobrenome e cidade para todos os contatos.
Consulta:
SELECT objectTypeId, objectId, name, value
FROM object_properties
WHERE objectTypeId = '0-1'
AND name IN ('firstname', 'lastname', 'city')
ORDER BY objectId;
Retorna:
OBJECTTYPEID | OBJECTID | NAME | VALUE |
0-1 | 10401 | firstname | Brian |
0-1 | 10401 | city | Dublin |
0-1 | 10401 | lastname | Gallagher |
0-1 | 23451 | firstname | Fernando |
0-1 | 23451 | lastname | Fierro |
0-1 | 25751 | firstname | Charles |
... | ... | ... | ... |
Exemplo 2
Recuperar nome, sobrenome e fase do ciclo de vida de todos os contatos, e combiná-los em uma linha por contato. Este exemplo utiliza a sintaxe SQL PIVOT.
Consulta:
SELECT objectId, firstname, lastname, lifecyclestage
FROM
(
SELECT objectId, name, value
FROM object_properties
WHERE objectTypeId = '0-1'
AND name IN ('firstname', 'lastname', 'lifecyclestage')
)
PIVOT(MAX(value) FOR name IN ('firstname', 'lastname', 'lifecyclestage')) AS p(objectId, firstname, lastname, lifecyclestage);
Retorna:
OBJECTTYPEID | OBJECTID | FIRSTNAME | LASTNAME | LIFECYCLESTAGE |
0-1 | 54325098 | Hobbes | Baron | lead |
0-1 | 96805401 | Milo | Gold | lead |
0-1 | 6922028 | Henry | Riley | lead |
... | ... | ... | ... | ... |
object_properties_history
Este objecto de base de dados contém valores históricos de propriedade. Para contatos, contém os 45 valores mais recentes. Para todos os outros objetos, ele contém os 20 valores mais recentes. Exibe uma linha para cada valor histórico de propriedade. O valor atual de uma propriedade é determinada pela data/hora mais recente UPDATEDAT no histórico da propriedade.
Este objecto de base de dados pode devolver as seguintes colunas:
Nome da coluna | Tipo | Descrição |
OBJECTTYPEID |
Varchar | O ID do tipo de objecto (por exemplo, contactos é 0-1 ). |
OBJECTID |
Número | O ID do registo (por exemplo, um registo de contacto com um ID de 123752 ). |
NAME |
Varchar | O nome da propriedade. |
VALUE |
Data/hora | O valor da propriedade. |
UPDATEDAT |
Data/hora | A data e hora em que os dados foram atualizados pela última vez no HubSpot. Saiba mais sobre os tipos de dados das colunas. |
INGESTEDAT |
Data/hora | A data e hora em que os dados foram consumidos pela última vez pelo Snowflake. |
Exemplo 1
Recuperar o histórico de uma única propriedade para um único contato.
Consulta:
SELECT objectId, name, value, updatedAt
FROM object_properties_history
WHERE objectTypeId = '0-1'
AND objectId = 136493192
AND name = 'hs_predictivescoringtier'
ORDER BY UPDATEDAT DESC;
Retorna:
OBJECTID | NAME | VALUE | UPDATEDAT |
136493192 |
hs_predictivescoringtier |
tier_1 |
2022-06-22 22:45:05.931 |
136493192 |
hs_predictivescoringtier |
tier_2 |
2021-09-18 08:20:56.622 |
136493192 |
hs_predictivescoringtier |
tier_3 |
2019-11-31 18:20:22.851 |
... |
... |
... |
... |
Exemplo 2
Recuperar o nome atual de todos os contatos que já tiveram uma fase do ciclo de vida de Subscriber.
Consulta:
SELECT
objectId,
properties:firstname::string AS firstname,
properties:lastname::string AS lastname
FROM object_with_object_properties
WHERE object_with_object_properties.objectTypeId = '0-1'
AND objectId IN (
SELECT objectId
FROM object_properties_history
WHERE
object_properties_history.objectTypeId = '0-1'
AND object_properties_history.name = 'lifecyclestage'
AND object_properties_history.value = 'subscriber'
);
Retorna:
OBJECTID | FIRSTNAME | LASTNAME |
54325098 | Hobbes | Baron |
96805401 | Milo | Gold |
6922028 | Henry | Riley |
... | ... | ... |
Consultas de associação
Tal como os dados dos objectos, os dados das associações são organizados de duas formas:
- Individual: Cada tipo de associação é armazenado na sua própria visão e contém apenas registos desse tipo. Por exemplo, as associações_contactos_à_contactos contêm apenas registos de associação entre objectos de contacto e de negociação. Isto elimina a necessidade de especificar um tipo de associação enquanto se faz uma consulta. Estes pontos de vista são bastante fáceis de consultar uma vez que não requerem familiaridade com o modelo de dados CRM para a sua utilização. Também devolvem uma descrição enriquecida do registo de associação entre dois objectos que podem ser facilmente utilizados em junções com vistas de objectos_x. Desde que não tenha dúvidas lentas, é aconselhável utilizar estes pontos de vista para recuperar dados de associação. Ver mais em associações_x_à_s opiniões abaixo.
- Combinados: Todos os registos para todos os tipos de associação são combinados num único objecto de base de dados. Assim, ao consultar, é necessário especificar um filtro como "ONDE combinou-associação tipoid='0-32'". Ver mais adiante em associações e definições_de-associação.
associações_x_para_y vistas
Cada tipo de associação tem a sua própria visão, rotulada como associações_<association type name> e.g. associações_contactos_até_às_deférias. Cada vista é um subconjunto dos dados no objecto da base de dados das associações e contém apenas registos de um tipo específico de associação combinada.
Cada objecto da base de dados devolverá as seguintes colunas:
Nome da coluna |
Tipo |
Descrição |
COMBINEDASSOCIATIONTYPEID |
Varchar |
O identificador único da definição da associação. |
ASSOCIAÇÃOCATEGORIA |
Varchar |
A fonte do tipo de associação. Uma das: HUBSPOT_DEFINED, USER_DEFINED, INTEGRADOR_DEFINED |
ASSOCIATIONTYPEID |
Varchar |
Um identificador único de uma definição de associação dentro de uma categoria de associação específica, ou seja, não haverá duas definições numa categoria de associação com o mesmo tipo de associação. |
FROMOBJECTTYPEID |
Varchar |
O tipo de objecto que é a fonte da definição da associação. |
FROMOBJECTTYPE |
Varchar |
O nome do tipo de objecto que é a fonte da definição da associação. |
TOOBJECTTYPEID |
Varchar |
O tipo de objecto que é o destino da definição da associação. |
TOOBJECTTYPE |
Varchar |
O nome do tipo de objecto que é o destino da definição da associação. |
NAME |
Varchar |
O nome da definição da associação. |
LABEL |
Varchar |
A descrição da definição da associação. |
ISMAINASSOCIATIONDEFINITION |
Booleano |
Se a definição da associação é o tipo principal. Quando verdadeira, a definição é a que o HubSpot apresenta nos registos associados |
[FROMOBJECTTYPE_OBJECTID] e.g. para visualização ASSOCIATIONS_CONTACTS_TO_DEALS, esta será CONTACT_OBJECTID |
Número |
O ID do objecto de origem. |
[TOOBJECTTYPE_OBJECTID] e.g. para a visualização ASSOCIATIONS_CONTACTS_TO_DEALS, isto será DEAL_OBJECTID |
Número |
O ID do Objecto do objecto de destino. |
INGESTEDAT |
Data/hora |
A data e hora em que os dados foram consumidos pela última vez pelo Snowflake. |
Exemplo 1
Recuperar todos os negócios associados a um contacto específico.
Consulta:
SELECT
contact_objectId, deal_objectId
DE_contactos_a_contactos_à_contratações
ONDE contactarId = 6626541373
Devoluções:
CONTACT_OBJECTID |
DEAL_OBJECTID |
6626541373 |
233620335 |
6626541373 |
90253678 |
Exemplo 2
Recuperar todos os contactos baseados no fuso horário de Bogotá e as suas ofertas.
SELECT contacts.property_firstname contact_firstname,
contacts.property_lastname contact_lastname,
contacts.property_email contact_email,
deals.property_dealtype deal_type, deals.property_amount deal_amount
FROM objects_contacts contacts
JOIN associations_contacts_to_deals assoc on
assoc.contact_objectid=contacts.objectid
JOIN objects_deals deals on deals.objectid=assoc.deal_objectid
where contacts.property_hs_timezone='america_slash_bogota'
CONTACT_FIRSTNAME |
CONTACT_LASTNAME |
CONTACTO_EMAIL |
DEAL_TYPE |
DEAL_AMOUNT |
Diego |
Magalhães |
dmagalhaes@example.com |
newbusiness |
74848 |
Fernanda |
Rodrigues |
fmoreira@example.com |
newbusiness |
253530 |
Exemplo 3
Recuperar todos os contactos e a soma total do montante total do negócio fechado para cada contacto.
SELECT SUM(deals.property_hs_closed_amount) AS
total_closed_amount, contacts.property_email contact_email
FROM objects_contacts contacts
JOIN associations_contacts_to_deals assoc on
assoc.contact_objectid=contacts.objectid
JOIN objects_deals deals.objectid=assoc.deal_objectid
GROUP BY contact_email
ORDER BY total_closed_amount DESC
Retorna:
TOTAL_FECHADA_MONTANTE |
CONTACTO_EMAIL |
98474793 |
johndoe@riverview.com |
849488 |
sallymae@longford.com |
association_definitions
Este objecto de base de dados contém informação sobre todos os tipos de associação disponíveis entre os objectos HubSpot, com uma linha por tipo de associação. Pode juntar-se a este objecto da base de dados com o objecto da base de dados das associações para obter informações específicas de associações de registos.
Pode haver vários tipos de associações entre os mesmos objetos. O tipo de associação principal, que é o tipo apresentado no HubSpot quando os registos são associados, utiliza a associação em que ISMAINASSOCIATIONDEFINITION
é true
.
Este objecto de base de dados pode devolver as seguintes colunas:
Nome da coluna | Tipo | Descrição |
COMBINEDASSOCIATIONTYPEID |
Varchar | O identificador único da definição da associação. |
CATEGORY |
Varchar | A fonte do tipo de associação. Um de: HUBSPOT_DEFINED , USER_DEFINED , INTEGRATOR_DEFINED |
ID |
Número | O identificador da definição da associação dentro da sua categoria. |
FROMOBJECTTYPEID |
Varchar | O ID do objeto que é a fonte da definição da associação. |
TOOBJECTTYPEID |
Varchar | O ID do objeto que é o destino da definição da associação. |
NAME |
Varchar | O nome da definição da associação. |
LABEL |
Varchar | O rótulo da definição da associação. |
ISMAINASSOCIATIONDEFINITION |
Booleano | Se a definição da associação é o tipo principal. Quando verdadeira, a definição é aquela que o HubSpot exibe nos registros associados. |
INGESTEDAT |
Data/hora | A data e hora em que os dados foram consumidos pela última vez pelo Snowflake. Saiba mais sobre os tipos de dados das colunas. |
Exemplo 1
Recuperar os tipos de associações disponíveis na sua conta.
Consulta:
SELECT combinedAssociationTypeId, fromObjectTypeId, toObjectTypeId, name
FROM association_definitions
ORDER BY category, id
Retorna:
COMBINEDASSOCIATIONTYPE | FROMOBJECTTYPEID | TOOBJECTTYPEID | NAME |
0-1 | 0-1 | 0-2 | CONTACT_TO_COMPANY |
0-2 | 0-2 | 0-1 | COMPANY_TO_CONTACT |
0-3 | 0-3 | 0-1 | DEAL_TO_CONTACT |
0-4 | 0-1 | 0-3 | CONTACT_TO_DEAL |
0-5 | 0-3 | 0-2 | DEAL_TO_COMPANY |
... | ... | ... | ... |
Exemplo 2
Recuperar os tipos de associação disponíveis entre negócios e empresas.
Consulta:
SELECT
combinedAssociationTypeId, fromObjectTypeId, toObjectTypeId, name
FROM association_definitions
WHERE fromObjectTypeId = '0-3' AND toObjectTypeId = '0-2'
AND isMainAssociationDefinition = trueORDER BY category, id
Retorna:
COMBINEDASSOCIATIONTYPE | FROMOBJECTTYPEID | TOOBJECTTYPEID | NAME |
0-5 | 0-3 | 0-2 | DEAL_TO_COMPANY |
0-271 | 0-3 | 0-2 | DEAL_TO_PRIMARY_COMPANY |
0-341 | 0-3 | 0-2 | DEAL_TO_COMPANY_UNLABELED |
associações
Este objecto de base de dados contém informações sobre as associações entre registos específicos. Cada linha representa uma associação de um objeto a outro objeto. As linhas podem estar presentes neste objecto de base de dados mesmo que os registos referenciados tenham sido eliminados. É possível verificar se existem registros unindo com a tabela de objetos.
Este objecto de base de dados pode ser útil se a sua conta tiver uma grande quantidade de dados, levando a que as associações_x_a_visões de_a_a actuem lentamente.
Este objecto de base de dados pode devolver as seguintes colunas:
Nome da coluna | Tipo | Descrição |
COMBINEDASSOCIATIONTYPEID |
Varchar | O identificador único da definição da associação. |
FROMOBJECTID |
Número | O ID do objeto fonte. |
TOOBJECTID |
Número | O ID do objeto de destino. |
INGESTEDAT |
Data/hora | A data e hora em que os dados foram consumidos pela última vez pelo Snowflake. Saiba mais sobre os tipos de dados das colunas. |
Exemplo 1
Recuperar todos os negócios e contatos associados.
Consulta:
SELECT combinedAssociationTypeId, fromObjectId, toObjectId
FROM associations
WHERE combinedAssociationTypeId = '0-5'
Retorna:
COMBINEDASSOCIATIONTYPEID | FROMOBJECTID | TOOBJECTID |
0-5 | 6626541373 | 233620335 |
0-5 | 6616436082 | 3866015468 |
0-5 | 6690805943 | 7132752747 |
... | ... | ... |
Exemplo 2
Recuperar todos os tickets associados a um contato específico (ID de contato: 3005).
Consulta:
SELECT combinedAssociationTypeId, fromObjectId, toObjectId
FROM associations
WHERE associationCategory = 'HUBSPOT_DEFINED'
AND combinedAssociationTypeId = '0-15'
AND fromObjectId = 3005;
Retorna:
COMBINEDASSOCIATIONTYPE | FROMOBJECTID | TOOBJECTID |
0-5 | 6626541373 | 233620335 |
Exemplo 3
Recuperar todos os negócios associados a um contato específico (ID do contato: 4464). Em vez de codificar combinedAssociationTypeId, este exemplo junta-se a association_definitions.
Consulta:
SELECT combinedAssociationTypeId, fromObjectId toObjectId,
FROM associations
WHERE
combinedAssociationTypeId = (
SELECT combinedAssociationTypeId
FROM association_definitions
WHERE fromObjectTypeId = '0-1'
AND toObjectTypeId = '0-3'
AND isMainAssociationDefinition)
AND fromObjectId = 4464;
Retorna:
COMBINEDASSOCIATIONTYPEID | FROMOBJECTID | TOOBJECTID |
0-5 | 6626541373 | 233620335 |
Consultas do proprietário
owners
Este objecto de base de dados contém informação sobre os utilizadores na sua conta HubSpot. Os usuários podem ser definidos como proprietários de registros e terão um ID de usuário e um ID de proprietário, dependendo de seu contexto. Os dois IDs podem ser usados para identificar o mesmo usuário.
Este objecto de base de dados pode devolver as seguintes colunas:
Nome da coluna | Tipo | Descrição |
OWNERID |
Número | O ID de proprietário do usuário. |
USERID |
Número | O ID de usuário do usuário. Os usuários com NULL nesta coluna foram excluídos. |
EMAIL |
Varchar | O endereço de e-mail do usuário. |
FIRSTNAME |
Varchar | O nome do usuário. |
LASTNAME |
Varchar | O sobrenome do usuário. |
ARCHIVED |
Booleano | Se o usuário foi excluído. |
CREATEDAT |
Data/hora | A data e hora em que o usuário foi criado no HubSpot. Consulte os tipos de dados da coluna para obter mais informações. |
UPDATEDAT |
Data/hora | A data e hora em que o usuário foi atualizado pela última vez no HubSpot. Consulte os tipos de dados da coluna para obter mais informações. |
INGESTEDAT |
Data/hora | A data e hora em que os dados foram consumidos pela última vez pelo Snowflake. |
Exemplo 1
Recuperar todos os usuários. O filtro WHERE archived = false
remove os utilizadores eliminados dos dados devolvidos.
Consulta:
SELECT ownerId, userId, email, firstname, lastname
FROM owners
WHERE archived = false
Retorna:
OWNERID | USERID | FIRSTNAME | LASTNAME | |
29584574 | 4621126 | 233620335 | Hobbes | Baron |
30532717 | 4874784 | 3866015468 | Pablo | Walters |
30580321 | 925511 | 7132752747 | Milo | Gold |
... | ... | ... | ... | ... |
Exemplo 2
Recuperar um proprietário específico através do seu ID de proprietário.
Consulta:
SELECT ownerId, userId, email, firstname, lastname
FROM owners
WHERE ownerId = 29584574;
Retorna:
OWNERID | USERID | FIRSTNAME | LASTNAME | |
29584574 | 4621126 | 233620335 | Hobbes | Baron |
Exemplo 3
Recuperar todos os contatos e seus proprietários. Esta consulta junta os registros dos proprietários com object_with_object_properties e hubspot_owner_idda propriedade de contato.
SELECT
contact.objectId contactid,
contact.property_firstname contact_firstname,
contact.property_lastname contact_lastname,
contact.property_hubspot_owner_id contact_hubspot_owner_id,
owner.firstname owner_firstname,
owner.lastname owner_lastname,
owner.email owner_email
FROM objects_contacts contact
JOIN owners owner ON contact.property_hubspot_owner_id = owner.ownerId
Retorna:
CONTACTID | CONTACT_FIRSTNAME | CONTACT_LASTNAME | CONTACT_HUBSPOT_OWNER_ID | OWNER_FIRSTNAME | OWNER_LASTNAME | OWNER_EMAIL |
113834202 | Richard | Greenfield | 29584574 | Hobbes | Baron | hobbes.b@business.com |
53540801 | Ford | Karl | 30241125 | Milo | Gold | milo.g@business.com |
... | ... | ... | ... | ... | ... | ... |
Perguntas da equipa
equipas
As equipes no HubSpot permitem organizar os usuários em grupos para fins organizacionais e de relatórios. Você pode ter uma equipe principal e equipes extras.
Este objeto de base de dados contém informações sobre as equipas na sua conta da HubSpot.
Este objecto de base de dados pode devolver as seguintes colunas:
Nome da coluna | Tipo | Descrição |
EQUIPA | Número | A identificação da equipa. |
NOME DA EQUIPA | Varchar | O nome da equipa. |
PARENTTEAMIDA | Número | A identificação da equipa da equipa principal. |
CRIANÇAS-TEAMIDA | Array | Os IDs de equipa das equipas secundárias. |
MEMBROS PROPRIETÁRIOS PRIMÁRIOS | Varchar | Os IDs do proprietário dos membros principais da equipa. |
MEMBROS SECUNDÁRIOS | Booleano | Os IDs do proprietário dos membros secundários da equipa. |
INGESTEDAT | Data/hora | A data e hora em que os dados foram consumidos pela última vez pelo Snowflake. |
Exemplo 1
Recuperar todas as equipas.
Consulta:
SELECT teamId,teamName, primaryOwnerMembers
DE equipas
Retorna:
EQUIPA | NOME DA EQUIPA | MEMBROS PROPRIETÁRIOS PRIMÁRIOS |
29584574 | Sub-equipa | [233620335, 1234553] |
30532717 | Super Equipa | [3866015468, 126221873] |
3058032 | Uma equipa | [7132752747] |
equipa_proprietária
Este objeto de base de dados contém informações sobre que proprietários correspondem a que equipas na sua conta da HubSpot.
Este objecto de base de dados pode devolver as seguintes colunas:
Nome da coluna | Tipo | Descrição |
EQUIPA | Número | A identificação da equipa. |
OWNERID | Número | O ID de proprietário do usuário. |
ISTEAMPRIMÁRIO | Booleano | Se esta equipa é a equipa principal para este proprietário. |
INGESTEDAT | Data/hora | A data e a hora em que os dados foram ingeridos pela última vez pelo Snowflake. |
Exemplo 1
Recuperar todos os proprietários de uma determinada equipa.
Consulta:
SELECT teamId, ownerId, isTeamPrimary
FROM teams
WHERE teamId = 29584574
Devoluções
EQUIPA | NOME DA EQUIPA | ISTEAMPRIMÁRIO |
29584574 | 233620335 | VERDADEIRO |
29584574 | 1234553 | VERDADEIRO |
Consultas sobre pipelines
Abaixo, saiba como consultar os dados do pipeline de negócios e tíquetes do , como os pipelines disponíveis em sua conta e seus estágios.
Você pode juntar estes dados com os dados do objeto para uma visão completa dos seus pipelines. Por exemplo, pode consultar as ofertas e os seus pipelines juntando os dados dos objectos_deals_view ou os dados dos objectos_com_objectos_propriedades com os dados dos pipelines.
pipelines
Este objecto da base de dados contém informações sobre o negócio e as condutas de bilhetes na sua conta. Cada linha devolvida representa um único pipeline.
Esta tabela pode retornar as seguintes colunas:
Nome da coluna | Tipo | Descrição |
PIPELINEID |
Varchar | O ID do pipeline. |
OBJECTTYPEID |
Varchar | O ID do objeto que o pipeline pode conter (por exemplo, negócios ou tickets). |
LABEL |
Varchar | O nome do pipeline no HubSpot. |
DISPLAYORDER |
Número | A ordem em que o pipeline é exibido no HubSpot. |
ARCHIVED |
Booleano | Se o pipeline foi excluído. |
CREATEDAT |
Data/hora | Quando o pipeline foi criado. |
UPDATEDAT |
Data/hora | A data e hora em que os dados foram atualizados pela última vez no HubSpot. Saiba mais sobre os tipos de dados das colunas. |
INGESTEDAT |
Data/hora | A data e hora em que os dados foram consumidos pela última vez pelo Snowflake. |
Exemplo 1
Recuperar todos os pipelines disponíveis, ordenados pela sua ordem no HubSpot.
Consulta:
SELECT objectTypeId, pipelineId, label
FROM pipelines
WHERE objectTypeId = '0-3'
AND not archived
ORDER BY displayorder;
Retorna:
OBJECTTYPEID | PIPELINEID | LABEL |
0-3 | 1bed503c-37f7-4f51-9d40-7598902673f4 | Pipeline de vendas |
0-3 | 12659678 | Pipeline de licenças |
0-3 | 75e28846-ad0d-4be2-a027-5e1da6590b98 | Nova empresa |
... | ... | ... |
Exemplo 2
Recuperar negócios dentro de um pipeline específico. Une object_with_object_properties e pipelines.
Consulta:
SELECT
deals.objectId deal_id,
deals.property_dealname deal_name,
pipelines.label pipeline_name
FROM objects_deals deals
INNER JOIN pipelines
ON deals.objectTypeId = pipelines.objectTypeId
AND deals.property_pipeline = pipelines.pipelineid
WHERE pipelines.objectTypeId = '0-3';
Retorna:
DEAL_ID | DEAL_NAME | PIPELINE_NAME |
605140072 | Inscrição da Meowmix | Pipeline de vendas |
605457408 | Rebrand da Friskies | Pipeline de vendas |
604362473 | Criação do aplicativo Fresh Step | Pipeline de vendas |
Exemplo 3
O mesmo que o Exemplo 2 acima, recuperar negócios dentro de um gasoduto específico. Mas, em vez de usar objectos_deals nas uniões, usar objectos_com_objectos_propriedades.
SELECT
deals.objectId deal_id,
deals.properties:dealname::varchar deal_name,
pipelines.label pipeline_name
FROM object_with_object_properties deals
INNER JOIN pipelines
ON deals.objectTypeId = pipelines.objectTypeId
AND deals.properties:pipeline::string = pipelines.pipelineid
WHERE deals.objecttypeId = '0-3'
AND pipelines.objectTypeId = '0-3';
Retorna:
DEAL_ID |
DEAL_NAME |
PIPELINE_NAME |
605140072 |
Inscrição da Meowmix |
Pipeline de vendas |
605457408 |
Rebrand da Friskies |
Pipeline de vendas |
604362473 |
Criação do aplicativo Fresh Step |
Pipeline de vendas |
pipeline_stages
Esta visualização contém informações sobre etapas individuais dentro de um pipeline. Identificar etapas através da combinação do ID do tipo de objeto, ID do pipeline e ID da etapa. Ao unir com pipelines, usar o ID do tipo de objeto e ID d pipeline.
Este objecto de base de dados pode devolver as seguintes colunas:
Nome da coluna | Tipo | Descrição |
PIPELINEID |
Varchar | O ID do pipeline. |
STAGEID |
Varchar | A identificação do palco. |
LABEL |
Varchar | O nome do palco em HubSpot. |
DISPLAYORDER |
Número | A ordem em que o pipeline é exibido no HubSpot. |
METADATA |
Variante | Uma descrição do palco em formato JSON, incluindo se está aberto ou fechado |
ARCHIVED |
Booleano | Se a fase de gasoduto foi eliminada. |
CREATEDAT |
Data/hora | Quando a fase de gasoduto foi criada. |
Exemplo 1
Recuperar as etapas de um pipeline para um pipeline de negócios chamado Pipeline de vendas.
Consulta:
SELECT pipelineid, stageId, label
FROM pipeline_stages
WHERE not archived
AND pipelineid = (
SELECT pipelineid
FROM pipelines
WHERE objectTypeId = '0-3'
AND not archived
AND label = 'Sales Pipeline' LIMIT 1)
ORDER BY displayorder;
Retorna:
PIPELINEID | STAGEID | LABEL |
941650 | 941651 | Contatado |
941650 | 941652 | Compromisso agendado |
941650 | 941653 | Fatura enviada |
... | ... | ... |
Exemplo 2
Recuperar todos os negócios e suas respectivas fases de pipeline.
Consulta:
SELECTdeals.objectId deal_id,
deals.properties:dealname::varchar deal_name,
pipelines.label pipeline_name,
pipeline_stages.label pipeline_stage_name
FROM object_with_object_properties deals
INNER JOIN pipelines
ON deals.objectTypeId = pipelines.objectTypeId
AND deals.properties:pipeline::string = pipelines.pipelineid
INNER JOIN pipeline_stages
ON deals.objectTypeId = pipeline_stages.pipelineid
AND deals.properties:pipeline::string = pipeline_stages.pipelineid
AND deals.properties:dealstage::string = pipeline_stages.stageId
WHERE deals.objecttypeId = '0-3';
Retorna:
DEAL_ID | DEAL_NAME | PIPELINE_NAME | PIPELINE_STAGE_NAME |
605140072 | Inscrição da Meowmix | Pipeline de vendas | Contrato enviado |
605457408 | Rebrand da Friskies | Pipeline de vendas | Compromisso agendado |
604362473 | Criação do aplicativo Fresh Step | Pipeline de vendas | Contrato assinado |
... | ... | ... | ... |
Consultas de propriedade
property_definitions
Este objecto de base de dados contém informação sobre propriedades de objectos e propriedades de eventos na sua conta HubSpot. As propriedades de eventos incluem eventos padrão, como abertura e cliques de e-mail, e propriedades de eventos comportamentais personalizados. Essas informações podem ser úteis para definir valores encontrados nos dados de object_properties de events.
É possível identificar propriedades específicas combinando seu nome e ID do tipo de objeto. Você pode recuperar informações semelhantes usando as propriedades de API.
Este objecto de base de dados pode devolver as seguintes colunas:
Nome da coluna | Tipo | Descrição |
OBJECTYPEID |
Varchar | O ID do objeto com o qual o evento se relaciona. |
NAME |
Varchar | O nome interno da propriedade. |
LABEL |
Varchar | O rótulo da propriedade. |
DESCRIPTION |
Varchar | A descrição da propriedade. |
TYPE |
Varchar | O tipo da propriedade (por exemplo, string, número, data e hora). |
FIELDTYPE |
Varchar | O tipo de campo da propriedade. Define como a propriedade é exibida no HubSpot e em formulários (por exemplo, caixa de seleção, seleção). |
DISPLAYORDER |
Número | A ordem de exibição da propriedade. |
GROUPNAME |
Varchar | O nome do grupo da propriedade. |
OPTIONS |
Variante | Para propriedades de enumeração, um conjunto de opções da propriedade, incluindo os atributos de cada opção (por exemplo, ordem de exibição, rótulo). |
CREATEDUSERID |
Número | O ID do usuário que criou a propriedade. |
REFERENCEDOBJECTTYPE |
Varchar | O tipo de objeto a qual a propriedade referencia. As propriedades do proprietário devolverão um valor de OWNER. |
CALCULATED |
Booleano | Se a propriedade é uma propriedade calculada. |
EXTERNALOPTIONS |
Booleano | Se as opções da propriedade estão definidas em um sistema externo. |
HASUNIQUEVALUE |
Booleano | Se os valores da propriedade são únicos. Só pode ser definido ao criar uma propriedade através da API. |
HIDDEN |
Booleano | Se a propriedade está oculta no HubSpot. |
SHOWCURRENCYSYMBOL |
Booleano | Se o número de valor de uma propriedade é formatado como moeda. |
FORMFIELD |
Booleano | Se esta propriedade pode ser usada em formulários. |
READONLYDEFINITION |
Booleano | Se a propriedade pode ser editada no HubSpot. |
READONLYVALUE |
Booleano | Se o valor da propriedade pode ser editado no HubSpot. |
HUBSPOTDEFINED |
Booleano | Se a propriedade foi criada pela HubSpot, versus criada por um usuário. |
ARCHIVED |
Booleano | Se a propriedade foi excluída. |
CREATEDAT |
Data/hora | A data e hora em que a propriedade foi criada no HubSpot. |
UPDATEDAT |
Data/hora | A data e hora em que os dados foram atualizados pela última vez no HubSpot. Saiba mais sobre os tipos de dados das colunas. |
INGESTEDAT |
Data/hora | A data e hora em que os dados foram consumidos pela última vez pelo Snowflake. |
Exemplo 1
Recuperar os nomes e as descrições de todas as propriedades do contato.
Consulta:
SELECT name, label, description
FROM property_definitions
WHERE objectTypeId = '0-1'
Retorna:
NAME | LABEL | DESCRIPTION |
enter_sql_stage | Entrada na fase SQL | Iniciar contagem de dias de fase SQL. |
first_conversion_event_name
|
Primeira conversão | O primeiro formulário que esse contato enviou. |
endereço | Endereço | O endereço do contato. |
Consultas do evento
Os eventos incluem eventos padrão e eventos comportamentais personalizados do HubSpot. Cada evento tem o seu próprio objecto de base de dados, identificado como events_eventname
.
Nome | |
EVENTOS_AD_INTERACÇÃO | Detalhes de um anúncio e contactos que interagiram com ele, clicando no anúncio ou enviando um formulário após se ter envolvido com ele. |
EVENTOS_AD_METRICS_IMPORTADOS_V0 |
Detalhes de um anúncio e as suas métricas de desempenho. |
EVENTS_CALL_MENTIONED_MENTIONED_KEYWORD | Detalhes das palavras-chave mencionadas por quaisquer participantes nas chamadas. |
EVENTOS_CLICK_LINK_IN_IN_EMAIL_V2 |
Links clicados em e-mails de marketing por contactos. |
EVENTOS_CLICK_LINK_IN_IN_TRACKED_INBOX_EMAIL_V8 | Ligações clicadas na Caixa de Entrada de Conversações por contactos. |
EVENTOS_COOKIE_BANNER_CLIQUE_CLIQUE | Contactos que clicaram em cookies. |
EVENTOS_COOKIE_BANNER_VIEWED | Contactos que viram os cookies. |
EVENTOS_DOCUMENT_SHARED_V2 | Documentos de vendas partilhados com contactos através de uma ligação externa. |
EVENTOS_DOCUMENT_VIEWED_V2 | Documentos de vendas e contactos que tenham visualizado abrindo a ligação externa. |
EVENTS_DOCUMENT_COMPLETED_V2 | Documentos de venda e contactos que os encerraram. |
EVENTOS_HS_SCHELED_EMAIL_V2 | E-mails enviados para os servidores de e-mail do HubSpot a serem enviados. |
EVENTOS_MTA_DELIVERED_EMAIL_V2 | E-mails entregues com sucesso aos destinatários pelos servidores de e-mail HubSpot. |
EVENTOS_MTA_BOUNCED_EMAIL_V2 | Tentativas de entrega de correio electrónico que foram rejeitadas pelo servidor de correio electrónico do destinatário. |
EVENTS_OPENED_EMAIL_V2 | O e-mail é aberto por contactos. |
EVENTS_REPORTED_SPAM_EMAIL_V2 | E-mails marcados como spam pelos destinatários. |
EVENTOS_ACTUALIZADOS_EMAIL_SUBSCRIPTION_STATUS_V2 | Alterações nas subscrições de correio electrónico pelos destinatários. |
EVENTS_OPENED_TRACKED_INBOX_EMAIL_V8 | A caixa de entrada da Conservations abre-se por email através de contactos. |
EVENTOS_MB_MEDIA_PLAYED | Actividade de reprodução de vídeo por contactos. |
EVENTOS_V2_CONTACTOS_REUNIÃO_DE_CONTACTOS_REUNIÃO_ATRAVÉS_DA_SEQUÊNCIA | O contacto marcou uma reunião através de sequência. |
EVENTOS_V2_CONTACTOS_CONTACTOS_IN_SEQUENCE | Contacto inscrito a partir da sequência. |
EVENTOS_V2_CONTACTO_CONTATO_CONCLUÍDO_SEQUÊNCIA | Sequência terminada. |
EVENTOS_V2_CONTACTO_REPLICADO_REPLICADO_REPLICADO_REPROCESSO_EMAIL | O contacto respondeu ao correio electrónico (ou correio electrónico recebido que não foi registado) enviado em sequência. |
EVENTOS_V2_CONTACTO_DESLIGADO_DE_SEQUÊNCIA | Contacto não enrolado da sequência. |
EVENTOS_V2_CONTACTO_DESLIGADO_MANUALMENTE_DE_SEQUÊNCIA | O utilizador desenrolou manualmente o contacto. |
EVENTOS_V2_CONTACTO_DESCONTACTO_DESCRITAS_SETE_EMAIL | Contactar a cancelar a inscrição, desenrolar a sequência. |
EVENTS_V2_SEQUENCE_EMAIL_BOUNCED | O e-mail sequencial foi devolvido. |
EVENTOS_V2_SEQUÊNCIA_ERRORIZADA | Sequência errada causando o desenrolar da inscrição. |
EVENTS_V2_SEQUENCE_STEP_EXECUTED_EXECUTED | Passo sequencial executado. |
EVENTOS_VISITADOS_PÁGINA_VISITADA | Visitas a páginas web por contactos. |
Você pode identificar eventos combinando o ID e o ID do tipo de evento. As colunas que são devolvidas dependem do evento, com uma coluna para cada propriedade do evento. Todos os eventos retornarão as seguintes colunas:
Por favor note: HubSpot adicionou duas novas colunas a todas as tabelas e vistas de eventos:
occurredat
occurredatdateint
Estas colunas irão substituir as colunas occuredat
e occuredatdateint
em 24 de Novembro de 2022. Nessa data, as antigas colunas deixarão de estar disponíveis, e as tentativas de consultar um objecto ou vista de base de dados contendo eventos utilizando essas colunas falharão. Saiba mais sobre como quebrar as alterações para a partilha de dados do Floco de Neve.
Nome da coluna | Tipo | Descrição |
EVENTTYPEID |
Varchar | O ID do tipo de evento, semelhante ao OBJECTTYPEID Pode consultar todos os IDs de tipo uniforme na sua conta usando a vista de definições de tipo_objecto_e_evento_tipo_definições. |
ID |
Varchar | Isto é único por tipo de evento. Não haverá dois registos com a mesma identificação dentro de um determinado tipo de evento. |
OBJECTTYPEID |
Varchar | O tipo de objeto que completou o evento. Por exemplo, um clique numa hiperligação de correio electrónico apresentaria 0-1 nesta coluna, representando o objecto contactos. |
OBJECTID |
Número | O ID do registro que completou o evento. |
OCCURREDAT |
Data/hora | Quando o evento ocorreu. |
|
Número | Um número que representa quando o evento ocorreu. Contém os mesmos dados que a coluna OCCURREDAT mas formatados como um número e utilizados como parte da chave de agrupamento da tabela. Na maioria dos casos, é possível utilizar o OCCURREDAT carimbo de data/hora em vez deste número. |
|
Número | Um número que representa quando o evento ocorreu. Contém os mesmos dados que a coluna Nota: esta coluna será descontinuada em 24 de Novembro de 2022 e substituída por |
OCCUREDAT |
Data/hora | Quando o evento ocorreu. Nota: esta coluna será descontinuada em 24 de Novembro de 2022 e substituída por |
INGESTEDAT |
Data/hora | A data e hora em que os dados foram consumidos pela última vez pelo Snowflake. Saiba mais sobre os tipos de dados das colunas. |
PROPERTY_* |
Varchar | Colunas individuais que contêm as propriedades do evento. |
Exemplo 1
Recuperar os 50 mais recentes eventos de clique por e-mail.
Consulta:
SELECT eventTypeId, objectTypeId, objectId, occuredAt, property_hs_click_raw_url AS hs_click_raw_url
FROM events_clicked_link_in_email_V2
ORDER BY occuredAt
LIMIT 50;
Retorna:
EVENTTYPEID | OBJECTTYPEID | OBJECTID | OCCUREDAT | HS_CLICK_RAW_URL |
4-666288 | 0-1 | 45318579 | 2016-08-04 21:06:43.245 | http://website.com?utm_campaign=Launch&utm_source=hs_email&utm_medium=email&utm_content=32520579 |
4-666288 | 0-1 | 80701 | 2016-08-29 13:31:28.622 | https://cta-image-cms2.hubspot.com/ctas/v2/public/cs/ci/?pg=f0f6585a-08fc-4273-8422-49cfaddcf8d8&pid=1976760&ecid=ACsprvtkRbakerw4BiWlaDL7xFAqau1aW9m1_PAqSfQiWarY69X7Ds42zHGYTCfhHJLrXUP86Nxu |
4-666288 | 0-1 | 26146013 | 2017-11-30 14:27:11.528 | https://hubs.ly/H097a37a?utm_source=hs_email&utm_medium=email&utm_content=58251290 |
... | ... | ... | ... | ... |
Exemplo 2
Recuperar todos os eventos de clique por e-mail pelos contatos que clicaram. Esta consulta obtém dados de contato unindo-se com object_with_object_properties.
Consulta:
SELECT
click.occuredat click_timestamp,
click.property_hs_click_raw_url click_url,
contact.properties:firstname::varchar contact_firstname,
contact.properties:lastname::varchar contact_lastname
FROM events_clicked_link_in_email_V2 click
LEFT JOIN object_with_object_properties contact
ON click.objectTypeId = contact.objectTypeId
AND click.objectId = contact.objectId
LIMIT 3;
Retorna:
CLICK_TIMESTAMP | CLICK_URL | CONTACT_FIRSTNAME | CONTACT_LASTNAME |
2019-01-04 22:35:41.264 | https://help.website.com/articles/tutorial/how-to-use-email-tool?utm_source=hs_automation&utm_medium=email&utm_content=68042217 | Hobbes | Baron |
2018-11-08 09:37:41.400 | https://www.website.net/webinar-case-study?utm_source=hs_automation&utm_medium=email&utm_content=55200164 | Milo | Gold |
2018-11-08 09:37:41.426 | https://www.website.net/contact?utm_source=hs_automation&utm_medium=email&utm_content=55200164 | Carlow | Villari |
... | ... | ... | ... |
Consultas_tipo_objecto_e_evento
object_and_event_type_definitions
Este objecto de base de dados contém definições para todos os objectos e eventos disponíveis na sua conta HubSpot.
Este objecto de base de dados pode devolver as seguintes colunas:
Nome da coluna | Tipo | Descrição |
OBJECTTYPEID |
Varchar | O ID do objeto que o pipeline pode conter (por exemplo, negócios ou tickets). |
FULLYQUALIFIEDNAME |
Varchar | O nome do objeto ou evento. |
INGESTEDAT |
Data/hora | A data e hora em que os dados foram consumidos pela última vez pelo Snowflake. Saiba mais sobre os tipos de dados das colunas. |
Exemplo 1
Recuperar todos os objetos e eventos disponíveis na sua conta do HubSpot.
Consulta:
SELECT objectTypeId, fullyQualifiedName
FROM object_and_event_type_definitions;
Retorna:
OBJECTTYPEID | FULLYQUALIFIEDNAME |
0-1 | CONTACT |
0-8 | LINE_ITEM |
0-11 | CONVERSATION |
... | ... |
Consultas de listas
Abaixo, saiba como consultar suas listas, como as listas de contatos e empresas disponíveis e os registros incluídos nessas listas.
listas
Este objecto de base de dados contém informação sobre contactos HubSpot e listas de empresas. Retorna uma linha por lista, e as colunas incluem detalhes, como nome da lista, tamanho e tipo de objeto dos registros nela contidos. Não contém informações sobre os registros individuais dentro de cada lista (ver list_membership).
Este objecto de base de dados pode devolver as seguintes colunas:
Nome da coluna | Tipo | Descrição |
OBJECTTYPEID |
Varchar | O tipo de registros na lista (por exemplo, contato ou empresa). |
LISTID |
Número | O ID da lista. Une-se à coluna LISTID na tabela list-memberships. |
CLASSICLISTID |
Número | Um ID específico para listas de contatos que corresponda ao ID no URL da lista no HubSpot. |
NAME |
Varchar | O nome da lista. |
SIZE |
Número | O número de registros na lista. |
CREATEDBYUSERID |
Número | O ID do usuário que criou a lista. |
CREATEDAT |
Data/hora | Quando a lista foi criada no HubSpot. |
UPDATEDBYUSERID |
Número | O ID do usuário que mais recentemente atualizou a lista. |
UPDATEDAT |
Data/hora | A data e a hora em que a data foi atualizada pela última vez no HubSpot. Saiba mais sobre os tipos de dados das colunas. |
INGESTEDAT |
Data/hora | A data e hora em que os dados foram consumidos pela última vez pelo Snowflake. |
Exemplo 1
Recuperar todas as listas de contatos.
Consulta:
SELECT listId, name, size
FROM lists
WHERE objectTypeId = '0-1';
Retorna:
LISTID | NAME | TAMANHO |
118131 | Contato semanal | 103 |
66156 | Inscritos do blog | 455 |
771852 | Principais inscritos de 2021 | 37 |
... | ... | ... |
Exemplo 2
Recuperar uma lista de contatos específica chamada Principais inscritos de 2021.
Consulta:
SELECT listId, name, size
FROM lists
WHERE objectTypeId = '0-1'
ANDlistName = 'Top subscribers 2021';
Retorna:
LISTID | NAME | TAMANHO |
771852 | Principais inscritos de 2021 | 37 |
list_membership
Este objecto de base de dados contém informações sobre quais os registos que são membros de quais listas, com uma linha por registo na lista. Por exemplo, se tiver uma lista de subscritores de Blog com 500 contactos, o objecto da base de dados devolverá 500 filas.
Contém apenas IDs de lista e IDs de objeto. Para mais informações, junte-se ao objecto da base de dados das listas.
Este objecto de base de dados pode devolver as seguintes colunas:
Nome da coluna | Tipo | Descrição |
LISTID |
Varchar | O ID da lista. Una a coluna HS_LIST_ID na tabela lists. |
OBJECTID |
Varchar | O ID do registro na lista. |
UPDATEDAT |
Data/hora | A data e hora em que os dados foram atualizados pela última vez no HubSpot. Saiba mais sobre os tipos de dados das colunas. |
INGESTEDAT |
Data/hora | A data e hora em que os dados foram consumidos pela última vez pelo Snowflake. |
Exemplo 1
Recuperar os IDs de todos os contatos da lista Principais inscritos de 2021.
Consulta:
SELECT objectId
FROM list_memberships
INNER JOIN lists
ON list_memberships.listId = lists.listId
WHERE lists.objectTypeId = '0-1'
AND lists.name = 'Top Subscribers 2021';
Retorna:
OBJECTID |
54325098 |
96805401 |
6922028 |
... |
Exemplo 2
Recuperar o primeiro e último nomes dos contactos na lista dos Top Subscribers 2021.
Consulta:
SELECT
contact.objectId AS objectid,
contact.property_firstname AS firstname,
contact.property_lastname AS lastname
FROM objects_contacts contact
INNER JOIN list_memberships ON contact.objectId = list_memberships.objectId
INNER JOIN lists ON list_memberships.listId = lists.listId
WHERE lists.objectTypeId = '0-1'
AND lists.name = 'Top Subscribers 2021'
Retorna:
OBJECTID |
FIRST NAME |
LAST NAME |
54325098 |
Hobbes |
Baron |
96805401 |
Milo |
Gold |
6922028 |
Henry |
Riley |
... |
... |
... |
Perguntas frequentes
Quero gerar dados semelhantes a um relatório da aplicação Hubspot, como é que faço para o fazer?
De um modo geral, gostaria de olhar para as colunas presentes no relatório com que se está a comparar. Se a visualização do relatório não for tabular, a sua conversão para uma tabela mostrará as colunas que o relatório contém. Estas colunas são normalmente propriedades de um tipo de objecto ou de um tipo de evento. O próximo passo é descobrir a propriedade do tipo de objecto a que corresponde uma coluna. Pode fazer isto consultando property_definitions:
SELECT * FROM property_definitions
WHERE label = [column_name]
Pode não haver sempre uma correspondência exacta porque alguns nomes de propriedades são normalmente resolvidos para um nome mais descritivo na aplicação. Em casos como este, fazer uma pesquisa fuzzy utilizando o operador LIKE na coluna do rótulo (ou mesmo a descrição) na coluna property_definitions pode ajudar.
Depois de determinar a que tipo de objecto pertence a coluna, é trivial determinar o que deve ser consultado. Pode simplesmente pesquisar a vista object_x que corresponde ao tipo.
Como posso ligar este tipo de dados a outro, por exemplo, como recuperar formulários para uma campanha?
Se precisar de ligar dois ou mais registos diferentes um ao outro, dê uma vista de olhos às associações. As associações representam as relações entre objectos no CRM do HubSpot. Todas as diferentes associações possíveis entre dois tipos estão listadas em definições_de-associação. No exemplo acima, para conhecer todas as formas a que uma campanha está ligada, é necessário consultar ASSOCIATIONS_CAMPAIGNS_TO_FORMS:
SELECT campaigns.property_hs_name campaign_name,
forms.property_hs_form_id form_id
FROM objects_campaigns campaigns
JOIN associations_campaigns_to_forms assoc ON
assoc.campaign_objectid=campaigns.objectid
JOIN objects_forms forms ON forms.objectid=assoc.form_objectid
GROUP BY campaign_name
Como posso saber o estado da integração do HubSpot-Snowflake?
Para receber atualizações de status em tempo real sobre interrupções e problemas para a integração do HubSpot-Snowflake, consulte a exibição data_share_status:
SELECT * FROM hubspot.public.data_share_status
LIMIT 1
Os resultados serão apresentados como:
ESTADO | MENSAGEM | UPDATEDAT |
OK | NENHUM INCIDENTE CONHECIDO ATÉ AO MOMENTO | 2023-04-10 09:21:20.123 |
Esta vista fornece actualizações sobre o estado da integração por ordem cronológica inversa. A integração dos resultados desta consulta num painel de controlo ajudá-lo-á a acompanhar o desempenho da integração e a detectar qualquer tempo de inactividade ou interrupções.