第三方后台配置—Android版

第三方后台配置—Android版

wapublisher No Comment
Uncategorized

1.Google后台应用配置

google控制台地址:https://console.developers.google.com

Google后台配置简要流程如下:

1.创建一个项目(如果已经有项目则不需要再创建,一个主开发者帐号只能关联一个项目),填写项目名和项目id(项目id需要全世界唯一,系统会自动生成一个,可以更换也可以自己填写)
2.在这个项目中创建服务者帐号,下载.p12证书,并为服务者帐号开放权限,目前只需要开发财务权限。
3.将证书和服务者帐号保存至SDK后台。

1.1 google后台首先需要做一些公共配置,大致流程如下:

图片1
上图中的所涉及到的流程在后续章节中都有详细指引。

1.1.1 Google API 控制台中创建新的公共项目

首先,需要注册Google开发者账号(参考链接:https://play.google.com/apps/publish/signup/)。
注册账号后,打开Google API 控制台,创建一个新的公共项目,如果使用现有的公共项目,可以不新建。

图片2
点击“+”新建项目
图片3
在创建页面输入项目名称,点击“Create”新建即可完成

图片4

1.1.2 关联公共项目

打开Google Play后台,点击“设置”,如下图:
点击“设置”后进入设置详情页,在开发者账号->API权限下可以关联项目,一个开发者账号只能关联一个项目,如果已经关联了项目,创建服务账号和OAuth Client在相应的Project中创建即可,如下图:
图片6

1.2.公共项目创建服务账号(Service account key)*

服务帐号是SDK后台验证支付订单时候使用,运营人员需要将服务帐号和证书保存至SDK后台。SDK后台的操作请参考《WINGSDK后台基础设置》。不同的应用,不要使用相同的服务帐号。
打开Google API 控制台,选中项目,在“Credentials”标签下,点击“Create credentials”,在下拉菜单中选择“Service account key”。
图片7

点击进入“Create service account”页面,如下图所示:
图片1

点击“CREATE”按钮,进入选择角色页面,如下图所示:

图片2

点击“CONTINUE”,进入下面的界面,如下所示:
图片2
点击“DONE”即可创建完服务账号。接下来在“Service Accounts”列表中找到刚创建的服务账号,如下所示:
图片2

点击编辑,进入详情页面,如下所示:
图片2

如下所示:
图片2

在“Key type”选择P12,创建完后会自动下载P12证书,需要将P12证书上传到WASDK服务器,WASDK服务器中Google支付的配置需要用到。

创建账号完毕后,在Google Play后台设置->开发者账号->API权限页面中可以看到新创建的服务账号,可以查看权限或者授予访问权(目前只需要开发财务权限)。

图片9

点击“查看权限”或者“授予访问权”,进入权限查看或者授权页面。在权限查看页面,同样可以进行权限修改操作,如下图。

如果是从API权限列表里面的“创建服务账号”入口创建账号,创建完成后回到这个页面,点击窗口的“完成”即可刷新列表。
图片12

查看和修改权限
图片13

图片13

选择应用后,点击应用后,会弹出应用权限,勾选查看财务数据权限,如下图
图片13

点击账号权限,可以授予开发者帐号中所有应用的权限

图片13
选择完后,点击保存更改。

进行完上述操作之后,将服务帐号(邮箱)和证书保存至WA后台即可。

1.3.子项目中配置应用的OAuth Client Id*

简要流程如下:

1.3.1 创建一个子项目(如果已经有项目可以跳过,子项目和公共项目是平级结构),填写项目名和项目id(项目id需要全世界唯一,系统会自动生成一个,可以更换也可以自己填写)
1.3.2 在这个项目中创建新的Android类型Client ID,其中要填写package name(请和程序开发人员沟通获取),这个package name要和客户端的package name一样(定义在AndroidManifest.xml中)


图片2
注意:如果使用AndroidStudio开发工具,包名为程序目录下(通常为app/)的build.gradle配置中的“applicationId”参数值。

另外需要获取程序证书的SHA1指纹(请和程序开发人员沟通获取)填写到Client ID的创建选项中。
图片3
图片4

注意:
1)Eclipse项目的包名在AndroidManifest.xml中package的取值
图片15
2)Android Studio项目的包名在程序模块目录下的build.gradle文件配置中的applicationId中的取值
图片16

1.3.3 在这个子项目中创建一个Web application类型的ClientId(如果项目已经存在这种类型的ClientId,可以不创建新的),将ClientId提供给前端开发人员配置到程序中,另外需要提供给后台配置人员将这个ClientId配置到WA后台的登录配置中。

图片1

1.4.添加Google+ API权限*

因为SDK中的Google登录使用到OAuth2.0,需要从API Manager中添加Google+ API权限来获取用户数据。
打开Google API控制台,选中项目,在“Dashboard”页面中点击“ENABLE API”启用API
图片17
点击后会跳到“Library”页面,“Google APIs”页面查找“Google+ API”(可输入关键字搜索),点击项目进入详情。
图片18
点击上面的“ENABLE”或者“DISABLE”启用/禁用这个API
图片19

