DataNavoAPI / DOCS

广告:字段与来源

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

本地模拟所有展示数据均为虚构样本。真实 API、支付和外部邮件关闭。English ↗
01

对象与空值语义

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

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

02

完整字段路径

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

字段路径类型要求声明平台
idstring | null按合同可缺失Google 广告、LinkedIn、Meta 广告库、TikTok
urlstring | null按合同可缺失Google 广告、LinkedIn、Meta 广告库、TikTok
formatstring | null按合同可缺失Google 广告、LinkedIn、Meta 广告库、TikTok
titlestring | null按合同可缺失Google 广告、LinkedIn、Meta 广告库、TikTok
textstring | null按合同可缺失Google 广告、LinkedIn、Meta 广告库、TikTok
landing_urlstring | null按合同可缺失Google 广告、LinkedIn、Meta 广告库、TikTok
advertiserobject | null按合同可缺失Google 广告、LinkedIn、Meta 广告库、TikTok
advertiser.idstring | null按合同可缺失Google 广告、LinkedIn、Meta 广告库、TikTok
advertiser.namestring | null按合同可缺失Google 广告、LinkedIn、Meta 广告库、TikTok
advertiser.urlstring | null按合同可缺失Google 广告、LinkedIn、Meta 广告库、TikTok
advertiser.avatar_urlstring | null按合同可缺失Google 广告、LinkedIn、Meta 广告库、TikTok
imagesarray | null按合同可缺失Google 广告、LinkedIn、Meta 广告库、TikTok
videosarray | null按合同可缺失Google 广告、LinkedIn、Meta 广告库、TikTok
first_shown_atstring | null按合同可缺失Google 广告、LinkedIn、Meta 广告库、TikTok
last_shown_atstring | null按合同可缺失Google 广告、LinkedIn、Meta 广告库、TikTok
approximatearray | null按合同可缺失Google 广告、LinkedIn、Meta 广告库、TikTok
approximate[].fieldstring | null按合同可缺失Google 广告、LinkedIn、Meta 广告库、TikTok
approximate[].kindstring | null按合同可缺失Google 广告、LinkedIn、Meta 广告库、TikTok
extobject按合同可缺失Google 广告、LinkedIn、Meta 广告库、TikTok
ext.regionsarray | null按合同可缺失Google 广告、TikTok
ext.impressions_mininteger | null按合同可缺失Google 广告
ext.impressions_maxinteger | null按合同可缺失Google 广告
ext.variationsarray | null按合同可缺失Google 广告
ext.variations[].titlestring | null按合同可缺失Google 广告
ext.variations[].textstring | null按合同可缺失Google 广告
ext.variations[].destinationstring | null按合同可缺失Google 广告
ext.variations[].image_urlstring | null按合同可缺失Google 广告
ext.variations[].video_urlstring | null按合同可缺失Google 广告
ext.format_labelstring | null按合同可缺失LinkedIn、Meta 广告库
ext.ctastring | null按合同可缺失LinkedIn、Meta 广告库
ext.impressions_rangestring | null按合同可缺失LinkedIn
ext.targeting_languagestring | null按合同可缺失LinkedIn
ext.targeting_locationstring | null按合同可缺失LinkedIn
ext.activeboolean | null按合同可缺失Meta 广告库
ext.platformsobject | null按合同可缺失Meta 广告库
ext.platforms.facebookboolean | null按合同可缺失Meta 广告库
ext.platforms.instagramboolean | null按合同可缺失Meta 广告库
ext.platforms.messengerboolean | null按合同可缺失Meta 广告库
ext.platforms.audience_networkboolean | null按合同可缺失Meta 广告库
ext.platforms.threadsboolean | null按合同可缺失Meta 广告库
ext.platforms.whatsappboolean | null按合同可缺失Meta 广告库
ext.cardsarray | null按合同可缺失Meta 广告库
ext.cards[].titlestring | null按合同可缺失Meta 广告库
ext.cards[].textstring | null按合同可缺失Meta 广告库
ext.cards[].landing_urlstring | null按合同可缺失Meta 广告库
ext.cards[].image_urlstring | null按合同可缺失Meta 广告库
ext.cards[].video_urlstring | null按合同可缺失Meta 广告库
ext.likesinteger | null按合同可缺失TikTok
ext.commentsinteger | null按合同可缺失TikTok
ext.sharesinteger | null按合同可缺失TikTok
ext.durationnumber | null按合同可缺失TikTok
ext.cover_urlstring | null按合同可缺失TikTok
ext.objectivestring | null按合同可缺失TikTok
ext.audience_rangestring | null按合同可缺失TikTok
ext.categorystring | null按合同可缺失TikTok
ext.industrystring | null按合同可缺失TikTok
03

返回该对象的接口

能力对象返回形状分页
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显式逐页
TRY THE CONTRACT

输入清楚,结果可查。

每次点击仅运行本机固定样本,不访问平台。高级 JSON 参数按所选方法校验;修改输入不会自动执行。

复制不会运行请求。CLI quote 只读报价,需要本地客户 TEST Key;MCP 需先配置 demo;GET 与批量 POST 均只返回本地虚构样本。

下载合同固定示例(不执行) ↗

需要 TEST 预算、Key 权限或失败演练?进入账户控制台。 客户模拟网关 ↗