appgallery-kit

Imported from rshu/VeriKit (skills/appgallery-kit/SKILL.md). Install upstream with npx skills add rshu/VeriKit --skill appgallery-kit. Copyright stays with the author.

功能说明

AppGallery Kit（应用市场服务）提供应用市场业务的对外开放能力，支持应用的下载、推荐和分发等场景以提高曝光度，同时为开发者提供便捷高效的数字商品服务接入流程和交互体验，助力商业变现。主要功能包括数字商品服务（IAP）、应用市场推荐、产品特性按需分发、生态查询服务、应用市场更新功能、应用归因服务、隐私管理服务、图标管理服务和应用评论服务等。

数字商品服务（IAP）是AppGallery Kit的核心功能之一，支持消耗型商品、非消耗型商品和订阅型商品三种类型。开发者可以通过AppGallery Connect或Server API配置数字商品，在应用中展示商品列表、处理购买流程和发放商品权益。IAP提供了完整的购买生命周期管理，包括订单查询、消耗确认、订阅续费管理和沙箱测试环境。

产品特性按需分发能力允许开发者将应用的某些功能模块配置为按需加载，在用户需要时才下载和安装对应模块，减小应用初始安装体积。支持ArkTS和C/C++两种开发语言，并提供了模块加载状态管理、卸载和重新加载等完整能力。

应用归因服务帮助开发者追踪和分析应用的用户来源，支持标准转化事件和自定义转化事件的登记，提供归因策略管理和归因结果回传能力。此外，AppGallery Kit还提供了应用市场推荐（展示精选应用）、应用市场更新功能（检测和提示应用更新）、生态查询服务（查询应用在生态中的场景值）、隐私管理服务（管理用户隐私设置）、应用评论服务、应用图标动态切换等辅助能力。

使用场景

当开发者需要在应用中实现内购和数字商品销售时，应使用AppGallery Kit的数字商品服务。如果你需要销售消耗型商品（如游戏币、道具）、非消耗型商品（如去广告、解锁功能）或订阅型商品（如会员、定期服务），AppGallery Kit提供了完整的商品配置、展示、购买和权益发放流程。

当开发者需要优化应用安装体积或实现功能模块的按需加载时，应使用AppGallery Kit的产品特性按需分发能力。如果你的应用包含部分用户可能不需要的大体积功能模块，可以将其配置为按需加载模块，在用户使用时才下载安装。

当开发者需要分析应用的用户来源和转化效果时，应使用AppGallery Kit的应用归因服务。如果你需要追踪用户从哪个渠道（广告、推荐、分享等）安装了应用，或者需要记录和分析用户的转化行为，归因服务提供了完整的事件登记和结果回传能力。

典型场景

• 如何接入数字商品服务实现消耗型、非消耗型和订阅型商品的内购功能
• 如何通过AppGallery Connect或Server API配置数字商品
• 如何实现购买数字商品的完整流程并发放商品权益
• 如何使用沙箱环境测试数字商品服务
• 如何实现产品特性按需分发以减小应用初始安装体积
• 如何接入应用归因服务追踪用户来源和转化效果
• 如何实现应用市场推荐、应用更新检测、应用评论等辅助功能
• 如何动态切换应用图标（节日主题、会员特权等场景）
• 如何排查按需加载模块失败、归因接口报错、更新功能异常等常见问题

使用指南

重要提示： 本Kit的references目录下包含大量详细参考文档。在查询时，请根据用户的具体问题，仅加载references中与问题相关的MD文件进行阅读，不要一次性加载所有文件，以免上下文过长影响回答质量。先通过标题和描述判断哪些文件与当前问题相关，再针对性地读取。

参考文档

Kit简介

• [AppGallery Kit简介](references/AppGallery Kit简介.md) - 介绍AppGallery Kit的完整功能服务列表、支持设备范围和约束限制，帮助开发者了解应用市场服务的整体架构

数字商品服务

• 数字商品介绍 - 介绍数字商品的概念、三种类型（消耗型、非消耗型、订阅型）的定义和适用场景
• 开通相关服务和配置参数 - 详细说明开通数字商品服务所需的步骤和各项参数配置方法，包括开发者账号设置和支付配置
• 配置应用 - 介绍在应用中配置数字商品服务的方法，包括SDK集成和初始化参数设置
• [通过AppGallery Connect配置数字商品](references/通过AppGallery Connect配置数字商品.md) - 说明如何通过AppGallery Connect控制台创建和管理数字商品，包括商品定价、描述和状态管理
• [通过Server API配置数字商品](references/通过Server API配置数字商品.md) - 介绍如何通过服务端API批量创建和管理数字商品，适用于大规模商品管理的自动化场景
• 展示数字商品 - 说明如何在应用中展示数字商品列表，包括商品信息获取和UI展示的最佳实践
• 购买数字商品 - 详细说明数字商品购买的完整开发流程，包括发起购买、处理支付结果和异常情况处理
• 发放数字商品权益 - 介绍购买成功后如何发放数字商品权益，包括服务端验证、权益到账和防重复发放策略
• 测试数字商品服务 - 说明数字商品服务的沙箱测试方法，帮助开发者在正式上线前完成功能验证和兼容性测试
• 概述 - 数字商品服务的总体概述，包括架构设计和核心流程说明