1.5.添加Google Play商品信息

添加Google商品信息可以参考相关官方管理应用内购买结算文档
在Google Play后台应用列表中点击应用进入应用详情,商店发布->应用内商品,可以管理商品。
点击“添加商品”添加新商品信息,选择商品类型和商品id,商品id必须唯一
图片21

图片21

设置价格页面:
图片21

填写名称、说明、设置价格,点击保存后,继续点击激活按钮才能够使用。
图片22

 

1.6 添加Google Play测试用户

Google Play的android应用测试分两部分:ALPHA/BETA阶段和正式发布阶段
 
1.ALPHA/BETA阶段
上传ALPHA/BETA版本应用,获取测试邀请链接发给测试者,测试者确认成为测试者后即可进行该应用的测试。注意:如果是封闭式测试,还需要将测试人员账号添加到测试组。
具体步骤可参考:
https://support.google.com/googleplay/android-developer/answer/3131213 的 Open beta testing部分。
图片25

具体以官方说明为准,截图可能会过期。
 
2.正式发布阶段
将测试者的email添加到google控制台的测试者账户中,具体可参考:
http://developer.android.com/google/play/billing/billing_admin.html#billing-testing-setup

图片26
具体以官方说明为准,截图可能会过期。

 

1.7.添加Google Game Service支持

在开发者管理者控制台左侧菜单打开“游戏服务”菜单,在列表中选中需要新建成就的游戏服务。

图片27

如看不到Play 游戏服务,则在顶部搜索栏中搜索”Play游戏服务设置”,然后选中
图片27

选中“是,我的游戏已经使用了Google API”,此时在下方选择要关联的项目。选择项目,下一步即可完成创建。(如没有创建Google API项目,则参考 1.3.子项目中配置应用的OAuth Client Id* 流程先创建子项目)

图片28

在游戏服务中添加新游戏之后自动生成了Google Game Service App Id,此值需提供给开发人员,如下图所示:

图片28

如提示配置OAuth同意屏幕,按照要求操作同意接口,同意完后,点击添加凭证,选择Android类型,输入名称等基本信息,选择OAuth客户端即可,然后保存。(默认情况下选择OAuth客户端只有一个,如若多个,可以选择后,查看包名和指纹是否和应用的一致进行确认)

图片6

创建完游戏服务之后就可以创建成就和排行榜了,创建完的游戏服务,必须要发布才能够使用。

在goolge应用控制台为某一个应用添加Google Game Service成就,请参考以下官方文档:
https://developers.google.com/games/services/common/concepts/achievements
 
在左侧菜单选择“成就”,点击页面“添加成就”可以添加新的成就。

图片28

1.8.获取Google Play Public Licensing Key (3.9.0版本及以后不需要配置)

1)打开Google Play后台,确认登录的账号是已经或者将要发布应用的账号
2)点击所有应用->选择应用->点击获利->获利设置
3)在“服务和API”页面的“许可和应用内结算”部分,就可以找到public licensing key
 
如图:
图片36

1.9.Google 促销商品配置

参考地址:https://developer.android.com/google/play/billing/promo
登录Google Play后台,选择对应应用进入详情,选择获利—产品—促销代码,点击创建促销代码

图片36

输入 促销活动名称、开始时间、结束时间,促销类型选择应用内商品,然后选择需要参与促销的商品,输入促销代码数量,保存即可。

图片36

当到达输入当开始日期时间后,促销码就可以使用。在您的应用中:用户可以点击 Google Play 购买屏幕中付款方式旁边的向下箭头,然后点击兑换链接以输入代码,由此发起购买交易

图片36

选择兑换代码,输入对应兑换代码
图片36

注:创建促销商品的商品id为google_001,在应用内兑换时,需要点击相对应的商品(对应google商品id为google_001)弹出支付界面,然后输入兑换码才能正常兑换。

 

1.10.Google Play 签名密钥

Google Play控制台的签名密钥有两种,一种是应用签名密钥,一种是上传签名密钥,他们对应的实体文件是keystore/jks文件。

上传签名密钥:上传Google Play 的aab或apk包必须使用该签名秘钥进行签名,不能使用应用签名秘钥或者其他签名秘钥,否则会提示签名错误,无法上传。

应用签名密钥:是应用最终所使用的签名密钥。虽然上传Play使用的是上传签名秘钥签名,但是正式上架对外时,Google Play会抹去原来的签名,并使用应用签名秘钥签名。无论对外发布,或者给一些平台配置如Google和Facebook,或者用于应用调试测试,都应该使用应用签名密钥

1.10.1.Google Play 签名密钥

首次创建应用版本会要求加入谷歌签名计划,在加入谷歌签名计划时候,默认由谷歌自行创建签名密钥,它会保存在谷歌服务器,无法访问和下载。默认方式的签名密钥文件不可访问,无法控制,不利于管理签名密钥文件和调试测试,所以建议上传自己的签名密钥。

准备内容:
a、应用签名密钥文件(jks文件),及密钥相关别名和密码
b、上传签名密钥文件(jks文件),及密钥相关别名和密码

操作步骤:

