所有的Key和Value数据类型均为String
| 广告平台ID | 广告平台名称 | auth_content (所有的key对应的value的值都是string类型) key名称后面带(必填)表示8.1接口创建/修改广告平台无论是否开通报表,都需要传该属性 | app_auth_content (所有的key对应的value的值都是string类型) | 广告样式 | adsource_token (所有的key对应的value的值都是string类型)key名称后面带(唯一)表示第三方平台的广告源唯一标识,多个key(唯一)标识组合唯一,9.1接口同一个三方平台的广告源唯一标识不允许创建重复的TopOn广告源 | adsource_token对应枚举值 |
|---|---|---|---|---|---|---|
| 1 | - | app_id app_token property_id | rewarded_video interstitial | unit_id(唯一) | ||
| 1 | - | app_id app_token property_id | banner | unit_id(唯一) size | size枚举值:320x50,320x90,300x250 | |
| 1 | - | app_id app_token property_id | native | unit_id(唯一) unit_type height | unit_type枚举值:0-native,1-native banner; height枚举值:50,100,120 | |
| 2 | Admob | account_id oauth_key | app_id | rewarded_video interstitial | unit_id(唯一) | |
| 2 | Admob | account_id oauth_key | app_id | banner | unit_id(唯一) size | size枚举值:320x50,320x100,300x250,468x60,728x90 |
| 2 | Admob | account_id oauth_key | app_id | native | unit_id(唯一) media_ratio(可选) | media_ratio枚举值:0-未指定(默认),1-任意尺寸,2-横屏,3-竖屏,4-正方形 |
| 2 | Admob | account_id oauth_key | app_id | splash | unit_id(唯一) orientation(可选) | orientatio枚举值:1-Portrait(默认),2-Landscape |
| 3 | Inmobi | username password apikey app_id(必填) | - | native rewarded_video interstitial | unit_id(唯一) | |
| 3 | Inmobi | username password apikey app_id(必填) | - | banner | unit_id(唯一) size | size枚举值:320x50 |
| 4 | Flurry | token | sdk_key | native rewarded_video interstitial | ad_space(唯一) | |
| 4 | Flurry | token | sdk_key | banner | ad_space(唯一) size | size枚举值:320x50 |
| 5 | Applovin | sdkkey(必填) apikey | - | native | - (唯一属性为TopOn广告位ID) | |
| 5 | Applovin | sdkkey(必填) apikey | - | rewarded_video interstitial | zone_id(唯一) | |
| 5 | Applovin | sdkkey(必填) apikey | - | banner | zone_id(唯一) size | size枚举值:320x50,300x250 |
| 6 | Mintegral | skey secret appkey(必填) | appid | native | placement_id unitid (唯一) unit_type(必填) video_muted (可选) video_autoplay (可选) close_button (可选) | unit_type枚举值:0-原生自定义渲染 , 1-原生自动渲染 video_muted枚举值:0-静音(默认),1-不静音 video_autoplay枚举值:1-仅WiFi网络, 2-手动点击, 3-自动播放(默认) close_button枚举值:0-显示(默认), 1-不显示 |
| 6 | Mintegral | skey secret appkey(必填) | appid | rewarded_video | placement_id unitid(唯一) video_muted (可选) | video_muted枚举值:0-静音(默认),1-不静音 |
| 6 | Mintegral | skey secret appkey(必填) | appid | splash | placement_id unitid(唯一) countdown (可选) allows_skip (可选) orientation (可选) | countdown:2秒~10秒,默认5秒 allows_skip枚举值:0-关,默认;1-开 orientation枚举值:1-Portrait(默认), 2-Landscape |
| 6 | Mintegral | skey secret appkey(必填) | appid | banner | placement_id unitid(唯一) size | size枚举值:320x50,300x250,320x90,smart |
| 6 | Mintegral | skey secret appkey(必填) | appid | interstitial | placement_id unitid(唯一) is_video video_muted (可选) | is_video枚举值:0-插屏图片,1-插屏视频(默认) video_muted枚举值:0-静音(默认),1-不静音 |
| 7 | Mopub | repkey apikey | - | native rewarded_video interstitial | unitid(唯一) | |
| 7 | Mopub | repkey apikey | - | banner | unitid(唯一) size | size枚举值:320x50,300x250,728x90 |
| 8 | 腾讯广告 | 当api_version=1时 agid publisher_id app_key qq 当api_version=2时 account_id secret_key | app_id | native | unit_id(唯一) unit_version unit_type video_muted (可选) video_autoplay (可选) video_duration (可选) | unit_version枚举值:1- 1.0版本,2- 2.0版本unit_type枚举值:1-平台模板渲染,2-开发者自渲染 ,3-视频贴片广告(模板渲染),4-视频贴片广告(自渲染) video_muted枚举值:1-Yes(静音,默认), 0-No(有声音) video_autoplay枚举值:0-WiFi 网络自动播放,4G 网络手动点击播放; 1-总是自动播放( 默认); 2-点击播放 video_duration: 视频最大时长,可选时长(5~61秒),0代表不限时长,不传时默认60秒 |
| 8 | 腾讯广告 | 当api_version=1时 agid publisher_id app_key qq 当api_version=2时 account_id secret_key | app_id | rewarded_video | unit_id(唯一) personalized_template video_muted (可选) | personalized_template枚举值:0-SDK原生渲染(默认), 1- 平台模板2.0 video_muted枚举值:1-Yes(静音, 默认), 0-No(有声音) |
| 8 | 腾讯广告 | 当api_version=1时 agid publisher_id app_key qq 当api_version=2时 account_id secret_key | app_id | splash | unit_id(唯一) zoomoutad_sw | zoomoutad_sw枚举值:1-不使用开屏V+功能(默认), 2-使用开展V+功能 |
| 8 | 腾讯广告 | 当api_version=1时 agid publisher_id app_key qq 当api_version=2时 account_id secret_key | app_id | banner | unit_id(唯一) unit_version size | unit_version枚举值:2 size枚举值:320x50 |
| 8 | 腾讯广告 | 当api_version=1时 agid publisher_id app_key qq 当api_version=2时 account_id secret_key | app_id | interstitial | unit_id(唯一) unit_version is_fullscreen video_muted(可选) video_autoplay(可选) video_duration(可选) personalized_template | unit_version枚举值:2 is_fullscreen枚举值:0-No,1-Yes (默认) video_muted枚举值:1-Yes(静音,默认),0-No(有声音) video_autoplay枚举值:0-(WiFi 网络自动播放,4G 网络手动点击播放), 1-(WiFi 和4G 网络都自动播放,默认值为 1 ),2-点击播放 video_duration: 视频最大时长,可选时长(5~61秒),0代表不限时长,不传时默认60秒 personalized_template枚举值:0-否(默认), 1- 平台模板2.0 |
| 9 | Chartboost | user_id user_signature | app_id app_signature | rewarded_video interstitial | location(唯一) | - |
| 9 | Chartboost | user_id user_signature | app_id app_signature | banner | location(唯一) size | location枚举值: Default Startup Home Screen Main Menu Game Screen Achievements Quests Pause Level Start Level Complete Turn Complete IAP Store Item Store Game Over Leaderboard Settings Quit size枚举值:320x50 (默认), 300x250, 728x90 |
| 10 | Tapjoy | apikey | sdk_key | rewarded_video interstitial | placement_name(唯一) | - |
| 11 | Ironsource | username secret_key | app_key | rewarded_video interstitial | instance_id(唯一) | - |
| 12 | UnityAds | apikey organization_core_id | game_id | rewarded_video interstitial | placement_id(唯一) | - |
| 12 | UnityAds | apikey organization_core_id | game_id | banner | placement_id(唯一) size | size枚举值:320x50, 468x60, 728x90 |
| 13 | Vungle | apikey account_id(必填) | app_id | rewarded_video interstitial | placement_id(唯一) | - |
| 13 | Vungle | apikey account_id(必填) | app_id | banner | placement_id(唯一) unit_type size_type | unit_type枚举值:0- Banner, 1- MREC size_type枚举值: (unit_type =0 时可选: 2-320x50, 3-300x50, 4-728x90), (unit_type =1 时可选: 0-300x250) |
| 14 | AdColony | user_credentials | app_id | rewarded_video interstitial | zone_id(唯一) | - |
| 14 | AdColony | user_credentials | app_id | banner | zone_id(唯一) size | size枚举值:320x50,300x250, 728x90, 160x600 |
| 15 | 穿山甲 | user_id secure_key | app_id | native | slot_id(唯一) is_video layout_type media_size | is_video枚举值:0-信息源广告 (默认), 1-Draw信息流广告, 2-Banner广告(原生类型=自渲染), 3-插屏广告(原生类型=自渲染),4-视频贴片广告 layout_type枚举值:0-模板渲染 (默认),1-自渲染 media_size枚举值(layout_type = 1必填):1 - 690x388px (默认), 2 - 228x150px |
| 15 | 穿山甲 | user_id secure_key | app_id | rewarded_video | slot_id(唯一) personalized_template | personalized_template枚举值:0- 非个性化模板, 1- 个性化模板(默认) |
| 15 | 穿山甲 | user_id secure_key | app_id | banner | slot_id(唯一) layout_type size | layout_type枚举值:1 size枚举值:640x100,600x90,600x150,600x500,600x400,600x300,600x260,690x388 |
| 15 | 穿山甲 | user_id secure_key | app_id | interstitial | slot_id(唯一) is_video layout_type size personalized_template | is_video枚举值:0-插屏广告, 1-全屏视频广告 (默认)2- 新插屏广告 layout_type枚举值:1 size枚举值:1:1, 3:2, 2:3 (默认) personalized_template枚举值:0-非个性化模板, 1-个性化模板(默认) |
| 15 | 穿山甲 | user_id secure_key | app_id | splash | slot_id(唯一) personalized_template zoomoutad_sw | personalized_template枚举值:0-非个性化模板 zoomoutad_sw枚举值:1-否,不设置开展点睛的icon (默认);2-是,开展点睛的icon设置成Yes |
| 21 | AppNext | email password key | - | native rewarded_video interstitial | placement_id(唯一) | - |
| 21 | AppNext | email password key | - | banner | placement_id(唯一) size | size枚举值:320x50,320x100,300x250 |
| 22 | Baidu | access_key | app_id | native | ad_place_id(唯一) unit_type cta_button button_type dl_type | 注意:unit_type=0时cta_button,button_type,dl_type值按默认值传参即可 unit_type枚举值:0:自渲染(默认);1:模板渲染 cta_button枚举值:0:按百度默认值处理(默认);1:显示CTA Button;2:不显示CTA Button button_type枚举值:0:按百度默认值处理(默认);1:全屏可点击;2:仅CTA可点击 dl_type枚举值:0:按百度默认值处理(默认);1:无二次确认弹窗;2:显示二次确认弹窗并调用应用信息(四要素等) |
| 22 | Baidu | access_key | app_id | rewarded_video | ad_place_id(唯一) | - |
| 22 | Baidu | access_key | app_id | banner | ad_place_id(唯一) size | size枚举值:375x56,200x30,375x250,200x133,375x160,200x85,375x187,200x100 |
| 22 | Baidu | access_key | app_id | interstitial | ad_place_id(唯一) unit_type | unit_type枚举值:0:插屏 ;1:全屏视频;2:模板插屏 |
| 22 | Baidu | access_key | app_id | splash | ad_place_id(唯一) button_type | button_type枚举值:0:按百度默认值处理(默认);1:全屏可点击;2:仅CTA可点击 |
| 23 | Nend | api_key | - | naitve | spot_id(唯一) api_key(唯一) is_video | 0:插屏 默认 1:全屏视频is_video枚举值:0- 原生,默认;1- 原生视频 |
| 23 | Nend | api_key | - | rewarded_video | spot_id(唯一) api_key(唯一) | - |
| 23 | Nend | api_key | - | banner | spot_id(唯一) api_key(唯一) size | size枚举值:320x50,320x100,300x100,300x250,728x90 |
| 23 | Nend | api_key | - | interstitial | spot_id(唯一) api_key(唯一) is_video | is_video枚举值:0-插屏广告(默认),1-插屏视频广告,2-全屏广告 |
| 24 | Maio | api_id api_key | media_id | rewarded_video interstitial | zone_id(唯一) | - |
| 25 | Start.io | partner_id token | app_id | rewarded_video interstitial | ad_tag(唯一) | - |
| 26 | SuperAwesome | - | property_id | rewarded_video | placement_id(唯一) | - |
| 28 | 快手 | access_key security_key account_id(必填) | app_id app_name | native | position_id(唯一) unit_type layout_type video_sound | unit_type枚举值:0- 信息流广告 (默认), 1- Draw视频广告 unit_type 等于0的时候下面两个参数必填 layout_type枚举值:0-自渲染 (默认), 1-模板 video_sound枚举值:0-无声音 (默认),1-有声音 |
| 28 | 快手 | access_key security_key account_id(必填) | app_id app_name | rewarded_video | position_id(唯一) orientation(可选) video_muted (可选) | orientation枚举值:1-竖屏(默认), 2-横屏 video_muted枚举值:0-否,有声音(默认), 1-是,静音 |
| 28 | 快手 | access_key security_key account_id(必填) | app_id app_name | interstitial | position_id(唯一) orientation(可选) video_muted (可选) is_video (可选) | orientation枚举值:1-竖屏(默认), 2-横屏 video_muted枚举值:0-否,有声音(默认), 1-是,静音 is_video:0- 否(插屏广告)1-是(全屏视频广告,默认) |
| 28 | 快手 | access_key security_key account_id(必填) | app_id app_name | splash | position_id(唯一) zoomoutad_sw | zoomoutad_sw枚举值:1-不使用开屏V+功能(默认), 2-使用开展V+功能 |
| 29 | Sigmob | public_key secret_key | app_id app_key | rewarded_video interstitial splash | placement_id(唯一) | - |
| 32 | MyTarget | access_token | app_id | native rewarded_video interstitial | slot_id(唯一) | - |
| 32 | MyTarget | access_token | app_id | banner | slot_id(唯一) size | size枚举值:320x50;300x250;728x90 |
| 33 | Google Ad Manager | - | - | native | unit_id(唯一) media_ratio(可选) | media_ratio枚举值:0-未指定(默认),1-任意尺寸,2-横屏,3-竖屏,4-正方形 |
| 33 | Google Ad Manager | - | - | rewarded_video interstitial | unit_id(唯一) | - |
| 33 | Google Ad Manager | - | - | banner | unit_id(唯一) size | size: 320x50 320x100 300x250 468x60 728x90 |
| 34 | Yandex | - | - | native | unit_id(唯一) unit_type | unit_type枚举值:1-模板渲染 , 0-自渲染 |
| 34 | Yandex | - | - | interstitial rewarded_video | unit_id(唯一) | - |
| 34 | Yandex | - | - | banner | unit_id(唯一) size | size: 240x400 300x250 300x300 320x100 320x50 400x240 728x90 全屏 |
| 36 | Ogury | api_key api_secret | key | rewarded_video interstitial | unit_id(唯一) | - |
| 37 | Fyber | publisher_id consumer_key consumer_secret | app_id | rewarded_video banner | spot_id(唯一) | - |
| 37 | Fyber | publisher_id consumer_key consumer_secret | app_id | interstitial | spot_id(唯一) video_muted | video_muted枚举值:1-视频播放时静音, 0-视频播放时有声(默认) |
| 39 | Huawei Ads | client_id client_secret | - | native | ad_id(唯一) media_ratio(可选) orientation(可选) video_muted(可选) | media_ratio枚举值:0-未指定(默认),1-任意尺寸,2-横屏,3-竖屏,4-正方形 orientation(设置图片方向)枚举值: 0-任意方向(默认), 1-PORTRAIT, 2-LANDSCAPE video_muted枚举值:0-静音(默认), 1- 不静音 |
| 39 | Huawei Ads | client_id client_secret | - | banner | ad_id(唯一) size | size: 320x50 320x100 300x250 360x57 360x144 smart |
| 39 | Huawei Ads | client_id client_secret | - | interstitial rewarded_video | ad_id(唯一) | - |
| 39 | Huawei Ads | client_id client_secret | - | splash(暂不支持) | ad_id(唯一) orientation | orientation: 1-竖屏(默认), 2-横屏 |
| 40 | Helium | user_id user_signature | app_id app_signature | interstitial rewarded_video | placement_name(唯一) | - |
| 50 | Pangle | user_id secure_key | app_id | native | slot_id(唯一) is_video layout_type media_size dl_type | is_video枚举值:0:信息源广告 layout_type枚举值:1:自渲染 media_size枚举值:1: 690x388px dl_type枚举值:0:按穿山甲 SDK的默认值处理;1:对于应用的下载不做特殊处;2:用每次下载都需要触发弹窗披露应用信息(不含跳转商店的场景) |
| 50 | Pangle | user_id secure_key | app_id | rewarded_video | slot_id(唯一) personalized_template dl_type | personalized_template枚举值:0:非个性化模板;1:个性化模板 dl_type枚举值:0:按穿山甲 SDK的默认值处理;1:对于应用的下载不做特殊处;2:用每次下载都需要触发弹窗披露应用信息(不含跳转商店的场景) |
| 50 | Pangle | user_id secure_key | app_id | banner | slot_id(唯一) layout_type size nw_rft dl_type | layout_type枚举值:1:自渲染 size枚举值:640x100;600x90;600x150;600x500;600x400;600x300;600x260;690x388 nw_rft说明:设置Network SDK的Banner刷新时间,默认值为0,单位毫秒 dl_type枚举值:0:按穿山甲 SDK的默认值处理;1:对于应用的下载不做特殊处;2:用每次下载都需要触发弹窗披露应用信息(不含跳转商店的场景) |
| 50 | Pangle | user_id secure_key | app_id | interstitial | slot_id(唯一) is_video layout_type size personalized_template dl_type | is_video枚举值:0:插屏广告;1:全视频广告;2:新插屏广告 layout_type枚举值:1 size枚举值:1:1;3:2;2:3 personalized_template枚举值:0:非个性化模板;1:个性化模板 dl_type枚举值:0:按穿山甲 SDK的默认值处理;1:对于应用的下载不做特殊处;2:用每次下载都需要触发弹窗披露应用信息(不含跳转商店的场景) |
| 50 | Pangle | user_id secure_key | app_id | splash | slot_id(唯一) personalized_template zoomoutad_sw dl_type button_type | personalized_template枚举值:0:非个性化模板;1:个性化模板 zoomoutad_sw枚举值:1:不设置开展点睛的icon;2:开展点睛的icon设置成Yes dl_type枚举值:0:按穿山甲 SDK的默认值处理;1:对于应用的下载不做特殊处;2:用每次下载都需要触发弹窗披露应用信息(不含跳转商店的场景) button_type枚举值:0:按穿山甲 SDK的默认值处理;1:全屏区域可点击;2:按钮区域可点击 |
| 59 | Bigo | developer_id token | app_id | native | slot_id(唯一) | - |
| 59 | Bigo | developer_id token | app_id | rewarded_video | slot_id(唯一) | - |
| 59 | Bigo | developer_id token | app_id | banner | slot_id(唯一) size | size枚举值:320x50;320x100;300x250;336下80 |
| 59 | Bigo | developer_id token | app_id | interstitial | slot_id(唯一) | - |
| 59 | Bigo | developer_id token | app_id | splash | slot_id(唯一) | - |
附录4:支持开启Header Bidding 的广告平台和广告样式
注意:有些平台相同广告样式下某些选择可能不支持头部竞价,比如Mintegral平台广告位样式为interstitial时:广告位类型选择插屏视频时支持头部竞价,广告位类型选择插屏图片时不支持头部竞价,创建时需注意,具体参考开发者后台