合并分支 'release' 到 'master'

新增购买商品上报接口

查看合并请求 zwwl/zw_game_sdk!273

iossdk_appstore对接说明文档_含广告分享.md

-## ZYouSDK V1.0.0文档接入使用
+## ZYouSDK V1.0.0文档接入使用
@@ -705,6 +705,7 @@ payNotify();
 ```
 ### 12.2 全自动加载所有激励广告
 ```
+/// 全自动加载所有激励广告
 - (void)autoLoadAllRewardedAd;
 ```
 ### 调用示例<a name="sec11.2"></a>
@@ -716,40 +717,55 @@ payNotify();
 ```
 /// 全自动加载多组场景的激励广告
 /// - Parameters:
-///   - RewardedSceneIDs: 场景ID组
-- (void)autoLoadRewardedAdRewardedSceneIDs:(NSArray *)RewardedSceneIDs;
+///   - sceneIDs: 场景ID组
+- (void)autoLoadRewardedAdSceneIDs:(NSArray *)sceneIDs;
 ```
 ### 调用示例<a name="sec11.2"></a>
 ```
  // 广告全自动加载多组场景，研发调用
-[[ZYouManager shareInstance] autoLoadRewardedAdRewardedSceneIDs:@[@"b1s8", @"b1s9"]];
+[[ZYouManager shareInstance] autoLoadRewardedAdSceneIDs:@[@"b1s8", @"b1s9"]];
 ```
-### 12.4 加载激励广告
+### 12.4 预加载激励广告
 ```
-/// 加载激励广告
+/// 预加载激励广告
 /// - Parameters:
-///   - RewardedPlacementID: 广告位ID
-///   - RewardedSceneID: 场景ID，可选，可在后台生成。没有可传入空字符串
-///   - extra: 额外信息字典，适用于广告平台的服务端激励验证，将被透传
-- (void)loadRewardedAd:(NSString *)RewardedPlacementID RewardedSceneID:(NSString *)RewardedSceneID extra:(NSDictionary *)extra;
+///   - sceneID: 场景ID
+- (void)loadRewardedAdSceneID:(NSString *)sceneID;
 ```
 ### 调用示例<a name="sec11.2"></a>
 ```
-// 广告加载，研发调用，第一次广告加载可放在游戏初始化完成后，第二次加载可放在第一次广告显示之后，依次类推
-[[ZYouManager shareInstance] loadRewardedAd:@"b1gumhqnlglb24" RewardedSceneID:@""  extra:loadConfigDict];
+// 广告预加载，研发调用
+[[ZYouManager shareInstance] loadRewardedAdSceneID:@"b1s8"];
 ```
 ### 12.5 显示激励广告
 ```
-- (void)showRewardedAd;
+/// 显示激励广告（无法展示时通过 didFailToShowADBlock 回调）
+/// - Parameters:
+///   - sceneID: 场景ID
+- (void)showRewardedAdSceneID:(NSString *)sceneID;
 ```
 ### 调用示例<a name="sec11.2"></a>
 ```
 // 广告显示，在研发需要进行广告显示的按钮或图标点击事件中调用
-[[ZYouManager shareInstance] showRewardedAd];
+[[ZYouManager shareInstance] showRewardedAdSceneID:@"b1s8"];
 ```
 
+说明：
+
+a)在游戏启动后全自动加载，如果已经加载所有场景，后面无需再手动预加载
+
+b)手动预加载目前为可选接入，游戏中需要单独加载某个场景广告，提前预加载传入场景id即可
+
+c)广告显示目前只有一种方法，传入需要显示的场景id即可
+
 ### 12.6 激励广告回调
 ```
+/// 全自动加载失败
+/// - Parameters:
+///   - error: 错误信息
+- (void)didFailToAutoLoadADBlock:(void(^)(NSError *error))block;
+```
+```
 /// 广告位加载完成
 /// - Parameter placementID: 广告位ID
 - (void)didFinishLoadingADBlock:(void(^)(NSString *placementID))block;
@@ -762,6 +778,13 @@ payNotify();
 - (void)didFailToLoadADBlock:(void(^)(NSString *placementID, NSError *error))block;
 ```
 ```