1、在首次创建应用版本的 签名计划 中,选择“管理应用签名”

图片36

2.选择“从Java密钥库导出并上传密钥”

图片36

3.按照介绍,下载PEPK工具

4.复制命令,把红框粗体部分更换为自己的内容。

图片36

a、foo.keystore:应用签名密钥文件绝对路径,例:E:\DemoWA\app\keystore.jks
b、foo:应用签名密钥文件的别名,例:foo
c、output.zip:最终输出文件绝对路径,例:E:\DemoWA\app\output.zip

5.到命令终端,进入到,PEPK工具保存的路径,输入最终内容,然后按提示输入签名密钥密码。

图片36

6.点击“上传生成的ZIP文件”,找到最终输出的zip文件进行上传,这相当于配置了“应用签名密钥”。

7.展开第四步,按照说明,复制下面命令,红框粗体部分替换为自己的内容
图片36

a、upload-keystore.jks:上传签名密钥文件绝对路径,例:E:\DemoWA\keystore.jks
b、upload:上传签名密钥文件的别名,例:foo
c、upload_certificate.pem:最终输出证书文件绝对路径,例:E:\DemoWA\upload_certificate.pem

8.到命令终端,输入最终内容,然后按提示输入签名密钥密码。
图片36

9.点击“上传您的上传密钥证书”,找到最终生成的证书文件进行上传,这相当于配置了“上传签名密钥”。
10.点击右下角“更新”

图片36

11.回到 Play App Signing ,点击 “继续”,即可完成签名密钥上传。完成后可在“设置”的“应用完整性”中可以看到签名密钥的指纹证书。

图片36

图片36

注意:
1.如果Play控制台的设置->应用完整性中,如果没有上传签名密钥,那么首次上传的应用包所使用的签名密钥,就会作为后续的上传签名密钥。
2.上传签名密钥和应用签名密钥相互独立,不影响。两者可以使用相同的签名密钥。

1.10.2.验证签名密钥

1.在命令终端通过输入keytool命令获取签名密钥jks文件的证书指纹。
命令:keytool -list -v -alias ALIAS_NAME -keystore KEYSTORE_PATH

图片36

2.在Google Play控制台的,设置->因公完整性,中找到当前的签名密钥指纹证书,比较应用签名密钥和上传签名密钥的指纹证书是否一致。
图片36

1.10.3.升级应用签名密钥

已经配置谷歌签名计划的签名密钥后,会有一个升级应用签名密钥提示。每个应用,只有一次升级签名密钥机会,而且升级签名密钥会相当于更换一个新的签名密钥,会要求更新与应用签名密钥相关的配置内容(如Google登录,Facebook登录等),所以非特殊情况要求,不建议升级签名密钥。
升级前建议详细了解:

https://support.google.com/googleplay/android-developer/answer/9842756#针对新安装应用升级应用签名密钥

1.10.3.1.升级前的重要注意事项

1.如果您为多个应用使用相同的应用签名密钥,以便在它们之间共享数据/代码,则您需要更新这些应用以使它们同时能够识别新旧两版应用签名密钥证书。

2.如果您的应用使用 API,请务必在 API 提供商那里注册新旧两版应用签名密钥的证书,以确保 API 能继续正常运行。您可以在 Play 管理中心内的应用签名页面上找到相应证书。 如谷歌登录,Facebook登录等。

3.如果您有很多用户通过点对点共享安装更新,那么只有当要安装的更新的签名密钥与其已安装的应用版本所用密钥相同的情况下,他们才能安装。如果用户的应用版本因使用不同的签名密钥而无法更新,则可以选择卸载并重新安装应用以获取更新。

1.10.3.2.升级前的重要注意事项

点击“请求升级密钥”会提示选择升级原因,按照具体升级原因进行选择。

图片36

1.10.3.3 升级操作

升级操作选择会有两种,建议使用“上传新的应用签名密钥”,理由和操作方式在前面“上传自己的签名密钥”章节已经有说明。
图片36

1.10.3.3 升级后续配置更改指南

必须确保平台配置中有新旧签名密钥两套配置,才能保证新应用和旧应用的平台API(如Google登录等)都可用。

下面罗列一些平台需要用到签名信息的相关配置指南:

