SteveSignalsDocs

イベントリファレンス

LinkedIn エンゲージメントイベント

競合の LinkedIn 投稿にリアクションまたはコメントした 1 人分のイベント。すべてのキー、会社のフィールド、例を紹介します。

エンゲージメントイベントは、トラッキング中の競合の最新の LinkedIn 投稿に、誰かがリアクションまたはコメントしたときに発生します。1 人が 1 つの投稿にエンゲージすると、1 つのイベントです。

eventType
engagement
subEventType
linkedin_engagement
signalType
engagement.new(スキーマには engagement.updated、engagement.removed もあります)
プラットフォームフィールド
engagementResponse(metadata と同じ値)
relevance
スコアリングなし:{ "status": "unjudged" }

このページの読み方

すべてのイベントには、共通フィールドと engagementResponse オブジェクトが 1 つ含まれます(metadata としても送信されます)。アイテムのフィールドと platform、その後に下のキーが続きます。アイテムの author は、エンゲージした人です。競合ではありません。

engagementResponse

engagementResponse · linkedin
platform
'linkedin'
常に linkedin。
personHandle
string
LinkedIn での人物の ID。イベントをまたいで変わらないため、人物の重複排除に使えます。
name
string
人物の名前。
headline
string|null
LinkedIn の見出し。LinkedIn が返さない場合は null。
profileUrl
string
LinkedIn プロフィールのリンク。
imageUrl
string|null
その人の写真。LinkedIn が返さない場合は null。写真リンクは数週間で期限切れになります。
companyName
string|null
その人が勤める会社。見つからない場合は null。
companyDomain
string|null
その会社の Web サイトのドメイン(例:hubspot.com)。見つからない場合は null。
companyLinkedinUrl
string|null
その会社の LinkedIn ページ。見つからない場合は null。
how
'reacted'|'commented'
エンゲージの仕方。
reaction
string|null
how が reacted のときのリアクションの種類(LIKE、PRAISE、ENTERTAINMENT など)。それ以外は null。
commentText
string|null
how が commented のときのコメント。それ以外は null。
postUrn
string
競合の投稿の LinkedIn ID。
postUrl
string
競合の投稿へのリンク。
postTitle
string|null
投稿の 1 行目。

アイテムのフィールドも人物を表します。title は名前、text は見出し、url と author.url はプロフィールのリンクです。media は空、metrics は {} です。

イベント · linkedin_engagement正確な形のサンプル(実データはまだありません)
json
1{
2 "version": 1,
3 "eventId": "1742a36b-08e8-477d-8f35-10b3d6207930",
4 "eventType": "engagement",
5 "subEventType": "linkedin_engagement",
6 "action": "new",
7 "signalType": "engagement.new",
8 "source": "linkedin_engagement",
9 "orgId": "org_3KikADUjsyXrUJ4RJhWpwcp98Yf",
10 "trackerId": "271e9142-1ab6-41ad-b905-3d58e065e71d",
11 "runId": "57a0369d-23f8-4aa5-86db-6c64b3cea6e4",
12 "competitor": {
13 "name": "HubSpot",
14 "domain": "hubspot.com",
15 "subjectKey": "engagement:hubspot|posts:5"
16 },
17 "occurredAt": "2026-10-27T20:28:38.954Z",
18 "detectedAt": "2026-10-27T20:28:38.954Z",
19 "sequence": 27,
20 "itemKey": "linkedin_engagement-7520919497038557184-priya-shah",
21 "relevance": {
22 "status": "unjudged"
23 },
24 "engagementResponse": {
25 "platform": "linkedin",
26 "title": "Priya Shah",
27 "text": "B2B Marketing Strategy | Lifecycle Operations",
28 "url": "https://www.linkedin.com/in/priya-shah",
29 "author": {
30 "name": "Priya Shah",
31 "handle": "priya-shah",
32 "url": "https://www.linkedin.com/in/priya-shah",
33 "imageUrl": null
34 },
35 "media": [],
36 "metrics": {},
37 "personHandle": "priya-shah",
38 "name": "Priya Shah",
39 "headline": "B2B Marketing Strategy | Lifecycle Operations",
40 "profileUrl": "https://www.linkedin.com/in/priya-shah",
41 "imageUrl": null,
42 "companyName": "Example Inc.",
43 "companyDomain": "example.com",
44 "companyLinkedinUrl": "https://www.linkedin.com/company/example/",
45 "how": "reacted",
46 "reaction": "ENTERTAINMENT",
47 "commentText": null,
48 "postUrn": "7520919497038557184",
49 "postUrl": "https://www.linkedin.com/feed/update/urn:li:activity:7520919497038557184/",
50 "postTitle": "Which of these is “frighteningly” on brand? 👻"
51 },
52 "metadata": {
53 "platform": "linkedin",
54 "title": "Priya Shah",
55 "text": "B2B Marketing Strategy | Lifecycle Operations",
56 "url": "https://www.linkedin.com/in/priya-shah",
57 "author": {
58 "name": "Priya Shah",
59 "handle": "priya-shah",
60 "url": "https://www.linkedin.com/in/priya-shah",
61 "imageUrl": null
62 },
63 "media": [],
64 "metrics": {},
65 "personHandle": "priya-shah",
66 "name": "Priya Shah",
67 "headline": "B2B Marketing Strategy | Lifecycle Operations",
68 "profileUrl": "https://www.linkedin.com/in/priya-shah",
69 "imageUrl": null,
70 "companyName": "Example Inc.",
71 "companyDomain": "example.com",
72 "companyLinkedinUrl": "https://www.linkedin.com/company/example/",
73 "how": "reacted",
74 "reaction": "ENTERTAINMENT",
75 "commentText": null,
76 "postUrn": "7520919497038557184",
77 "postUrl": "https://www.linkedin.com/feed/update/urn:li:activity:7520919497038557184/",
78 "postTitle": "Which of these is “frighteningly” on brand? 👻"
79 }
80}

イベントの受け取り方

LinkedIn エンゲージメントの実行では、eventType: "engagement" の実行 Webhook が 1 件届き、engagement.new と engagement.updated のセクションがあります。各セクションのページを読むと、各アイテムが上のようなイベント 1 件です。