SteveSignalsDocs
EN日本語

イベントリファレンス

広告イベント

Google、Meta、LinkedIn 広告の Webhook イベント。すべてのキーとその型、各ネットワークの実例を紹介します。

広告イベントは、トラッキング中の競合が Google、Meta（Facebook、Instagram、Messenger）、LinkedIn で新しい広告を開始したときに発生し、その広告が停止、再開、または本文の変更をしたときにも発生します。1 つの広告につき、変更のたびに 1 つのイベントです。

eventType
ads
subEventType
google_ad · meta_ad · linkedin_ad
signalType
新しい広告は ads.new（action: "new"）、停止、再開、本文の変更は ads.updated（action: "updated"）です。ads.removed はスキーマにありますが、送信されることはありません。
プラットフォームフィールド
adsResponse（metadata と同じ値）
トラッカー
広告
relevance
常に { "status": "unjudged" }: 広告は公開されたまま配信されます

このページの読み方

広告のボディはすべて、共通フィールド（eventId、competitor、detectedAt など）と、プラットフォームオブジェクト 1 つで構成されます。このオブジェクトは adsResponse と metadata の 2 か所に、同じ値で送信されます。どちらか一方を使い、もう一方は無視してください。

すべての広告に共通するフィールド

これらのキーは、3 つのネットワークすべての adsResponse に含まれます。platform でどのネットワークか分かります。

adsResponse · 全ネットワーク
platform
'google'|'meta'|'linkedin'
広告ネットワーク。subEventType に対応します（google → google_ad）。
adId
string
ネットワーク独自の広告 ID。Google: クリエイティブ ID（CR…）。Meta: 広告ライブラリ ID。LinkedIn: 広告ライブラリ ID。
title
string|null
広告の見出し。ネットワークが見出しを表示しない場合は null です（ほとんどの Google 広告）。
text
string|null
広告の本文コピー。ネットワークが提供しない場合は null です。
url
string|null
広告への公開リンク。
author
object|null
広告の配信元: { name: string, handle: string | null, url: string | null }。
media
object[]
画像と動画: { type: 'image' | 'video' | 'document', url: string }。空配列の場合もあります。
metrics
object|null
ネットワークが提供する数値で、{ [name]: number } の形です。広告では通常 null です。
format
string|null
ネットワークが付けた広告フォーマット名。例: text、video、single_image。
isActive
boolean|null
広告が配信中は true、停止後は false、不明な場合は null です。
startedAt
string|null
広告の開始日時（ISO 8601、2025-07-30T14:52:54.000Z）。
endedAt
string|null
広告が停止した日時。配信中は null です。
previewUrl
string|null
ネットワークの透明性ツールで広告を開くリンク。

Google 広告

subEventType: "google_ad"。Google では 1 つのキーが加わります。

adsResponse · Google のみ
daysShown
number|null
Signals が広告を確認した時点で、Google がその広告を表示していた日数。広告が配信されている間は増えるため、「少なくともこの日数」として読んでください。

ほとんどの Google 広告にはテキストがありません

Google の広告透明性センターでは、見出しや本文が提供されず、広告の画像だけのことがよくあります。title: null と text: null を想定し、広告の表示には media[0].url または previewUrl を使ってください。