Google:Google Cloud Platform(https://console.cloud.google.com/)控制台,API和服务 -> 凭据中,添加Android类型的OAuth 2.0 客户端 ID,输入包名和新的应用签名的SHA-1证书指纹。子项目中配置应用的OAuth Client Id

Facebook:Facebook登录的“密钥散列”与应用签名有关,需要添加新的“密钥散列”。
添加签名密钥散列

Fireabse:关联应用有用到应用签名的SHA-1和SHA-256证书指纹,需要添加
手动关联GooglePlay应用

Huawei:华为应用需要配置证书指纹。
生成签名证书指纹

1.10.3.4 签名密钥常见问题

1.打包的时候该使用哪个签名密钥?
上传签名密钥,只有在给需要上传到Google Play任意轨道(测试或正式等)的应用包打包时使用。
其他任意时候,比如想在本地运行调试,或者本地打包测试,只要不需要上传到Google Play的,都使用应用签名密钥进行打包。

2.MD5,SHA-1,SHA-256这些证书指纹该用哪个签名密钥的?
上传签名密钥只有在上传Google Play任意轨道时候打包应用包时使用,其他任何情况都以应用签名密钥为准。所以给Google,Firebase,Facebook,Huawei等平台提供的SHA-1,SHA-256证书指纹都需要使用应用签名密钥的证书指纹。

3.什么是keystore/jks文件,怎么生成的?
二者是同一个东西,都是Android签名密钥文件,用来打包Android应用的,当前常用的是jks文件。该文件用于确保应用的唯一性及合法性,非常重要,请务必保管好该文件及相关的密码,并确保不会泄漏。
虽然可以使用JDK的keytool工具生成这两种文件,但常用的方式是开发者使用Android Studio生成jks文件,而keystore文件一般使用Eclipse生成。

4.Google Play上的应用签名密钥keystore/jks文件找不到了,能否重新生成一个跟上面相同证书指纹的签名密钥文件?如果不能又该如何处理?
不能生成指定证书指纹的签名密钥文件。Google Play上也无法下载签名密钥文件。
处理方法:
1)上传应用到任意轨道(正式或测试),从Play Store的应用页面下载应用,上面下载的应用都会使用应用签名密钥打包签名过。
2)如果想自己重新掌握keystore/jks文件,并且Play控制台中该应用未升级过应用签名密钥(每个应用只有一次升级机会),可以进行密钥升级,更换为新的keystore/jks文件信息。升级的时候务必选择“上传自己的签名密钥”,不要选择默认的“由Google Play生成。。。”,升级成功后也务必对一些平台上的配置做出相依的配置改动,否则会影响这些平台的API使用,如Google登录,Facebook登录等,具体升级请参考“升级应用签名密钥”章节操作。

5.应用打包运行之后的签名密钥,和Play上的应用签名密钥不一致会有什么后果?
通常会影响所有配置了与应用签名密钥有关信息的平台API。比如Google的Android类型OAuth ClientID使用了SHA-1,会影响谷歌登录,导致谷歌登录直接返回取消。Facebook使用的散列秘钥,影响Facebook登录。其他的还有Firebase的应用关联,Huawei的应用配置。

 

1.11Google Play 发布应用

准备应用包:
使用上传签名密钥打包签名好应用包apk或aab。若使用应用签名密钥或其他签名密钥,会提示错误。关于签名密钥可以参考上一章节说明。
注意:推荐aab,2021年8份起新应用必须使用aab包发布应用。Play发布的apk大小限制为100MB,aab大小限制为150MB,若超出大小限制,apk包需要使用APK拓展文件obb功能,aab需要使用Play Asset Delivery功能,对应用或游戏资源进行配置,才能上传成功。

登录Google Play 控制台,选择并进入需要发布的应用。

1.选择发布的版本,根据需要可以选择内部测试,封闭测试,开放性测试,正式版。
2、若是测试轨道,可以选择测试人员并保存

图片36

3.若是开放性测试,或正式版,需要设置发布的国家。

图片36

4.创建新版本,上传应用包,保存。若之前已上传过该应用包,可以直接从内容库中选择。保存之后,点击检查发布版本。

图片36

图片36

5.在检查发布版本页面,查看所有错误警告消息,若是错误,必须按照指引完成修改。完成所有错误的修改后,回到该页面,点击 开始发布,即可完成操作,等谷歌审核通过后,即是正式完成发布。

图片36

其他说明:发布前错误提示,信息中心需要完成步骤,主要是设置应用部分,按照指引完成任务即可。

图片36

2.Facebook第三方后台配置

2.1 Facebook基础配置

Facebook控制台地址:https://developers.facebook.com/

2.1.1 创建Facebook应用

一共有五种可选的应用类型:公司、游戏、小游戏、消费者或无。当您选择应用类型后,系统会为应用提供仅适用于该应用类型的产品(如登录,分析等产品)、权限(访问用户生日性别照片等数据权限)和功能,精简应用创建流程。
1、公司类型适用于可帮助公司和组织管理公共主页、小组、活动、广告以及和广告相关素材的应用。
2、游戏类型适用于可以在 Facebook 开放平台上游玩的游戏应用。
3、小游戏类型适用于可以在 Facebook 开放平台上游玩的游戏应用。
4、消费者类型适用于整合 Facebook 登录等消费者相关产品以便为用户提供更多帐户关联体验的应用程式。
根据说明,上面的“游戏类型”是适用Facebook游戏平台上的游戏。我们推荐创建应用类型时,选择“消费者”类型,该类型包含Facebook登录,分析,应用事件,应用链接,Instagram基本显示API,分享,社交等常用的产品。
想了解所有应用类型对应可使用的产品、权限和功能,可以查看Facebook官方文档: https://developers.facebook.com/docs/apps/app-types/

进入应用控制台,点击“创建应用”。
图片1

点选择用途“打造关联体验”(对应消费者应用类型),点击“继续”。

图片1

填写“应用显示名”,和“应用联系邮箱”,点击“创建应用”。
图片1

