添加数据连接器
- 在 Settings > Data Connectors中，点击 Add Data Connector，然后输入并选择“Facebook”。
- 使用您的 Facebook 凭据登录。您可能需要重新返回 Singular 并再次打开数据连接器。
- 打开您添加的数据连接器，激活您要提取数据的账户，然后点击 Submit.
快速详情
| 数据连接器技术 | API (Facebook Graph API 和 Marketing API v19.0) |
| 数据分类（细分） |
Facebook 会按 以下所有维度 对您的数据进行分类（术语和更多详情参见下方的 数据映射）：
此外，Facebook 还提供 以下任一分类维度：
其中默认值为 国家。如果您希望改用其他分类维度，请联系您的 Customer Success Manager 或 Singular 支持团队为您配置集成。您可以为每个 Account ID 单独选择分类维度。 |
| 我们从多长时间前提取数据 | Singular 每天提取过去 7 天的数据。每周一还会提取过去 30 天的数据。 |
| 时区 | 该账户在 Facebook 中配置的时区。 |
| 创意（广告）层面的数据可用吗？ | 是。 |
| Singular 是否会显示您的创意资产？ | 是，包括 Dynamic Creative 中的多个资产。请注意，如果用户不是该页面的管理员，Singular 无法从 Facebook 页面提取视频。 |
| 已知限制/问题 | 如果您在 Facebook 账户上启用了双重验证，则必须在 Singular 中重新验证 Facebook 数据连接器。 |
数据映射
术语说明：
- "Campaign" 在 Singular 中对应 Facebook 的 "Ad Campaign"。
- "Sub-Campaign" 对应 Facebook 的 "Ad Set"
- "Creative" 对应 Facebook 的 "Ad"
- "Asset" 是层级结构中位于 Creative 之下的新层级，对应 Facebook 的 "Asset"。它用于 Dynamic Creative，例如 Automated App Ads [AAA] 广告系列中）。
有关所有字段的说明，请参阅 Singular 指标与维度术语表。
有关在 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 |
Call to Action Button |
call_to_action_button | A creative field with the call to action message if there is any |
| Metrics | ||
|
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 |
|
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 也支持提取此合作伙伴的广告系列属性， 请点击此处查看更多详情。
常见问题与故障排查
如果您已将广告系列设置为针对 AEM 进行优化，我们会将 AEM 安装量提取到网络安装维度中
为保护最终用户隐私，Facebook 不允许展示展示次数少于 1000 次的用户群体的测量数据。如果您在报表的某一行看到此消息，说明该行的展示次数较少。要获取您需要的数据，请尝试运行粒度更粗的报表，即减少维度或选择更宽的日期范围。
Dynamic Creative 是 Facebook 中一种包含多个创意资产的特殊创意类型。现在，Singular 可以在您的报表中展示这些创意资产，并提供资产层面的统计数据。
Facebook 将资产视为一个独立的分类维度，不会将资产层面的数据与其他任何允许的分类维度（例如国家或子广告网络）一起提供。为了向您展示按国家（或您在其他 Facebook 报表中使用的任何分类维度）划分的资产数据，Singular 会额外执行一个步骤：先按创意提取数据，再进行插值计算，将指标按比例分配给每个资产。
例如，如果您选择的 Facebook 分类维度是国家：
由于 Facebook API 只提供国家、子广告网络或平台三者之一，Singular 会通过其他方式推断另外两个维度，即查看广告系列、子广告系列或创意的 定向设置。
例如，如果您按广告系列和国家分类数据，从 Facebook 提取的数据将不包含平台。Singular 会查询每个广告系列的定向设置，如果某个广告系列仅定向 iPhone 等单一特定平台， Singular 会使用该定向信息填充该广告系列的平台字段，值为 "iPhone"。
反之，如果某个广告系列同时定向 iOS 和 Android 等多个平台，Singular 就无法据此填充平台字段。
这意味着，如果您将广告系列或子广告系列（在 Facebook 中为 ad campaign 或 ad set）设置为各自仅定向一个国家和/或一种设备，就能在报表中获得更丰富的数据。
注意： 如果平台数据来自定向设置，您的报表有时会将平台显示为 "iPhone" 或 "iPad"，有时仅显示 "iOS"，也可能完全不显示。这取决于每种情况下的定向粒度。
默认情况下，Facebook 对点击使用 7 天归因窗口，对展示浏览使用 1 天归因窗口。
如果您希望在 Singular 分析报表中使用其他值，请 联系 Singular 支持团队 为您更改归因窗口。
要开始将数据从 Facebook 提取到 Singular：
- 在 Singular 平台中，前往 Settings > Data Connectors。
- 将鼠标悬停在 Add New Connector 按钮上，然后开始输入 "Facebook"。从出现的列表中选择 Facebook。
-
点击 Connect with Facebook 并使用有权访问所需广告账户的 Facebook 用户登录。
注意： 点击该按钮前，请确认您没有使用无关账户（例如个人账户）登录 Facebook。
要通过您的代理商 Facebook Ads 账户投放广告系列，请前往 Settings > Data Connectors并添加您的代理商 Facebook 账户。您无需对 SDK 集成或合作伙伴配置做任何更改。
之后，您就可以使用我们的报表工具获取展示次数、点击次数和成本等广告系列数据。运行报表时，请使用 Account ID 和 Account Name 维度。
如果您的广告系列成本包含额外费用（例如代理费），您可以让 Singular 将这些费用计入报表中显示的成本，设置位置为 Settings > Partner Fees。请参阅 合作伙伴费用常见问题。
您也可以选择以代理商身份查看数据。前往 Settings > Data Connectors，打开您的 Facebook 配置，然后使用 View This Source As 下拉菜单。
Singular 会显示您登录所用账户可访问的全部账户。请选择要连接到 Singular 的账户。例如，如果您有包含测试数据的测试账户，建议将其排除。
注意： 如果您选择的账户中有一个无效，将无法保存。当 Facebook 上的某个账户不再处于活跃状态，或登录用户不再有权访问该账户时，就可能出现这种情况。
Source 列可用于为每个账户命名。数据将以该名称显示在您的报表中。多个账户可以使用同一个来源名称。
例如，如果您有一个或多个由 Nanigans 等 Preferred Marketing Developer（PMD）或 Facebook Marketing Partner（FMP）管理的广告系列 Facebook 账户，请为这些账户指定 "Nanigans"。Singular 报表会汇总这些账户的数据，并以来源名称 "Nanigans" 展示。
默认情况下，所有账户的来源名称均为 "Facebook"。
有关 Singular 中自定义事件的一般信息，请参阅配置自定义事件
Singular 可以分析用户的安装后事件数据，例如注册或首次购买。通常更建议从您的归因服务商获取这些事件数据，但如果您没有通过归因服务商追踪 Facebook 活动，或者希望追踪非移动端流量，也可以直接接入来自 Facebook 的数据。在 Facebook 中，用户事件称为 actions。
要开始追踪来自 Facebook 的自定义事件，请按照配置自定义事件中的说明添加新的自定义事件。如果您已配置 Facebook 广告系列，New Custom Event 框中会包含一个 Facebook 下拉列表。点击该列表可显示所有可用的 Facebook actions，然后选择要映射到自定义事件的操作。
如果您的 iOS 报表未显示安装数，请确认您查看的是正确的报表。SKAN 报表会显示 SKAN 安装量；Reports 会同时显示网络安装量和 MMP 安装量。
请注意：
- SKAN 报表： SKAN 报表会将网络数据与 SKAN 安装量合并。网络数据较为详细，而 SKAN 数据由于 SKAdNetwork 的限制通常仅在广告系列层面。
- 报表分类： 按子广告系列分类时，如果合作伙伴仅在广告系列层面传递数据，SKAN 安装量可能显示为 'N/A'。其他数据则会归入各自的子广告系列。