เบต้าเชื่อมต่อ HubSpot และ Google BigQuery

เรียนรู้วิธีเชื่อมต่อ HubSpot และ Google BigQuery เพื่อซิงค์ข้อมูล HubSpot กับอินสแตนซ์ Google BigQuery ของคุณ

โปรดทราบ: HubSpot ไม่ได้ แชร์ข้อมูล HIPAA ไปยัง Google BigQuery

เชื่อมต่อ HubSpot และ BigQuery

ในการเชื่อมต่อ HubSpot และ Google BigQuery คุณต้องดำเนินการตามขั้นตอนเหล่านี้เพื่อ:

1. ติดตั้ง Google BigQuery จาก HubSpot App Marketplace
2. สร้างบทบาท IAM ที่กำหนดเองใน Google Cloud Platform
3. กำหนดบทบาทที่กำหนดเองให้กับบัญชีบริการของ Google
4. ให้สิทธิ์บัญชี Google BigQuery ที่สร้างโดย HubSpot เพื่อแก้ไขตาราง BigQuery
5. ตั้งค่าใน HubSpot ให้เสร็จสมบูรณ์

1. ติดตั้ง Google BigQuery จาก HubSpot App Marketplace

ขอแนะนำให้คุณเปิดบัญชี HubSpot และบัญชี Google BigQuery ในแท็บแยกต่างหากเมื่อเชื่อมต่อแอปทั้งสอง 

1. ตรวจสอบให้แน่ใจว่าคุณ เลือกใช้บัญชี HubSpot ของคุณในรุ่นเบต้า: เข้าถึงข้อมูล HubSpot ใน Google BigQuery 
2. ไปที่ ลิงก์นี้ แล้วเลือกบัญชี HubSpot ของคุณ 
3. คลิก ติดตั้ง
4. ป้อน URI ถังและ ID โครงการของคุณ 
5. คลิกถัดไป 
6. ตรวจสอบและจดบันทึกบัญชี Google Service และ BigQuery ตามที่คุณต้องการในขั้นตอนต่อไป จากนั้นไปที่คอนโซล Google Cloud ของคุณเพื่อทำขั้นตอนต่อไปให้เสร็จสิ้น 

2. สร้างบทบาท IAM ที่กำหนดเองใน Google Cloud Platform

1. ลงชื่อเข้าใช้คอนโซล Google Cloud ของคุณ 
2. คลิกเมนูนำทางด้านซ้ายและเลือก> บทบาท  & ผู้ดูแลระบบ IAM  
3. ที่ด้านบนให้คลิก สร้างบทบาท
4. ป้อนชื่อคำ อธิบายที่เป็นตัว เลือกและ ID สำหรับบทบาท 
5. คลิกเพิ่มการอนุญาต 

6. ในตารางให้เลือกการอนุญาตต่อไปนี้แล้วคลิกเพิ่ม:

bigquery.datasets.create
bigquery.datasets.get
bigquery.datasets.getIamPolicy
bigquery.jobs.create
bigquery.tables.create
bigquery.tables.createIndex
bigquery.tables.createSnapshot
bigquery.tables.createTagBinding
bigquery.tables.delete
bigquery.tables.deleteIndex
bigquery.tables.deleteSnapshot
bigquery.tables.update
bigquery.tables.get
storage.buckets.get
storage.objects.create
storage.objects.delete
storage.objects.get
storage.objects.list

7. คลิกสร้าง 

3. ให้สิทธิ์บัญชีบริการของ Google ในการเข้าถึง Cloud Storage Buckets

1. คลิกเมนูนำทางด้านซ้ายและเลือก Cloud Storage > Buckets 
2. เลือกที่เก็บข้อมูล เพื่อกำหนดค่า 
3. คลิกแท็บ สิทธิ
4. บน แท็บมุมมองตามหลักการ ให้คลิกให้สิทธิ์การเข้าถึง 

5. ในแผงด้านขวาในช่องหลักการใหม่ ให้ป้อนชื่อบัญชีบริการ Google จากขั้นตอนที่ 1

โปรดทราบ: ตรวจสอบให้แน่ใจว่าได้กำหนดบัญชีบริการ Google ไม่ใช่บัญชี BigQuery

6. ในส่วนกำหนดบทบาทให้ คลิก เมนูแบบเลื่อนลง และเลือกกำหนดเอง > <role> ว่าบทบาท IAM <role> ที่กำหนดเองที่สร้างขึ้นในขั้นตอนที่ 2 อยู่ที่ไหน 
7. คลิก บันทึก บัญชี Google Service จะถูกเพิ่มลงในบทบาท Storage Object Viewer  