“创建应用”完成以后会立即进入到该应用的控制台页面。
图片1

移除应用类型

如果选择应用类型之后,在产品添加中没有找到自己需要的产品,或者当前应用类型提供的权限或功能无法满足需求,可以移除该应用的应用类型,或者重新创建新的应用类型的应用。移除应用类型之后,就是无指定类型的应用了,可以选择添加任何产品和申请任意权限及功能。
注意:移除类型后是无法再次指定应用类型的。

下面介绍如何移除应用类型:
进入目标应用控制台页面,点击“产品 +”,往下滑,找到“想找其他产品和权限?”卡片,点击“移除应用类型”按钮。

图片1
输入该账号的密码,点击“提交”

图片1

操作完成之后,在应用控制台中可以看到,已经不再显示应用类型了,并且可添加产品中,显示了所有的产品,权限页面也可以看到显示所有权限。

图片1

2.1.2 添加产品

创建完应用编号后,需要添加产品。点击左侧菜单栏中的“产品+”按钮,找到所需的产品,点击该产品卡片的“设置”按钮进行添加。(接下来以必接的登录功能为示例,另外在这里只需要对产品进行设置,所以会忽略其他非设置步骤)。

图片1

2.1.3 设置项目信息

点击“设置”进入产品添加的向导(菜单栏“快速启动”方式设置),选择添加的产品支持的平台(此处以Android平台为例)

图片5

图:选择产品支持的平台

选择平台后,进入平台的设置页面,在这个页面可以在上面的tab中切换不同的平台进行设置,第1、2步是SDK集成,由开发人员完成,进入第三步设置项目信息。

输入应用包名,和默认活动类的完整路径(如果使用DeepLink功能,需要填入DeepLink功能响应的Activity类路径,否则可以填入首个启动的Activity,例如MainActivity即可),点击“Save”保存。

图片5

图:填写Android项目信息

点击保存,如果你的应用在Google Play没有上架,会弹出下图“Google Play包名校验遇到困难”的对话框,点击“使用此包名”即可。

图片5
图:Google Play包名验证出现困难

2.1.4 添加签名秘钥散列

签名秘钥散列需要开发技术同事协助获取,获取到的字符串是包含 28 个字符的唯一密钥散列,获取方式参考Facebook官方文档。将生成的秘钥散列添加到“秘钥散列”下面的文本框,如果测试环境和正式环境不一样的签名文件,这里可以添加多个。添加后点击“Save”保存。

具体操作过程可以参考以下任何一种方式,他们都是相同的指引,然后按指引生成“发布密钥散列”进行添加:
1.Facebook控制台 -> 产品 -> Facebook登录 -> 快速启动 -> Android平台 -> 添加开发和发布密钥散列
2.Facebook登录接入文档,第6节-为应用提供开发和发布密钥散列:
https://developers.facebook.com/docs/facebook-login/android#6

图片8

图:添加签名秘钥散列

2.1.5 启用单点登录

根据需求,如果需要启用单点登录,打开单点登录,保存进入下一步。
图片9
图:启用单点登录

Facebook的基础配置已经完成,接下来的6、7、8、9、10是开发人员的集成步骤,集成参考文档《WING SDK使用指南(Android).doc》,如果需要进行其他设置,请参考后续章节。

2.1.6 其他配置及提供参数信息给技术配置到工程项目中

