ZEROHAND / HUBSPOT IMPORT PREFLIGHT

HubSpotへ入れる前に、
CSVを一度止めて確認する。

HubSpotのimportは強力ですが、unique identifierの不足や重複、Association用IDの不整合があると、重複レコードや関連付け失敗につながります。まずCSV側で事故の種を切り分けます。

BEFORE IMPORT

最初に確認する5項目

1. Unique identifier

既存レコード更新なら Record ID、contactならEmail、companyならCompany domain nameなど、HubSpotが識別に使う列を確認。

2. Duplicate values

識別列の重複を確認。同じIDを意図せず複数行に持たせていないかを見る。

3. Column structure

列数ズレ、ヘッダー重複、引用符崩れを確認。mapping以前の構造事故を先に除く。

4. Association IDs

contact-companyなど複数objectを関連付ける場合、両側の識別子が揃っているか確認。

5. Create / Update intent

新規作成なのか既存更新なのかを混ぜない。空欄やID不足が何を起こすかをimport前に決める。

WHAT ZEROHAND CHECKS

無料CSV Quick Checkは区切り文字、列数ズレ、ヘッダー重複、引用符崩れ、空行をブラウザ内で確認します。

CSV Preflightは指定列の必須値・重複まで確認できます。HubSpot API接続やCRM側のproperty存在確認は行いません。

どちらもCSVをZEROHANDのサーバーへ送らず、ブラウザ内で処理します。

OFFICIAL RULES

HubSpot公式では、既存レコードの更新や重複回避にunique identifierを使うこと、Associationでは各objectの識別子を含めることが案内されています。