广告接入优化

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

-## ZYouSDK V1.0.0文档接入使用
+## ZYouSDK V1.0.0文档接入使用
@@ -722,34 +722,41 @@ payNotify();
 ### 调用示例<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"];
 ```
 
 ### 12.6 激励广告回调
 ```
+/// 全自动加载失败
+/// - Parameters:
+///   - error: 错误信息
+- (void)didFailToAutoLoadADBlock:(void(^)(NSError *error))block;
+```
+```
 /// 广告位加载完成
 /// - Parameter placementID: 广告位ID
 - (void)didFinishLoadingADBlock:(void(^)(NSString *placementID))block;
@@ -762,6 +769,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 +872,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 +902,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