关于获取Instagram媒体付费触达、曝光数据的API技术问询

核心结论 #

没有直接通过mediaId获取Instagram媒体付费触达（paid reach）、付费曝光（paid impressions）的独立API接口，需通过关联广告数据的方式间接获取。

详细说明 #

1. Instagram Media Insights接口的限制
   你调用的GET <media-id>/insights?metric=reach,impressions接口，确实仅返回自然渠道的触达和曝光数据——官方文档虽未在接口参数处直接标注，但在指标定义细节里明确了这类无拆分的reach/impressions默认对应organic数据，Meta团队的答复是准确的。

2. 付费数据的获取路径
   付费相关数据需通过Marketing API获取，步骤如下：

   • 关联mediaId与adId：调用GET <media-id>/promotions接口，获取该媒体关联的所有推广活动（promotion）记录，每条记录中会包含对应的ad_id（即广告ID）。
   • 通过adId拉取付费数据：拿到ad_id后，调用GET <ad-id>/insights接口，指定请求reach、impressions指标，此处返回的就是该广告为目标媒体带来的付费触达和曝光数据。
   • 汇总自然+付费数据：自行将Media Insights返回的自然数据与Marketing API拿到的付费数据相加，得到总触达/总曝光。

3. 与Facebook帖子的差异说明
   Facebook帖子支持post_impressions_paid这类直接拆分渠道的指标，是因为Facebook Graph API的帖子洞察体系原生支持渠道拆分；但Instagram目前未提供类似的直接拆分指标，必须通过上述“媒体关联广告→拉取广告数据”的方式获取付费部分的数据。

内容的提问来源于stack exchange，提问作者Hayrullah