TogetherAd 开源项目教程

TogetherAd 开源项目教程

TogetherAd🔥持续更新。Android广告聚合：帮助 Android 开发者快速、便捷、灵活的接入国内多家主流安卓广告 SDK。广点通（优量汇）、穿山甲、快手联盟、百青藤（百度Mob）。开屏广告、Banner横幅广告、插屏广告、激励广告、原生信息流、全屏广告。项目地址:https://gitcode.com/gh_mirrors/to/TogetherAd

项目介绍

TogetherAd 是一个基于 Kotlin 实现的 Android 广告聚合框架，它旨在简化Android开发者集成国内主流广告SDK的过程。该项目提供了一种高度灵活的方式，使得接入广点通（优量汇）、穿山甲、快手联盟、百度百青藤等广告平台变得迅速而简便。TogetherAd不仅支持多种广告形式，如开屏广告、Banner广告、插屏广告、激励视频广告等，还内置了诸多定制选项，包括但不限于广告按权重分配、失败自动切换、自定义加载策略等功能。

项目快速启动

添加依赖

首先，在您的Android项目的build.gradle(Module级别)文件中添加TogetherAd的依赖。由于具体的版本号可能会更新，请前往GitHub仓库查看最新版本：

dependencies {
    implementation 'com.github.ifmvo.TogetherAd:library:<latest_version>'
}

别忘了同步Gradle项目。

初始化TogetherAd

在应用程序的入口处，通常是Application类中初始化TogetherAd库并配置必要的广告平台：

class App : Application() {
    override fun onCreate() {
        super.onCreate()
        
        // 初始化TogetherAd, 此处填写对应广告平台的AppID
        val togetherConfig = TogetherConfig.Builder(this)
            .addPlatform(Platform.GDT, "your_gdt_appid")
            .addPlatform(Platform.TT, "your_tt_appid")
            .addPlatform(Platform.KS, "your_ks_appid")
            .addPlatform(Platform.BAIDU, "your_baidu_appid")
            .build()
        
        TogetherAd.init(this, togetherConfig)
    }
}

显示一个基本的Banner广告

为了展示如何快速集成，以下是如何显示一个Banner广告的例子：

val bannerPlaceId = "your_banner_place_id"
val bannerContainer = findViewById<LinearLayout>(R.id.banner_container)

// 创建并显示Banner广告
TogetherAd.loadBanner(this, bannerPlaceId) { ad ->
    val adView = ad as BannerAd
    bannerContainer.addView(adView)
}.failed { error ->
    Log.e("TogetherAdExample", "Load banner failed: ${error.message}")
}

应用案例和最佳实践

在实际开发中，利用TogetherAd的特性，比如广告失败后的自动切换到下一个可用的广告商，以及通过权重控制不同广告来源的展示频率，可以显著提高用户体验和填充率。确保每次请求广告之前检查网络状态，并且合理安排广告的刷新逻辑，避免过于频繁的请求导致用户体验下降或违反广告政策。

典型生态项目

TogetherAd因其模块化设计和对多种广告平台的支持，成为了许多需要集成广告的Android应用中的首选框架。虽然直接相关的“典型生态项目”信息未在提供的材料中明确指出，开发者可以在自己的应用中创建特定场景的应用案例，例如，在新闻阅读应用中的文章详情页插入原生广告，或者在游戏中巧妙地融入激励视频广告，以增强收入而不破坏用户体验。

TogetherAd社区和文档鼓励开发者分享他们的实现方式和实践心得，通过这种方式，这个开源项目形成了一个不断成长的生态环境，其中包含了各种各样的应用场景和优化技巧。

请注意，为了获取最新的使用方法和最佳实践，定期查阅GitHub仓库的最新文档和更新是非常重要的。

TogetherAd🔥持续更新。Android广告聚合：帮助 Android 开发者快速、便捷、灵活的接入国内多家主流安卓广告 SDK。广点通（优量汇）、穿山甲、快手联盟、百青藤（百度Mob）。开屏广告、Banner横幅广告、插屏广告、激励广告、原生信息流、全屏广告。项目地址:https://gitcode.com/gh_mirrors/to/TogetherAd