在左侧菜单点开“设置->基本”,将应用编号(Facebook App id)提供给技术配置到项目中,如果需要礼物功能,需要将应用密钥(App Secret配置到SDK后台,关于礼物的配置参考后续章节。如果需要使用游戏邀请功能,必须在设置中设置应用的类别为“游戏”
图片9

往下滑动,可以看到上面添加的Android平台的配置,可以在这里修改配置。如果需要添加其他平台,可以点击“+ 添加平台”按钮添加(如果添加产品的时候,针对某个平台进行了配置,会自动添加了该平台)。
图片9

2.1.7 相关产品的配置修改

如果需要修改相关产品的配置,在左侧菜单中的“产品”中找到相应的产品,“设置”展示所有设置,“快速启动”是包含了向导的设置。
图片9
图:产品配置修改

2.2 Facebook添加开发者

添加步骤如下:
在Facebook控制台页面,在左侧“用户身份”菜单展开,下面有两个,“用户身份”和“测试用户”。“用户身份”是配置哪些用户拥有编辑和查看应用的权限;“测试用户”用来测试不同应用功能的临时性的 Facebook 帐户。

图片18
图:用户身份配置

图片18
图:测试用户

2.3 上线注意事项

切换到线上模式,必须提供“隐私权政策网址”和“数据删除信息”。
“隐私权政策网址”必须提供有效的地址,在Facebook登录页面和应用详情页面会显示该入口。
“数据删除信息”,Facebook为了符合通用数据保护条例 (GDPR),可获取用户数据的应用程序必须执行以下某项操作:
1.执行数据删除请求回调。
2.为用户提供含有明确说明的网址,介绍如何使用第三方网站或工具删除数据。第三方网站可能是应用程序隐私政策的相关部分。
用户在Facebook设置中移除应用时候,会有提醒用户移除数据的相关说明。
第一种方式需要按照官方文档要求提供接口给Facebook调用。我们建议选择第二种方式,提供数据删除说明地址,介绍如何删除数据。
图片18
图:切换线上模式提示框

图片18
图:选择 数据删除说明网址

图片18
图:选择 数据删除说明网址

3.VK后台应用配置

VK目前必接的功能包括登录,登出,显示用户名称以及头像,group和邀请。

3.1. VK基础配置

创建VK应用,创建地址如下(如果还没注册,需要先注册):https://new.vk.com/editapp?act=create
Android-VK基础配置

title中填入应用的名称, 点击Connect Application按钮,并按照提示创建应用。填写关键信息,主要是填写Information和Settings部分:
Android-VK基础配置

Android-VK基础配置

Android-VK基础配置

上图的SDK settings中安卓部分需要填写应用的包名和指纹,指纹的获取方式请参考1.1 配置应用程序证书指纹(去掉冒号),也可以参考:https://new.vk.com/dev/android_sdk,或者与开发人员联系获取。

获取vk app id提供给开发人员并且注意设置应用状态为可见
android-VK基础配置

3.2 应用提交审核

VK的邀请功能是对接VK渠道官方要求必须接入的,而邀请功能只能在审核通过的应用中使用,所以需要将配置好的应用提审。

这里需要注意的是:
VK的应用审核比较严格,首先必须是游戏应用,并且需要全部翻译成俄文,不能是demo,有人工审核。
如果需要测试邀请,原则需要审核过的应用,在应用审核通过之前,使用apps.sendRequest接口,type为request来测试,测试者需要双方是好友,都是管理员并且都已经安装过该应用。
对接VK邀请功能业务流程图如下:
vk上线流程图

控制台提审大致步骤如下:
Android-VK基础配置

Android-VK基础配置

4.Firebase后台配置

在Firebase后台配置后,会得到两个文件,一个是google-services.json,需要给研发配置到游戏中去;另一个是Firebase服务器秘钥,需要配置到SDK后台

4.1 新建Firebase项目

在浏览器中打开Firebase控制台点击添加已经在Google API存在的项目

图片6

点击输入项目名称输入框时,会弹出已经存在Google Api的项目列表,选择对应项目并继续

图片6

图片6

选择配置Google Analytics账号,点击添加Firebase按钮
图片6

图片6

点击继续,则项目创建完成。

4.2 新建应用

进入项目,点击对应应用类型

图片6

输入软件包名、应用名、SHA-1指纹,点击注册应用

图片6

注册应用,进入下一步,下载google-services.json。将下载的配置文件复制到项目模块文件夹,通常为 app/。

图片6

google-services.json文件可以随时重新下载,可以在设置,常规,选中项目后,下载某个项目的google-services.json文件,如果包名改变,或者其他配置更新,则需要重新下载google-services.json文件,然后更新到项目中去。

图片6

4.3 获取Firebase服务器秘钥

在项目详情左侧菜单中点击设置按钮进入设置页面,选中云消息传递标签,在页面上可以找到服务器秘钥(请使用新版的服务器秘钥)。

图片6

4.4 将Google Play链接到Firebase

1、登录到Firebase
2、单击设置图标,然后选择项目设置

Android-Firebase后台配置

3、单击集成 选项卡
4、在Google Play卡上,点击链接,如果您的项目已被链接,则会看到“ 管理”,如果您没有Google Play开发者帐户,则可以点击升级和链接以创建一个新帐户。

图片6

说明:必须链接到Google Play账号才能查看Android应用的in_app_purchase和订阅事件。需使用主账号进行关联

已关联Google Play账号的的项目,如若继续添加应用,则需要手动关联Google Play应用
图片36

然后点击添加SHA-1 、SHA-256指纹查找方式为:在googleplay后台–设置–应用签名—-应用签名密钥证书,SHA-1、SHA-256指纹。

图片36

然后需要重新下载最新的google-services.json配置文件,给到研发进行更新

注:应用不需要上架正式版,但是需要至少上架一个内测版本才能关联成功

4.5 Firebase 分析调试

参考:https://firebase.google.com/docs/analytics/debugview?authuser=0
要在 Android 设备上启用 Analytics“调试”模式,请执行以下命令:

例如:adb shell setprop debug.firebase.analytics.app com.ghw.sdk2

“调试”模式将保持启用状态,直至您通过执行以下命令明确停用“调试”模式:

开启调试后,打开管理后台,选择项目–分析–DebugView,能够看到目前正在调试的设备,以及上传的事件。

图片36

注意:为了防止测试和开发影响测量值,在调试模式下记录的事件将从总体 Analytics 数据中排除,并且不会包含在每日 BigQuery 导出报告中。

5.Twitter后台配置

5.1 Twitter后台应用配置

注册一个Twitter账号,打开Twitter开发者页面,如果您的Twitter账号不是开发者账号,还需要将Twitter账号注册成为开发者账号。进入My Apps页面,可管理应用。如果还没有应用,点击“Create New App”进入创建应用界面,填写相关信息新建应用。
Twitter-后台配置
新建应用后,点击应用列表中的应用,可以查看应用的详情。
Twitter-后台配置
点开“Keys and Access Tokens”标签可以看到ConsumerKey和ConsumerSecret
Twitter-后台配置

5.2 WINGSDK后台应用配置

将Twitter中新建应用的consumeKey和ConsumeSecret配置到WINGSDK后台。选中应用→设置→登录平台→添加Twitter登录平台,在“平台应用ID”中填写consumeKey,在“公钥”中填写consumeSecret。
Twitter-后台配置

6.Instagram后台配置

打开Instagram开发者页面,注册账号并登陆。点击“Manage Clients”标签打开应用列表,点击“Register a New Client”新建一个客户端。
Instagram-后台配置
在新建客户端的页面填写相关信息提交即可完成创建。
Instagram-后台配置
回到“Manage Clients”页面,点击刚刚新建的客户端可以查看详情,在这里可以看到Client ID和Client Secret。
Instagram-后台配置
新建的客户端的状态是“Sandbox”,在这种状态下,所有参与测试的人员都需要添加到“Sandbox”才能参与测试,添加用户到“Sandbox”的方法如下:打开“Sandbox”标签页面,输入邀请的用户名,用户名不是邮箱,一般用户名是注册邮箱@符号的前部分。注意,添加后一定要保存才能生效。保存后通知被邀请人接受邀请,可在“Sandbox Invites”看到邀请记录,接受邀请后的用户可以测试登录。
Instagram-后台配置
应用如果完成了测试要准备上线,需要将应用发布为正式状态,在“permissions”标签下,点击“Start a submission”进行权限申请。
Instagram-后台配置
在下一步选择“My app allows people to login with Instagram and share their own content.”,填写相关信息,这一步需要一个视频演示链接,完成提交后等待审核即可。
Instagram-后台配置

7.智能客服 AIHelp后台配置

AiHelp官方支持地址:
https://aihelp.net/elva/FAQ/FAQList.aspx?l=zh_CN&SectionID=0&pf_app_id=5

AiHelp 官方后台配置文档地址(页面内有下载链接介绍文档pdf):
https://aihelp.net/elva/FAQ/FAQList.aspx?SectionID=3392&LanguageID=5&pf_app_id=5&kmContentId=122760

已下是常用功能配置说明,需更多更详细请到官方下载最新pdf文档

7.1.新建应用

7.1.1 左侧“设置”-> “应用”-> “+”如下图位置

WechatIMG548
弹出界面,输入应用名称,点击“Add”完成新建 如下图
WechatIMG549

7.1.2 选择新建应用,如下图操作

WechatIMG550

选择中刚刚新建应用,会切换到应用下内容。

7.2.获取参数

如果不在需要app下,需按照 7.1.2 切换app
左侧“设置”-> “应用”-> “+”如下图位置

WechatIMG551

7.3.添加语言

设置语言后app应用Aihelp部分功能支持多语言。
左侧“设置”-> “语言”-> “添加语言”如下图位置
WechatIMG552
点击设置后,弹出语言列表,可以增加需要语言
WechatIMG553

7.4.配置FAQ

此功能配置是在app 应用中FAQ相关功能

7.4.1.新建FAQ分类

左侧“机器人”->“常见问题”-> “[分类]”-> “新增分类+” 如下图位置
WechatIMG554

弹出新增页面,输入名称和顺序编号后保存

WechatIMG556

WechatIMG555

分类列表会出现新建分类,左侧栏也会出现对应分类

7.4.2编辑FAQ分类

在分类列表中,点击如下图按钮
WechatIMG558

弹出详情页面,可做对应修改。其中中文,英文对应aihelp sdk显示的语言内容。

WechatIMG557

7.4.3.新建FAQ

在左侧栏选择FAQ分类->“新增FAQ”,如下图
WechatIMG559

弹出新增页面

WechatIMG560

7.4.4.编辑FAQ

在FAQ列表中,点击如下图按钮

WechatIMG562

弹出详情页面,其中语言对应aihelp sdk显示的语言内容。

WechatIMG563

7.4.5.发布FAQ

如,在热门问题分类下,创建了一个信息,然后发布流程
左侧“机器人”-> “常见问题”-> “发布” 如下图位置

WechatIMG564

7.5.配置运营模块Tab

此功能是app应用中运营界面功能

7.5.1.新建Tab

左侧“运营支持”-> “运营模块”-> “[Tab设置]”-> “新增Tab” 如下图位置
WechatIMG566

弹出新增页面

WechatIMG567

7.5.2.编辑Tab

左侧“运营支持”-> “运营模块”-> “[Tab设置]”-> 编辑,如下图

WechatIMG568

7.5.3.新建文章

左侧“运营支持”-> “运营模块”-> “[Tab列表]”,选择刚才创建的tab1,点击新建,如下图
WechatIMG569

弹出新增页面

WechatIMG570

7.5.4.编辑文章

在文章列表中,点击如下按钮
WechatIMG571

弹出详情页面,其中语言对应aihelp sdk显示的语言内容。

WechatIMG572

7.5.5.发布Tab

Tab要在app应用中显示需要发布,每次修改都需要发布。
左部“运营支撑”-> “运营模块”-> 需要发布的Tab -> “发布” 如下图位置
选择平台、语言后发布

WechatIMG573
发布后,效果图如下
WechatIMG575

8.华为HMS后台配置

8.1 基本流程

1、登录流程
WechatIMG575

参考:https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/dev-process-0000001050443773
2、支付流程
WechatIMG575
参考:https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/dev-process-0000001050033070

8.2 配置AppGallery Connect

1)注册成为开发者
2)在 AppGallery Connect创建项目、创建应用
A、 如果没有项目,则创建项目,我的项目—添加项目,输入项目名称,确认,则项目创建成功。
WechatIMG575

