Apple Ads (formerly Apple Search Ads) 数据连接器

关注
Avatar
Vaibhav Gupta
Updated
Apple Search Ads
成本聚合
设置数据连接器

了解 Singular 如何从 Apple Search Ads (ASA) 提取广告成本数据并在您的报表中展示。

重要提示：ASA 提供两种可供广告主使用的方案： Advanced 或 Basic（点击此处查看区别）。在 ASA 的 Basic 方案上投放的广告系列不受其报表 API 支持，因此 Singular 无法报告这些广告系列的广告成本。

2022 年 2 月 11 日更新：新增 Keyword Match Type 维度。

快速详情

数据连接器技术 API (Apple Search Ads API v. 5)
数据分类（细分）

Apple Search Ads 的数据按以下维度分类：

  • 广告系列
  • 子广告系列（Ad Group）
  • 国家

此外，您还可以选择 其中一项 分类维度：

  • 关键词（搜索关键词）- 默认
  • 城市与地区

如果您希望使用城市与地区分类而非关键词分类，请联系您的 Customer Success Manager 或 Singular 支持团队。
我们从多长时间前提取数据 30 天
时区 默认情况下，Singular 会按您在 Apple 仪表板中设定的原始时区提取数据。如果您希望以 UTC 提取数据，请联系我们。
创意层面的数据可用吗？ 是
Singular 是否会显示您的创意资产？

是 — Singular 支持 Apple Ads 的创意预览，适用于 Default 和 Custom Product Pages。

Singular 会将与产品页面关联的所有资产合并为一个 GIF 预览。

注意： 创意预览以及 Custom Product Page 的名称和 ID 仅在 Creative IQ (CIQ)。
Singular 是否支持 Custom Product Page ROI？

是

- 每个 Apple Search Ads 创意只对应一个 Custom Product Page
- 当创意没有关联的产品页面变体时，product page id 和 product page name 下会显示默认产品页面。
- 如何查看 Custom Product Page ROI？
只需在您的 ASA 创意报表中，将 ROI 指标与创意和 Product Page ID 一并添加即可。

数据映射

提示：

  • Singular 的 子广告系列 对应 Apple 的 Ad Group。
  • 发布商 字段在此数据连接器中不会填充，因为发布商即 Apple Search Ads。
  • 有关 Singular 报表中各字段的说明，请参阅 Singular 指标与维度术语表

Field in Singular UI Field in Singular API Field in Apple
Dimensions
Account ID adn_account_id orgID
App app appName
App Site ID app_site_id adamId
City
 city
 locality
Country country_field countryOrRegion OR countryCode
Creative Format
 creative_format

creativeType
Possible values:

  • DEFAULT_PRODUCT_PAGE
  • CUSTOM_PRODUCT_PAGE
  • IMAGE
Creative ID creative_id adId
Creative Name creative_name adName
Date date_field date
Keyword keyword searchTermText OR keyword
Keyword ID keyword_id keywordId
Keyword Match Type keyword_match_type matchType
Network Campaign ID adn_campaign_id (campaign) id
Network Campaign Name adn_campaign_name (campaign) name
Network Creative ID adn_creative_id adId,
Network Creative Name adn_creative_name adName
Network Sub Campaign ID adn_sub_campaign_id (adGroup) id
Network Sub Campaign Name adn_sub_campaign_name (adGroup) name
OS os Always "iOS" (hardcoded)
Platform
 platform
 deviceClass
Public Id site_public_id adamId
Region
 region
 adminArea
Sub Ad Network
 adn_subadnetwork
 adChannelType
Timezone adn_timezone timeZone
Ad Type ad_type SupplySources
Product Page ID product_page_id productPageId
Product Page Name product_page_name productPageName
Metrics
Network Clicks adn_clicks taps
Network Impressions adn_impressions impressions
Network Installs adn_installs installs
Original Cost adn_original_cost amount
Original Currency adn_original_currency currency

Singular 也支持提取此合作伙伴的广告系列属性， 请点击此处查看更多详情。

其他事件/指标

Apple Search Ads 还提供自行申报的浏览归因（view-through attribution）报表。目前它仅通过数据连接器集成提供这些数据；Apple Search Ads 尚不支持 MMP 浏览归因。要设置浏览归因报表，您可以将其作为转化事件添加到账户中。

要在 Singular 中设置 转化事件，请执行以下步骤：

  1. 在 Singular 中，前往 Settings > Events。如果同时存在 Custom Events 和 Conversion Events 两个标签页，请选择 Conversion Events。
  2. 点击 New Event。

  3. 在 Apple SearchAds 下拉菜单中会显示 AppleSearchAds 提供的可用指标列表，其中包括 "view installs count"。

    第二天，当 Singular 提取您账户的每日数据时，也会一并提取这些活动的统计数据。

创意预览

Singular 支持 Apple Ads 的创意预览，适用于 Default Product Pages 和 Custom Product Pages。

Singular 会将与产品页面关联的所有资产合并为一个动态 GIF，直观呈现您的创意在用户端的展示效果。

注意： 创意预览以及 Custom Product Page 的名称和 ID 仅在 Creative IQ (CIQ)。

常见问题

问：为什么创意名称或 Creative id 中显示 -1？

答： 如果您投放的是 "Search Results" 广告系列，且未为广告组指定特定的 Custom Product Page（CPP）或 Creative Set，Apple 会自动使用您应用的默认元数据（图标、标题、截图）来生成广告。由于该"广告"并非由您显式创建为独立对象，API 会为其分配的 ID 为 -1