• 抖音广告IOS/Android接入笔记：

    一、抖音广告接入（Android接入）

    注意：内容输出对接中已包含广告对接，建议使用广告4.6.0.7版本，如使用其他广告版本建议做好自测

    1.  
    2. //2600及以上版本，需要使用如下Maven命令
    3. //火山引擎maven仓库地址
    4. maven{url 'https://artifact.bytedance.com/repository/Volcengine/'}
    5. //穿山甲maven仓库地址
    6. maven{url 'https://artifact.bytedance.com/repository/pangle'}
    7. //为保证兼容性 建议使用广告SDK版本
    8. implementation 'com.pangle.cn:ads-sdk-pro:4.6.0.7'
    9. implementation ('com.pangle.cn:pangrowth-sdk:2.9.0.4'){
    10. 	exclude group: 'com.pangle.cn', module: 'partner-live-sdk'
    11. 	exclude group: 'com.pangle.cn', module: 'pangrowth-novel-sdk'
    12. 	exclude group: 'com.pangle.cn', module: 'pangrowth-game-sdk'
    13. 	exclude group: 'com.pangle.cn', module: 'pangrowth-luckycat-sdk'
    14. 	exclude group: 'com.pangle.cn', module: 'pangrowth-reward-sdk'
    15. 	exclude group: 'com.pangle.cn', module: 'partner-luckycat-api-sdk'
    16. 	exclude group: 'com.pangle.cn', module: 'pangrowth-luckycat-api'
    17. }

    二、抖音广告接入（IOS接入）

    （一）静态短视频

    1.  
    2. source 'https://github.com/CocoaPods/Specs.git'
    3. source 'https://github.com/volcengine/volcengine-specs.git'
    4. pod 'Ads-CN', '4.6.0.0' #为保证兼容性 建议使用广告SDK版本
    5. pod 'Pangrowth', '3.0.0.0', :subspecs => [ 'media' ]

    （二）动态短视频

    1.  
    2. source 'https://github.com/CocoaPods/Specs.git'
    3. source 'https://github.com/volcengine/volcengine-specs.git'
    4. pod 'Ads-CN', '4.6.0.0' #为保证兼容性 建议使用广告SDK版本
    5. pod 'Pangrowth', '3.0.0.0', :subspecs => [ 'media-dynamic' ]

    三、抖音开屏广告****接入新规-2022年11月

    （一）Android开屏广告接入

    新版开屏广告说明

    为提高开发者的收入体验，新版开屏广告降低开发者的接入成本，烦请开发者详读本文档，以避免出现接入错误。

    重大变化

    旧接口废弃&新增 （直接从4700版本开始接入的新用户无需看此部分，可以直接从老版本升级上来的需要阅读此部分区分新老接口区别）

    开屏请求、回调接口变更

    目前4700Android 在创建TTAdNative对象以及创建广告请求AdSlot阶段和之前保持一致，在调用loadSplashAd接口时新增了新的加载开屏接口，新老接口对比以及示例：

    1.接口规范

    1. /**
    2.  * @param adSlot   请求配置信息
    3.  * @param listener 加载结果回调
    4.  * @param timeOut  加载超时时间
    5.  * 异步加载Splash广告，结果会通过CSJSplashAdListener回调
    6.  */
    7. void loadSplashAd(AdSlot adSlot, CSJSplashAdListener listener, int timeOut);
    8.  
    9. /**
    10.  * 开屏广告加载监听器
    11.  */
    12. interface CSJSplashAdListener{
    13.     //广告物料、素材加载成功回调
    14.     void onSplashLoadSuccess();
    15.  
    16.     //广告物料或素材加载失败或超时回调
    17.     void onSplashLoadFail(CSJAdError csjAdError);
    18.  
    19.     /**
    20.      * 广告渲染回调，接入方可以在这个回调中，调用ad.showSplashView(splashContainerView)进行渲染
    21.      * @param ad 开屏广告接口
    22.      */
    23.     void onSplashRenderSuccess(CSJSplashAd ad);
    24.  
    25.     //广告渲染失败或超时回调
    26.     void onSplashRenderFail(CSJSplashAd ad, CSJAdError csjAdError);
    27. }

    2.代码示例

    2.1代码实现

    1. mTTAdNative.loadSplashAd(adSlot, new TTAdNative.CSJSplashAdListener() {
    2.  
    3.     @Override
    4.     public void onSplashLoadSuccess() {
    5.  
    6.     }
    7.  
    8.     @Override
    9.     public void onSplashLoadFail(CSJAdError error) {
    10.         showToast(error.getMsg());
    11.         goToMainActivity();
    12.     }
    13.  
    14.     @Override
    15.     public void onSplashRenderSuccess(CSJSplashAd ad) {
    16.         if (ad == null) {
    17.             return;
    18.         }
    19.         mSplashAd = ad;
    20.         mSplashAd.showSplashView(mSplashContainer);
    21.     }
    22.  
    23.     @Override
    24.     public void onSplashRenderFail(CSJSplashAd ad, CSJAdError csjAdError) {
    25.         showToast(csjAdError.getMsg());
    26.         goToMainActivity();
    27.     }
    28. }, AD_TIME_OUT);

    2.2接口回调代码示例

    1. package com.bytedance.sdk.openadsdk;
    2.  
    3. import android.app.Activity;
    4. import android.view.View;
    5. import android.view.ViewGroup;
    6. import java.util.Map;
    7.  
    8. public interface CSJSplashAd extends TTClientBidding {
    9.     /**
    10.      * 获取开屏广告
    11.      *
    12.      * @return
    13.      */
    14.  
    15.     View getSplashView();
    16.  
    17.     /**
    18.      * 获取点睛view
    19.      * @return
    20.      */
    21.  
    22.     View getSplashClickEyeView();
    23.  
    24.     /**
    25.      * 获取卡片view
    26.      *
    27.      * @return
    28.      */
    29.  
    30.     View getSplashCardView();
    31.  
    32.     /**
    33.      * 得到Splash广告的交互类型
    34.      *
    35.      * @return 2在浏览器内打开 （普通类型）3落地页（普通类型），5:拨打电话 -1 未知类型
    36.      */
    37.     int getInteractionType();
    38.  
    39.     /**
    40.      * 设置开屏广告不开启倒计时功能、不显示跳过按钮
    41.      */
    42.     void hideSkipButton();
    43.  
    44.     /**
    45.      * 返回广告额外信息
    46.      */
    47.     Map<String, Object> getMediaExtraInfo();
    48.  
    49.     interface SplashAdListener {
    50.  
    51.         //开屏展示
    52.         void onSplashAdShow(CSJSplashAd ad);
    53.  
    54.         //开屏点击
    55.         void onSplashAdClick(CSJSplashAd ad);
    56.  
    57.         //开屏关闭
    58.         void onSplashAdClose(CSJSplashAd ad, int closeType);
    59.     }
    60.  
    61.     /**
    62.      * 注册Splash广告的下载回调
    63.      *
    64.      * @param downloadListener 下载回调监听器
    65.      */
    66.     void setDownloadListener(TTAppDownloadListener downloadListener);
    67.  
    68.     /**
    69.      * 注册开屏阶段回调
    70.      *
    71.      * @param splashAdListener
    72.      */
    73.     void setSplashAdListener(SplashAdListener splashAdListener);
    74.  
    75.     int[] getSplashClickEyeSizeToDp();
    76.  
    77.     /**
    78.      * 通知sdk开始点睛动画
    79.      */
    80.     void startClickEye();
    81.  
    82.     interface SplashClickEyeListener {
    83.         //通知媒体可以展示点睛
    84.         void onSplashClickEyeReadyToShow(CSJSplashAd bean);
    85.  
    86.         //媒体点睛点击回调
    87.         void onSplashClickEyeClick();
    88.  
    89.         //点睛关闭回调
    90.         void onSplashClickEyeClose();
    91.     }
    92.  
    93.     interface SplashCardListener {
    94.         //通知媒体可以展示卡片
    95.         void onSplashCardReadyToShow(CSJSplashAd bean);
    96.  
    97.         //媒体卡片点击回调
    98.         void onSplashCardClick();
    99.  
    100.         //卡片关闭回调
    101.         void onSplashCardClose();
    102.     }
    103.  
    104.     /**
    105.      * 注册点睛阶段回调
    106.      * @param clickEyeListener
    107.      */
    108.     void setSplashClickEyeListener(SplashClickEyeListener clickEyeListener);
    109.  
    110.  
    111.     /**
    112.      * 注册卡片阶段回调
    113.      *
    114.      * @param cardListener
    115.      */
    116.     void setSplashCardListener(SplashCardListener cardListener);
    117.  
    118.     /**
    119.      * 告知sdk展示开屏
    120.      * @param viewGroup
    121.      */
    122.     void showSplashView(ViewGroup viewGroup);
    123.  
    124.     /**
    125.      * 告知sdk展示点睛
    126.      * @param viewGroup
    127.      */
    128.     void showSplashClickEyeView(ViewGroup viewGroup);
    129.  
    130.     /**
    131.      * 告知sdk展示卡片
    132.      * @param viewGroup
    133.      */
    134.     void showSplashCardView(ViewGroup viewGroup, Activity activity);
    135.  
    136. }

    2.3交互接口新

    1. interface SplashAdListener {
    2.  
    3.     //开屏展示
    4.     void onSplashAdShow(CSJSplashAd ad);
    5.  
    6.     //开屏点击
    7.     void onSplashAdClick(CSJSplashAd ad);
    8.  
    9.     //开屏关闭(开屏跳过以及倒计时结束统一收敛到该接口)
    10.     void onSplashAdClose(CSJSplashAd ad, int closeType);
    11. }

    2.4点晴新接口

    1. interface SplashClickEyeListener 
    2. { 
    3. //通知媒体可以展示点睛 
    4. void onSplashClickEyeReadyToShow(CSJSplashAd bean); 
    5. //媒体点睛点击回调 void onSplashClickEyeClick(); 
    6. //点睛关闭回调 
    7. void onSplashClickEyeClose(); 
    8. }

    2.5卡片新接口

    1. interface SplashCardListener {
    2.     //通知媒体可以展示卡片
    3.     void onSplashCardReadyToShow(CSJSplashAd bean);
    4.  
    5.     //媒体卡片点击回调
    6.     void onSplashCardClick();
    7.  
    8.     //卡片关闭回调
    9.     void onSplashCardClose();
    10. }

    2.6开屏广告接入接口说明

    开屏广告： 开屏广告为用户在进入App时展示的全屏广告。开屏广告为一个View，宽高默认为match_parent。注意： 开屏广告view：width =屏幕宽；height需要>=75%屏幕高 ，否则会影响计费。支持的广告尺寸：开屏广告的尺寸为开发者请求广告时设置的尺寸，建议设置的请求尺寸传入与展示区域大小保持一致，避免素材变形。

    1. public interface CSJSplashAd extends TTClientBidding {
    2.     /**
    3.      * 获取开屏广告
    4.      *
    5.      * @return
    6.      */
    8.     View getSplashView();
    9.  
    10.     /**
    11.      * 获取点睛view
    12.      * @return
    13.      */
    15.     View getSplashClickEyeView();
    16.  
    17.     /**
    18.      * 获取卡片view
    19.      *
    20.      * @return
    21.      */
    23.     View getSplashCardView();
    24.  
    25.     /**
    26.      * 得到Splash广告的交互类型
    27.      *
    28.      * @return 2在浏览器内打开 （普通类型）3落地页（普通类型），5:拨打电话 -1 未知类型
    29.      */
    30.     int getInteractionType();
    31.  
    32.     /**
    33.      * 设置开屏广告不开启倒计时功能、不显示跳过按钮
    34.      */
    35.     void hideSkipButton();
    36.  
    37.     /**
    38.      * 返回广告额外信息
    39.      */
    40.     Map<String, Object> getMediaExtraInfo();
    41.  
    42.     interface SplashAdListener {
    43.  
    44.         //开屏展示
    45.         void onSplashAdShow(CSJSplashAd ad);
    46.  
    47.         //开屏点击
    48.         void onSplashAdClick(CSJSplashAd ad);
    49.  
    50.         //开屏关闭
    51.         void onSplashAdClose(CSJSplashAd ad, int closeType);
    52.     }
    53.  
    54.     /**
    55.      * 注册Splash广告的下载回调
    56.      *
    57.      * @param downloadListener 下载回调监听器
    58.      */
    59.     void setDownloadListener(TTAppDownloadListener downloadListener);
    60.  
    61.     /**
    62.      * 注册开屏阶段回调
    63.      *
    64.      * @param splashAdListener
    65.      */
    66.     void setSplashAdListener(SplashAdListener splashAdListener);
    67.  
    68.     int[] getSplashClickEyeSizeToDp();
    69.  
    70.     /**
    71.      * 通知sdk开始点睛动画
    72.      */
    73.     void startClickEye();
    74.  
    75.     interface SplashClickEyeListener {
    76.         //通知媒体可以展示点睛
    77.         void onSplashClickEyeReadyToShow(CSJSplashAd bean);
    78.  
    79.         //媒体点睛点击回调
    80.         void onSplashClickEyeClick();
    81.  
    82.         //点睛关闭回调
    83.         void onSplashClickEyeClose();
    84.     }
    85.  
    86.     interface SplashCardListener {
    87.         //通知媒体可以展示卡片
    88.         void onSplashCardReadyToShow(CSJSplashAd bean);
    89.  
    90.         //媒体卡片点击回调
    91.         void onSplashCardClick();
    92.  
    93.         //卡片关闭回调
    94.         void onSplashCardClose();
    95.     }
    96.  
    97.     /**
    98.      * 注册点睛阶段回调
    99.      * @param clickEyeListener
    100.      */
    101.     void setSplashClickEyeListener(SplashClickEyeListener clickEyeListener);
    102.  
    103.  
    104.     /**
    105.      * 注册卡片阶段回调
    106.      *
    107.      * @param cardListener
    108.      */
    109.     void setSplashCardListener(SplashCardListener cardListener);
    110.  
    111.     /**
    112.      * 告知sdk展示开屏
    113.      * @param viewGroup
    114.      */
    115.     void showSplashView(ViewGroup viewGroup);
    116.  
    117.     /**
    118.      * 告知sdk展示点睛
    119.      * @param viewGroup
    120.      */
    121.     void showSplashClickEyeView(ViewGroup viewGroup);
    122.  
    123.     /**
    124.      * 告知sdk展示卡片
    125.      * @param viewGroup
    126.      */
    127.     void showSplashCardView(ViewGroup viewGroup, Activity activity);
    128.  
    129. }

    2.7开屏广告请求广告接口说明

    1. mTTAdNative.loadSplashAd(adSlot, new TTAdNative.CSJSplashAdListener() {
    2.  
    3.     //开屏素材加载成功
    4.     @Override
    5.     public void onSplashLoadSuccess() {
    6.  
    7.     }
    8.  
    9.     //加载开屏素材失败
    10.     @Override
    11.     public void onSplashLoadFail(CSJAdError error) {
    12.         //开发者处理跳转到APP主页面逻辑
    13.     }
    14.  
    15.     //开屏渲染成功，可以展示开屏
    16.     @Override
    17.     public void onSplashRenderSuccess(CSJSplashAd ad) {
    18.     
    19.       if (ad == null) {
    20.             return;
    21.         }
    22.         if (mSplashContainer != null && !SplashActivity.this.isFinishing()) {
    23.             mSplashContainer.removeAllViews();
    24.             //把SplashView 添加到ViewGroup中,注意开屏广告view：width =屏幕宽；height >=75%屏幕高
    25.              ad.showSplashView(mSplashContainer);
    26.             //设置不开启开屏广告倒计时功能以及不显示跳过按钮,如果这么设置，您需要自定义倒计时逻辑
    27.             //ad.setNotAllowSdkCountdown();
    28.         }else {
    29.             //开发者处理跳转到APP主页面逻辑
    30.         }
    31.         if (ad == null) {
    32.             return;
    33.         }
    34.       
    35.     }
    36.  
    37.     @Override
    38.     public void onSplashRenderFail(CSJSplashAd ad, CSJAdError csjAdError) {
    39.        //开发者处理跳转到APP主页面逻辑
    40.     }
    41. }, AD_TIME_OUT);

    2.8广告交互监听器

    1. interface SplashAdListener {
    2.  
    3.     //开屏展示
    4.     void onSplashAdShow(CSJSplashAd ad);
    5.  
    6.     //开屏点击
    7.     void onSplashAdClick(CSJSplashAd ad);
    8.  
    9.     //开屏关闭
    10.     void onSplashAdClose(CSJSplashAd ad, int closeType);
    11. }

    2.9移除广告

    可在Activity跳转到其他Activity时把广告控件上的广告视图remove掉

    mSplashContainer.removeAllViews();

    3.0开屏广告衔接注意

    1、模板渲染的开屏请求方法需设置setExpressViewAcceptedSize参数 单位dp。非模板渲染开屏请求方法需设置setImageAcceptedSize参数 单位px 。切记不可使用错误

    2、开屏广告加载超时时间建议大于3500ms，最大程度的保证广告的展示率可开屏体验,示例设置了3500ms

    3、为了收益最大化所有开屏广告均要实时请求，不可缓存。

    4、开发者要在onSplashLoadFail()、onSplashRenderFail()、onSplashAdClose()回调及CSJSplashAd广告为null时开发者做跳转主页面的处理，跳转之后开屏控件上的view移除。

    5、需要开发者在开屏Activity中onStop()中做一个标记 在onResume()中做跳转主页面的逻辑处理，跳转之后开屏控件上的view移除。

    1. @Override
    2. protected void onResume() {
    3.     //判断是否该跳转到主页面
    4.     if (mForceGoMain) {
    5.         goToMainActivity();
    6.     }
    7.     super.onResume();
    8. }
    9.  
    10. @Override
    11. protected void onStop() {
    12.     super.onStop();
    13.     mForceGoMain = true;
    14. }

    6、如果要在底部添加自身logo，需要缩小的开屏广告的展示区域，此时请求的时候宽和高填写裁剪后宽和高即可，即请求尺寸为屏幕宽*（屏幕高-logo高）

    （二）iOS新版开屏广告接入

    新版开屏广告使用BUSplashAd对象管理开屏广告所有业务。开屏广告所有视图的展示和移除将由SDK统一管理，开发者无需关心。 接入方式上，使用BUSplashAd对象调用loadAdData方法请求广告，调用show方法展示广告，通过设置BUSplashAdDelegate代理，获取广告加载、 渲染、点击、关闭、跳转等回调。

    1.服务范围

    创建广告位对象、请求广告、展示广告

    2.传入广告位ID

    1. _splashAd = [[BUSplashAd alloc] initWithSlotID:slotID adSize:size];
    2. // 设置开屏广告代理
    3. _splashAd.delegate = self;
    4. // 加载广告
    5. [_splashAd loadAdData];

    3.广告物料、素材加载成功后，会回调splashAdLoadSuccess：方法，在这里调用show方法展示广告：

    1. - (void)splashAdLoadSuccess:(BUSplashAd *)splashAd {
    2.     // 使用应用keyWindow的rootViewController（接入简单，推荐）
    3.     UIWindow *keyWindow = [[[UIApplication sharedApplication] delegate] window];   
    4.     [splashAd showSplashViewInRootViewController:keyWindow.rootViewController];
    5. }

  • 相关阅读:
    C：宏定义中使用do{...}while(0)
    恐怖片里，人工智能大开杀戒
    Js各种时间转换问题（YYYY-MM-DD 时间戳 中国标准时间）
    MySQL Binlog 简介
    【一键生成】3DMAX配景楼生成插件使用教程
    打印机不能正常打印怎么办
    vscode编辑器创建分支注意事项？！
    【计算机网络】介质访问控制
    ShardingSphere主从复制
    2022 年首届钉钉杯大学生大数据挑战赛初赛的Baseline
  • 原文地址：https://blog.csdn.net/baidu_31002735/article/details/127985473