WechatIMG575
点击确定完成后,点击添加应用,跳转添加应用界面
WechatIMG575

WechatIMG575

注:需要集成支付能力,包名后缀必须为.HUAWEI或者.huawei

B、如果已存在项目,则可在项目下,创建具体的应用,一个项目下可创建多个应用
WechatIMG575


3)生成签名证书指纹
keytool -list -v -keystore C:\TestApp.jks
执行结果如下:

WechatIMG575

说明:C:\TestApp.jks表示应用签名文件,CP替换成自己的签名文件即可。

4)在“我的项目”中找到刚创建的项目项目,找到对应的应用,配置SHA256证书,如下图所示
WechatIMG575

5)打开相关服务
5.1)打开API权限服务,在“项目设置”->“API管理”菜单中,开启相应服务,如下图所示:
WechatIMG575
登录服务为 Auth Service,支付服务为 In-App Purchases,其他权限为创建应用默认开启的权限,可以忽略。

此操作为项目级别操作,操作完后,项目下所有应用都会有此权限。

5.2)配置支付参数
① 在我的项目中,选择具体某个应用,在左侧导航栏选择“盈利 > 应用内支付服务”,点击“设置”。

WechatIMG575
说明:如果首次配置会弹出签署协议弹框,其中订阅通知地址,可不填写