产品特性按需分发

• 产品特性按需分发(ArkTS) - 介绍使用ArkTS语言实现产品特性按需分发的完整开发流程，包括模块配置、加载请求和状态监听
• 产品特性按需分发(C/C++) - 介绍使用C/C++语言实现产品特性按需分发的完整开发流程，适用于Native模块的按需加载场景

应用归因服务

• 开发概述 - 应用归因服务的开发概述，介绍归因服务的设计理念和核心概念
• 接入流程 - 详细说明应用归因服务的完整接入流程，从注册企业账号到完成归因数据回传的全链路步骤
• 注册企业账号 - 说明如何注册华为开发者企业账号，满足应用归因服务的企业认证要求
• 概述 - 归因服务的功能概述，包括归因场景、数据模型和核心能力说明
• 接入调试功能 - 介绍如何接入归因服务的调试功能，帮助开发者在开发阶段验证归因数据的正确性
• 标准化事件及应用归因签名 - 说明标准化事件的定义和归因签名的生成方法，确保归因数据的安全性和完整性
• 标准转化事件 - 介绍系统预定义的标准转化事件类型，包括注册、登录、购买等常用事件的定义和使用
• 自定义转化事件 - 说明如何创建和使用自定义转化事件，满足特定业务场景的归因需求
• 管理归因角色 - 介绍归因角色（广告主、渠道方等）的管理方法，包括角色创建、权限分配和协作配置
• 管理归因策略 - 说明归因策略的配置和管理方法，包括归因窗口、匹配规则和优先级设置
• 登记归因来源及转化 - 详细说明如何登记归因来源信息和转化事件，实现从用户点击到应用安装的完整归因链路
• 归因结果回传 - 介绍归因结果的回传方法和接口调用，将归因分析结果同步到广告平台或数据分析系统
• 场景值 - 说明归因服务中各场景值的含义和用途，帮助开发者理解不同安装来源的场景分类

其他服务

• 应用市场推荐 - 介绍应用市场推荐服务的接入方法，在应用中展示精选应用推荐以提升应用发现率
• 应用市场更新功能 - 说明如何集成应用市场更新功能，检测新版本并引导用户完成应用更新
• 生态查询服务 - 介绍生态查询服务的使用方法，查询应用在华为生态中的场景值和分发状态信息
• 隐私管理服务 - 说明隐私管理服务的接入方法，帮助应用管理用户隐私设置和数据授权
• 应用评论服务 - 介绍应用评论服务的使用方法，支持用户在应用内直接提交评价和评论
• 实现应用图标动态切换 - 说明如何在应用中实现动态切换应用图标的功能，适用于节日主题、会员特权等场景
• [通过AppGallery Connect动态管理应用图标](references/通过AppGallery Connect动态管理应用图标.md) - 介绍如何通过AppGallery Connect控制台远程管理应用的动态图标配置
• 支持的国家/地区 - 列出AppGallery Kit各项服务支持的国家和地区，帮助开发者了解服务的地域覆盖范围

数字商品常见问题

