Unreal 引擎 SDK 集成： 添加 SKAdNetwork 支持

关注
Avatar
Eyal Rabinovich
Updated
Singular 虚幻引擎 SDK
下载
 奇异虚幻引擎 SDK 2.4.0 版
兼容性

虚幻引擎 4.23+
集成指南
  1. 基本集成
  2. 跟踪事件和收入
  3. 实现深度链接
  4. 添加SKAdNetwork支持
  5. 高级选项

 

简介：SKAdNetwork 和 SKAN

SKAdNetwork是苹果公司在不损害最终用户隐私的情况下，为移动安装归属提供支持的新框架。Singular 的新版 iOS SDK 可帮助您以最小的工程投入无缝实施 SKAdNetwork。该SKAdNetwork实施基于SKAN--Singular为顺利实施SKAdNetwork而开发的标准。

有关 Singular SKAdNetwork 实施的完整指南，请参阅iOS SDK SKAdNetwork 实施指南。

在虚幻引擎SDK中实现SKAdNetwork

USingularSDKBPLibrary::Initialize方法设置

您可以在USingularSDKBPLibrary::Initialize 方法 中配置以下选项。 有关这些选项的详细信息，请参阅iOS SDK SKAdNetwork 实现指南。

选项 默认
 说明
skAdNetworkEnabled True 设为 true 可启用 SKAdNetwork 支持。
manualSKANConversionManagement False 如果要手动管理转换值，则设置为 true。

注意： 从虚幻引擎 SDK 版本 2.0.11 开始，默认启用 SKAdNetwork。

如果您使用的是旧版本的 SDK，则需要通过将skAdNetworkEnabled 设置为True 来启用 SKAdNetwork。

SKAdNetwork 方法

SingularSDK SkanRegisterAppForAdNetworkAttribution 方法
说明

注册 SKAdNetwork 跟踪。

注释：

  • 这与在USingularSDKBPLibrary::Initialize 方法中将skAdNetworkEnabled设置为 True 相同。
  • 调用此方法将覆盖USingularSDKBPLibrary::Initialize 中的配置值。
  • 从虚幻引擎 SDK 版本 2.0.11 开始，默认启用 SKAdNetwork。
签名 public void SkanRegisterAppForAdNetworkAttribution()
使用示例 
USingularSDKBPLibrary::SkanRegisterAppForAdNetworkAttribution();
SingularSDK SkanUpdateConversionValue 方法
描述

更新 SKAdNetwork 转换值。

注意： 如果您选择手动更新 SKAdNetwork 转换值，请使用此方法。只有当manualSKANConversionManagement 设置为True 时，此方法才会起作用。
签名 public void SkanUpdateConversionValue(int conversionValue)
使用示例 
  // 发生了注册事件
  USingularSDKBPLibrary::SendEvent("SignUp");
  
  // 将转换值更新为 7
  USingularSDKBPLibrary::SkanUpdateConversionValue(7);
SingularSDK SkanGetConversionValue 方法
说明 获取 Singular SDK 追踪的当前转换值。
签名 public int SkanGetConversionValue()
使用示例 
int value = USingularSDKBPLibrary::SkanGetConversionValue();

注册到更新的 SKAN 转换值

  1. 在要注册委托的类的头文件顶部添加#include "SingularDelegates.h" 。

  2. 在类中添加以下内容：

      // 调用更新的转换值的注册委托
  UPROPERTY(BlueprintAssignable, Category = "Singular-SDK")
  FOnConversionValueUpdated OnConversionValueUpdated;
  
  // 我们将用来注册委托的方法
  UFUNCTION()
  void NewConversionValue(int32 conversionValue);

  3. 在类的 cpp 文件中注册到事件：

    OnConversionValueUpdated.AddDynamic(this,&YOURCLASS::NewConversionValue);
Singular 虚幻引擎 SDK
集成指南
  1. 基本集成
  2. 跟踪事件和收入
  3. 实现深度链接
  4. 添加SKAdNetwork支持
  5. 高级选项