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