• 数字商品服务器支持证书 - 说明数字商品服务端支持的SSL证书类型和配置要求
• 数字商品服务器支持加密套件 - 列出数字商品服务端支持的加密套件列表，指导服务端安全通信配置
• 数字商品服务中订单订购状态有哪些？ - 详细说明数字商品订单的所有可能状态（已支付、已发货、已取消、已退款等）及其含义
• 是否能在删除商品后添加具有相同productId的商品？ - 解答删除数字商品后productId是否可以复用的问题和相关规则说明
• 签名校验是否可以都在服务端执行？ - 说明签名校验的执行位置选择建议和安全性最佳实践
• 是否必须使用SHA256的证书才能通过验签？ - 解答签名证书算法选择的问题，说明支持的证书类型和验签要求
• 支付界面是否仅有一种UI设计？是否存在其他支付界面方案？ - 说明数字商品支付界面的UI设计方案和自定义能力
• 订阅商品的续费周期规则是什么？ - 详细说明订阅型商品的自动续费周期规则，包括续费时间和扣费逻辑
• 订阅时长按照自然月计算时，2月份是28天还是29天？ - 解答自然月订阅时长在不同月份天数差异下的计算规则
• 订阅型商品中的续费周期1个月是指30天、31天还是自然月？同理，2个月、3个月具体包含多少天数？ - 详细说明订阅续费周期的天数计算规则，涵盖各月份和多月订阅的精确计算方式
• [AppGallery Connect商品管理页面中，价格展示是否做了数字调整？比如小数点第二位6/9等调整？](references/AppGallery Connect商品管理页面中，价格展示是否做了数字调整？比如小数点第二位6_9等调整？.md) - 解答商品价格在展示时是否存在自动数字调整（如四舍五入）的问题
• [AppGallery Connect商品管理页面，商品价格编辑界面的默认价格表示什么意思？](references/AppGallery Connect商品管理页面，商品价格编辑界面的默认价格表示什么意思？.md) - 说明商品价格编辑界面中默认价格的含义和计算逻辑
• [在AppGallery Connect中单独修改商品在某个地区的价格，以后汇率变动，是否会影响应用内的商品价格？](references/在AppGallery Connect中单独修改商品在某个地区的价格，以后汇率变动，是否会影响应用内的商品价格？.md) - 解答单独修改地区价格后汇率变动对商品价格的影响规则
• [AppGallery Connect获取的IAP公钥最大长度是多少？便于用户存储设置的最大长度是多少？](references/AppGallery Connect获取的IAP公钥最大长度是多少？便于用户存储设置的最大长度是多少？.md) - 说明IAP公钥的长度限制，指导开发者在存储时预留足够的缓冲空间
• [AppGallery Connect中可以配置多个订阅关键事件回调地址吗？](references/AppGallery Connect中可以配置多个订阅关键事件回调地址吗？.md) - 解答是否支持配置多个订阅事件回调地址以及相关配置规则

按需分发常见问题

• 按需加载模块是否支持单独上架应用市场或单独更新？ - 解答按需加载模块的独立发布和更新规则
• 按需加载场景中，用户在加载指定模块后是否可以卸载，然后重新发起请求？ - 说明按需加载模块的卸载和重新加载机制
• 按需加载场景中，是否支持同时存在多个任务？ - 解答按需加载是否支持多任务并发执行的限制说明
• 按需加载场景中，是否支持依赖模块同步加载? - 说明按需加载模块之间的依赖关系和同步加载策略
• 按需加载场景中，应用在加载指定模块后重启，还是已加载状态吗？是否需要重新发起按需加载请求？ - 解答应用重启后已加载模块的状态保持机制
• 按需加载场景中加载动态模块失败 - 排查按需加载动态模块失败的常见原因和解决方案
• 未上架应用市场的应用，如何快速接入调试产品特性按需分发功能？ - 说明未上架应用如何进行按需分发功能的本地调试和验证

归因与其他常见问题

• 调用应用归因服务登记归因来源接口报错身份检查错误 - 排查归因接口身份检查错误的常见原因，包括账号认证和签名配置问题
• 生态查询服务场景中获取自身场景值为空 - 排查生态查询服务返回场景值为空的问题，包括服务配置和查询参数的检查方法
• 应用市场更新功能抛出不在前台异常 - 解决调用应用市场更新功能时抛出应用不在前台异常的问题
• 应用市场推荐展示元服务卡片异常 - 排查应用市场推荐功能展示元服务卡片时出现异常的问题
• 应用内快捷方式加桌返回401错误码 - 排查应用内快捷方式添加到桌面时返回401错误码的原因和解决方案
• 如何过滤应用归因服务的日志？ - 说明如何通过日志标签过滤应用归因服务的调试日志，便于问题定位和分析
• 如何过滤应用内快捷方式加桌的日志？ - 说明如何过滤应用内快捷方式添加到桌面功能的调试日志
• 向用户显示应用更新提示弹框文案能否自定义？ - 解答应用更新提示弹框文案是否支持自定义以及自定义方法

References / 参考文档索引

Auto-generated by VeriKit from this Kit's reference manifest — 63 document(s) shipped under references/. Each link points at a real file in the plugin tree; load any with the agent's file-read tool.