4. ให้สิทธิ์บัญชี Google BigQuery ที่สร้างโดย HubSpot เพื่อแก้ไขตาราง BigQuery

1. คลิกเมนูนำทางด้านซ้ายและเลือก >  IAM & Admin  IAM 
2. คลิกให้สิทธิ์การเข้าถึง
3. ในแผงด้านขวาในฟิลด์หลักใหม่ให้ ป้อน บัญชี Google BigQuery ที่สร้าง โดย HubSpot จากขั้นตอนที่ 1
4. ในส่วนกำหนดบทบาทให้ คลิก เมนูแบบเลื่อนลง และเลือกกำหนดเอง > <role> ว่าบทบาท IAM <role> ที่กำหนดเองที่สร้างขึ้นในขั้นตอนที่ 2 อยู่ที่ไหน 

5. ตั้งค่าใน HubSpot ให้เสร็จสมบูรณ์

1. กลับไปที่บัญชี HubSpot ของคุณคลิก ดำเนินการต่อไปยังแอปที่เชื่อมต่อ 
2. ในกล่องโต้ตอบให้เลือก ช่องทำเครื่องหมายจากนั้นคลิกอนุญาตและติดตั้ง 

รูปแบบข้อมูลสำหรับการซิงค์ระหว่าง HubSpot และ Google BigQuery

ข้อมูลที่มีอยู่สำหรับการซิงค์

คุณสามารถซิงค์ข้อมูลต่อไปนี้จาก HubSpot ไปยัง Google BigQuery: 

• วัตถุ: วัตถุมาตรฐานและวัตถุที่กำหนดเองเช่นรายชื่อผู้ติดต่อบริษัทตั๋วหรือผลิตภัณฑ์
• เรคคอร์ด: เรคคอร์ด วัตถุแต่ละรายการ 
• การเชื่อมโยง: ทุกประเภทการเชื่อมโยงและบันทึกที่เกี่ยวข้อง
• กิจกรรม: ข้อมูลกิจกรรมสำหรับทั้งกิจกรรม HubSpot มาตรฐานและกิจกรรมพฤติกรรมที่กำหนดเอง 
• เซกเมนต์: ผู้ติดต่อ HubSpot และเซกเมนต์บริษัท
• เจ้าของ: เจ้าของเรคคอร์ด 
• ท่อ: ท่อข้อตกลงและตั๋วและขั้นตอนท่อ 
• พร็อพเพอร์ตี้: พร็อพเพอร์ตี้และค่าของพร็อพเพอร์ตี้ในบันทึกวัตถุรวมถึงประวัติพร็อพเพอร์ 

ข้อมูลวัตถุประเภทต่างๆได้รับการจัดระเบียบและมีให้เลือกสองวิธี:

• บุคคล: ประเภทวัตถุ e ach จะถูกเก็บไว้ในตารางของตัวเองและมีเพียงระเบียนของประเภทวัตถุเดียวกันเท่านั้น ตัวอย่างเช่น objects_contacts มีเพียงบันทึกการติดต่อเท่านั้น
• รวมกัน: ระเบียน ll สำหรับทุกประเภทออบเจ็กต์จะรวมกันเป็นออบเจ็กต์ฐานข้อมูลเดียว ดังนั้นเมื่อสอบถามคุณต้องระบุตัวกรองเช่น “WHERE objectTypeId =' 0 -1 ’

วัตถุที่กำหนดเองจะถูกกำหนด ID ในขณะที่สร้างและจะถูกระบุเป็น 2 - UNIQUE_ID ตัวอย่างเช่น 2 -12345 

object_x ตาราง

วัตถุแต่ละประเภทที่มีอยู่รวมถึงวัตถุที่กำหนดเองมีตารางเฉพาะของตัวเอง ตารางเหล่านี้ถูกตั้งชื่อตามรูป <object type name> แบบ OBJECTS_<object type name> โดยที่ป้ายชื่อรูปแบบพหูพจน์ objecttypeของ (โปรดทราบว่าหากประเภทวัตถุไม่มีรูปแบบพหูพจน์ <object type name> จะเป็นฉลากรูปแบบเอกพจน์ของชื่อประเภทวัตถุที่เชื่อมต่อกับ “S ”)

ด้านล่างนี้คือรายการประเภทออบเจ็กต์ HubSpot ที่มีอยู่ทั้งหมดคำอธิบายสั้นๆเกี่ยวกับข้อมูลที่พวกเขาแสดงและตารางที่เกี่ยวข้อง

object_with_object_properties

ตารางนี้มีข้อมูลจากระเบียน HubSpot ของคุณ คุณสามารถรับหนึ่งแถวสำหรับแต่ละระเบียนภายในประเภทอ็อบเจกต์ (เช่นระเบียนผู้ติดต่อทั้งหมดในประเภทอ็อบเจ็กต์ผู้ติดต่อ) 

