Singular

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

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

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

安装

在 ios/Podfile 和 android/app/build.gradle.kts 中添加连接器：

target 'Runner' do
  # ... existing Flutter config ...

  pod 'CloudXSingularConnector', '~> 12.6.0.0'
end

dependencies {
    implementation("io.cloudx:connector-singular:12.0.0.0")
}

Singular 将其 Android SDK 发布到自有的 Maven 仓库，而非 Maven Central，因此还需要声明该仓库。请添加到您的 Gradle 模板已有的那个块中，不要两处都加；新建项目由 Flutter 生成 Kotlin DSL 文件名，较早的项目则是 Groovy 文件名。如果您的应用已经集成 Singular，通常已经声明过。

dependencyResolutionManagement {
    repositories {
        google()
        mavenCentral()
        // io.cloudx:connector-singular
        maven { url = uri("https://maven.singular.net") }
    }
}

allprojects {
    repositories {
        google()
        mavenCentral()
        // io.cloudx:connector-singular
        maven { url = uri("https://maven.singular.net") }
    }
}

然后安装 iOS pod：

cd ios && pod install

要求

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

上报内容

连接器会为每次符合上报条件的 CloudX 竞得展示上报一次，覆盖 CloudX 广告格式。对于竞价方 SDK 已向您的 MMP 上报收入的展示，连接器会跳过上报，以免重复计算收入。每个事件以广告平台 CloudX 记录，并包含竞得广告网络、该次展示的 CloudX 收入估算（USD），以及 CloudX 广告单元 ID、广告类型、广告位名称和广告网络侧的广告位。