菜单

Meta Ads 广告集成方案

适用于 SA3.0.4 及以上版本。

该功能由独立 license 控制，若有需求，请联系您的客户经理。

若您的 APP 正在投放海外广告以获取新用户，希望获取海外广告平台的广告聚合数据（如展、点、消）到神策平台，可使用此功能。

功能概述

支持对接Meta Ads（Facebook Ads），通过其开放的API完成广告层级数据，如展、点、消数据的拉取。拉取后以事件形式入库神策，可在分析模型中完成分析。同时可以与后链路中的用户行为数据关联分析。

接口
数据粒度
数据更新频率
归因
成本
展示
点击
转化
Insights API 聚合数据 天粒度   ✅ ✅ ✅ ✅

功能入口

渠道追踪 > 三方数据集成 > 广告生态 > Meta Ads

接入说明

Meta Ads 数据说明

支持通过Meta Ads 的Ad Insight API拉取广告数据，此为Ad层级的模版。API详情可参考：Meta Ads API

内置 4个模版，涵盖广告常用的指标及维度。

  • Ad Group Ad 模板：Ad层级的广告数据，原始内容可查看 官方文档。通过该模版可获取的指标及维度如下
metrics
  • metrics.all_conversions
  • metrics.all_conversions_value
  • metrics.active_view_impressions
  • metrics.active_view_cpm
  • metrics.active_view_ctr
  • metrics.impressions
  • metrics.clicks
  • metrics.conversions
  • metrics.cost_micros
  • metrics.cost_per_all_conversions
  • metrics.cost_per_conversion
  • metrics.average_cost
  • metrics.average_cpc
  • metrics.average_cpe
  • metrics.average_cpm
  • metrics.average_cpv
  • metrics.ctr
  • metrics.value_per_all_conversions
  • metrics.value_per_all_conversions_by_conversion_date
  • metrics.value_per_conversion
  • metrics.value_per_conversions_by_conversion_date
group by
  • customer.id
  • customer.status
  • customer.time_zone
  • customer.currency_code
  • campaign.id
  • campaign.name
  • campaign.status
  • campaign.app_campaign_setting.app_id
  • campaign.advertising_channel_type
  • campaign.advertising_channel_sub_type
  • ad_group.id
  • ad_group.name
  • ad_group.status
  • ad_group.type
  • ad_group_ad.ad.id
  • ad_group_ad.ad.name
  • ad_group_ad.ad.type
  • ad_group_ad.status
  • segments.date
  • segments.ad_network_type
  • segments.slot

 

接入前准备

需要完成与Meta Ads的授权认证，方可通过Meta Ads API获取广告数据。详情可参考官方文档：Meta Ads API官方文档

步骤 内容 说明
第一步 创建应用

登录 Meta for Developers后台，创建应用

  1. 填入应用名称
  2. 选择用例（use case）中的 用市场营销API衡量广告表现数据，用于后续从Meta广告账号中拉取广告聚合数据
  3. 在应用设置 - 高级选项中，找到授权广告账号，将后续希望拉数及推送的广告账户ID填写在此处
第二步 将应用添加为业务资产

登录 Meta Business Suite后台，先导航到广告管理工具平台，然后点击所有工具，找到业务设置

  1. 在账号 - 应用中添加第一步中创建好的应用
  2. 定位到用户 - 系统用户，如果已经有系统用户，则在指定人员中，选择已有的系统用户，选择 分配资产，将应用与广告账号添加为该系统用户的资产，继续下文中的第四步
  3. 如果没有系统用户，则继续下文中的第三步
第三步 创建系统用户
  1. 在用户 - 系统用户中新建系统用户，选择角色为admin
  2. 在右上角选择分配资产，将后续要拉取数据的广告账号以及在第一步中创建的应用作为资产添加进来
第四步 创建口令

生成系统用户的口令

  1. 选择应用
  2. 设置过期日期，设为永不
  3. 选择权限，勾选ads_management, ads_read, business_management
第五步 使用口令 在对接Meta Ads的方案中，在Access Token处填入第四步中生成的口令

配置Meta Ads接入方案

主要包括以下3个部分的配置：

1. 方案基本信息

2. 授权配置

    • 该部分填入的字段主要用于与Meta Ads进行鉴权以及明确要拉取的广告账号范围。请参考上一段落「接入前准备」中的内容，从Meta Ads平台获取相应的字段
    • 最多支持拉取100个Meta Ads广告账号的数据，如果用户有超过100个Meta Ads广告账号，则可以创建多个拉取方案
    • 在保存方案前，需要完成「连通性测试」，确保此处填写的Access Token具备访问Customer ID的权限
    • 修改Access Token和Customer ID时均需要再次进行连通性测试，未通过报错信息将会通过Error Code告知

3. 数据拉取配置

数据回溯

支持「数据回溯」，可以选择最长180天时长的时间段，拉取该时间段内的广告数据。

数据入库说明

拉取的Meta Ads数据，以事件入库，原始字段将进行标准化，以sensors_ad开头作为属性入库。

事件将使用一个固定值作为其用户标识，可理解为用户标识是一个虚拟用户。

事件名：meta_ads_ad_insight

以下列举一些常见的原始数据及相应的入库属性：

原始字段 入库字段
account_id sensors_ad_customer_id
account_name sensors_ad_customer_name
account_timezone sensors_ad_customer_timezone
account_currency sensors_ad_customer_currency
media_source sensors_ad_media_source
campaign_id sensors_ad_campaign_id
campaign_name sensors_ad_campaign_name
adset_id sensors_ad_ad_group_id
adset_name sensors_ad_ad_group_name
ad_id sensors_ad_ad_id
ad_name sensors_ad_ad_name
country sensors_ad_country
impressions sensors_ad_metrics_impressions
clicks sensors_ad_metrics_clicks
spend sensors_ad_metrics_cost
reach sensors_ad_metrics_reach

在分析模型中进行分析

将Meta Ads数据作为事件入库后，可在事件分析中选择相应事件，分析Meta Ads的展示数、点击数、花费等指标。

权限

管理员角色默认可进行Meta Ads方案的配置。也可将配置方案与查看方案的权限点分配给普通用户。

 

上一个
Google Ads 广告集成方案
下一个
分群
最近修改: 2026-01-29