イベント · google_ad（HubSpot）Signals の実行で得た実際のイベント
json
1{
2  "version": 1,
3  "eventId": "617692b7-2c85-499c-bc3b-6810f3673190",
4  "eventType": "ads",
5  "subEventType": "google_ad",
6  "action": "new",
7  "signalType": "ads.new",
8  "source": "ads",
9  "orgId": "org_3KikADUjsyXrUJ4RJhWpwcp98Yf",
10  "trackerId": "3c8918c2-7011-4518-9185-31344c83861f",
11  "projectId": "2738158a-08fd-4fc4-912d-43d4c328bc10",
12  "runId": "b0b5b63b-fc3d-4eef-84ab-879e2335c06d",
13  "competitor": {
14    "name": "HubSpot",
15    "domain": "hubspot.com",
16    "subjectKey": "google:AR10072600183532683265@-|meta:https://www.facebook.com/hubspot|linkedin:hubspot"
17  },
18  "occurredAt": "2025-07-30T14:52:54.000Z",
19  "detectedAt": "2026-10-27T20:28:40.624Z",
20  "sequence": 254,
21  "itemKey": "ads-google-CR00389017023612452865",
22  "relevance": {
23    "status": "unjudged"
24  },
25  "adsResponse": {
26    "platform": "google",
27    "title": null,
28    "text": null,
29    "url": null,
30    "author": {
31      "name": "Hubspot, Inc.",
32      "handle": null,
33      "url": null,
34      "imageUrl": null
35    },
36    "media": [
37      {
38        "type": "image",
39        "url": "https://tpc.googlesyndication.com/archive/simgad/13161062113949559550"
40      }
41    ],
42    "metrics": null,
43    "adId": "CR00389017023612452865",
44    "format": "text",
45    "isActive": true,
46    "startedAt": "2025-07-30T14:52:54.000Z",
47    "endedAt": null,
48    "previewUrl": "https://adstransparency.google.com/advertiser/AR10072600183532683265/creative/CR00389017023612452865?region=anywhere",
49    "daysShown": 455
50  },
51  "metadata": {
52    "platform": "google",
53    "title": null,
54    "text": null,
55    "url": null,
56    "author": {
57      "name": "Hubspot, Inc.",
58      "handle": null,
59      "url": null,
60      "imageUrl": null
61    },
62    "media": [
63      {
64        "type": "image",
65        "url": "https://tpc.googlesyndication.com/archive/simgad/13161062113949559550"
66      }
67    ],
68    "metrics": null,
69    "adId": "CR00389017023612452865",
70    "format": "text",
71    "isActive": true,
72    "startedAt": "2025-07-30T14:52:54.000Z",
73    "endedAt": null,
74    "previewUrl": "https://adstransparency.google.com/advertiser/AR10072600183532683265/creative/CR00389017023612452865?region=anywhere",
75    "daysShown": 455
76  }
77}
Signals のフィードに表示された新しい Google 広告
アプリ上の同じ Google 広告です。ステータス、配信期間、フォーマット、開始日は上記のフィールドから取得されます（画面は英語版）。

Meta 広告

subEventType: "meta_ad"。Meta の広告 1 件は、Facebook、Instagram、Messenger にまたがります。Meta には、共通リスト以外の追加キーはありません。

