添加数据连接器
- 在"设置">"数据连接器"中，单击 "添加数据连接器"，然后键入并选择 "Facebook"。
- 使用 Facebook 认证登录。您可能需要重新导航到 Singular 并再次打开数据连接器。
- 打开已添加的数据连接器，激活要从中提取数据的账户，然后点击提交。
快速了解详情
| 数据连接器技术 | 应用程序接口（Facebook 图形应用程序接口和营销应用程序接口v13.0） |
| 数据分类（细分） |
Facebook 可按以下所有 分类提供数据（有关术语和更多详情，请参阅下面的 "数据映射"）：
此外，Facebook 还提供以下其中一种细分：
默认为Country 。如果您需要其他细分信息，请联系您的客户成功经理或 Singular 支持人员为您配置集成。您可以为每个账户 ID 分别选择细目。 |
| 我们从多长时间前提取数据 |
每天，Singular 都会提取 7 天前的数据。每周一，Singular 会提取 30 天前的数据。 |
| 时区 | 在 Facebook 上为账户配置的时区。 |
| 创意（广告）层面的数据可用吗？ |
有。 |
| Singular 是否会显示您的创意资产？ |
是的，包括动态创意中的多个资产。请注意，Singular 无法为非 Facebook 页面管理员的用户从该页面提取视频。 |
| 已知限制/问题 | 如果在 Facebook 账户上启用双因素身份验证，则必须在 Singular 中重新验证 Facebook 数据连接器。 |
数据映射
术语说明：
- "Campaign" 在 Singular 中对应于 Facebook 中的"Ad Campaign"
- "Sub-Campaign" 对应于 Facebook 的"Ad Set"
- "Creative" 对应于 Facebook 的"Ad"
- "Asset" 是Creative 以下层次结构中的一个新层级，与 Facebook 的"Asset" 相对应。它用于动态创意（如自动应用广告 [AAA] 活动）。
有关所有字段的说明，请参阅《奇异度量和维度词汇表》。
有关如何在 Meta 中运行创意报告的更多提示，请参阅 如何在 Meta 和 Google Ads 中运行创意报告？
| Field in Singular UI | Field in Singular API | Field in Facebook |
| Dimensions | ||
| Account ID | adn_account_id | 'id' from me/adaccounts |
| Account Name | adn_account_name | 'name' from me/adaccounts |
| Asset ID | asset_id | asset_id |
| Campaign URL | adn_campaign_url | Taken from one of the Creative URLs. |
| Country | country_field | Country from Insights URL |
| Date | date_field | Given as a parameter when querying Facebook |
| DMA ID | dma_id_field | targeting[geo_locations][data][key] |
| DMA Name | dma_name_field | dma |
| Network Campaign ID | adn_campaign_id | campaign_id |
| Network Campaign Name | adn_campaign_name | 'Name' from the campaign-level endpoint |
| Network Creative ID | adn_creative_id | ad_id |
| Network Creative Name | adn_creative_name | 'Name' from ad level |
| Network Sub Campaign ID | adn_sub_campaign_id | adset_id |
| Network Sub Campaign Name | adn_sub_campaign_name | 'Name' from the sub-campaign (ad set) level endpoint |
| Placement |
placement |
Mapped from one of the following fields: device_platforms/ publisher_platforms/ facebook_positions/ instagram_positions/ audience_network_positions/ messenger_positions Possible values: mobile, desktop, facebook, instagram, messenger, audience_network, feed, right_hand_column, instant_article, marketplace, video_feeds, search stream, story, explore, classic, instream_video, rewarded_video, messenger_home, sponsored_messages |
| Platform | platform |
|
| Public Id | site_public_id |
|
| Region |
region_field |
region |
| Source | source | For Sub Ad Network ("Publisher Platform") breakdown - this field contains the sub ad network, i.e. Facebook Advertising Network, Instagram, Whatsapp, etc. |
| Sub Ad Network | adn_subadnetwork | publisher_platform |
| Sub Campaign ID | sub_campaign_id | adset_id |
| Sub Campaign Name | sub_campaign_name | ‘Name’ from sub campaign level insights |
| Target Countries | target_countries_str | targeting[‘geo_locations’] |
| Text | creative_text | Get creative(ad) data by id
|
| Timezone | adn_timezone | From Account.timezone_utc_offset |
| UTC Offset | adn_utc_offset | From Account.timezone_utc_offset |
| Age | age | age |
| Gender | gender | gender |
|
Facebook Attribution Type
|
campaign_attribution_type |
A field for FB app ads campaign, which directly indicates the chosen attribution type for an app install campaign (e.g., SKAN or AEM) while creating it on FB
|
| Metrics | ||
| Average Frequency |
frequency | frequency |
| Comments |
adn_comments | Post comments |
| Likes |
adn_likes | Post reactions |
| Network Clicks | adn_clicks | Clicks (default) or inline_link_clicks (if specifically requested by Singular customer) |
| Network Impressions | adn_impressions | impressions |
| Network Installs | adn_installs | Mobile_installs / canvas_installs. Note that if you set up your campaign with Facebook to optimize on AEM installs, this metric will reflect AEM installs. |
| Original Cost | adn_original_cost | spend |
| Original Currency | adn_original_currency | 'currency' from me/adaccounts endpoint |
| Posts saved |
posts_saved | Post saves |
| Reach |
reach |
reach |
| Shares |
adn_shares | Post shares |
| Video Views 25% | video_views_25pct | video_p25_watched_actions |
| Video Views 50% | video_views_50pct | video_p50_watched_actions |
| Video Views 75% | video_views_75pct | video_p75_watched_actions |
| Completed Video Views | completed_video_views | video_p100_watched_actions |
Singular也支持为该合作伙伴提取广告系列属性，详情请点击此处。
常见问题和故障排除
为了保护最终用户的隐私，Facebook 不允许显示印象少于 1000 次的用户段的测量值。如果您在报告中的某一行看到此信息，则表示该行的印象数较低。要获得所需的数据，请尝试运行粒度较小的报告，即包含较少的维度或选择较宽的日期范围。
动态创意是 Facebook 中一种特殊类型的创意，其中包括多个创意资产。现在，Singular 可以在报告中显示这些创意资产，并显示资产层面的统计数据。
Facebook 认为资产是一个单独的细分，不提供任何其他允许细分的资产级数据（如国家或子广告网络）。为了向您显示每个国家的资产数据（或您在其他 Facebook 报告中看到的任何其他细分数据），Singular 会额外提取每个创意的数据，然后对数据进行插值，使每个资产的指标按比例分配。
例如，如果您选择的 Facebook 细分指标是国家：
由于 Facebook API 只提供了国家或子广告网络或平台，Singular 尝试通过另一种方式--检查广告系列、子广告系列或创意的定向设置--来找出其他两个维度。
例如，如果按广告系列和国家分列数据，从 Facebook 获取的数据不包括平台。Singular 会查找每个营销活动的定位设置，如果某个营销活动针对的是单一特定平台（如 iPhone），Singular就会使用定位信息在该营销活动的"平台"字段中填写"iPhone"。
另一方面，如果广告系列针对的是多个平台，例如 iOS 和 Android，Singular 就不能使用这些信息来填写平台字段。
这意味着您可以通过定义广告系列或子广告系列（在 Facebook 中为广告系列或广告集），使每个系列针对一个国家和/或一个设备，从而在报告中获得更丰富的数据。
注意：如果平台数据来自定向设置，您的报告有时会显示平台为 "iPhone "或 "iPad"，有时则只显示 "iOS "或什么都不显示。这取决于每种情况下的定位水平。
开始将数据从 Facebook 拉入 Singular：
- 在Singular平台中，转到 Settings > Data Connectors.
- 将鼠标悬停在Add New Connector 按钮上，然后开始输入 "Facebook"。在出现的列表中，选择 Facebook。
-
点击Connect with Facebook ，然后登录到可以访问所需广告账户的 Facebook 用户。
注意：在点击该按钮之前，请确保您未使用无关账户（如您的个人账户）登录 Facebook。
要通过您的代理 Facebook 广告账户运行广告系列，请访问 Settings > Data Connectors，并添加您的机构 Facebook 帐户。您无需对 SDK 集成或合作伙伴配置进行任何更新。
然后，您就可以使用我们的报告工具获取广告系列数据，如印象、点击和成本。运行报告时，请使用Account ID 和Account Name 维度。
如果您的广告活动成本包括额外费用，如代理费，您可以让 Singular 在"设置">"合作伙伴费用"下将这些费用添加到报告中显示的成本中。请参阅合作伙伴费用常见问题。
您也可以选择以代理身份查看数据。访问Settings > Data Connectors ，打开你的 Facebook 配置，然后使用View This Source As 下拉菜单。
Singular 会显示你登录的用户可以访问的所有账户。选择你想连接到Singular的账户。例如，如果你有使用虚拟数据的测试账户，你可以不选择它们。
注意：如果你选择的账户之一无效，你将无法保存。如果 Facebook 上的某个账户不再活跃，或者已登录的用户不再拥有该账户的访问权限，就会出现这种情况。
在 "来源"栏中，您可以为每个账户命名。这是数据在报告中显示的名称。可以为多个账户使用相同的源名称。
例如，如果您有一个或多个 Facebook 账户，用于由首选营销开发人员（PMD）或 Facebook 营销合作伙伴（FMP）（如 Nanigans）处理的广告活动，则为这些账户指定 "Nanigans"。Singular 报告将汇总这些账户的数据，并以 "Nanigans "源名称显示在报告中。
默认情况下，所有账户的源名称都是 "Facebook"。
有关 Singular 中自定义事件的一般信息，请参阅配置自定义事件。
Singular 可以分析用户安装后的事件数据，如注册或首次购买。通常情况下，最好从归因提供商那里获取有关这些事件的数据，但如果你没有通过归因提供商跟踪 Facebook 的活动，或者如果你想跟踪非移动流量，你可以从 Facebook 本身获取数据。在 Facebook 中，用户事件被称为操作。
要开始跟踪来自 Facebook 的自定义事件，请按照 "配置自定义事件 "中的说明添加新的自定义事件。如果已配置 Facebook 活动，"新自定义事件 "框中会包含一个 Facebook 下拉列表。单击该列表可显示所有可用的 Facebook 操作，并选择一个操作将自定义事件映射到该操作。
如果您的 iOS 报告没有显示安装数量，请确保您查看的是正确的报告。SKAN 报告将显示 SKAN 安装值；报告将显示网络和 MMP 安装。
请记住
- SKAN 报告：了解 SKAN 报告结合了网络数据和 SKAN 安装量。网络数据很详细，而 SKAN 数据由于 SKAdNetwork 的限制，通常是广告系列级别的数据。
- 报告细分：按子广告系列细分时，如果合作伙伴只传递广告系列级别的数据，SKAN 安装量可能在 "不适用 "下。其他数据将显示在各自的子活动下。