object_properties_history

ตารางนี้มีค่าคุณสมบัติในอดีต สำหรับผู้ติดต่อจะมี 45 ค่าล่าสุด สำหรับออบเจ็กต์อื่นๆทั้งหมดจะมี 20 ค่าล่าสุด ตารางมีแถวสำหรับแต่ละมูลค่าทรัพย์สินในอดีต มูลค่าปัจจุบันของทรัพย์สินจะถูกกำหนดโดยการประทับเวลา UPDATEDAT ล่าสุดในประวัติของทรัพย์สิน

ข้อซักถามของสมาคม

เช่นเดียวกับข้อมูลออบเจ็กต์ข้อมูลการเชื่อมโยงจะถูกจัดระเบียบในสองวิธี:

• บุคคล: แต่ละประเภทการเชื่อมโยงจะถูกจัดเก็บไว้ในตารางของตัวเองและมีเพียงระเบียนประเภทนั้นเท่านั้น ตัวอย่างเช่น associations_contacts_to_deals มีเฉพาะระเบียนการเชื่อมโยงระหว่างการติดต่อและการจัดการวัตถุ T
• รวมกัน: ระเบียนทั้งหมดสำหรับประเภทการเชื่อมโยงทั้งหมดจะรวมกันเป็นตารางเดียว

associations_x_to_y 

แต่ละประเภทการเชื่อมโยงมีมุมมองของตัวเองที่ติดฉลากเป็น associations_<association type name> ตัวอย่าง associations_contacts_to_dealsเช่น 

association_definitions

ตารางนี้มีข้อมูลเกี่ยวกับประเภทการเชื่อมโยงที่มีอยู่ทั้งหมดระหว่างออบเจ็กต์ HubSpot โดยมีหนึ่งแถวต่อประเภทการเชื่อมโยง

property_definitions

ตารางนี้มีข้อมูลเกี่ยวกับคุณสมบัติวัตถุและคุณสมบัติกิจกรรมในบัญชี HubSpot ของคุณ คุณสมบัติของกิจกรรมรวมถึงกิจกรรมมาตรฐานเช่นการเปิดและคลิกอีเมลและคุณสมบัติของกิจกรรมพฤติกรรมที่กำหนดเอง ข้อมูลนี้จะเป็นประโยชน์สำหรับการกำหนดค่าที่พบในข้อมูล object_properties และเหตุการณ์

กิจกรรม

กิจกรรมรวมถึงกิจกรรม HubSpot มาตรฐานและกิจกรรมพฤติกรรมที่กำหนดเอง แต่ละกิจกรรมมีตารางของตัวเองซึ่งมีป้ายกำกับ events_eventnameว่า

object_and_event_type_definitions

ตารางนี้มีคำจำกัดความสำหรับออบเจ็กต์และกิจกรรมทั้งหมดที่มีอยู่ในบัญชี HubSpot ของคุณ

ความถี่ในการซิงค์และการจัดระเบียบข้อมูล

งานซิงค์ข้อมูลระหว่าง HubSpot และ Google BigQuery เริ่มทุกวันเวลาประมาณ 6:00 น. UTC เวลาที่ข้อมูลจะซิงค์กับ Google BigQuery ขึ้นอยู่กับตำแหน่งคิวและปริมาณข้อมูลของบัญชีของคุณ ไม่รับประกันเวลาที่เสร็จสมบูรณ์

โฟลเดอร์จะถูกสร้างขึ้นสำหรับแต่ละวันที่ซิงค์ข้อมูลกับโฟลเดอร์ย่อยหลายรายการสำหรับแต่ละตาราง การซิงค์เจ็ดครั้งสุดท้ายจะพร้อมใช้งานในแพลตฟอร์ม Google Cloud และตารางใน BigQuery จะได้รับการอัปเดตเพื่อชี้ไปที่การถ่ายโอนข้อมูลถังล่าสุด

แต่ละตารางต่อไปนี้จะมีเป็นไฟล์รูปแบบปาร์เก้:

ASSOCIATIONS
ASSOCIATION_DEFINITIONS
EVENTS_[Event name]
LISTS
LIST_MEMBERSHIPS
OBJECTS
OBJECT_AND_EVENT_TYPE_DEFINITIONS
OBJECT_PROPERTIES
OBJECT_PROPERTIES_HISTORY
OBJECT_WITH_OBJECT_PROPERTIES
OWNERS
OWNER_TEAM
PIPELINES
PIPELINE_STAGES
PROPERTY_DEFINITIONS
TEAMS