# 广告：字段与来源

广告：字段与来源。结合Google 广告、LinkedIn、Meta 广告库、TikTok的接口合同、示例和可复核步骤，在本地验证输入与结果；真实调用保持关闭。

规范页面: https://datanavoapi.com/docs/objects/ad/

当前为本地模拟模式；样本由程序生成，不代表平台实时数据，也不证明真实供应商的可用性。

## 对象与空值语义

广告（ad）由 11 项能力引用，涉及 4 个平台。统一字段名帮助整理数据，不意味着所有平台都返回相同的值。

保留原始标识为字符串；null、缺失、0 和空数组表示不同情况。ext 的字段属于平台扩展，不应当作所有平台通用字段。

## 完整字段路径

字段事实取自保存的公开合同。下表按对象合并平台扩展，并列出每个字段在哪些平台的合同中出现。

| 字段路径 | 类型 | 要求 | 声明平台 |

| --- | --- | --- | --- |

| id | string \| null | 按合同可缺失 | Google 广告、LinkedIn、Meta 广告库、TikTok |

| url | string \| null | 按合同可缺失 | Google 广告、LinkedIn、Meta 广告库、TikTok |

| format | string \| null | 按合同可缺失 | Google 广告、LinkedIn、Meta 广告库、TikTok |

| title | string \| null | 按合同可缺失 | Google 广告、LinkedIn、Meta 广告库、TikTok |

| text | string \| null | 按合同可缺失 | Google 广告、LinkedIn、Meta 广告库、TikTok |

| landing_url | string \| null | 按合同可缺失 | Google 广告、LinkedIn、Meta 广告库、TikTok |

| advertiser | object \| null | 按合同可缺失 | Google 广告、LinkedIn、Meta 广告库、TikTok |

| advertiser.id | string \| null | 按合同可缺失 | Google 广告、LinkedIn、Meta 广告库、TikTok |

| advertiser.name | string \| null | 按合同可缺失 | Google 广告、LinkedIn、Meta 广告库、TikTok |

| advertiser.url | string \| null | 按合同可缺失 | Google 广告、LinkedIn、Meta 广告库、TikTok |

| advertiser.avatar_url | string \| null | 按合同可缺失 | Google 广告、LinkedIn、Meta 广告库、TikTok |

| images | array \| null | 按合同可缺失 | Google 广告、LinkedIn、Meta 广告库、TikTok |

| videos | array \| null | 按合同可缺失 | Google 广告、LinkedIn、Meta 广告库、TikTok |

| first_shown_at | string \| null | 按合同可缺失 | Google 广告、LinkedIn、Meta 广告库、TikTok |

| last_shown_at | string \| null | 按合同可缺失 | Google 广告、LinkedIn、Meta 广告库、TikTok |

| approximate | array \| null | 按合同可缺失 | Google 广告、LinkedIn、Meta 广告库、TikTok |

| approximate[].field | string \| null | 按合同可缺失 | Google 广告、LinkedIn、Meta 广告库、TikTok |

| approximate[].kind | string \| null | 按合同可缺失 | Google 广告、LinkedIn、Meta 广告库、TikTok |

| ext | object | 按合同可缺失 | Google 广告、LinkedIn、Meta 广告库、TikTok |

| ext.regions | array \| null | 按合同可缺失 | Google 广告、TikTok |

| ext.impressions_min | integer \| null | 按合同可缺失 | Google 广告 |

| ext.impressions_max | integer \| null | 按合同可缺失 | Google 广告 |

| ext.variations | array \| null | 按合同可缺失 | Google 广告 |

| ext.variations[].title | string \| null | 按合同可缺失 | Google 广告 |

| ext.variations[].text | string \| null | 按合同可缺失 | Google 广告 |

| ext.variations[].destination | string \| null | 按合同可缺失 | Google 广告 |

| ext.variations[].image_url | string \| null | 按合同可缺失 | Google 广告 |

| ext.variations[].video_url | string \| null | 按合同可缺失 | Google 广告 |

| ext.format_label | string \| null | 按合同可缺失 | LinkedIn、Meta 广告库 |

| ext.cta | string \| null | 按合同可缺失 | LinkedIn、Meta 广告库 |

| ext.impressions_range | string \| null | 按合同可缺失 | LinkedIn |

| ext.targeting_language | string \| null | 按合同可缺失 | LinkedIn |

| ext.targeting_location | string \| null | 按合同可缺失 | LinkedIn |

| ext.active | boolean \| null | 按合同可缺失 | Meta 广告库 |

| ext.platforms | object \| null | 按合同可缺失 | Meta 广告库 |

