建立並填入 HubDB 表
上次更新時間: 十一月 20, 2024
可与下列任何一种订阅一起使用,除非有说明:
行銷 Hub Enterprise |
Content Hub Professional , Enterprise |
HubDB是一個關聯式資料庫,可讓您建立具有靈活架構的表來儲存可在網站頁面上使用的數據,或透過 HubDB API 進行外部查詢。
- 若要使用 HubDB 資料建立動態頁面,您需要Content Hub Professional或Enterprise 。
- 僅擁有Marketing Hub企業的帳戶 訂閱只能使用 HubDB 發送行銷電子郵件。
建立一個表
- 在你的 HubSpot 帳戶中,瀏覽「內容」>「HubDB」。
- 點選右上角的「建立表」 。
- 在對話方塊中,輸入表格標籤和表格名稱。創建表後就無法更改表的名稱。
- 單擊創建。
新增和編輯表數據
直接在您的 HubSpot 帳戶中編輯 HubDB 表或上傳 CSV 以自動將現有資料與表格行合併。
新增自訂表格列
- 在 HubDB 儀表板上,按一下其中一個表格的標籤。
- 在右上角,按一下「動作」 ,然後選擇「新增列」 。
- 在對話方塊中,配置您的列:
- 輸入列標籤。
- 輸入列名稱。您可以使用此名稱透過 HubDB API 查詢您的資料。
- 輸入列描述。當使用者將滑鼠懸停在列名稱旁邊的info圖示上時,將顯示此說明。
- 輸入列類型。
- 點選新增列。
- 若要修改或刪除列,請將滑鼠懸停在該列上並按一下箭頭圖標,然後選擇編輯或刪除。
新增表格行
- 在 HubDB 儀表板上,按一下現有表的標籤。
- 在右上角,按一下「動作」 ,然後選擇「新增行」 。
- 將在任何現有行下方自動建立一個新行。為您為表格配置的每一列輸入一個值。
- 若要複製或刪除行,請將滑鼠懸停在該行的 ID 上並點擊downCarat箭頭圖標,然後選擇克隆或刪除。
透過 CSV 匯入表數據
如果您現有的電子表格包含與 HubDB 表架構相符的數據,則可以將其匯入 HubSpot 以自動將其數據與您的表合併。
請注意:
- 若要將圖像匯入 HubDB 表,請將圖像的 URL 新增至 CSV 檔案。要設定圖像的尺寸,請將寬度和高度添加到 URL 末尾,並以逗號偏移。例如:http: //www.hubspot.com/sample-image.jpg,100,300。
- 匯入的日期必須使用 MM/DD/YYYY 格式。例如,2022 年 11 月 6 日將是 11/06/2022。
- 在 HubDB 儀表板上,按一下其中一個表格的標籤。
- 在右上角,按一下「動作」 ,然後選擇「匯入」 。
- 按一下新增或取代磁貼:
- 新增:電子表格中的行將會新增到現有資料中。
- 替換:電子表格中的行將覆蓋並替換表中的任何現有資料。如果電子表格中包含行 ID,則行將被更新而不是被取代。
- 按一下“下一步” 。
- 點選選擇檔案。
- 瀏覽電腦的硬碟以尋找要上傳的 CSV,然後按一下「開啟」 。
- 預設情況下,HubSpot 將偵測 CSV 中資料的編碼。手動指定資料編碼:
- 按一下進階選項。
- 按一下自訂資料編碼下拉式選單,然後選擇一種編碼。
- 按一下“下一步” 。
- 指定您希望如何將 CSV 中的每個欄位對應到對應的 HubDB 表格列:
- 按一下HubDB 表列下拉式選單,然後選擇一個列。
- 如果您尚未為 CSV 欄位配置關聯列,請按一下新增列。在對話方塊中,輸入標籤、名稱,然後選擇類型。完成後,按一下「新增列」 。
- 按一下“導入” 。
- 導入完成後,按一下“完成” 。
管理表格設定(僅限 Content Hub Professional 和 Enterprise)
如果您擁有Content Hub Professional或Enterprise帳戶,則可以管理每個 HubDB 表的設置,例如該表是否可透過 API 公開存取以及資料是否可用於建立動態頁面。
- 在你的 HubSpot 帳戶中,瀏覽「內容」>「HubDB」。
- 按一下表格的名稱。
- 在右上角,點擊操作>管理設定。
- 在右側邊欄中,配置表的設定:
- 允許公共 API 存取:預設情況下,表的資料只能在 HubSpot 中、透過HubL或透過經過驗證的API 呼叫來存取。啟用此設定可啟用未經身份驗證的API 呼叫來查詢表的資料。要查詢數據,您需要在
portalId
查詢參數中包含 HubSpot 帳戶 ID。 - 啟用使用行資料建立動態頁面:開啟此設定以啟用使用HubDB 資料建立動態頁面。然後您可以配置以下附加選項:
- 使用下拉式選單選擇哪些欄位將使用元描述、特色圖片和規範 URL 資料填入動態頁面。對於新表,您需要建立新列來包含此資料。
- 元描述:必須是文字類型列。
- 特色圖片:必須是圖片類型欄位。
- 規格 URL:必須是 URL 類型欄位。
- 允許使用子表:開啟此設定以允許引用此表中的其他 HubDB 表。您也可以選擇自動為子表建立清單頁面設置,以使 HubSpot 自動建立中間清單頁面。 了解有關使用 HubDB 建立多層動態頁面的更多資訊。
請注意:父表不能引用也引用父表的子表。這將建立一個循環,在嘗試選擇父表中的子表時會導致錯誤。
- 使用下拉式選單選擇哪些欄位將使用元描述、特色圖片和規範 URL 資料填入動態頁面。對於新表,您需要建立新列來包含此資料。
- 允許公共 API 存取:預設情況下,表的資料只能在 HubSpot 中、透過HubL或透過經過驗證的API 呼叫來存取。啟用此設定可啟用未經身份驗證的API 呼叫來查詢表的資料。要查詢數據,您需要在
- 按一下「儲存」 。
發布表格
當您完成以資料填充 HubDB 表後,您可以將其發布以在您的網站頁面上使用,並使其可透過 HubSpot API 進行查詢。
- 點選右上角的「發布」 。
- 在對話方塊中,確認您已準備好公開表,然後按一下「發布」 。
匯出表數據
- 在 HubDB 儀表板上,按一下其中一個表格的標籤。
- 在右上角,點擊“操作”下拉式選單並選擇“匯出” ,然後選擇一種文件格式。 HubDB 資料將立即開始下載。
請注意:從 HubDB 表匯出的圖像將被格式化為圖像 URL。如果圖像的尺寸已自訂,它們將顯示在 URL 的末尾。
查看表格依賴項
建立表格後,您可以從 HubDB 儀表板查看內容中使用 HubDB 表的位置。此外,刪除 HubDB 表時,如果該表目前正被任何資產使用,HubSpot 會向您發出警告。
若要查看使用 HubDB 表的資產,請在 HubDB 儀表板上按一下表格旁的操作下拉式選單,然後選擇顯示依賴項。
在HubSpot 的開發人員文件中了解有關 HubDB 的更多資訊。