Singular

CloudX Unity SDK 的 Singular 广告收入连接器。无需发布商编写胶水代码即可将 CloudX 广告收入转发至 Singular。

Singular 连接器会将 CloudX 广告收入转发至您的移动归因合作伙伴（MMP），使收入与您在 Singular 中的其他数据一并呈现，并用于 ROAS 衡量。添加连接器依赖后，收入上报会自动生效；无需调用 Unity C# API。

连接器不会初始化 Singular。您的应用必须已经使用自己的 SDK key 集成并初始化 Singular SDK。

安装

在 Assets/CloudXSdk/Editor/CloudXDependencies.xml 中取消注释 Singular 连接器相关行（适用于已包含这些条目的包；若您的包中没有，请参见下文）：

<!-- Android -->
<androidPackage spec="io.cloudx:connector-singular:12.0.0.0"/>

<!-- iOS -->
<iosPod name="CloudXSingularConnector" version="12.6.0.0" minTargetSdk="13.0"/>

然后运行 External Dependency Manager for Unity (EDM4U) 的 Android 和 iOS 依赖解析。

在 CloudX Unity SDK 4.5.1 及更早版本中，CloudXDependencies.xml 尚未包含这些条目——请自行添加，然后运行 EDM4U 依赖解析：

<androidPackages>
    <repositories>
        <!-- 与已列出的其他仓库并列 -->
        <repository>https://maven.singular.net</repository>
    </repositories>

    <androidPackage spec="io.cloudx:connector-singular:12.0.0.0"/>
</androidPackages>

<iosPods>
    <iosPod name="CloudXSingularConnector" version="12.6.0.0" minTargetSdk="13.0"/>
</iosPods>

Singular 将其 Android SDK 发布到自有的 Maven 仓库，而非 Maven Central。从下一个 Unity SDK 版本开始，CloudXDependencies.xml 会为您声明该仓库，因此只需取消注释连接器相关行即可。

要求

• CloudX Unity SDK 4.5.0 或更高版本。
• 您的应用已经集成并初始化 Singular。
• Android 应用包含 com.singular.sdk:singular_sdk 12.0.0 或更高版本。
• iOS 应用包含 Singular-SDK pod 12.6.0 或更高版本。

上报内容

连接器会为每次 CloudX 竞得的展示上报一次，覆盖 CloudX 广告格式。每个事件以广告平台 CloudX 记录，并包含竞得广告网络、该次展示的 CloudX 收入估算（USD），以及 CloudX 广告单元 ID、广告类型、广告位名称和广告网络侧的广告位。