エラー
[ERROR]: Response body: {"status":"error","message":"Duplicate IDs found in batch input: [***]. IDs must be unique","correlationId":"***","context":{"ids":["***"]},"category":"VALIDATION_ERROR"}
原因
1度のデータ転送バッチ内に、データの挿入先が「同じコンタクト」と判定されるレコードが複数含まれている場合に発生します。
主に以下のケースが考えられます。
- 転送元のデータ内に、同じIDまたは同じメールアドレスを持つレコードが複数行存在している
- 転送元のデータ内に、同じコンタクトに紐づけられているメールアドレスを持つレコードが複数行存在している
※HubSpotでは、1つのコンタクトに複数のメールアドレス(プライマリーEメールと追加のEメール)を登録できます。異なるメールアドレスであっても同一コンタクトに紐づいている場合、HubSpot内部で同じIDに紐づくため、IDの重複エラーが発生します。
対処法
方法1:同じID/メールアドレスが複数行ある場合
転送元のデータ内で、1つのID/メールアドレスが1レコードのみ存在するようにデータを修正してください。
方法2:異なるメールアドレスが同じコンタクトに紐づいている場合
転送元のデータ内で、同じコンタクトに紐づくメールアドレスが重複しないようにデータを修正してください。
転送元データ内で各メールアドレスに紐づくコンタクトの特定が困難な場合は、HubSpotのcontactのデータをDWHへ転送し、データの名寄せすることをご検討ください。
データの名寄せのイメージをご紹介します。
- 以下のデータをHubSpotに転送するとします。
| email |
company |
updated_at |
| test.user@example.com |
hogehoge, Inc. |
2022-02-01 |
| test_001@example.com |
fugafuga, Inc. |
2023-03-01 |
| test_002@example.com |
piyopiyo, Inc. |
2024-04-01 |
- HubSpotのcontactのデータをDWHに転送します。
転送したデータのうち、email カラムにはプライマリーEメールが、hs_additional_emails には追加のEメールが存在します。追加のEメールに複数登録されている場合は、; 区切りで1つの値として含まれています。
| id |
email |
hs_additional_emails |
| 120351 |
test.user@example.com |
test_001@example.com;test_002@example.com |
- 転送したデータから名寄せのためのデータを作成します。
プライマリーEメールと追加のEメールを同じ email カラムに抽出し、email_type カラムで primary(プライマリーEメール)と secondary(追加のEメール)を判別できるようにします。
| id |
email |
email_type |
| 120351 |
test.user@example.com |
primary |
| 120351 |
test_001@example.com |
secondary |
| 120351 |
test_002@example.com |
secondary |
- 転送するデータに名寄せ用に作ったデータをジョインします。
| email |
company |
updated_at |
id |
email_type |
| test.user@example.com |
hogehoge, Inc. |
2022-02-01 |
120351 |
primary |
| test_001@example.com |
fugafuga, Inc. |
2023-03-01 |
120351 |
secondary |
| test_002@example.com |
piyopiyo, Inc. |
2024-04-01 |
120351 |
secondary |
- 1つのIDにつき1レコードとなるようにデータを修正します。
id ごとに email_type が primary のレコードのみ残す、updated_at が最新のレコードのみ残すなど、転送したいデータを残します。
| email |
company |
updated_at |
id |
email_type |
| test.user@example.com |
hogehoge, Inc. |
2022-02-01 |
120351 |
primary |
コメント
0件のコメント
記事コメントは受け付けていません。