8.3.获取应用的AppGallery Connect配置文件

1)获取agconnect-services.json文件
WechatIMG575

8.4.配置商品

1)打开“ AppGallery Connect”->“我的应用”->“运营”菜单,如下:
WechatIMG575

2)点击“添加商品”,如下图所示:
WechatIMG575
填写商品相关的商品信息,点击保存即可,这里选择“消耗型”商品。

3)创建商品后,默认状态为失效状态,需要点击激活按钮:
WechatIMG575
点击后,提示此商品将被开放购买,点击确认。

8.5.配置沙盒测试账号

参考:https://developer.huawei.com/consumer/cn/doc/distribution/app/agc-tester_account_mgt

接入完支付sdk后,华为提供沙盒支付测试模式。打开华为AppGallery Connect管理后台,选择用户与访问,选择左侧沙盒测试栏目下的测试账号,点击新增,输入华为账号即可
WechatIMG575

WechatIMG575

注:测试帐号必须填写已注册、真实的华为帐号。

添加完成后,使用此沙盒测试账号,支付时,可以直接进行沙盒支付测试

8.6.配置华为分析

1)接入流程
WechatIMG575
2)后台开启分析服务

a、如果没有华为开发者联盟帐号,需要先注册帐号并通过实名认证。详细操作请参见帐号注册认证。
b、参见创建项目和在项目中添加应用完成应用的创建。
c、登录AppGallery Connect网站,点击“我的项目”图标
d、选择需要查看分析数据的应用。
e、点击“华为分析”下的任意菜单,并点击“启动分析服务”按钮可开通分析服务。(注:需拥有产品管理权限才可开通服务)

WechatIMG575

f、进入“项目接入设置”页面,设置数据存储位置、数据共享设置、支持行业分析、标识用户、时区、货币、设置用户数据留存时间、设置自然周定义后,点击“完成”,即完成Analytics Kit 服务开通。对于支持行业分析,如果您已经设置应用的分类情况,则默认开启

WechatIMG575

g、开启后,选择项目设置–我的项目–应用,下载最新的配置文件,给到研发进行更新

WechatIMG575

3)调试

1、开启/停用调试模式

调试模式打开后,所有事件将实时上报,在应用调试界面可实时查看上报的数据。
说明:请将命令行中的“package_name”字段替换为您的应用包名
数据成功上报后,“华为分析 > 应用调试”页面会展示出数据,如下图

WechatIMG575

2、您可执行如下命令行,停用调试模式

8.7.开通华为性能分析

参考:https://developer.huawei.com/consumer/cn/doc/development/AppGallery-connect-Guides/agc-apms-viewdata

进入“质量->性能管理”,如果APM服务未开通,请点击“立即开通”按钮,开通APM服务

WechatIMG575

说明:
由于开通服务时可能需要设置数据存储位置,设置数据存储位置后会刷新agconnect-services.json文件里的配置。如果您开通服务时设置了数据存储位置,在开通完成后您需要重新下载agconnect-services.json文件并集成到您的工程中。

Leave a Reply