跳到主要内容

iOS 手动集成说明

基础配置

  • Xcode 12 或更高版本
  • iOS 9.0 或更高版本

注意:自 iOS 9 开始,iOS 应用一律使用应用传输安全 (ATS) 功能,这是一种强制使用加密连接的数据传输安全功能。在继续之前,请参阅应用传输安全中的要求配置您的 info.plist,以确保您的广告不受 ATS 影响。

一、cocoapod集成

进入TradPlusSDK下载平台,根据需求选择所需三方广告平台,点击生成接入代码后,就可以一键获取您要添加的pod配置信息

在导出的xcode项目中进行pod配置

或是参考以下文章在unity项目中进行pod配置 如何在unity项目中通过pod来配置SDK

二、手动集成

1、进入TradPlusSDK下载平台,选择非cocoapod接入,根据需求选择所需三方广告平台,点击生成接入代码后,下载包含TPSDK及三方源的zip包

2、将解压后的TradPlusFrameworks目录添加到 Xcode项目中进行配置

详细流程可参考 iOS Xcode项目集成流程

三、注意事项

1.集成完成后添加 IDFA 及 SKAdNetwork 列表

相关设置和集成可参考:适配 iOS14.5+

2.百度接入问题

如果将百度SDK的bundle资源包添加在 UnityFramework 中,会导致百度在展示广告时无法显示关闭按钮等本地图片资源。

您需要将百度SDK的 bundle 资源包添加在 Unity-iPhone 项目中。

3.Facebook要求

需要下载Facebook并成功登录,才能展现广告,包括测试广告。 正式广告需要IDFA说全

4.Admob要求

必须要将产品在 Admob 的唯一性标识写在客户端中,否则将会造成应用crash。

在Info.plist中添加 GADApplicationIdentifier配置, 应用发布时请替换成应用在Admob后台的appid。

<key>GADApplicationIdentifier</key>
<string>ca-app-pub-3940256099942544~1458002511</string>

其他

  • 请在mac上下载解压sdk,否则会导致部分文件格式损坏。

  • 请不要在TradPlus同一应用的不同广告位,配置相同的三方渠道广告位,会导致回调错乱等各种问题。

  • 后台的广告配置修改后一般30秒生效,SDK本地配置缓存失效时间为1小时,如果需要尽快获取更新后的配置开发者需要删除并重装App或调快1小时系统时间。

  • 在构建和测试应用时,请确保使用的是测试广告,而不是实际投放的广告。否则,可能会导致您的帐号被暂停。

  • 开发者可以使用TP后台的测试模式,验证是否已正确接入,具体可参考:如何使用测试模式

  • 广告加载成功,广告展示,广告关闭等回调时的返回信息可参考: 回调信息说明

  • 错误码说明