• AppGallery Connect中可以配置多个订阅关键事件回调地址吗？ — 不可以。 references/AppGallery Connect中可以配置多个订阅关键事件回调地址吗？.md
• AppGallery Connect商品管理页面中，价格展示是否做了数字调整？比如小数点第二位6/9等调整？ — 做了调整，具体调整规则请参见 换算规则描述 。 references/AppGallery Connect商品管理页面中，价格展示是否做了数字调整？比如小数点第二位6_9等调整？.md
• AppGallery Connect商品管理页面，商品价格编辑界面的默认价格表示什么意思？ — 该默认价格在 AppGallery Connect 页面其他地方涉及商品价格展示时使用。 references/AppGallery Connect商品管理页面，商品价格编辑界面的默认价格表示什么意思？.md
• AppGallery Connect获取的IAP公钥最大长度是多少？便于用户存储设置的最大长度是多少？ — 长度是随密钥规格而定的，不是固定长度。后续会升级到3072位或更长，建议在数据库中使用text类型存储。 references/AppGallery Connect获取的IAP公钥最大长度是多少？便于用户存储设置的最大长度是多少？.md
• AppGallery Kit简介 — AppGallery Kit（应用市场服务）提供应用市场业务的对外开放能力，可以更好地支持应用的下载、推荐和分发等场景以提高在应用市场上的曝光度，以及为开发者提供便捷高效的数字商品服务的接入流程和交互体验，助力开发者商业变现。 使用AppGallery Kit为您的应用和应用内数字商品提供以下功能和服务： 数字商品服务 ：指华为为开发者的数字商品的管… references/AppGallery Kit简介.md
• 产品特性按需分发(ArkTS) — 随着HarmonyOS应用的持续发展，应用的功能将越来越丰富，实际上80%的用户使用时长都会集中在20%的特性上，其余的功能可能也仅仅是面向部分用户。为了避免用户首次下载应用耗时过长，及过多占用用户空间，应用市场服务提供按需分发的能力，支持用户按需动态下载自己所需的增强特性。 #### 基本概念 按需分发：一个应用程序被打包成多个安装包，安装包包含了所有的应… references/产品特性按需分发(ArkTS).md
• 产品特性按需分发(C/C++) — 随着HarmonyOS应用的持续发展，应用的功能将越来越丰富，实际上80%的用户使用时长都会集中在20%的特性上，其余的功能可能也仅仅是面向部分用户。为了避免用户首次下载应用耗时过长，及过多占用用户空间，应用市场服务提供按需分发的能力，支持用户按需动态下载自己所需的增强特性。 #### 基本概念 按需分发：一个应用程序被打包成多个安装包，安装包包含了所有的应… references/产品特性按需分发(C_C++).md
• 发放数字商品权益 — - 消耗型商品 若应用提供消耗型商品，需要按照 确保权益发放处理 消耗型商品的权益发放。 - 非消耗型商品 若应用提供非消耗型商品，且为单机应用，则需要按照 单机应用权益发放 （非消耗型商品）处理非消耗型商品的权益发放。其他场景建议按照消耗型/非消耗型商品的 确保权益发放处理 。 - 自动续期订阅商品 若应用为非单机应用，则建议按照 确保权益发放处理 自动续… references/发放数字商品权益.md
• 向用户显示应用更新提示弹框文案能否自定义？ — 可以，弹框文案详细信息由用户配置，具体请参考 配置本地化基础信息 中的新版本特性。 references/向用户显示应用更新提示弹框文案能否自定义？.md
• 在AppGallery Connect中单独修改商品在某个地区的价格，以后汇率变动，是否会影响应用内的商品价格？ — 不会，除非开发者自己修改，修改方法请参考 修改数字商品 。 references/在AppGallery Connect中单独修改商品在某个地区的价格，以后汇率变动，是否会影响应用内的商品价格？.md
• 场景值 — 元服务的场景值用来描述用户进入元服务的路径。您可以遵循此场景值规则来实现进入元服务场景的归因功能。 完整场景值的含义请查看 场景值列表 。 #### 场景值列表 各场景值ID和场景说明的对应关系如下表所示。 如果需要查看场景值对应的场景图例，请点击下表中“图例”列的缩略图查看。 references/场景值.md
• 如何过滤应用内快捷方式加桌的日志？ — 解决措施 过滤关键词：AppGalleryKit|ShortcutManager references/如何过滤应用内快捷方式加桌的日志？.md
• 如何过滤应用归因服务的日志？ — 解决措施 过滤关键词：Attr-。 references/如何过滤应用归因服务的日志？.md
• 实现应用图标动态切换 — AppGallery Kit为使用动态图标的应用客户端提供查询动态图标信息、切换动态图标、恢复默认图标功能。 从版本5.0.3(15)开始，支持实现应用图标动态切换。 #### 场景介绍 - 查询动态图标信息 应用内查询可选的动态图标信息。 - 切换动态图标 用户点击切换可选的动态图标，系统切换对应的动态图标。 - 恢复默认图标 用于停止已选择的动态图标，系… references/实现应用图标动态切换.md
• 展示数字商品 — 数字商品服务为接入消耗型/非消耗型、非续期订阅商品、自动续期订阅商品购买能力的应用提供向用户展示可供购买的商品信息列表的能力。 #### 前提条件 当前登录的华为账号所在服务地支持数字商品服务。 #### 开发步骤 1. 判断当前登录的华为账号所在的服务地是否支持数字商品服务应用内支付。 在使用应用内支付之前，应用需要向IAP Kit发送 queryEnvi… references/展示数字商品.md
• 应用内快捷方式加桌返回401错误码 — 问题现象 调用应用内快捷方式接口加桌时，返回401错误码，参数错误。 可能原因 1. checkPinShortcutPermitted 校验快捷方式是否允许加桌接口： - 上下文context为空。 - 快捷方式shortcutId长度超过63字节。 - 快捷方式目标want中参数parameters非基本字符串类型或键值长度超过1024个… references/应用内快捷方式加桌返回401错误码.md
• 应用市场推荐 — - 元服务卡片加桌 您可调用应用市场服务提供的元服务加桌 loadService 接口，加载元服务卡片加桌页面，用户点击“添加至桌面”按钮，将元服务卡片添加至桌面。 - 应用详情页展示 1. 您可调用应用市场服务提供的loadProduct接口，直接加载应用市场的应用详情页面，用户可以在页面内点击“安装”按钮完成应用的下载安装； 2. 您可使用Deep Li… references/应用市场推荐.md
• 应用市场推荐展示元服务卡片异常 — 问题现象 调用展示元服务卡片详情页接口，显示异常页面。 解决措施 1. 确认元服务卡片是否已上架到应用市场。 2. uri链接是否在有效期内。 references/应用市场推荐展示元服务卡片异常.md
• 应用市场更新功能 — 应用市场更新功能为已上架应用提供版本检测、显示更新提醒能力。开发者使用应用市场更新功能可以在应用内提醒用户及时更新到最新版本。 #### 场景介绍 当应用启动完成或用户在应用中主动检查应用新版本时，开发者可以通过本服务，来查询应用是否有可更新的版本。如果存在可更新版本，您可以通过本服务为用户显示更新提醒。 #### 业务流程 1. 应用调用检查更新接口。 2… references/应用市场更新功能.md
• 应用市场更新功能抛出不在前台异常 — 问题现象 调用应用市场更新功能相关API时，提示应用不在前台异常。 解决措施 应用市场更新功能API要求应用必须在前台时进行调用，请在应用处于前台时调用相关接口。 references/应用市场更新功能抛出不在前台异常.md
• 应用评论服务 — 通过应用评论服务，用户无需进入应用市场应用详情页，可以直接在应用内进行评论。 从版本6.0.0(20)开始，支持拉起应用评论弹框。 #### 场景介绍 - 拉起应用评论弹框 开发者可以通过该接口拉起应用评论弹窗对应用进行评分及评论，无需进入应用市场应用详情页进行评论。 #### 业务流程 1. 用户需要在应用内评论应用。 2. 应用调用showComment… references/应用评论服务.md
• 开发概述 — 应用归因服务是华为提供的不依赖用户标识符的端侧归因能力。 当用户完成应用安装或在已安装应用内完成转化时，应用归因服务通过匹配用户在转化前的行为数据，分析用户的来源渠道以及转化的原因，并将归因结果回传给分发平台、开发者、归因监测平台。开发者可以通过归因结果数据分析投放效果、评估渠道质量，进而优化投放策略，分发平台可以评估渠道商业价值，优化营销效果。 #### … references/开发概述.md
• 开通相关服务和配置参数 — 请先参考“ 应用开发准备 ”完成基本准备工作及指纹配置，再继续进行以下开发活动。 配置签名信息 时，请使用手动签名方式。 接入数字商品服务，需要 添加公钥指纹 。 #### 开通商户服务 开发者需开通商户服务才能使用华为数字商品服务，具体请登录 华为开发者联盟官网 ，点击“管理中心”>“开发者中心”>“商户服务”进入商户服务页面。 商户服务里配置的银行卡账号… references/开通相关服务和配置参数.md
• 归因结果回传 — 应用归因将满足隐私要求的归因结果，回传给开发者、获胜的分发平台以及分发平台配置的归因监测平台。归因结果回传详细信息请参考 归因结果回传 。分发平台/开发者/归因监测平台需按照回传接口的要求完成相应的接口实现。 归因结果回传地址为注册归因角色时维护的链接地址。 为保证信息合法性，分发平台/开发者/归因监测平台需要对回传的归因结果进行验签（验签算法：SHA256… references/归因结果回传.md
• 按需加载场景中加载动态模块失败 — 问题现象 调用加载接口时加载模块失败。 解决措施 支持按需加载的应用需要先上架到应用市场，然后从应用市场下载应用包。应用包安装后才能在应用中调用动态下载接口。开发者通过本地DevEco Studio编译的示例包无法直接调用下载接口。 references/按需加载场景中加载动态模块失败.md
• 按需加载场景中，应用在加载指定模块后重启，还是已加载状态吗？是否需要重新发起按需加载请求？ — 在这种情况下，无需重新发起按需加载请求。产品特性按需分发服务分为两部分：按需加载安装和动态引入模块。只要已经下载安装了应用，就完成了按需下载安装。动态引入是运行时，即应用运行状态下去查找指定模块。 references/按需加载场景中，应用在加载指定模块后重启，还是已加载状态吗？是否需要重新发起按需加载请求？.md
• 按需加载场景中，是否支持依赖模块同步加载? — 支持，如果模块A依赖模块B，按需加载模块A时也会同步加载模块B。 references/按需加载场景中，是否支持依赖模块同步加载_.md
• 按需加载场景中，是否支持同时存在多个任务？ — 不支持，同一应用同时只能存在一个按需分发任务。 解决措施 1. fetchModules接口支持多个模块同时下载安装，可以将多个任务合并为一个任务。 2. 通过on接口监听上一个任务的下载安装状态，安装成功后即可发起下一个任务。 references/按需加载场景中，是否支持同时存在多个任务？.md
• 按需加载场景中，用户在加载指定模块后是否可以卸载，然后重新发起请求？ — 可以卸载指定模块后重新调用 fetchModules 接口发起按需加载请求。 使用hdc指令卸载指定应用的指定模块后重新发起请求，卸载命令请参考：hdc shell bm uninstall -n com.xxxx.instantdownloaddemo -m modulelibName。 references/按需加载场景中，用户在加载指定模块后是否可以卸载，然后重新发起请求？.md
• 按需加载模块是否支持单独上架应用市场或单独更新？ — 不支持，上架是整个.app包，包括基础包和功能包。 references/按需加载模块是否支持单独上架应用市场或单独更新？.md
• 接入流程 — 1. 启用数字商品服务 请先参考“ 应用开发准备 ”完成基本准备工作及指纹配置，再继续进行后续开发活动。在启动开发之前，需先 启用数字商品服务 ，打开相关服务API开关和配置服务参数，才能对数字商品相关的API进行调用。 2. 配置数字商品 开发者需要提前录入商品信息（包括商品ID、商品类型、不同国家的商品价格、商品名称等），在客户端调用购买… references/接入流程.md
• 接入调试功能 — 应用归因服务为开发者提供接入调试能力，支持开发者在接入过程中进行自助调试，通过调用调试接口验证接入的准确性及归因结果回传等基础能力，从而提升接入效率。 #### 场景介绍 应用归因服务接入调试功能支持的场景如下： - 校验接口调用是否准确 调用调试接口，校验接口请求及业务逻辑，如参数校验、签名校验等，并提示相应错误码，支持开发者自行发现问题。 - 主动触发归… references/接入调试功能.md
• 支付界面是否仅有一种UI设计？是否存在其他支付界面方案？ — 是的，当前支付功能仅提供单一UI界面设计方案。 references/支付界面是否仅有一种UI设计？是否存在其他支付界面方案？.md
• 支持的国家/地区 — - 手机、平板、2in1、车机、智慧屏仅支持中国境内（香港特别行政区、澳门特别行政区、中国台湾除外）。 - 智能穿戴设备支持以下国家/地区。 references/支持的国家_地区.md
• 数字商品介绍 — 数字商品服务为接入应用内购买的应用提供了 展示数字商品 、 购买数字商品 、 发放数字商品权益 的功能。 #### 数字商品类型介绍 #### 数字商品购买场景 在应用购买场景中，用户会以一次性付款方式购买消耗型商品或非消耗型商品。请结合实际业务场景选择对应的商品类型。 订阅是指用户在购买自动续期订阅商品后，可以在一段时间访问应用的增值功能或内容，并且会在订… references/数字商品介绍.md
• 数字商品服务中订单订购状态有哪些？ — 1. 订阅型商品的订阅状态，请查看 订阅状态（status） 。 2. 消耗型/非消耗型商品，请查看 发货状态（finishStatus）和是否撤销的状态（purchaseOrderRevocationReasonCode） 。 references/数字商品服务中订单订购状态有哪些？.md
• 数字商品服务器支持加密套件 — 具体见 加密套件 。 references/数字商品服务器支持加密套件.md
• 数字商品服务器支持证书 — 数字商品服务器内置了如下92个证书，请检查开发者证书链，确保证书链的完整性，同时确保证书链中的证书在数字商品服务器支持证书表格中。 references/数字商品服务器支持证书.md
• 是否必须使用SHA256的证书才能通过验签？ — 是的，现在华为开发者联盟上要求配置的就是SHA256指纹，具体请参考 配置公钥指纹 。 references/是否必须使用SHA256的证书才能通过验签？.md
• 是否能在删除商品后添加具有相同productId的商品？ — 不支持。同一个productId只能使用一次。 references/是否能在删除商品后添加具有相同productId的商品？.md
• 未上架应用市场的应用，如何快速接入调试产品特性按需分发功能？ — 推荐使用 邀请测试 。 references/未上架应用市场的应用，如何快速接入调试产品特性按需分发功能？.md
• 标准化事件及应用归因签名 — #### 归因来源签名计算规则 1.按照如下规则（字段顺序及分隔符）拼接待签名的字符串： adTechId+ '\u2063' + campaignId+ '\u2063' + destinationId+ '\u2063' + serviceTag+ '\u2063' + mmpIdStr + '\u2063' + nonce + '\u2063' + t… references/标准化事件及应用归因签名.md
• 标准转化事件 — 接入应用归因服务前，请先明确转化事件。应用归因支持标准转化事件和自定义转化事件，建议开发者优先选用标准转化事件登记上报。若无法满足业务需求，开发者可自行创建 自定义转化事件 用于后续的归因服务。 处于生效状态的开发者角色的合作伙伴在转化事件管理页面可以查看标准转化事件和自定义转化事件： 点击左侧“转化事件管理”菜单，点击页面中“标准转化事件”。 查看… references/标准转化事件.md
• 概述 — 数字商品服务为开发者提供便捷高效的数字商品服务接入流程和交互体验，让开发者聚焦应用本身的业务能力，助力开发者商业变现。数字商品服务提供基础的数字商品交易能力，保障用户交易的完成，并对应用内的数字商品交易能力可用性、商品价值和商品质量进行审核。本服务能帮助开发者实现统一的数字商品分发体验和营销宣传（包括在应用内的商品展示和销售，以及在应用市场内的商品分发等）、… references/概述.md
• 注册企业账号 — 在注册归因角色前，需要在华为开发者联盟网站上 注册成为开发者 ，并完成 企业开发者实名认证 。 references/注册企业账号.md
• 测试数字商品服务 — 沙盒测试允许开发者在接入数字商品服务的调测过程中无需真实付款即可完成数字商品的购买等相关测试。 沙盒订单并非真实订单，无法在[开发者中心]->[我的报表]->[支付报表]中查询。 #### 配置沙盒测试 - 设置测试账号 在进行测试前，需要在 AppGallery Connect 中的“用户与访问”中添加测试账号，这些测试账号都是真实的华为账号。开发者在Ha… references/测试数字商品服务.md
• 生态查询服务 — 生态查询服务可以为您提供应用/元服务运行信息的查询，当前提供场景值查询和广告验签信息查询。场景值是用来描述用户进入应用和元服务的路径。您可以通过本服务，来查询您的元服务/应用是通过何种场景被打开的（ 场景值列表 ）。当前我们支持元服务的场景值查询，后续我们会继续公布应用场景值的查询。广告验签版本查询只在您的应用涉及广告场景下才会被使用到。您可以通过本查询服务… references/生态查询服务.md
• 生态查询服务场景中获取自身场景值为空 — 问题现象 调用查询自身场景值接口返回场景值为空。 解决措施 当前应用/元服务没有生成场景值，通过其他应用或者元服务拉起当前应用或者元服务可以产生场景值，然后查询场景值。 references/生态查询服务场景中获取自身场景值为空.md
• 登记归因来源及转化 — 6.0.2(22)版本开始，登记归因转化接口新增属性timestamp、serviceTag，支持设置转化事件时间及开发者关注的业务信息。 #### 场景介绍 应用归因服务为媒体App、分发平台提供向端侧应用归因服务登记归因来源（即应用曝光点击事件）、开发者应用登记转化事件的能力。 端侧应用归因服务根据媒体应用登记的归因来源，以及开发者应用登记的转化事件，按… references/登记归因来源及转化.md
• 签名校验是否可以都在服务端执行？ — 若开发者有架设服务器，建议在服务器执行签名校验。 references/签名校验是否可以都在服务端执行？.md
• 管理归因策略 — 通过归因策略管理，支持开发者在应用归因云端管理台维护可归因的分发平台及归因优先级、归因窗口期、归因节点设置，从而提升归因能力拓展性，适配开发者多样化归因诉求。 开发者角色的合作伙伴在归因策略管理页面可以做如下操作 ： 新增、编辑、查看、删除归因策略，创建完成即可生效（生效时间24小时）。 点击左侧归因策略管理菜单栏，进入归因策略管理页面，开发者基于推… references/管理归因策略.md
• 管理归因角色 — 应用生态伙伴通过应用归因服务云端管理台注册归因角色及配置信息，包括：角色、名称、回传地址（用于接收归因结果回传的URL）、公钥。注册成功后平台生成归因角色ID。 注册归因角色前需生成用于签名/验签的密钥对。 #### 开通权限 注册归因角色前，需开通应用市场服务权限。当前功能为定向邀请功能，如果您有意向请通过客服邮箱 **developer@huawei.c… references/管理归因角色.md
• 自定义转化事件 — 开发者角色的合作伙伴在转化事件管理页面可以做如下操作 ： 新增、修改、删除、查看自定义转化事件。 新增、修改、删除自定义转化事件时，相应的操作会被运营人员在后台审核通过或驳回，仅被审核通过的自定义转化事件才能生效。 #### 新增 1. 在左侧点击转化事件管理菜单栏，进入自定义转化事件页面。 2. 点击右上角“新增”按钮，进入新增自定义转化事件页面。… references/自定义转化事件.md
• 订阅商品的续费周期规则是什么？ — 当前支持的续费周期为1周、1个月、2个月、3个月、6个月、1年、30天（上次订阅日期+30天）、31天（上次订阅日期+31天），具体配置方法请参考 配置自动续期订阅商品 。 references/订阅商品的续费周期规则是什么？.md
• 订阅型商品中的续费周期1个月是指30天、31天还是自然月？同理，2个月、3个月具体包含多少天数？ — 按照自然月计算。 references/订阅型商品中的续费周期1个月是指30天、31天还是自然月？同理，2个月、3个月具体包含多少天数？.md
• 订阅时长按照自然月计算时，2月份是28天还是29天？ — 根据订阅日期决定。例如：当月第N日订阅，下个月的第N日续期。如果这个N在下个月不存在，那就在下个月的最后一日续期，下下个月恢复第N日续期。 references/订阅时长按照自然月计算时，2月份是28天还是29天？.md
• 调用应用归因服务登记归因来源接口报错身份检查错误 — 问题现象 媒体调用登记归因来源接口返回1009300003错误码，身份检查错误。 解决措施 1. 需要将应用通过应用市场上架。 2. 在应用归因云侧注册应用生态伙伴信息。 3. 开发者下配置应用id列表。 references/调用应用归因服务登记归因来源接口报错身份检查错误.md
• 购买数字商品 — 在应用内数字商品的购买场景中，用户会以一次性付款的方式购买消耗型商品或非消耗型商品。 订阅是指用户在购买自动续期订阅商品后，可以在一段时间访问应用的增值功能或内容，并且会在订阅周期结束后自动续期购买下一期服务的能力。如果期间用户取消订阅，则订阅在当期结束后将不再自动续期。 接入数字商品服务购买能力前，您需在华为 AppGallery Connect 网站 配… references/购买数字商品.md
• 通过AppGallery Connect动态管理应用图标 — 通过图标管理服务，开发者可以在不升级应用版本的情况下，通过AGC页面动态管理应用的个性化图标，并在应用侧实现应用图标动态切换。 #### 申请开通服务 使用图标管理服务之前，请按如下格式向华为运营人员发送邮件申请开通服务。申请审核时间为1-3个工作日，审核结果请关注邮件信息或 互动中心 通知。 - 请确保申请开通图标管理服务的应用处于正式上架状态，避免服务开… references/通过AppGallery Connect动态管理应用图标.md
• 通过AppGallery Connect配置数字商品 — 您可以通过华为数字商品管理系统将您的数字商品信息托管在华为侧，方便您的商品价格国际化管理，助力您的应用进行全球化推广。开发者需要在AppGallery Connect中提前录入商品信息（包括商品ID、商品类型、不同国家的商品价格、商品名称等），在客户端调用购买接口时，只需传入此处配置的商品ID和商品类型，系统会根据用户当前的账号服务地展示对应国家/地区的商品… references/通过AppGallery Connect配置数字商品.md
• 通过Server API配置数字商品 — 您也可以通过 PMS （Product Management System）接口，对应用内数字商品的销售完成商品创建、查询、更新、管理促销活动等操作，并实现全球本地化定价。 基本的开发流程如下： - 获取AppGallery Connect服务端授权 ：通过API客户端方式或者OAuth客户端方式获取服务端授权。 - 创建商品 ：包括商品的单个和批量方式的创… references/通过Server API配置数字商品.md
• 配置应用 — 接入数字商品服务前，需要先完成应用的bundleName配置和应用身份信息配置。 #### bundleName配置 工程“AppScope/app.json5”下的 bundleName 需要与开发者在 AppGallery Connect 中 创建应用 时的包名保持一致。 配置内容示例如下： { "app": { // bundleName需要与… references/配置应用.md
• 隐私管理服务 — 隐私管理服务为使用 标准化隐私声明托管服务 的应用/元服务提供查询隐私链接、查询隐私签署状态、撤销同意记录和拉起标准化隐私弹框请求用户同意功能。 如果在应用/元服务中使用了标准化隐私声明托管服务，则首次打开应用/元服务，会默认显示标准化隐私弹窗，请勿在应用/元服务中自行实现弹窗展示隐私声明，否则发布审核将被驳回。 #### 场景介绍 - 查询隐私链接 在接入… references/隐私管理服务.md