ZJSDK

SDK 集成

SDK 集成

工程设置导入framework

申请应用的AppId

请找运营人员获取应用ID和广告位ID。

导入package

  • pubspec.yaml接入方式，优缺点： 桥接已写好，开发者只需导入package即可。 适用： 适用于大多数flutter开发者，集成、使用简单，省时省力。
zjsdk_flutter: ^0.1.8

提示

0.1.8版本之后，接入flutter，默认使用ZJSDK的版本2.5.8.14及其以上版本

Xcode编译选项设置

添加HTTP权限

  • 在项目路径下 -> ios -> 打开Runner.xcworkspace, 在Runner项目 -> TARGETS -> Info -> Custom iOS Target Properties 添加 App Transport Security Settings，先点击左侧展开箭头，再点右侧加号，Allow Arbitrary Loads 选项自动加入，修改值为 YES。 SDK API 已经全部支持HTTPS，但是广告主素材存在非HTTPS情况。
<key>NSAppTransportSecurity</key>
  <dict>
     <key>NSAllowsArbitraryLoads</key>
   <true/>
</dict>

切记

千万不要在NSAllowsArbitraryLoads这个属性 之后 再去设置 Allow Arbitrary Loads in Web Content 这个属性，否则影响某些正常功能的使用

  • Build Settings中Other Linker Flags 增加参数 -ObjC，字母o和c 大写 。

添加位置权限

  • SDK 需要位置权限以更精准的匹配广告，需要在应用的 info.plist 添加相应配置信息，避免 App Store 审核被拒：
Privacy - Location When In Use Usage Description
Privacy - Location Always and When In Use Usage Description
Privacy - Location Always Usage Description
Privacy - Location Usage Description

scheme列表添加以下内容

  • 用于判断用户设备使用环境，提高安全性，增加收益
<key>LSApplicationQueriesSchemes</key>
    <array>
        <string>alipayauth</string>
        <string>alipays</string>
        <string>wechat</string>
        <string>weixin</string>
        <string>taobao</string>
        <string>tbopen</string>
        <string>openapp.jdmobile</string>
        <string>pinduoduo</string>
        <string>meituanwaimai</string>
        <string>imeituan</string>
        <string>snssdk1128</string>
        <string>cydia</string>
        <string>kwai</string>
    </array>

SKAdNetwork 接入

  • 使用Apple的转化跟踪SKAdNetwork，这意味着即使IDFA不可用，也可以将应用安装归因。 1.在Xcode项目导航器中，选择Info.plist。 2.单击属性列表编辑器中任何键旁边的添加按钮（+），以创建一个新的属性键。 3.输入密钥名称SKAdNetworkItems。选择Array。 4.将SKAdNetworkId以字典的形式添加到数组中。
//将SKAdNetwork ID 添加到 info.plist 中，以保证 SKAdNetwork 的正确运行
//广点通
SKAdNetworkIdentifier : f7s53z58qe.skadnetwork
//快手
SKAdNetworkIdentifier : r3y5dwb26t.skadnetwork
//sigmob
SKAdNetworkIdentifier : 58922NB4GD.skadnetwork
//MTG
SKAdNetworkIdentifier : kbd757ywx3.skadnetwork
//穿山甲
SKAdNetworkIdentifier : 238da6jt44.skadnetwork
SKAdNetworkIdentifier : x2jnk7ly8j.skadnetwork
SKAdNetworkIdentifier : 22mmun2rn5.skadnetwork
//Google
SKAdNetworkIdentifier : cstr6suwn9.skadnetwork

<key>SKAdNetworkItems</key>
<array>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>238da6jt44.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>x2jnk7ly8j.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>f7s53z58qe.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>58922NB4GD.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>kbd757ywx3.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>22mmun2rn5.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>r3y5dwb26t.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>cstr6suwn9.skadnetwork</string>
    </dict>
</array>
目录