WebHookでコンタクト作成時のトラッキングの手動紐付けの可否

[hiroki_murata]

現在、WebHookを利用してコンタクトを作成し。

HubSpotのトラッキングコードを埋め込んだサイトにユーザーがアクセスした際に作成されたコンタクトのアクティビティに記録がされるようにしたいのですが、可能なのでしょうか？

ちなみに、以下のようにcurlでコンタクトを作成した際に

contextにhubspotutkを記載してもトラッキングはされませんでした

curl --request POST \
  --url https://api.hubapi.com/crm/v3/objects/contacts \
  --header 'authorization: Bearer {ApiKey}' \
  --header 'content-type: application/json' \
  --data '{
  "properties": {
    "email": "example@hubspot.com",
    "firstname": "Jane",
    "lastname": "Doe",
    "phone": "(555) 555-5555",
    "company": "HubSpot",
    "website": "hubspot.com",
    "lifecyclestage": "marketingqualifiedlead"
  }
  "context": {
    "hutk": "{hubspotutk値}"
  }
}'

調べた限りですと、フォーム送信でemailと紐付けを行わないとトラッキングされないと出てきたのですが、フォーム入力は行わないので

どうやって紐付けを行おうか困っています。

何か良い方法がありましたらご教授いただけますと幸いです。 

[skimura · Accepted solution]

@hiroki_murata 

下記の方法はいかがでしょうか。

1. アクティビティ記録用の公開アプリを作成.（公開アプリをインストール）

2. 公開アプリの設定画面で「タイムラインイベント」を定義.

必要に応じてトークンも定義（今回はアクセスしたページの記録用に[ pageTitle ]トークンを定義）

3. アクティビティを記録したいタイミングでタイムラインイベント作成APIを呼ぶ

https://developers.hubspot.jp/docs/api/crm/timeline

POST
/crm/v3/timeline/events

Create a single event

パラメータ例：
{
  "eventTemplateId": "XXXXX",
  "utk": "UTK",
  "tokens": {
    "pageTitle": "ページタイトル"
  }
}

私はEメールで検証しましたが「UTKが使用可能」とのことなので利用できそうです。

Use the utk parameter to associate an event with a contact by usertoken.

This is recommended if you don't know a user's email,

but have an identifying user token in your cookie.

※もしUTKを利用できない場合はUTKからコンタクト情報を取得して、

emailを上記APIで利用すると良いと思います。

https://legacydocs.hubspot.com/docs/methods/contacts/get_contact_by_utk

上記タイムラインイベント作成APIを呼ぶことで

コンタクトにアクティビティが作成されます。

よろしくお願いします。

@natsumimori 

お知らせいただきありがとうございます。

[hiroki_murata]

1. アクティビティ記録用の公開アプリを作成.（公開アプリをインストール）

2. 公開アプリの設定画面で「タイムラインイベント」を定義.

こちら使用できるプランに制限がありますでしょうか？？

どこにも見つからず、ご提案ありがとうございます

[skimura]

@hiroki_murata 

公開アプリの作成方法は下記に記載されていますのでご確認いただけますでしょうか。

https://developers.hubspot.jp/docs/api/creating-an-app

インストール時のトークン生成は、私の場合は自分でAPIを叩いて実行しました。

よろしくお願いします。

[hiroki_murata]

@skimura 

返信いただきありがとうございます

公開アプリを作成して、タイムラインイベントを定義しないと

アクティビティは追えない感じですか？

マーケティングEメールでHubSpotのトラッキングコードが埋め込まれた

サイトに遷移したタイミングでアクティビティが記録されて欲しくて。

それも公開アプリで対応って形になってしまうんですかね？？

[skimura]

@hiroki_murata 

起点がメール配信で

「メール文中のリンクをクリック→遷移したサイト」、ということであれば

Eメールトラッキングの範疇かもしれません。

https://www.hubspot.jp/products/sales/email-tracking

@natsumimori 

間違いがありましたらご指摘いただけますでしょうか。

よろしくお願いします。

[hiroki_murata]

私もEメールトラッキングで実現できる想定だったのですが

トラッキングされず...

[natsumimori]

@skimura 

検証までしていただきありがとうございます！！

@hiroki_murata 

ぜひご参考にされてください＾＾

[natsumimori]

@hiroki_murata さん、コミュニティーへの投稿ありがとうございます。

@yskz_aoyama @skimura > アドバイスできることや何か役立つ情報をお持ちでしたら、ぜひ共有いただけないでしょうか？👀