入门指南
关于本指南
本入门指南旨在为已通过我们的业务拓展团队与 Aptoide Connect 建立合作关系、并正准备在各替代应用商店分发其 Android 应用的 Android 开发者提供支持。
其主要目标是：
- 提供清晰的分步概览，介绍技术与运营层面的接入流程。
- 协调开发者与 Aptoide 团队之间的预期。
- 确保顺畅高效的集成与上线。
什么是 Aptoide Connect？
Aptoide Connect 是 Android 和 iOS 上替代应用分发的接入点，旨在帮助开发者在包括 Aptoide、Xiaomi 等领先合作伙伴在内的多个替代应用商店中扩大覆盖范围，触达超过 5000 万的月活跃用户。
Aptoide Connect 内的分发工作流的构建力求简单高效，只需投入极少的工程精力即可实现跨多个商店的大规模分发。
通过与 Aptoide Android Billing SDK 集成，开发者可在应用内购买中享受高达 90% 的分成比例，同时通过在各合作商店中的优先搜索展示位置和精选推广获得更高的曝光度。
如需进一步了解我们的产品，请访问我们的**官方网站以及本文档的关于我们**部分。
沟通渠道
在入门通话之前或之后，您的客户经理将设立专属沟通渠道，在整个集成过程中为您提供支持，并确保快速高效的协作。
我们首选的沟通渠道为：
- 私有 Slack 频道（首选）
- WeChat 群组
- Telegram 群组
如果您的团队更倾向于使用其他平台，请告知您的客户经理。
为了简化沟通，客户经理将邀请相关团队的代表加入，包括：
- 运营
- 技术支持
- 市场营销与精选推广
- 业务与销售
在技术集成开始之前，如有需要，我们可以安排一次额外的入门通话，以便：
- 提供集成流程的端到端概览
- 对 Aptoide Connect Console 进行实时演示
- 解答任何技术、运营或业务相关的问题
启动问卷
在我们开始集成之前，如果您尚未提供以下信息，请就您的应用提供相关信息。您的回答将帮助我们高效地规划集成，并优化您的应用在 Aptoide 及合作商店中的上线。
必填信息：
- 应用包名：您要集成的 APK 的包名是什么？
- 集成开始日期：您希望何时开始集成流程？
- 预期上线日期：您的应用/游戏在 Aptoide 上的计划发布日期是什么？
- PSV 合规性：请确认您的 APK 遵循 PSV 公式：与 Google Play 相同的包名和签名，以及更高的版本代码。
- 社交登录：您的应用是否支持社交登录选项（例如 Google、Facebook）？
- 分发渠道：您希望启用哪些分发渠道？（例如 Aptoide、Xiaomi GetApps、ApkPure、OPPO App Market、RuStore、Huawei Petal Search）
- 分发国家/地区：您计划分发的国家/地区有哪些？是否存在任何地域限制？
- 元数据与应用内商品同步：您希望手动还是自动同步元数据和应用内商品？
- 如果您的应用同时以相同的包名在 Google Play 上提供，Aptoide Connect 可以：
- 从 Google Play 获取多种语言的元数据，包括应用信息以及通用素材和本地化素材。
- 自动同步应用内商品。启用后，每当用户购买尚未在 Aptoide Connect 中注册的商品时，您的应用内商品列表都会自动更新。
- 如果您的应用同时以相同的包名在 Google Play 上提供，Aptoide Connect 可以：
- 非消耗型商品：您的应用是否包含任何非消耗型商品（例如订阅、一次性购买）？
入门流程
在 Aptoide Connect 上注册
请在 https://connect.aptoide.com/register 创建您的账户。您可以使用电子邮件和密码注册，或使用您的 Google 账户进行身份验证。
在注册并接受认证开发者分发协议和条款与条件后，请通过提供以下信息完善您的公司资料：
- 公司名称
- 公司地址
- 注册成立国家/地区
为确保账户安全，我们强烈建议您使用电子邮件、短信或身份验证应用启用双重身份验证 (2FA)。
浏览我们的文档
利用我们的文档来指导您的集成，并熟悉 Aptoide Connect 的关键组件，包括计费、账户管理和性能优化。
我们建议从以下资源开始：
- 开发者控制台概览
在您的应用上线后，熟悉 Aptoide Connect 开发者控制台中可用的菜单以及您能够访问的信息。 - 用户访问管理
了解如何在同一 Aptoide Connect 账户内向多个用户授予访问权限，使团队无需共享凭据即可安全协作。 - Billing SDK
了解如何使用 Aptoide Android Billing SDK 实现应用内购买。 - PSV 公式
了解我们用于优化应用在各合作商店中的分发和变现的公式。
添加您的应用
向 Aptoide Connect 添加应用是一个简单且高效的流程。如需完整的操作演示，请参阅我们的专用文档页面。以下是主要步骤的概要。
- 在顶部导航栏中，单击 Add App。
- 通过为“Is your app in Google Play?”这一问题选择 Yes 或 No，表明您的 Android 应用是否已在 Google Play 上提供。
- 提供您应用的包名（例如 com.example），或粘贴 Google Play 网址（例如 https://play.google.com/store/apps/details?id=com.example）。
- 单击 Next 继续。您将被重定向至**应用提交表单**，系统将要求您提供有关应用的所有相关技术和商店信息。
证明应用所有权
验证应用所有权是确保您有权在 Aptoide Connect 上提交和分发应用的必要步骤。
验证流程取决于您的应用当前是否已在 Google Play 上发布，并可能据此适用不同的方法。
如需详细说明，请参阅我们的专用文档页面。
实现我们的 Billing SDK
Aptoide Android Billing SDK 提供了一种简单可靠的方式，将 Aptoide Connect 计费集成到您的 Android 应用中。
该 SDK 包含一个与 Aptoide Wallet 通信的计费客户端，使您能够从 Aptoide Connect 检索您的应用内商品并安全地处理购买交易。
概要
使用该 SDK 在您的应用中实现的计费流程如下：
- 与 Aptoide Android Billing SDK 建立连接；
- 从 Aptoide Android Billing SDK 查询应用内商品；
- 最终用户希望在您的应用中购买某商品；
- 应用通过 Aptoide Android Billing SDK 发起支付；
- Aptoide Android Billing SDK 处理支付，并在完成后回调您的应用；
- 应用通过服务器端购买验证来验证交易的合法性；
- 应用向最终用户发放商品；
- 应用通过服务器端通知商品已交付/已消耗。
如需了解实现细节、配置指南和最佳实践，请参阅我们的专用文档页面。
最佳实践
遵循我们的 PSV 公式
如上所述，遵循 PSV 公式具有以下若干优势：
- 避免分发使用不同应用包名的应用的多个版本。
- 防止因签名不匹配而被合作商店拒绝。
- 通过使用更高的版本代码，确保用户在自动更新期间不会被重定向回 Google Play。
- 避免安装后出现 Google Play Protect 警告，从而提升用户信任度和体验。
使用与 Google Play 相同的应用签名
如果您的应用已在 Google Play 上提供，或将在 Google Play 和 Aptoide 上同时上线，则使用相同的应用签名至关重要。
请参阅我们的详细指南，了解如何使用 Google Play 开发者控制台为您的 Aptoide 版本签名。
禁用 Google Play 应用完整性警告
如果您的应用同时在 Google Play 上分发，部分用户在启动游戏时可能会遇到“Get this app from Play”的弹窗。此警告可能会完全阻止访问，导致用户无法使用该应用。
这通常是因为在 Google Play 开发者控制台中启用了自动保护设置。当此设置生效时，如果应用并非直接从 Google Play 安装，则会限制应用的启动。在某些情况下，这些设置可能默认处于启用状态。
如果您通过多个渠道分发应用，请务必检查并调整这些设置，以便无论应用从何处安装，用户都能正常游玩。有关如何禁用此设置的分步说明，请参阅我们的文档。
切勿忘记消耗商品
在集成 Aptoide Android Billing SDK 时，请确保当商品已成功交付给用户时，您的应用通过在我们这一端将其设置为已消耗来通知我们的服务器（计费流程的第 8 步）。有关如何执行此操作的详细信息，请参阅我们的文档。
如果未报告消耗，系统将自动为该交易办理退款。
确保应用内商店价格一致
请确保您游戏内商店中显示的价格和货币与用户在 Aptoide Wallet 结账时所看到的一致。
为此，请使用我们的 Aptoide Android Billing SDK 查询应用内商品并显示相同的价格信息。有关如何正确获取应用内商品的详细信息，请参阅我们的文档。
使用我们的支持与调试工具
Aptoide Connect 提供了专用工具，帮助您更高效地集成和排查 Aptoide Android Billing SDK，包括 Billing SDK Log Analyzer 和 Billing SDK Transaction Analyzer。两者均可通过我们的智能助手 Connectoide 在 Aptoide Connect 开发者控制台中使用。
在开发和测试的早期阶段使用这些工具，可以显著缩短集成时间并加快问题解决速度。有关每个工具及其使用方法的详细信息，请参阅我们的支持工具页面。
提交您的版本
在将应用添加到您的 Aptoide Connect 账户后，您将被重定向至**应用提交表单**，您可以在此提交所有必需的文件并提供发布应用所需的信息。
应用文件
在使用应用提交表单提交应用时，您需要上传计划发布版本的版本文件。目前支持以下文件类型：
- .apk - 最大 2 GB
- .obb - 最大 5 GB（请遵循有效的文件名指南）
重要注意事项：
- APK 签名：所有 .apk 文件在提交前都必须签名。
- 压缩文件：不支持压缩文件。请在上传前解压所有文件。
- 不支持 .aab 文件：
- 如果您未使用 Google Play 应用签名，请遵循我们的 APK 提取指南，使用 bundletool 将您的 .aab 转换为 .apk 文件。
- 如果您使用 Google Play 应用签名，则可以直接从 Google Play Console 下载已签名的 APK。请参阅我们的指南：从 Google Play Console 下载您的应用。
应用信息与素材
如果您的应用已在 Google Play 上提供，其元数据将被自动获取。如果未提供，您将需要手动提供所有必需信息。
您的版本由我们审核
在此阶段，运营团队将审核您应用的技术实现和内容，并测试所有关键流程，包括应用内购买。
如果在审核过程中发现任何问题，团队将立即通知您，以便我们尽快进行排查和解决。
作为最佳实践，我们建议您在计划发布日期前至少一周提交应用进行审核，以留出充足的时间进行验证和潜在的修复。
您的应用上线
一旦应用成功通过所有 QA 检查，运营团队将批准其发布。
应用仅会在约定的发布日期上线。发布可通过以下任一方式进行管理：
- 安排在特定日期上线
- 由运营团队手动发布
- 由您通过开发者控制台直接发布
上市计划
上市计划包含一系列旨在于上线时最大化曝光度和表现的推广举措。
Aptoide Connect 在其各平台上提供多种精选推广机会，包括：
- 推广卡片
在 Aptoide App Store、Web 和 Games 中的顶部位置展示的高影响力临时横幅。 - 编辑精选
在 Aptoide App Store、Web 和 Games 中，每周对精选游戏进行重点展示，并配有专门的编辑文章。 - 编辑推荐
在 Aptoide App Store、Web 和 Games 中，以高级顶部横幅位置突出展示高质量的精选作品。 - “Level Up”合辑
在 Aptoide Web 上以醒目位置展示的高表现作品精选合辑。 - 横幅（店内广告）
Aptoide Web 上的首页主横幅，以及应用查看、安装和搜索页面上的定向弹窗，确保在关键用户接触点获得最大曝光。 - “Highlighted”合辑
在 Aptoide Games 上自动适应每位用户偏好和游玩风格的个性化游戏合辑。 - “高达 20% 奖励”合辑
在 Aptoide App Store 上精选的优质应用和游戏，为用户的应用内购买提供高达 20% 的返现。 - Aptoide Wallet 促销
为通过 Aptoide Wallet 进行应用内购买的用户提供的独家奖励激励。
为便于妥善规划推广活动，在集成过程中尽早确定最终发布日期非常重要。如果可用版本在最终发布日期前不足一周才提交，我们将无法保证推广位，精选推广的排期可能需要在发布后安排。
此外，请分享任何可用的通用图形和推广素材，以便我们的团队将其用于社交媒体活动和店内推广。
常见问题
合作应用商店的提交流程是如何运作的？
一旦您的应用在 Aptoide Connect 中完成集成并获得批准，它便会在我们面向合作应用商店的分发系统中变得可用。
您可以明确选择允许哪些合作商店获取和分发您的应用。只有选定的商店才能访问和发布您的应用。
这使您能够在不同的市场和合作伙伴之间掌控您的分发策略。
PSV 公式是什么？为什么我应该遵循它？
PSV 代表：
- P：与 Google Play 相同的 应用包名。
- S：与 Google Play 相同的 应用签名。
- V：比 Google Play 上发布的版本更高的 版本代码。
遵循 PSV 公式具有以下优势：
- 避免分发使用不同应用包名的应用的多个版本。
- 防止因签名不匹配而被合作商店拒绝。
- 通过使用更高的版本代码，确保用户在自动更新期间不会被重定向回 Google Play。
- 避免安装后出现 Google Play Protect 警告，从而提升用户信任度和体验。
建议
请始终将 Aptoide 版本代码设置为比 Google Play 多一位数字。
示例： 如果您的 Google Play 版本代码为 101，请在 Aptoide Connect 上使用 1101。
我需要使用与 Google Play 相同的应用签名吗？
是的。如果您的应用已在 Google Play 上提供，或将在 Google Play 和 Aptoide 上同时上线，您必须使用相同的应用签名。
使用相同的签名可确保兼容性，并防止用户出现安装或更新问题。
如需分步说明，请参阅我们的详细指南，了解如何使用 Google Play 开发者控制台为您的 Aptoide 版本签名。
Aptoide Connect 能否自动从我在 Google Play 上的应用获取数据？
可以。如果您的应用同时以相同的应用包名在 Google Play 上提供，Aptoide Connect 可以自动从 Google Play 同步关键数据。
这包括：
- 应用信息与素材，例如多种语言的通用素材和本地化素材
- 应用内商品，当用户购买尚未在 Aptoide Connect 中注册的商品时会自动同步。随后，应用内商品价格会每周更新。如需了解更多详情，请参阅我们的文档。您还可以预加载商品，以提前预填充该列表。
我该如何测试我的应用内购买？
您可以使用 Aptoide Connect 中提供的 Sandbox 环境来测试应用内购买。
要执行 IAP 测试：
- 下载并安装 Aptoide Wallet 应用。
- （可选）创建一个用于测试的专用 Wallet 地址。
- 在开发者控制台的 Sandbox 部分添加您的测试 Wallet 地址。
- 使用此 Wallet 地址在您的应用内执行测试购买。
如需详细的设置说明和测试指南，请参阅我们的文档。
目前 Aptoide Connect 计费在应用内购买中支持哪些货币？
应用内购买目前支持以下货币：
| 货币代码 | 货币名称 |
|---|---|
| USD | 美元 |
| AUD | 澳大利亚元 |
| BRL | 巴西雷亚尔 |
| CAD | 加拿大元 |
| CHF | 瑞士法郎 |
| CLP | 智利比索 |
| CNY | 人民币 |
| CZK | 捷克克朗 |
| DKK | 丹麦克朗 |
| EUR | 欧元 |
| GBP | 英镑 |
| HKD | 港元 |
| HUF | 匈牙利福林 |
| IDR | 印度尼西亚卢比 |
| ILS | 以色列谢克尔 |
| INR | 印度卢比 |
| JPY | 日元 |
| KRW | 韩元 |
| MXN | 墨西哥比索 |
| MYR | 马来西亚林吉特 |
| NOK | 挪威克朗 |
| NZD | 新西兰元 |
| PHP | 菲律宾比索 |
| PKR | 巴基斯坦卢比 |
| PLN | 波兰兹罗提 |
| RUB | 俄罗斯卢布 |
| SEK | 瑞典克朗 |
| SGD | 新加坡元 |
| THB | 泰铢 |
| TRY | 土耳其里拉 |
| TWD | 新台币 |
| ZAR | 南非兰特 |
| BGN | 保加利亚列弗 |
| COP | 哥伦比亚比索 |
| EGP | 埃及镑 |
| KZT | 哈萨克斯坦坚戈 |
| NGN | 尼日利亚奈拉 |
| PEN | 秘鲁索尔 |
| QAR | 卡塔尔里亚尔 |
| RON | 罗马尼亚列伊 |
| SAR | 沙特里亚尔 |
| TZS | 坦桑尼亚先令 |
| AED | 阿联酋迪拉姆 |
| VND | 越南盾 |
| UAH | 乌克兰格里夫纳 |
我多久会收到一次应用内购买分成？
每当您从 Aptoide Connect 账户申请提现时，您都会收到您的应用内购买收入。
提现直接从开发者控制台发起。一经申请，付款将按照所配置的付款方式和适用的处理周期进行处理。
如需详细说明，请参阅我们的文档。