Leina 
Wanta 
比较广告系列表现
读取指定 App Store 广告系列的报表指标，比较已有结果。
/oo Apple Ads: 查看 Apple Ads 广告账号[广告账号 ID]中 App Store 广告系列[广告系列 ID 列表]在[开始日期]至[结束日期]的报表，使用 UTC。比较报表中的支出、展示与转化指标。
让你的 AI Agent 连接 Apple Ads
选择广告账号、广告系列与报告时段，比较结果并审阅调整建议。
98 个工具 Custom credential
试试这些 Apple Ads 任务
将提示词复制到已安装 oo Skill 的 Agent，补充页面链接和原始笔记后执行。
oo Skill Apple Ads
查看关键词结果
读取限定广告系列的关键词与搜索词报表，查看匹配流量。
/oo Apple Ads: 读取 Apple Ads 广告账号[广告账号 ID]中 App Store 广告系列[广告系列 ID]在[开始日期]至[结束日期]的关键词与搜索词报表，使用账号报告时区。整理支出较高的词，并说明缺失或汇总的搜索词。
审阅预算建议
查看建议，先不应用到当前广告系列预算。
/oo Apple Ads: 查看 Apple Ads 广告账号[广告账号 ID]中推广对象[对象 ID]、类型[推广对象类型]的每日预算建议，解释建议调整与支持指标，先不应用。
开始使用 Apple Ads
-
安装 OOMOL
在 Agent 中配置 oo CLI 和 oo Skill。
安装 OOMOL → -
连接 Apple Ads
连接 Apple Ads API 凭据，并选择广告账号。
连接 Apple Ads → -
向 Agent 交代任务
使用 /oo，说明要读取的页面、修改的内容和保存位置。
连接指南 →
选择你的 Agent
- Client ID、Team ID、Key ID，以及 Apple Ads 已登记公钥对应的私钥。
- 报表需要日期范围和广告账号；App Store 报表还必须明确广告系列。应用预算建议会修改广告系列预算。关键词与搜索词比较使用账号报告时区。
Apple Ads 工具
这个集成提供 Apple Ads 的账号、广告系列、关键词、报表与建议操作，涵盖 App Store 和 Apple Maps 广告。
广告系列与关键词报表
读取指定报告时段的广告系列、关键词和搜索词结果。
建议审阅与应用
查看预算或 CPA 建议，并仅在明确要求时应用。
账号与广告系列
查找有权访问的账号，并查看广告系列配置。
98 个工具
Get Me
读取该 access token 所属的用户和组织。这是确认凭据可用、并获取其他账户类操作所需 orgId 的最省成本方式。
apple_ads.get_me Get User Acls
列出该访问令牌可访问的所有广告账户，以及 API 用户在每个账户上拥有的角色。先用它找出以广告账户为作用域的操作所需的 adAccountId 值。
apple_ads.get_user_acls Get Org
按标识符读取一个组织 (organization)，包含其广告账户所继承的币种、时区、付款模式和系统状态。
apple_ads.get_org Get Advertiser Resources
列出该组织可委派给广告账户的某一类广告主资源。将返回的 resourceId 值用于 create_ad_account 和 update_ad_account 的 delegations 中。
apple_ads.get_advertiser_resources Create Ad Account
在访问令牌所绑定的组织下创建一个广告账户。币种、时区和付款模式继承自该组织，productFeatures 在创建时即固定：获授权投放 App Store 的账户永远无法投放 Apple Maps 广告系列，反之亦然。
apple_ads.create_ad_account Get Ad Account
读取一个广告账户的完整记录，包含其被授权的广告主资源以及它无法正常运作的原因。
apple_ads.get_ad_account Update Ad Account
修改单个广告账户的名称或委托的广告主资源。只有传入的字段会被更改，传入的 delegations 数组会完全替换已存储的数组。币种、时区、付款模式、组织和 productFeatures 是固定的，无法更新。
apple_ads.update_ad_account Search Apps
按名称或内容提供商在 App Store 中搜索 App，或列出该组织拥有的 App。至少需要提供 query、cpids 之一，或将 returnOwnedApps 设为 true。广告系列 (campaign) 只能推广该广告账户拥有的 App，因此用 returnOwnedApps 来找到可用的 promotedObjectId。
apple_ads.search_apps Get App
按 Adam ID 读取一个 App 的 App Store 元数据，包含其类别、支持的设备类型 (device class) 以及可用的国家或地区。当没有 App 匹配该 Adam ID 时，Apple Ads 返回 404。
apple_ads.get_app Query Supported App Languages
列出 App Store 的国家或地区，以及 Apple Ads 在每个市场支持的语言。在为 Ad Group 或创意设置 locale 之前，可用它进行校验。查询为空时返回所有市场。
apple_ads.query_supported_app_languages Query App Eligibilities
检查 App 是否有资格投放 App Store 广告，按 App、supply placement、supply source、国家或地区与设备类别的每种组合各返回一行。在新市场创建广告系列 (campaign) 之前先运行它，因为不具备资格的市场不会产生任何投放。此处不涵盖 Apple Maps 品牌推广。
apple_ads.query_app_eligibilities Query App Rejection Reasons
搜索某个 App 的 App Store 广告素材所记录的拒绝原因，说明每个素材为何未通过 Apple 审核。用 adamId 筛选可将搜索限定到单个 App。
apple_ads.query_app_rejection_reasons Get App Rejection Reasons
按标识符读取一条广告素材 (ad creative) 拒绝原因，包含其原因代码、适用层级以及审核人员的评论。
apple_ads.get_app_rejection_reasons Query Campaigns
以筛选、排序和偏移分页方式搜索某个广告账户的广告系列 (campaign)。除非用 deleted 筛选条件请求，否则软删除的广告系列不会包含在内。
apple_ads.query_campaigns Get Campaign
按标识符读取一个广告系列 (campaign)。无论该广告系列是否处于已删除状态，Apple Ads 都会返回它。
apple_ads.get_campaign Create Campaign
创建广告系列。promotedObjectType、promotedObjectId 和 billingEvent 在创建时即固定：要推广不同的 App 或品牌，请另建一个广告系列。
apple_ads.create_campaign Update Campaign
修改单个广告系列 (campaign) 的可变字段。只有传入的字段会被更改，但传入的数组会完全替换已存储的数组。
apple_ads.update_campaign Delete Campaign
软删除一个广告系列 (campaign)。Apple Ads 会保留记录，但停止投放，并将删除级联到该广告系列的 Ad Group、关键词和广告。
apple_ads.delete_campaign Get Campaign Limited Status Details
读取旧版 App 广告系列 (campaign) 在各国家或地区投放低于其潜力的原因，返回国家或地区代码到限制原因的映射。
apple_ads.get_campaign_limited_status_details Query Ad Groups
以筛选、排序和偏移分页方式搜索某个广告账户的 Ad Group。用 campaignId 筛选可将结果限定到单个广告系列 (campaign)。除非用 deleted 筛选条件请求，否则软删除的 Ad Group 不会包含在内。
apple_ads.query_ad_groups Get Ad Group
按标识符读取一个 Ad Group，包含其完整的定向和出价策略。无论 Ad Group 是否处于已删除状态，Apple Ads 都会返回它。
apple_ads.get_ad_group Create Ad Group
在已有广告系列内创建一个 Ad Group。campaignId、pricingModel 和 automatedKeywordsRequired 在创建时即固定。关键词和否定关键词无法内联创建：请在创建后用关键词相关的 action 添加。
apple_ads.create_ad_group Update Ad Group
修改单个 Ad Group 的可变字段。只有传入的字段会被更改，定向按维度逐一合并：传入的维度会替换已存储的维度，未传入的维度保持不变。campaignId、pricingModel 和 automatedKeywordsRequired 不可更改。
apple_ads.update_ad_group Delete Ad Group
软删除一个 Ad Group。Apple Ads 会保留记录，但停止投放，并将删除级联到该 Ad Group 的广告、关键词和否定关键词。该操作无法撤销。
apple_ads.delete_ad_group Query Keywords
以筛选、排序和偏移分页方式搜索某个广告账户的关键词。除非按 id 筛选，否则 Apple Ads 要求带有对 adGroupId 或 campaignId 的筛选条件；除非用 deleted 筛选条件请求，否则软删除的关键词不会包含在内。
apple_ads.query_keywords Get Keyword
按标识符读取一个关键词。对于软删除的关键词，Apple Ads 会返回 deleted 为 true 的记录，而不是 404。
apple_ads.get_keyword Create Keyword
向 Ad Group 添加一个关键词。adGroupId、text 和 matchType 在创建时即固定：要更改它们，需删除该关键词并新建一个。
apple_ads.create_keyword Update Keyword
修改单个关键词的出价或状态。更新时 Apple Ads 不接受其他任何内容，对已被删除的关键词会返回 404。
apple_ads.update_keyword Delete Keyword
软删除一个关键词。Apple Ads 会保留记录并停止对该词出价，父级 Ad Group 和广告系列不受影响。若只想暂时暂停该词，请改为把它的 status 更新为 PAUSED。
apple_ads.delete_keyword Bulk Create Keywords
在一次请求中创建多个关键词，可跨任意多个 Ad Group。整批只按一次调用计入速率限制，因此适合用它批量建立关键词列表。
apple_ads.bulk_create_keywords Bulk Update Keywords
在一次请求中修改多个关键词的出价或状态，例如为一批高效关键词重新定价，或暂停一批表现不佳的关键词。更新时 Apple Ads 不接受其他任何内容。
apple_ads.bulk_update_keywords Query Negative Keywords
以筛选、排序和偏移分页方式搜索某个广告账户的否定关键词。除按 id 筛选的查询外，Apple Ads 要求每个查询都带有 adGroupId 筛选条件：用 adGroupId IS_NULL 搭配 campaignId EQUALS 可列出广告系列 (campaign) 自身的排除项，用 adGroupId IS_NOT_NULL 搭配 campaignId EQUALS 可列出该广告系列下所有 Ad Group 层级的排除项，或用 adGroupId EQUALS 或 IN 将查询限定到特定 Ad Group。
apple_ads.query_negative_keywords Get Negative Keyword
按标识符读取一个否定关键词。无论记录是否处于已删除状态，Apple Ads 都会返回它；adGroupId 缺失或为 null 表示这是广告系列 (campaign) 层级的排除项。
apple_ads.get_negative_keyword Create Negative Keyword
创建一个否定关键词。作用范围二选一：只传 campaignId 则作用于广告系列，只传 adGroupId 则作用于单个 Ad Group；同时传两者或都不传，Apple Ads 会拒绝该载荷。text 和 matchType 在创建时即固定，要修改它们只能删除该记录并另建一条。
apple_ads.create_negative_keyword Update Negative Keyword
暂停或恢复单个否定关键词。status 是 Apple Ads 允许修改的唯一字段：PAUSED 让被排除的词重新进入竞价，ENABLED 恢复排除。对已删除的否定关键词发起请求时，Apple Ads 返回 404。
apple_ads.update_negative_keyword Delete Negative Keyword
软删除一个否定关键词。被排除的词会立即不再被屏蔽；对于广告系列级别的记录，该变化覆盖广告系列的每个 Ad Group。如果之后还需要恢复这条排除，请改用 update_negative_keyword 把 status 设为 PAUSED。
apple_ads.delete_negative_keyword Bulk Create Negative Keywords
在一次请求中创建多个否定关键词，可自由混合广告系列层级和 Ad Group 层级的排除。整批只按一次调用计入速率限制。每条结果都带有其所属载荷的从 0 开始的索引。
apple_ads.bulk_create_negative_keywords Bulk Update Negative Keywords
在一次请求中批量暂停或恢复多个否定关键词。status 是 Apple Ads 允许修改的唯一字段，每个 payload 都通过 id 标识其对应记录。每个结果都带有其所属 payload 的从 0 开始的索引。
apple_ads.bulk_update_negative_keywords Query Ads
以筛选、排序和偏移分页方式搜索某个广告账户的广告。用 adGroupId 筛选可限定到单个 Ad Group，用 campaignId 筛选则可覆盖整个广告系列 (campaign)。除非用 deleted EQUALS true 筛选条件请求，否则软删除的广告不会包含在内。
apple_ads.query_ads Get Ad
按标识符读取一条广告，包含 systemStatus、displayStatus 以及说明其未投放原因的 reason 数组。对被软删除的广告，Apple Ads 仍会返回，且 deleted 为 true。
apple_ads.get_ad Create Ad
创建一个广告，把已有的广告创意关联到某个 Ad Group。adGroupId 和 creativeId 在创建时即固定：要投放其他广告创意，请另建一个广告并删除当前这个。该广告创意的 systemStatus 必须为 VALID，且每个 Ad Group 同一时间只能有一个广告处于 ENABLED。
apple_ads.create_ad Update Ad
修改单个广告 (ad) 的名称或状态。它们是仅有的可变字段，adGroupId、creativeId、campaignId 和 adAccountId 在创建时即锁定。只有传入的字段会被更改。更新已被软删除的广告会返回 404。
apple_ads.update_ad Delete Ad
软删除一条广告。投放立即停止，查询结果中不再包含它，但 Apple Ads 会保留记录，读取时仍会返回。被引用的 ad creative 不受影响，仍可供其他广告使用。
apple_ads.delete_ad Query Creatives
以筛选、排序和偏移分页方式搜索某个广告账户的广告素材 (ad creative)。除非用 deleted EQUALS true 筛选条件请求，否则软删除的广告素材不会包含在内，而这也是删除后重新读取它的唯一方式。
apple_ads.query_creatives Get Creative
按标识符读取一个广告创意，包含其创意规格、落地目标、系统状态以及按广告位划分的投放资格。被软删除的广告创意会返回 404：请改用带 deleted 筛选条件的 query_creatives 读取。
apple_ads.get_creative Create Creative
在广告账户层级创建一个广告创意。它不与任何广告系列或 Ad Group 绑定，因此多个广告可以引用同一个创意。creativeType 和 destination 在创建时即固定。创建广告时把返回的标识符作为 creativeId 传入。
apple_ads.create_creative Update Creative
修改单个广告创意 (ad creative) 的名称或创意规格。它们是仅有的可变字段，creativeType 和 destination 在创建时即锁定。修改 creativeSpec 可能会让该广告创意退回 PENDING 重新审核，在它再次变为 VALID 之前，引用它的广告将停止投放。
apple_ads.update_creative Delete Creative
软删除一个 ad creative。该操作无法撤销，creative 也无法再用于新广告；已引用它的每条广告都会降为 systemStatus NOT_RUNNING，但不会被删除。删除已删除的 ad creative 会返回 404。
apple_ads.delete_creative Query Assets
搜索某个广告账户的创意素材 (creative asset)。结果中不包含软删除的素材和 variant crop；用 deleted 筛选可纳入软删除的素材，variant 则需用 get_asset 读取。用 promotedObjectId 筛选可将查询限定到单个 App 或品牌，因为不加筛选的查询会覆盖该广告账户中的所有推广对象。
apple_ads.query_assets Get Asset
按标识符读取一个创意素材 (creative asset)，包含其资格状态。无论素材是否处于已删除状态，Apple Ads 都会返回它；这也是读取 variant crop 的唯一方式，query_assets 不会返回这类素材。
apple_ads.get_asset Delete Asset
软删除一个 creative asset。只有通过 Apple Ads API 上传的 asset 才能删除；删除已删除的 asset 会以 404 失败；get_asset 仍会返回该记录，且 deleted 为 true。
apple_ads.delete_asset Query Product Pages
搜索某个广告账户可用的 App Store 产品页，涵盖默认产品页、自定义产品页以及产品页优化 (product page optimization) 变体。用 adamId 筛选以列出单个 App 的页面，因为不加筛选的查询会覆盖该广告账户可访问的所有 App。产品页来自 App Store Connect，会在短暂的同步延迟后出现在这里。
apple_ads.query_product_pages Get Product Page
按标识符读取一个 App Store 产品页。请先使用 query_product_pages 查找某个 App 的产品页标识符。
apple_ads.get_product_page Query Product Page Locale Details
读取一个自定义产品页的本地化内容：本地化的 App 名称、副标题、推广文案，以及按设备类型分组的截图和预览视频。必须带有对 productPageId 的筛选条件；不加 languageCode 筛选条件时，Apple Ads 会返回该页面配置的所有 locale。
apple_ads.query_product_page_locale_details Query App Locale Details
读取某个 App 默认产品页的本地化内容，由该 App 的 adamId 指定。除非用 languageCode 筛选条件缩小范围，否则会返回默认产品页配置的所有 locale。这里不涵盖自定义产品页 (custom product page)：那些请使用 query_product_page_locale_details。
apple_ads.query_app_locale_details Query Geo Locations
按标识符查询地理定向地点。传入你已有的地理位置 id 或以竖线分隔的 legacy id，Apple Ads 会返回它们在某一供给来源范围内的元数据和投放资格。可用它在把定向值应用到 Ad Group 之前批量校验；该端点不会过滤掉被软屏蔽的地理位置。
apple_ads.query_geo_locations Search Geo Locations
按名称搜索地理定向地点。用它查找可填入 Ad Group 的 country、adminArea、locality 或 postalCode 定向维度的地理位置 id。除非 eligible 为 true，否则软屏蔽的地理位置也会连同其资格数据一并返回。
apple_ads.search_geo_locations Query Locations
搜索广告主的营业地点，即 Apple Maps 广告系列 (campaign) 所推广的实体门店和场所。用 brandId 筛选可将结果限定到单个品牌，并可收集返回的 id 来构建 location group。
apple_ads.query_locations Get Location
按标识符读取一个营业地点 (business location)。在将某家门店加入 location group 之前，用它确认该门店的地址、坐标、运营状态和资格。
apple_ads.get_location Create Location Group
创建地点组 (location group)，即一组命名的广告主商家地点，可供 Ad Group 定向。brandId 和所属广告账户在创建时即固定：要把某个组移到其他品牌，需删除后重新创建。STATIC 组创建后立即可用，而 DYNAMIC 组会保持 PENDING，直到 Apple Ads 完成对其规则的评估。
apple_ads.create_location_group Query Location Groups
以筛选、排序和偏移分页方式搜索某个广告账户的 location group。除非用 deleted 筛选条件请求，否则软删除的分组不会包含在内。
apple_ads.query_location_groups Get Location Group
按标识符读取一个 location group，包含其成员定义、systemStatus、地点数量和资格。软删除的分组仍可读取，返回时 systemStatus 为 DELETED。
apple_ads.get_location_group Update Location Group
修改单个地点组 (location group) 的可变字段。只有传入的字段会被更改，但 locationIds 和 rules 会完全替换已存储的数组，而不是与之合并。修改 rules 会让 DYNAMIC 分组退回 PENDING，等待 Apple Ads 重新评估成员。systemStatus 为 INVALID 或 PENDING 的分组无法更新。
apple_ads.update_location_group Delete Location Group
软删除一个 location group。删除是永久的，无法恢复：定向该分组的 Ad Group 会立即失去这一约束，只有当它们还定向了另一个 location group 时才会继续投放。systemStatus 为 INVALID 或 PENDING 的分组无法删除。
apple_ads.delete_location_group Query Brands
以筛选、排序和偏移分页方式搜索某个广告账户可访问的品牌。品牌的 eligibility.status 必须达到 ELIGIBLE，Apple Maps 广告系列 (campaign) 才能推广它。
apple_ads.query_brands Get Brand
按标识符读取一个品牌 (brand)，包含其类别及当前的广告投放资格。
apple_ads.get_brand Query Business Categories
以筛选、排序和偏移分页方式搜索 Apple Maps 商户类别分类体系。只有 eligibility.status 为 ELIGIBLE 的类别才能被投放中的 Apple Maps 广告系列 (campaign) 使用。
apple_ads.query_business_categories Get Business Category
按 MUID 读取一个 Apple Maps 商户类目，包含其 qualifiedId 分类路径和投放资格状态。
apple_ads.get_business_category Query Brand Rejection Reasons
搜索用于说明 Apple Ads 为何拒绝某个品牌、其某个广告素材或其某个资产的政策关联 (policy assignment) 记录。用 promotedObjectId 筛选可将结果限定到单个品牌。
apple_ads.query_brand_rejection_reasons Query Budget Orders
以筛选、排序和偏移分页方式搜索某个广告账户的 Budget Order。除非用 deleted 筛选条件请求，否则软删除的 Budget Order 不会包含在内。
apple_ads.query_budget_orders Get Budget Order
按标识符读取一个 Budget Order，包含其金额、生效日期范围、所分配的广告账户以及发票详情。
apple_ads.get_budget_order Create Budget Order
为本次请求所指向的广告账户创建一个 Budget Order，然后把一组广告系列指派给它，从而限制这些广告系列的总花费。该广告账户必须使用 LOC (Line of Credit) 付款模式，因此必须提供发票信息。
apple_ads.create_budget_order Update Budget Order
修改单个 Budget Order 的可变字段。只有传入的字段会被更改。对已生效的 Budget Order，结束日期只能提前，不能延后；将 endTime 传为 null 会完全移除到期日期。
apple_ads.update_budget_order Delete Budget Order
软删除一个 Budget Order。只要还有广告系列 (campaign) 分配给该 Budget Order，Apple Ads 就会以 400 拒绝删除；Budget Order 一旦已开始、已过期、已用尽或已取消，同样会被拒绝。软删除后的 Budget Order 无法恢复，只能新建一个。
apple_ads.delete_budget_order Get Campaign Report
获取 App Store 广告系列 (campaign) 的投放效果，每个广告系列一行，指标在日期范围内聚合，并可按 granularity 和 dimension 拆分。每个 App Store 报告请求都必须带有对 campaignId 的筛选条件；缺少时，该操作会在请求到达 Apple Ads 之前将其拒绝。
apple_ads.get_campaign_report Get Ad Group Report
获取 App Store Ad Group 的投放效果，每个 Ad Group 一行，指标在日期范围内聚合，并可按 granularity 和 dimension 拆分。每个 App Store 报告请求都必须带有对 campaignId 的筛选条件；缺少时，该操作会在请求到达 Apple Ads 之前将其拒绝。再加上 adGroupId 筛选条件可进一步缩小报告范围。
apple_ads.get_ad_group_report Get Ad Report
获取 App Store 广告的投放效果，每条广告一行，指标在日期范围内聚合。每个 App Store 报告请求都必须带有对 campaignId 的筛选条件；缺少时，该操作会在请求到达 Apple Ads 之前将其拒绝。广告层级的报告不支持 HOURLY 粒度和人口属性维度。
apple_ads.get_ad_report Get Keyword Report
获取 App Store 关键词的投放效果，每个关键词一行，指标在日期范围内聚合，并可选返回出价建议。每个 App Store 报告请求都必须带有对 campaignId 的筛选条件；缺少时，该操作会在请求到达 Apple Ads 之前将其拒绝。再加上 adGroupId 筛选条件可将报告限定在单个 Ad Group 内。
apple_ads.get_keyword_report Get Search Term Report
获取匹配到某个关键词并产生展示的 App Store 搜索词，每个搜索词一行，并附带它匹配到的关键词。每个 App Store 报告请求都必须带有对 campaignId 的筛选条件；缺少时，该操作会在请求到达 Apple Ads 之前将其拒绝。为保护用户隐私，Apple Ads 会隐去或聚合低量搜索词。
apple_ads.get_search_term_report Get Brand Campaign Report
获取 Apple Maps 广告系列 (campaign) 的投放效果，每个广告系列一行，包含在日期范围内聚合的花费、互动和 Apple Maps 操作类指标。用 campaignId 筛选可将报告限定到特定广告系列。
apple_ads.get_brand_campaign_report Get Brand Ad Group Report
获取 Apple Maps Ad Group 的投放效果，每个 Ad Group 一行，包含在日期范围内聚合的花费、互动和 Apple Maps 操作类指标。用 campaignId 或 adGroupId 筛选可限定报告范围。
apple_ads.get_brand_ad_group_report Get Brand Ad Report
获取 Apple Maps 广告的投放效果，每条广告一行，包含其素材快照和在日期范围内聚合的指标。用 campaignId 或 adGroupId 筛选可限定报告范围。广告层级的报告不支持 HOURLY 粒度。
apple_ads.get_brand_ad_report Get Brand Keyword Report
获取 Apple Maps 关键词的投放效果，每个关键词一行，指标在日期范围内聚合，并可选返回出价建议。请始终用 campaignId 或 adGroupId 筛选，以免报告覆盖该广告账户中的所有关键词。
apple_ads.get_brand_keyword_report Get Brand Search Term Report
获取匹配到某个关键词并在 Search Results 广告位产生展示的 Apple Maps 搜索词，每个搜索词一行，并附带它匹配到的关键词。请始终用 campaignId 或 adGroupId 筛选。为保护用户隐私，Apple Ads 会隐去或聚合低量搜索词。
apple_ads.get_brand_search_term_report Query Impression Share
衡量某个 App Store App 在每个搜索词与国家或地区上，占据了可用展示量中的多少份额。Apple Maps 品牌广告系列没有对应的展示份额指标。
apple_ads.query_impression_share Query Search Term Popularity
在某个国家或地区及 genre 内按相对搜索量对 App Store 搜索词排名，用于发现值得定向的高搜索量词。
apple_ads.query_search_term_popularity Query Target Cpa Recommendations
列出 Apple Ads 为某个推广对象建议的目标 CPA 调整。只有采用 Maximize Conversions 出价策略的广告系列才会收到这类建议；目标 CPA 是自动出价器优化的目标，而不是出价。
apple_ads.query_target_cpa_recommendations Apply Target Cpa Recommendations
接受一条或多条目标 CPA 建议。Apple Ads 会更改广告系列 Maximize Conversions 竞价所优化的目标值，并将每条建议移至终态 APPLIED。
apple_ads.apply_target_cpa_recommendations Dismiss Target Cpa Recommendations
拒绝一条或多条目标 CPA 建议。广告系列 (campaign) 保持其当前的目标值，但每条建议都会进入终态 DISMISSED，不会再回到 AVAILABLE。
apple_ads.dismiss_target_cpa_recommendations Query Daily Budget Recommendations
列出 Apple Ads 为某个推广对象建议的每日预算提升方案，并附上每个方案背后的历史与预测表现。这是 Apple Maps 品牌广告系列唯一可用的推荐类型。
apple_ads.query_daily_budget_recommendations Apply Daily Budget Recommendations
接受一条或多条每日预算建议。Apple Ads 会提高相应广告系列 (campaign) 的每日预算，并将该建议移至终态 APPLIED。
apple_ads.apply_daily_budget_recommendations Dismiss Daily Budget Recommendations
拒绝一条或多条每日预算建议。各广告系列 (campaign) 保持其当前的每日预算，但建议会进入终态 DISMISSED，不会再回到 AVAILABLE。
apple_ads.dismiss_daily_budget_recommendations Query Keyword Suggestions
为某个推广对象发现值得定向的关键词，按相对热度排序。建议结果是无状态的：用 create_keyword 把某条建议变成正式投放的关键词。
apple_ads.query_keyword_suggestions Query Phrase Suggestions
为某个推广对象发现自然语言搜索短语，或查询已知短语的热度。只能二选一：SUGGESTION 需要推广对象，SEARCH 需要 phrases 或 phraseLike。
apple_ads.query_phrase_suggestions Query Category Suggestions
发现与某个推广对象相关的类别，或查询已知类别名称的热度。只能二选一：SUGGESTION 需要推广对象，SEARCH 需要 categories 或 categoryLike。
apple_ads.query_category_suggestions Query Target Cpa Suggestion
读取 Apple Ads 建议的目标 CPA，作为新建 Maximize Conversions 广告系列 (campaign) 的起点，它由该 App 过去 28 天的点击安装 CPI 计算得出。它仅适用于 App Store App，因此请求始终使用 promotedObjectType APPSTORE_APP。
apple_ads.query_target_cpa_suggestion Query Change History
搜索某个广告账户的变更历史，按事务、操作者和实体类型各返回一行，并附带该行涵盖的实体变更数量。必须带有对 eventTime 的筛选条件，且 Apple Ads 最多回溯 6 个月。汇总行不带 entityId，因此若打算用 get_change_history_detail 展开数据行，请将 metadata 设为 latest 或 snapshot：这样每行的 metas 条目中就会包含可直接使用的 detailId。
apple_ads.query_change_history Get Change History Detail
读取一次实体变更的字段级前后取值，通过复合 detailId 定位；当 metadata 为 latest 或 snapshot 时，query_change_history 会在每行的 metas 条目中返回该 detailId。
apple_ads.get_change_history_detail 没有匹配的工具。
常见问题
为什么 App Store 报表必须选择广告系列？
这些报表操作要求广告系列筛选条件。请提供广告账号、广告系列 ID 和日期范围，便于确定报告范围。
搜索词报表会显示每个查询词吗？
不会。Apple Ads 为保护隐私会隐藏或汇总低流量搜索词。助手应说明报表覆盖范围，不推测被省略的词。
查看建议会修改预算吗？
不会。查询与应用建议是不同操作。应用每日预算建议会提高广告系列预算，请明确提出修改要求。