| ext.platforms.facebook | boolean \| null | 按合同可缺失 | Meta 广告库 |

| ext.platforms.instagram | boolean \| null | 按合同可缺失 | Meta 广告库 |

| ext.platforms.messenger | boolean \| null | 按合同可缺失 | Meta 广告库 |

| ext.platforms.audience_network | boolean \| null | 按合同可缺失 | Meta 广告库 |

| ext.platforms.threads | boolean \| null | 按合同可缺失 | Meta 广告库 |

| ext.platforms.whatsapp | boolean \| null | 按合同可缺失 | Meta 广告库 |

| ext.cards | array \| null | 按合同可缺失 | Meta 广告库 |

| ext.cards[].title | string \| null | 按合同可缺失 | Meta 广告库 |

| ext.cards[].text | string \| null | 按合同可缺失 | Meta 广告库 |

| ext.cards[].landing_url | string \| null | 按合同可缺失 | Meta 广告库 |

| ext.cards[].image_url | string \| null | 按合同可缺失 | Meta 广告库 |

| ext.cards[].video_url | string \| null | 按合同可缺失 | Meta 广告库 |

| ext.likes | integer \| null | 按合同可缺失 | TikTok |

| ext.comments | integer \| null | 按合同可缺失 | TikTok |

| ext.shares | integer \| null | 按合同可缺失 | TikTok |

| ext.duration | number \| null | 按合同可缺失 | TikTok |

| ext.cover_url | string \| null | 按合同可缺失 | TikTok |

| ext.objective | string \| null | 按合同可缺失 | TikTok |

| ext.audience_range | string \| null | 按合同可缺失 | TikTok |

| ext.category | string \| null | 按合同可缺失 | TikTok |

| ext.industry | string \| null | 按合同可缺失 | TikTok |

## 返回该对象的接口

| 能力 | 对象 | 返回形状 | 分页 |

| --- | --- | --- | --- |

| google.ads.get | 广告 | item | 无游标 |

| google.advertisers.ads.list | 广告 | items | 显式逐页 |

| linkedin.ads.get | 广告 | item | 无游标 |

| linkedin.ads.search | 广告 | items | 显式逐页 |

| meta.ads.get | 广告 | item | 无游标 |

| meta.ads.search | 广告 | items | 显式逐页 |

| meta.advertisers.ads.list | 广告 | items | 显式逐页 |

| tiktok.ads.search | 广告 | items | 显式逐页 |

| tiktok.ads.get | 广告 | item | 无游标 |

| tiktok.creative_center.ads.get | 广告 | item | 无游标 |

| tiktok.creative_center.ads.search | 广告 | items | 显式逐页 |

- [Google 广告详情](https://datanavoapi.com/apis/google/ads/get/)
- [Google 广告主的广告](https://datanavoapi.com/apis/google/advertisers/ads/list/)
- [LinkedIn 广告详情](https://datanavoapi.com/apis/linkedin/ads/get/)
- [LinkedIn 广告库搜索](https://datanavoapi.com/apis/linkedin/ads/search/)
- [Meta 广告详情](https://datanavoapi.com/apis/meta/ads/get/)
- [Meta 广告库搜索](https://datanavoapi.com/apis/meta/ads/search/)
- [Meta 广告主的广告](https://datanavoapi.com/apis/meta/advertisers/ads/list/)
- [TikTok 广告库搜索](https://datanavoapi.com/apis/tiktok/ads/search/)
- [TikTok 广告库广告详情](https://datanavoapi.com/apis/tiktok/ads/get/)
- [TikTok 创意中心热门广告详情](https://datanavoapi.com/apis/tiktok/creative_center/ads/get/)
- [TikTok 创意中心热门广告搜索](https://datanavoapi.com/apis/tiktok/creative_center/ads/search/)

## 相关页面

- [Google 广告详情](https://datanavoapi.com/apis/google/ads/get/)
- [Google 广告主的广告](https://datanavoapi.com/apis/google/advertisers/ads/list/)
- [LinkedIn 广告详情](https://datanavoapi.com/apis/linkedin/ads/get/)
- [LinkedIn 广告库搜索](https://datanavoapi.com/apis/linkedin/ads/search/)
- [如何整理 Google 广告透明度数据？](https://datanavoapi.com/answers/google-ads-transparency-center-api/)
- [LinkedIn 广告研究有哪些接口？](https://datanavoapi.com/answers/linkedin-ad-library-api/)
- [广告创意研究工作流](https://datanavoapi.com/skills/ads/)

[English](https://datanavoapi.com/en/docs/objects/ad/)