+/// 广告位显示失败（sceneID 无效、无广告位、未就绪等）
+/// - Parameters:
+///   - placementID: 广告位ID
+///   - error: 错误信息
+- (void)didFailToShowADBlock:(void(^)(NSString *placementID, NSError *error))block;
+```
+```
 /// 获得展示收益
 /// - Parameters:
 ///   - placementID: 广告位ID
@@ -858,6 +881,16 @@ payNotify();
 ```
 
 ### 调用示例<a name="sec11.2"></a>
+下面的toastView为Demo展示，实际项目根据自身需求处理
+
+```
+/// 全自动加载失败
+/// - Parameter error: 错误信息
+[[ZYouManager shareInstance] didFailToAutoLoadADBlock:^(NSError * _Nonnull error) {
+    NSString *msg = [NSString stringWithFormat:@"广告全自动加载失败,%@", error];
+    [self toastView:msg];
+}];
+```
 
 ```
 /// 广告位加载完成
@@ -878,6 +911,16 @@ payNotify();
 }];
 ```
 ```
+/// 广告位显示失败（sceneID 无效、无广告位、未就绪等）
+/// - Parameters:
+///   - placementID: 广告位ID
+///   - error: 错误信息
+[[ZYouManager shareInstance] didFailToShowADBlock:^(NSString * _Nonnull placementID, NSError * _Nonnull error) {
+    NSString *msg = [NSString stringWithFormat:@"广告展示失败%@ %@", placementID.length ? placementID : @"", error.localizedDescription];
+    [self toastView:msg];
+}];
+```
+```
 /// 获得展示收益
 /// - Parameters:
 ///   - placementID: 广告位ID
@@ -1062,6 +1105,13 @@ payNotify();
 ```
  [[ZYouManager shareInstance] zy_openSdkEvent:@"serviceCenterUrl"];
 ```
+### 调用示例<a name="sec11.2"></a>
+
+&nbsp;&nbsp; 活动站跳转
+
+```
+ [[ZYouManager shareInstance] zy_openSdkEvent:@"activityStationUrl"];
+```
 
 ## 服务端接口   调用方直接使用http 调用接口：
 

服务端接口.md

-# 服务端接口说明
+# 服务端接口说明
@@ -56,6 +56,8 @@
 
         3.1.15 [装备日志上报接口](#sec3.1.15)
 
+        3.1.16 [种花主游戏内指定购买指定商品上报](#sec3.1.16)
+
       [签名规则2](#sigin2)
 
         3.2.1 [AI敏感词聊天记录上报](#sec3.2.1)
@@ -672,6 +674,36 @@
 | status_code | 是       | int      | 1 成功  2 失败        |
 | msg  | 是       | string   | 返回信息  ： 操作成功 |
 
+### 3.1.16 种花主游戏内指定购买指定商品上报<a name="sec3.1.16"></a>
+
+> 接口需要进行签名，签名方法详见[签名规则1](#sigin1)
+
+接口地址:/server/activity_product/reportLog
+
+请求数据
+
+| 字段               | 是否必传 | 字段类型     |                           |      |
+|------------------|------|----------|---------------------------|------|
+| zw_app_id        | 是    | String   | 掌玩appId                   |      |
+| cp_role_id       | 是    | String   | 购买角色ID                    |      |
+| player_id        | 是    | Int      | 玩家id                      |      |
+| product_id       | 是    | String   | 商品id                      |      |
+| product_name     | 是    | String   | 商品名称                      |      |
+| product_cnt      | 否    | String   | 商品数量                      |      |
+| product_price    | 是    | String   | 商品价格（分）                   |      |
+| pay_time         | 是    | String   | 支付时间（时间戳）                 |      |
+| order_time       | 是    | String   | 下单时间（时间戳）                 |      |
+
+
+
+返回数据
+
+|      | 是否必要 | 字段类型 |                       |
+| ---- | -------- | -------- | --------------------- |
+| status_code | 是       | int      | 1 成功  2 失败        |
+| msg  | 是       | string   | 返回信息  ： 操作成功 |
+
+
 
 ##### 签名规则2<a name="sigin2"></a>
 1. POST      数据结构  JSON