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

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

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

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

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

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

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

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

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

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

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

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

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

object_x ตาราง

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

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

object_with_object_properties

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

object_properties_history

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

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

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

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

associations_x_to_y 

แต่ละประเภทสมาคมมีมุมมองของตัวเองซึ่งมีป้ายกำกับว่า ASSOCIATIONSassociations_<association type name> > เช่น ASSOCIATIONSassociations_contacts_to_dealsDEALS 

association_definitions

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

property_definitions

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

กิจกรรม

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

object_and_event_type_definitions

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

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

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

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

ASSOCIATIONS
ASSOCIATION_DEFINITIONS
EVENTS_[Event name]
LISTS
LIST_MEMBERSHIPS
OBJECTS
OBJECT_AND_EVENT_TYPE_DEFINITIONS
OBJECT_PROPERTIES
OBJECT_PROPERTIES_HISTORYPR
OBJECT_WITH_OBJECT_PROPERTIES
OWNERS
PIPELINES OWNER_TEAM

TEAMS PIPELINE_STAGES
PROPERTY_DEFINITIONS
DEFINIT