イベント · meta_ad（HubSpot）Signals の実行で得た実際のイベント
json
1{
2  "version": 1,
3  "eventId": "8d8d8e1f-149d-4cbd-aee3-3e88b0d7d301",
4  "eventType": "ads",
5  "subEventType": "meta_ad",
6  "action": "new",
7  "signalType": "ads.new",
8  "source": "ads",
9  "orgId": "org_3KikADUjsyXrUJ4RJhWpwcp98Yf",
10  "trackerId": "3c8918c2-7011-4518-9185-31344c83861f",
11  "projectId": "2738158a-08fd-4fc4-912d-43d4c328bc10",
12  "runId": "b0b5b63b-fc3d-4eef-84ab-879e2335c06d",
13  "competitor": {
14    "name": "HubSpot",
15    "domain": "hubspot.com",
16    "subjectKey": "google:AR10072600183532683265@-|meta:https://www.facebook.com/hubspot|linkedin:hubspot"
17  },
18  "occurredAt": "2026-10-27T07:00:00.000Z",
19  "detectedAt": "2026-10-27T20:28:40.624Z",
20  "sequence": 294,
21  "itemKey": "ads-meta-1629444768536489",
22  "relevance": {
23    "status": "unjudged"
24  },
25  "adsResponse": {
26    "platform": "meta",
27    "title": "Top bei der KI-Suche",
28    "text": "Top bei der KI-Suche",
29    "url": "https://www.hubspot.de/products/aeo?utm_source=facebook&utm_medium=paid_brandstrategy&utm_campaign=BrandStrategy_VideoViews_DE_EMEA_DACH_GBC_AnnoyinglyGood-Q4-2026_FB_Downmarket-Founder_AEO-15",
30    "author": {
31      "name": "HubSpot",
32      "handle": null,
33      "url": null,
34      "imageUrl": null
35    },
36    "media": [
37      {
38        "type": "video",
39        "url": "https://video.fbaq13-1.fna.fbcdn.net/o1/v/t2/f2/m366/AQP1LJAF5-nhG0Rw4NgyVCXkevByhn2-Y8taPwow9GIv4XbWHuu8ZmCS8_XZLtW2A-prpHTzQLmPBe0cgeBKS19w1zDNpv5ybTNbcjdtvNJ76w.mp4?_nc_cat=111&_nc_oc=AdpXGVNNLxQUcFFtGGzDKhLmEoED9-eYZlBjz2rzLlx-JmFhJKw6aEnNX9OhBfZv2Hw&_nc_sid=b66105&_nc_ht=video.fbaq13-1.fna.fbcdn.net&_nc_ohc=ST2GJvVZG6AQ7kNvwHS0NUW&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5WSV9VU0VDQVNFX1BST0RVQ1RfVFlQRS4uQzMuNzIwLmRhc2hfaDI2NC1iYXNpYy1nZW4yXzcyMHAiLCJ4cHZfYXNzZXRfaWQiOjE0ODU0NzQ5NTAwODE3NDMsImFzc2V0X2FnZV9kYXlzIjoyMSwidmlfdXNlY2FzZV9pZCI6MTAxMzksImR1cmF0aW9uX3MiOjE1LCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&vs=3def2f9c4e6a0c28&_nc_vs=HBksFQIYRWZiX2VwaGVtZXJhbC84OTgyN0JFMzgyQkM0Q0NFQjE5QUFGNDhFNTZFMjQyNV9tdF8xX3ZpZGVvX2Rhc2hpbml0Lm1wNBUAAsgBEgAVAhhAZmJfcGVybWFuZW50LzQxNEI2MUFFMjJCMDQzRTE5QkRGQ0VCQjQwOTQ1Qzk0X2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACaes8frgsKjBRUCKAJDMywXQC4AAAAAAAAYGWRhc2hfaDI2NC1iYXNpYy1nZW4yXzcyMHARAHUAZbaeAQA&_nc_gid=sukKoLaJq1J9isAkMo9EDA&_nc_ss=78180&_nc_map=urlgen_bucketless&_nc_zt=28&oh=00_AQP3-WzimxnCTMWnwqONrEKnCBjF8kFq4xqPGwo4K1y9uQ&oe=6AE6C03D"
40      }
41    ],
42    "metrics": null,
43    "adId": "1629444768536489",
44    "format": "video",
45    "isActive": true,
46    "startedAt": "2026-10-27T07:00:00.000Z",
47    "endedAt": null,
48    "previewUrl": "https://www.facebook.com/ads/library/?id=1629444768536489"
49  },
50  "metadata": {
51    "platform": "meta",
52    "title": "Top bei der KI-Suche",
53    "text": "Top bei der KI-Suche",
54    "url": "https://www.hubspot.de/products/aeo?utm_source=facebook&utm_medium=paid_brandstrategy&utm_campaign=BrandStrategy_VideoViews_DE_EMEA_DACH_GBC_AnnoyinglyGood-Q4-2026_FB_Downmarket-Founder_AEO-15",
55    "author": {
56      "name": "HubSpot",
57      "handle": null,
58      "url": null,
59      "imageUrl": null
60    },
61    "media": [
62      {
63        "type": "video",
64        "url": "https://video.fbaq13-1.fna.fbcdn.net/o1/v/t2/f2/m366/AQP1LJAF5-nhG0Rw4NgyVCXkevByhn2-Y8taPwow9GIv4XbWHuu8ZmCS8_XZLtW2A-prpHTzQLmPBe0cgeBKS19w1zDNpv5ybTNbcjdtvNJ76w.mp4?_nc_cat=111&_nc_oc=AdpXGVNNLxQUcFFtGGzDKhLmEoED9-eYZlBjz2rzLlx-JmFhJKw6aEnNX9OhBfZv2Hw&_nc_sid=b66105&_nc_ht=video.fbaq13-1.fna.fbcdn.net&_nc_ohc=ST2GJvVZG6AQ7kNvwHS0NUW&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5WSV9VU0VDQVNFX1BST0RVQ1RfVFlQRS4uQzMuNzIwLmRhc2hfaDI2NC1iYXNpYy1nZW4yXzcyMHAiLCJ4cHZfYXNzZXRfaWQiOjE0ODU0NzQ5NTAwODE3NDMsImFzc2V0X2FnZV9kYXlzIjoyMSwidmlfdXNlY2FzZV9pZCI6MTAxMzksImR1cmF0aW9uX3MiOjE1LCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&vs=3def2f9c4e6a0c28&_nc_vs=HBksFQIYRWZiX2VwaGVtZXJhbC84OTgyN0JFMzgyQkM0Q0NFQjE5QUFGNDhFNTZFMjQyNV9tdF8xX3ZpZGVvX2Rhc2hpbml0Lm1wNBUAAsgBEgAVAhhAZmJfcGVybWFuZW50LzQxNEI2MUFFMjJCMDQzRTE5QkRGQ0VCQjQwOTQ1Qzk0X2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACaes8frgsKjBRUCKAJDMywXQC4AAAAAAAAYGWRhc2hfaDI2NC1iYXNpYy1nZW4yXzcyMHARAHUAZbaeAQA&_nc_gid=sukKoLaJq1J9isAkMo9EDA&_nc_ss=78180&_nc_map=urlgen_bucketless&_nc_zt=28&oh=00_AQP3-WzimxnCTMWnwqONrEKnCBjF8kFq4xqPGwo4K1y9uQ&oe=6AE6C03D"
65      }
66    ],
67    "metrics": null,
68    "adId": "1629444768536489",
69    "format": "video",
70    "isActive": true,
71    "startedAt": "2026-10-27T07:00:00.000Z",
72    "endedAt": null,
73    "previewUrl": "https://www.facebook.com/ads/library/?id=1629444768536489"
74  }
75}
Signals のフィードに表示された新しい Meta 広告
実際の Meta 動画広告です。タイトルとテキストは広告自体のコピーです。

