将 Tapjoy 与中介相集成
本指南介绍了如何使用 Google 移动广告 SDK 利用中介 从 Tapjoy 加载和展示广告,其中包括出价和广告瀑布流集成。它介绍了如何将 Tapjoy 广告添加到广告单元的中介配置中,以及如何将 Tapjoy SDK 和适配器集成到应用中 Android 。
Tapjoy 的 Ad Manager 中介适配器具有以下功能:
集成
出价
瀑布
表现形式
横幅
插页式广告
已奖励
原生
要求
Android API 级别 19 或更高级别
[用于出价]:Tapjoy 适配器 12.2.1.1 或更高版本(推荐使用最新版本 )
最新版 Google 移动广告 SDK
完成中介
入门指南
第 1 步:在 Tapjoy 界面中设置配置
注册 或登录 您的 Tapjoy 信息中心。
添加应用
前往右上角的应用列表,然后点击 Add App (添加应用)按钮,将您的应用添加到 Tapjoy 信息中心 。然后,系统会提示您输入应用的详细信息。
填写表单,然后点击 Create Now 按钮,将您的应用添加到 Tapjoy 信息中心。
您可以跳过 Tapjoy 提供的集成步骤,直接创建可与中介结合使用的展示位置。 Ad Manager
展示位置、虚拟货币和内容
展示位置
依次前往创收 > 展示位置 ,然后点击右上角的创建展示位置 按钮。即使您已有展示位置,也最好为 Ad Manager 创建一个新展示位置,以便单独进行跟踪和报告。
为展示位置输入名称 ,选中中介 复选框,然后从下拉列表中选择 AdMob 。完成后,点击创建 。
在下一部分中,系统将使用在此输入的展示位置名称 为中介设置Ad Manager 广告单元。此示例中使用了“Ad Manager 中介”,但您可以随意调用展示位置。
注意 :请为您要通过中介与 Tapjoy 进行中介的每个 Ad Manager插页式广告单元或激励广告单元创建新的展示位置。
虚拟货币
依次前往创收 > 虚拟货币 ,然后点击右上角的创建虚拟货币 按钮。
填写表单,然后点击立即创建 。使用 NO_CALLBACK 作为回调网址 。这样可以确保 Tapjoy SDK 避免对服务器进行不必要的调用。
货币值和名称不会通过 Tapjoy 适配器转发,因此您可以选择货币名称和金额的任何通用值。
内容
依次前往创收 > 创建内容 ,创建与展示位置一起展示的内容。
如需了解有关创建内容的更多说明,请选择与首选广告格式对应的标签页:
查找 SDK 密钥
除了展示位置名称之外,您还需要 SDK 密钥 才能设置广告单元 Ad Manager 。
依次转到设置 > 应用设置 。您可以从应用平台 标签页下的应用信息 中获取 SDK 密钥 。
找到报告键
注意 :这仅适用于广告瀑布流集成。如果您使用的是出价集成,则可以跳过此步骤。
瀑布 您需要有发布商 OAuth 密钥 和中介密钥 才能继续操作。您的发布商 OAuth 密钥 可以在同一页面的 API 密钥 标签页下获取。
在同一页面中,您可以在报告 API 密钥 列下的中介密钥 标签页下获取中介密钥 。该密钥带有“AdMob”标签。
尽管名称不匹配,Google Ad Manager 发布商仍应使用此值。
开启测试模式
您可以在 Tapjoy 信息中心通过 Settings > App Settings > Test Devices 启用测试广告。使用设备的广告 ID 创建一个新的测试设备:
Your device's **Advertising ID** can be located by navigating to **Google >
Ads** in your device **Settings**.
接下来,修改您之前创建的内容。
如需修改您的内容,请先依次转到创收 > 展示位置 ,然后点击用户发起 标签页。接下来,选择要修改的内容的下拉菜单,然后选择修改 。
在内容的 Basic 部分下,选中 Only for Test Devices 复选框。然后,点击页面底部的保存 。大功告成!现在,您已与 Tapjoy 有效集成了中介。
第 2 步:在界面中设置 Tapjoy 需求 Ad Manager
登录您的 Ad Manager 帐号 。
添加 Tapjoy 公司
瀑布 依次前往管理 > 公司 ,然后点击所有公司 标签页中的新公司 按钮。选择广告联盟 。
选择 Tapjoy 作为广告联盟 ,输入一个唯一的名称 并启用中介 。
您无需输入用户名 或密码 。完成后,点击保存 。
启用安全信号共享
出价 依次前往管理 > 全局设置 。前往 Ad Exchange 帐号设置 标签页,然后查看并开启安全信号共享 。点击保存 。
出价 依次前往投放 > 出价方 ,然后点击 SDK 出价 标签页下的新出价方 。
选择Tapjoy 作为出价方。
开启将此出价方的信号库添加到允许的信号列表中 和允许与此出价方共享信号 。然后,点击继续 。
点击继续 。
点击完成 。
出价 依次前往投放 > 出价方 ,然后在 SDK 出价 标签页下,为Tapjoy 选择公司。
转到广告单元映射 标签页,然后点击新建广告单元映射 。
选择特定广告单元 。选择一种广告单元和格式,选择移动应用 作为广告资源类型 ,然后选择移动应用 。然后,输入在上一部分中获得的SDK Key and Placement Name 。最后,点击保存 。
重要提示 : 应采用至少一个收益组来定位所选广告单元。
瀑布 依次转到投放 > 收益组 ,然后点击新建收益组 按钮。选择您的移动应用 。
向下滚动,然后点击添加收益合作伙伴 。
选择您在上一部分中为 Tapjoy创建的公司。选择移动 SDK 中介 作为集成类型 ,选择 Android 作为平台 ,选择活跃 作为状态 。
输入在上一部分获得的 SDK Key and Placement Name ,以及默认 CPM 值。点击保存 。
添加到 GDPR 和美国州级法规的广告合作伙伴列表中 Tapjoy
重要提示
:请确认您拥有帐号管理 权限,可以完成欧盟地区用户意见征求和 GDPR、CPRA 以及 User Messaging Platform 的配置。如需了解详情,请参阅管理用户对帐号的访问权限 。
按照
GDPR 设置
和
美国州级法规设置
中的步骤,将 Tapjoy 添加到 Ad Manager 界面中的 GDPR 和美国州级法规广告合作伙伴列表中。
第 3 步:导入 Tapjoy SDK 和适配器
注意 :如果未能集成兼容的 Tapjoy 和 Google 移动广告 SDK 版本,可能会导致 build 问题。
Android Studio 集成(推荐)
在应用级 build.gradle
文件中添加以下实现依赖项以及最新版本的 Tapjoy SDK 和适配器:
repositories {
google()
maven {
url "https://sdk.tapjoy.com/"
}
}
...
dependencies {
implementation 'com.google.android.gms:play-services-ads:22.6.0'
implementation 'com.google.ads.mediation:tapjoy:13.2.1.0'
}
...
手动集成
下载 Tapjoy Android SDK 并解压缩 Libraries
文件夹下的 tapjoyconnectlibrary.jar
,并将其添加到您的项目。
转到 Google Maven 制品库中的 Tapjoy 适配器工件 。选择最新版本,下载 Tapjoy 适配器的 .aar 文件,并将其添加到您的项目。
第 4 步:在 Tapjoy SDK 上实现隐私设置
欧盟地区用户意见征求和 GDPR
根据 Google 欧盟地区用户意见征求政策 ,您必须确保就设备标识符和个人数据的使用向欧洲经济区 (EEA) 用户披露特定披露信息,并征得其同意。此政策反映了欧盟《电子隐私指令》和《一般数据保护条例》(GDPR) 的要求。在征求用户意见时,您必须指明中介链中可能会收集、接收或使用个人数据的各个广告联盟,并提供有关每个广告联盟使用情况的信息。Google 目前无法自动将用户的同意情况传送给此类广告联盟。
在 Tapjoy SDK 12.6.0 版中,Tapjoy 添加了 User Consent API 来支持隐私设置。以下示例代码展示了如何将此用户意见征求信息传递给 Tapjoy SDK。如果您选择调用此方法,请在通过 Google 移动广告 SDK 请求广告之前执行此操作。
Java import com.tapjoy.TJPrivacyPolicy;
import com.tapjoy.Tapjoy;
...
TJPrivacyPolicy privacyPolicy = Tapjoy.getPrivacyPolicy();
privacyPolicy.setSubjectToGDPR(true);
privacyPolicy.setUserConsent("0");
Kotlin import com.tapjoy.Tapjoy
...
val privacyPolicy = Tapjoy.getPrivacyPolicy()
privacyPolicy.setSubjectToGDPR(true)
privacyPolicy.setUserConsent("0")
如需了解详情以及可在每种方法中提供的值,请访问 Tapjoy 的
用户隐私保护指南
。
美国州级隐私保护法律
美国州级隐私保护法
规定,必须让用户有权选择不“出售”其“个人信息”(该法律对这些术语进行了定义)。“出售”方须在首页醒目位置提供“请勿出售我的个人信息”链接,以供用户选择。美国州级隐私保护法律合规性指南 让您可以为 Google 广告投放启用受限的数据处理 ,但 Google 无法将此设置应用于中介链中的每个广告联盟。因此,您必须确定中介链中可能参与个人信息出售的每个广告网络,并遵循每个广告网络的指导以确保合规性。
在 Tapjoy SDK 12.6.0 版中,Tapjoy 添加了 User Consent API 来支持隐私设置。以下示例代码展示了如何将此用户意见征求信息传递给 Tapjoy SDK。如果您选择调用此方法,请在通过 Google 移动广告 SDK 请求广告之前执行此操作。
Java import com.tapjoy.TJPrivacyPolicy;
import com.tapjoy.Tapjoy;
...
TJPrivacyPolicy privacyPolicy = Tapjoy.getPrivacyPolicy();
privacyPolicy.setUSPrivacy(“1YYY”);
Kotlin import com.tapjoy.Tapjoy
...
val privacyPolicy = Tapjoy.getPrivacyPolicy()
privacyPolicy.setUSPrivacy(“1YYY”)
如需了解详情以及可在每种方法中提供的值,请访问 Tapjoy 的
用户隐私保护指南
。
第 5 步:添加所需的代码
Tapjoy 集成无需其他代码。
第 6 步:测试实现效果
启用测试广告
请务必为Ad Manager 注册您的测试设备 ,并在 Tapjoy 界面中启用测试模式 。
重要提示 : 在发布应用前,请为 Ad Manager 和Tapjoy 停用测试模式。
验证测试广告
如需验证您收到的是来自Tapjoy的测试广告,请使用相应广告来源在广告检查器中启用单一广告来源测试 。 Tapjoy (Bidding) and Tapjoy (Waterfall)
可选步骤
将 Tapjoy 添加到 CCPA 广告合作伙伴名单
请按照
CCPA 设置
中的步骤操作,将 Tapjoy 添加到Ad Manager 界面的 CCPA 广告合作伙伴名单中。
权限
为了获得最佳性能,Tapjoy 建议将以下可选权限 添加到应用的 AndroidManifest.xml
文件中:
<uses-permission android:name="android.permission.READ_PHONE_STATE"/>
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>
网络特定的参数
Tapjoy 适配器支持一个额外的请求参数,您可以使用 TapjoyExtrasBundleBuilder
类将该参数传递给适配器。TapjoyExtrasBundleBuilder
包含以下方法:
setDebug(bool)
在 Tapjoy SDK 上启用调试模式后,您可以在 Tapjoy 开发者控制台中看到各种 Tapjoy 操作。所有广告格式均支持此参数。
以下代码示例展示了如何设置这些广告请求参数:
Java
Bundle extras = new TapjoyAdapter.TapjoyExtrasBundleBuilder()
.setDebug(true)
.build();
AdManagerAdRequest adRequest = new AdManagerAdRequest.Builder()
.addNetworkExtrasBundle(TapjoyAdapter.class, extras)
.build());
Kotlin
val extras = TapjoyExtrasBundleBuilder()
.setDebug(true)
.build()
val adRequest = AdManagerAdRequest
.addNetworkExtrasBundle(TapjoyAdapter::class.java, extras)
.build()
验证您的适配器和 SDK 版本
如需记录适配器和 SDK 版本,请使用以下代码段:
TapjoyMediationAdapter adapter = new TapjoyMediationAdapter();
VersionInfo adapterVersion = adapter.getVersionInfo();
VersionInfo sdkVersion = adapter.getSDKVersionInfo();
// Log the adapter patch version to 3 digits to represent the x.x.x.x versioning
// used by adapters.
Log.d("TAG", String.format(
"Adapter version: %d.%d.%03d",
adapterVersion.getMajorVersion(),
adapterVersion.getMinorVersion(),
adapterVersion.getMicroVersion()));
Log.d("TAG", String.format(
"SDK version: %d.%d.%d",
sdkVersion.getMajorVersion(),
sdkVersion.getMinorVersion(),
sdkVersion.getMicroVersion()));
错误代码
如果适配器无法从 Tapjoy 接收广告,您可以使用以下类下的
ResponseInfo.getAdapterResponse()
检查广告响应中的潜在错误:
形式
类名称
插页式广告
TapjoyAdapter
已奖励
TapjoyMediationAdapter
以下是广告加载失败时 Tapjoy 适配器抛出的代码及相应消息:
错误代码
原因
101
在界面中配置的 Ad Manager 服务器参数缺失/无效。
103
发布商必须在 Activity
上下文中请求广告。
104
Tapjoy SDK 未能初始化。
105
视频播放期间发生了 Tapjoy 演示错误。
106
Tapjoy SDK 无法同时为同一展示位置 ID 加载两个广告。
107
应用未请求投放原生广告。
108
Tapjoy SDK 没有可用广告内容。
101
在界面中配置的 Ad Manager 服务器参数缺失/无效。
102
Tapjoy SDK 未能初始化。
103
Tapjoy 适配器不支持所请求的广告格式。
104
Tapjoy 发送了一个成功的加载回调,但没有可用的内容。
105
已针对此网络配置加载了一个广告。
106
Tapjoy SDK 返回了视频失败错误回调。
版本 13.2.1.0
将 Google 移动广告 SDK 的最低版本更新为 22.3.0。
已验证与 Tapjoy SDK 版本 13.2.1 的兼容性。
构建和测试方式:
Google 移动广告 SDK 22.3.0 版。
Tapjoy SDK 版本 13.2.1。
版本 13.1.2.0
已验证与 Tapjoy SDK 版本 13.1.2 的兼容性。
构建和测试方式:
Google 移动广告 SDK 22.2.0 版。
Tapjoy SDK 版本 13.1.2。
版本 13.1.1.0
已验证与 Tapjoy SDK 版本 13.1.1 的兼容性。
构建和测试方式:
Google 移动广告 SDK 22.1.0 版。
Tapjoy SDK 版本 13.1.1。
版本 13.0.1.0
已验证与 Tapjoy SDK 版本 13.0.1 的兼容性。
构建和测试方式:
Google 移动广告 SDK 22.0.0 版
Tapjoy SDK 版本 13.0.1。
版本 13.0.0.0
已验证与 Tapjoy SDK 版本 13.0.0 的兼容性。
更新了适配器以使用新的 VersionInfo
类。
将 Google 移动广告 SDK 最低版本更新到了 22.0.0。
构建和测试方式:
Google 移动广告 SDK 22.0.0 版
Tapjoy SDK 版本 13.0.0。
版本 12.11.1.0
已验证与 Tapjoy SDK 版本 12.11.1 的兼容性。
将 Google 移动广告 SDK 最低版本更新为 21.3.0。
构建和测试方式:
Google 移动广告 SDK 21.3.0 版。
Tapjoy SDK 版本 12.11.1。
版本 12.11.0.0
已验证与 Tapjoy SDK 版本 12.11.0 的兼容性。
将 Google 移动广告 SDK 最低版本更新为 21.2.0。
构建和测试方式:
Google 移动广告 SDK 21.2.0 版。
Tapjoy SDK 版本 12.11.0。
版本 12.10.0.1
将 compileSdkVersion
和 targetSdkVersion
更新为了 API 31。
将 Google 移动广告 SDK 最低版本更新为 21.0.0。
将所需的最低 Android API 级别更新为 19。
构建和测试方式:
Google 移动广告 SDK 21.0.0 版
Tapjoy SDK 版本 12.10.0。
版本 12.10.0.0
已验证与 Tapjoy SDK 版本 12.10.0 的兼容性。
构建和测试方式:
Google 移动广告 SDK 20.6.0 版
Tapjoy SDK 版本 12.10.0。
版本 12.9.1.0
已验证与 Tapjoy SDK 版本 12.9.1 的兼容性。
将 Google 移动广告 SDK 的最低版本更新为 20.6.0。
构建和测试方式:
Google 移动广告 SDK 20.6.0 版
Tapjoy SDK 版本 12.9.1。
版本 12.9.0.0
已验证与 Tapjoy SDK 版本 12.9.0 的兼容性。
将 Google 移动广告 SDK 的最低版本更新为 20.5.0。
构建和测试方式:
Google 移动广告 SDK 20.5.0 版
Tapjoy SDK 版本 12.9.0。
版本 12.8.1.1
已验证与 Tapjoy SDK 版本 12.8.1 的兼容性。
将 Google 移动广告 SDK 的最低版本更新为 20.4.0。
修复了 Tapjoy 的 TJError.message 字段为 null 时可能会发生崩溃的问题。
构建和测试方式:
Google 移动广告 SDK 20.4.0 版
Tapjoy SDK 版本 12.8.1。
版本 12.8.1.0
已验证与 Tapjoy SDK 版本 12.8.1 的兼容性。
修复了适配器记录错误时系统记录 NullPointerException
的问题。
将 Google 移动广告 SDK 的最低版本更新为 20.2.0。
构建和测试方式:
Google 移动广告 SDK 20.2.0 版
Tapjoy SDK 版本 12.8.1。
版本 12.8.0.1
将 Google 移动广告 SDK 的最低版本更新为 20.0.0。
构建和测试方式:
Google 移动广告 SDK 版本 20.0.0.
Tapjoy SDK 版本 12.8.0。
版本 12.8.0.0
修复了错误的错误消息。
将 Google 移动广告 SDK 的最低版本更新为 19.7.0。
构建和测试方式:
Google 移动广告 SDK 19.7.0 版。
Tapjoy SDK 版本 12.8.0。
版本 12.7.1.0
已验证与 Tapjoy SDK 版本 12.7.1 的兼容性。
将 Google 移动广告 SDK 的最低版本更新为 19.5.0。
构建和测试方式:
Google 移动广告 SDK 19.5.0 版。
Tapjoy SDK 版本 12.7.1。
版本 12.7.0.0
修复了适配器返回错误版本字符串的问题。
将 Google 移动广告 SDK 的最低版本更新为 19.4.0。
构建和测试方式:
Google 移动广告 SDK 19.4.0 版
Tapjoy SDK 版本 12.7.0。
版本 12.6.1.0
已验证与 Tapjoy SDK 版本 12.6.1 的兼容性。
现在,如果一次加载具有相同 Tapjoy 展示位置名称的多个插页式广告,会导致第二个请求出现加载错误。此行为现在与激励广告的现有行为一致。
构建和测试方式:
Google 移动广告 SDK 19.2.0 版。
Tapjoy SDK 版本 12.6.1。
版本 12.6.0.0
已验证与 Tapjoy SDK 版本 12.6.0 的兼容性。
将 Google 移动广告 SDK 的最低版本更新为 19.2.0。
构建和测试方式:
Google 移动广告 SDK 19.2.0 版。
Tapjoy SDK 版本 12.6.0。
版本 12.4.2.1
添加了描述性的错误代码以及适配器加载/显示失败的原因。
将 Google 移动广告 SDK 最低版本更新为 19.0.1。
构建和测试方式:
Google 移动广告 SDK 19.0.1 版。
Tapjoy SDK 版本 12.4.2。
版本 12.4.2.0
已验证与 Tapjoy SDK 版本 12.4.2 的兼容性。
构建和测试方式:
Google 移动广告 SDK 18.3.0 版
Tapjoy SDK 版本 12.4.2。
版本 12.4.1.0
已验证与 Tapjoy SDK 版本 12.4.1 的兼容性。
构建和测试方式:
Google 移动广告 SDK 18.3.0 版
Tapjoy SDK 版本 12.4.1。
版本 12.4.0.0
已验证与 Tapjoy SDK 版本 12.4.0 的兼容性。
构建和测试方式:
Google 移动广告 SDK 18.3.0 版
Tapjoy SDK 版本 12.4.0。
版本 12.3.4.0
已验证与 Tapjoy SDK 版本 12.3.4 的兼容性。
将 Google 移动广告 SDK 的最低版本更新为 18.3.0。
构建和测试方式:
Google 移动广告 SDK 18.3.0 版
Tapjoy SDK 版本 12.3.4。
版本 12.3.3.0
已验证与 Tapjoy SDK 版本 12.3.3 的兼容性。
版本 12.3.2.0
已验证与 Tapjoy SDK 版本 12.3.2 的兼容性。
将 Google 移动广告 SDK 的最低版本更新为 18.2.0。
版本 12.3.1.1
Tapjoy Adapter 现在只会为每个展示位置请求一个广告。
版本 12.3.1.0
将适配器更新为调用“onClick()”广告事件。
验证了与 tapjoy SDK 版本 12.3.1 的兼容性。
将 Google 移动广告 SDK 的最低版本更新为 17.2.1。
版本 12.2.1.1
针对插页式广告和激励广告,向适配器添加了出价功能。
版本 12.2.1.0
验证了与 tapjoy SDK 版本 12.2.1 的兼容性。
版本 12.2.0.1
更新了适配器,以支持新的公开 Beta 版 Rewarded API。
将 Google 移动广告 SDK 的最低版本更新为 17.2.0。
版本 12.2.0.0
验证了与 tapjoy SDK 版本 12.2.0 的兼容性。
版本 12.1.0.0
已验证与 tapjoy SDK 版本 12.1.0 的兼容性。
版本 12.0.0.1
更新了适配器以调用 onRewardedVideoComplete()
广告事件。
版本 12.0.0.0
已验证与 tapjoy SDK 版本 12.0.0 的兼容性。
版本 11.12.2.0
已验证与 tapjoy SDK 版本 11.12.2 的兼容性。
版本 11.12.1.0
已验证与 tapjoy SDK 版本 11.12.1 的兼容性。
版本 11.12.0.0
已验证与 tapjoy SDK 版本 11.12.0 的兼容性。
版本 11.11.1.0
已验证与 Tapjoy SDK 版本 11.11.1 的兼容性。
版本 11.11.0.0
更新了适配器,使其与 Tapjoy SDK 版本 11.11.0 兼容。
版本 11.10.2.0
将默认奖励金额更新为 1。
已验证与 Tapjoy SDK 版本 11.10.2 的兼容性。
版本 11.10.1.0
已验证与 Tapjoy SDK 版本 11.10.1 的兼容性。
版本 11.10.0.0
已验证与 Tapjoy SDK 版本 11.10.0 的兼容性。
版本 11.9.1.0