文档

虚幻引擎 SDK 集成指南

开发人员指南	开发人员变更日志
前提条件	奇异账户访问权限下载： Singular 虚幻引擎 SDK 2.5.0 版
兼容性	虚幻引擎 4.23+
集成指南	基本集成跟踪事件和收入实现深度链接添加SKAdNetwork支持高级选项

简介：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 "可启用 SKAdNetwork 支持。
manualSKANConversionManagement	假	如果要手动管理转换值，请设置为 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)
使用示例	`// A sign-up event happened USingularSDKBPLibrary::SendEvent("SignUp"); // Update the conversion value to 7 USingularSDKBPLibrary::SkanUpdateConversionValue(7);`
SingularSDK SkanGetConversionValue 方法
说明	获取 Singular SDK 追踪的当前转换值。
签名	public int SkanGetConversionValue()
使用示例	`int value = USingularSDKBPLibrary::SkanGetConversionValue();`

注册到更新的 SKAN 转换值

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

在类中添加以下内容：

// A delegate to register that invokes the Conversion Value updated

  UPROPERTY(BlueprintAssignable, Category = "Singular-SDK")
  FOnConversionValueUpdated OnConversionValueUpdated;
  
  // The method we will use to register the delegate

  UFUNCTION()
  void NewConversionValue(int32 conversionValue);

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

OnConversionValueUpdated.AddDynamic(this,&YOURCLASS::NewConversionValue);