LinkedIn 広告

subEventType: "linkedin_ad"。LinkedIn では 5 つのキーが加わります。

adsResponse · LinkedIn のみ
cta
string|null
ボタンのテキスト。例: Learn more。
landingUrl
string|null
広告の遷移先。トラッキングパラメーター付きです。
paidBy
string|null
広告費用を支払った法人名。
postedBy
object|null
ソートリーダー広告の場合に、投稿者として表示される人物: { name: string, title: string | null, imageUrl: string | null, profileUrl: string | null }。企業広告では null です。
logoUrl
string|null
広告主のロゴ。
イベント · linkedin_ad（HubSpot）Signals の実行で得た実際のイベント
json
1{
2  "version": 1,
3  "eventId": "156a24cb-28b1-4923-a5ec-75a5939634fb",
4  "eventType": "ads",
5  "subEventType": "linkedin_ad",
6  "action": "new",
7  "signalType": "ads.new",
8  "source": "ads",
9  "orgId": "org_3KikADUjsyXrUJ4RJhWpwcp98Yf",
10  "trackerId": "3c8918c2-7011-4518-9185-31344c83861f",
11  "projectId": "2738158a-08fd-4fc4-912d-43d4c328bc10",
12  "runId": "b0b5b63b-fc3d-4eef-84ab-879e2335c06d",
13  "competitor": {
14    "name": "HubSpot",
15    "domain": "hubspot.com",
16    "subjectKey": "google:AR10072600183532683265@-|meta:https://www.facebook.com/hubspot|linkedin:hubspot"
17  },
18  "occurredAt": "2026-10-22T00:00:00.000Z",
19  "detectedAt": "2026-10-27T20:28:40.624Z",
20  "sequence": 574,
21  "itemKey": "ads-linkedin-1605968824",
22  "relevance": {
23    "status": "unjudged"
24  },
25  "adsResponse": {
26    "platform": "linkedin",
27    "title": "Ein CRM – clever und selbst aktualisierend.",
28    "text": "Dein CRM ist nur so gut wie seine Daten. Das HubSpot Smart CRM aktualisiert sich selbst; d. h. für dein Team: weniger Admin-Aufwand – für vollen Fokus auf das Closing.",
29    "url": "https://www.linkedin.com/ad-library/detail/1605968824",
30    "author": {
31      "name": "HubSpot",
32      "handle": null,
33      "url": null,
34      "imageUrl": null
35    },
36    "media": [
37      {
38        "type": "video",
39        "url": "https://dms.licdn.com/playlist/vid/v2/D4E10AQF4aZ8Jii5OlQ/progressive-servable-video/B4EaFfZt56HoAc-/0/1792601942543?e=2147483647&v=beta&t=hAVp3eJnt7dNuLBvGRM701Y9_Fgq1zV789apgWdkwqQ"
40      }
41    ],
42    "metrics": null,
43    "adId": "1605968824",
44    "format": "video",
45    "isActive": true,
46    "startedAt": "2026-10-22T00:00:00.000Z",
47    "endedAt": null,
48    "previewUrl": null,
49    "cta": "Mehr erfahren",
50    "landingUrl": "https://www.hubspot.de/products/crm/ai-crm-lp?wfuid=311b3a3a0a.1790602582&wfsid=1790695501-99a0-9a79-371940b034b9?utm_source=linkedin&utm_medium=paid_brandstrategy&utm_campaign=BrandStrategy_VideoViews_DE_EMEA_DACH_GBC_AnnoyinglyGood-Q4-2026_InFeed-LAN_Downmarket-Founder_AI-CRM-30&trk=ad_library_ad_preview_headline_content",
51    "paidBy": "HubSpot, Inc.",
52    "postedBy": null,
53    "logoUrl": "https://media.licdn.com/dms/image/v2/C4D0BAQF8H-SLmMDZlA/company-logo_100_100/company-logo_100_100/0/1646683330132/hubspot_logo?e=1794441600&v=beta&t=ELYp0k9E4bEV_1FSDO-u7QRhufw2uo1tOCRnlNYT9lg"
54  },
55  "metadata": {
56    "platform": "linkedin",
57    "title": "Ein CRM – clever und selbst aktualisierend.",
58    "text": "Dein CRM ist nur so gut wie seine Daten. Das HubSpot Smart CRM aktualisiert sich selbst; d. h. für dein Team: weniger Admin-Aufwand – für vollen Fokus auf das Closing.",
59    "url": "https://www.linkedin.com/ad-library/detail/1605968824",
60    "author": {
61      "name": "HubSpot",
62      "handle": null,
63      "url": null,
64      "imageUrl": null
65    },
66    "media": [
67      {
68        "type": "video",
69        "url": "https://dms.licdn.com/playlist/vid/v2/D4E10AQF4aZ8Jii5OlQ/progressive-servable-video/B4EaFfZt56HoAc-/0/1792601942543?e=2147483647&v=beta&t=hAVp3eJnt7dNuLBvGRM701Y9_Fgq1zV789apgWdkwqQ"
70      }
71    ],
72    "metrics": null,
73    "adId": "1605968824",
74    "format": "video",
75    "isActive": true,
76    "startedAt": "2026-10-22T00:00:00.000Z",
77    "endedAt": null,
78    "previewUrl": null,
79    "cta": "Mehr erfahren",
80    "landingUrl": "https://www.hubspot.de/products/crm/ai-crm-lp?wfuid=311b3a3a0a.1790602582&wfsid=1790695501-99a0-9a79-371940b034b9?utm_source=linkedin&utm_medium=paid_brandstrategy&utm_campaign=BrandStrategy_VideoViews_DE_EMEA_DACH_GBC_AnnoyinglyGood-Q4-2026_InFeed-LAN_Downmarket-Founder_AI-CRM-30&trk=ad_library_ad_preview_headline_content",
81    "paidBy": "HubSpot, Inc.",
82    "postedBy": null,
83    "logoUrl": "https://media.licdn.com/dms/image/v2/C4D0BAQF8H-SLmMDZlA/company-logo_100_100/company-logo_100_100/0/1646683330132/hubspot_logo?e=1794441600&v=beta&t=ELYp0k9E4bEV_1FSDO-u7QRhufw2uo1tOCRnlNYT9lg"
84  }
85}
Signals のフィードに表示された新しい LinkedIn 広告
実際の LinkedIn 広告です。ボタン、ランディングページ、支払者は、cta、landingUrl、paidBy から取得されます。

削除された広告

スキーマでは action: "removed"（signalType: "ads.removed"）が許可されています。現在、Signals は広告についてこれを送信しません。もし届いた場合、adsResponse と metadata は null で、occurredAt も null です。イベントの形 → 削除イベントをご覧ください。

前へ
イベントタイプ一覧
次へ
レビュー