Tapjoy

Service

2024年08月24日 01:25

Tapjoy应用创建

1. 进入Tapjoy并登录账户，选择Monetization→点击右上角的个人账户→点击+Add App按钮，开始创建应用。

2. 进入应用创建界面，选择应用的操作系统，填写应用的基本信息。

应用名称：填写应用名称。
屏幕方向：通常选择两种都支持，以获得更高的广告填充率。
时区：即数据时区，建议选择(GMT+00:00)协调世界时，与OpenMediation时区一致。
货币单位：即报表币种。
Tapjoy Usage Case：一般选择Full Use of Tapjoy's Mobile Impact Platform。
App Store URL/Google Play URL：若您的应用已经在App Store / Google Play上线，请填入对应的商店链接。
This App is not in the App Store yet :若您的应用还未上架，请勾选此选项。

3.后续步骤可跳过

Tapjoy虚拟货币创建

若您需要使用Tapjoy虚拟货币服务请按照下方指南填写相关内容，若您无意使用Tapjoy虚拟货币服务，则填写任何内容将不会实际产生影响。

1.应用创建完成后，点击右上角进入选择应用，点击变现→虚拟货币→创建虚拟货币。

2.进入创建虚拟货币的界面，填写信息。

选择货币托管模式：
- Tapjoy Managed：由Tapjoy托管。
  - 开发者可以使用Tapjoy的服务器，存储用户的货币金额。这是Tapjoy为所有集成Tapjoy SDK的开发者提供的免费服务，这省去了通常需要为App存储用户货币数据的后端工作。
- Self Managed：开发者自行管理。
  - 开发者需要使用自己的服务器，处理用户的货币余额。该方法可以让您更好地控制虚拟货币，但这也意味着开发者要完全负责为所有用户存储和处理币种的后端工作。
注意：创建虚拟货币后，将不允许您删除。
更多详情可参见：Tapjoy帮助中心。
- Platform：即所选择应用的操作系统。
- 货币名称：为虚拟货币命名，比如钻石，金币等。
- 货币用途：您可以自定义描述货币用途。
- 兑换比率：汇率定义了您通过Tapjoy每获得1美元收益，用户所获得的虚拟货币数量。虚拟货币不支持小数值，小数奖励将四舍五入到最接近的整数。建议汇率等于或高于$ 1 = 100。
- 初始余额：这代表用户开始使用您的应用时，拥有的虚拟货币的初始余额。
- 您的APP是否允许用户进行实物性质物品的购买，或者允许用户将虚拟货币兑换成现实货币？：虚假陈述（故意或其他方式）会违反Tapjoy服务条款，将导致不支付收入，且不会有例外出现。
- 此条广告的年龄限制：
  - 所有人：最严格的过滤器-仅对所有人评分的广告
  - 低：包括评级为“低成熟度”和“所有人”的广告，但不包括“中”，“高”或“成熟”的广告
  - 中：包含评级为“中”，“低”和“所有人”的广告，但不包括“高”或“成熟”的广告
  - 高：包含评级为“高成熟度”，“中”，“低”和“所有人”的广告，但不成熟的广告
  - 成熟：21个以上（无过滤条件）广告类别（赌博，酒精饮料，约会，政治）。切换为选择加入或阻止
激励视频设置为固定奖励（选填）：可以为激励视频设定固定奖励数量。

Tapjoy广告单元创建

展示位置创建

1.点击上方变现，在左侧导航栏选择展示位置→建立位置。

2.为广单元命名。

名称：您可以自行定义您的广告单元名称，我们建议您命名为:Placement ID_Ad Network Name_ Country_Floor Price。（例如：6539_Tapjoy_USA_40）
描述：您可以自定义对广告单元的描述。
Mediation：您无需勾选该选项。

内容创建

1.点击上方变现，在左侧导航栏选择创建内容，并选择相应的广告类型。

创建激励视频时，请选择激励视频，而非程序化激励视频。
创建插屏视频时，请选择插屏视频，而非程序化插屏视频。

2.完善广告内容信息。

部署：即广告内容开关。
内容名称：命名需要与广告单元名称完全一致。
测试：若该广告内容需用于测试，请勾选该选项。
虚拟货币：选择您之前已经创建好的虚拟货币。
Exchange Rate：代表您通过Tapjoy获取的每一美元广告收益，用户获得的对应的虚拟货币数量，若您未使用Tapjoy虚拟货币服务，该选项不会实际产生影响，一般选择Default即可。
奖励类型：选择默认奖励 / 固定奖励，若您未使用Tapjoy虚拟货币服务，该选项不会实际产生影响，一般选择默认奖励。
隐藏奖励：建议勾选，否则广告中会出现虚拟货币名称。
Default Sound Status：广告的默认声音状态，通常选择为Unmute，即默认不静音。
选择展示位置：选择之前创建好的广告位置。
Tip：需要注意的是，您的广告位置和内容名称需要保持一致。

OpenMediation后台配置

Ad Network配置

1.进入OpenMediation后台，点击左侧导航栏Ad Network→在Tapjoy后方点击Edit 。

2.填写相关信息后，点击Save。

SDK Key & Publisher reporting API Key & Ad Reporting API Key:

a.进入Tapjoy后台，点击右上角账户并选择相应的应用。

b.点击上方设置→应用设置。

c.在下方应用平台处获取SDK Key（SDK密钥）。

d.点击API密钥获取Publisher reporting API Key（开发者报告API密钥）和Ad Reporting API Key（广告报告API密钥）。

Currency：选择您AdColony报表模块中对应的货币单位。

Instance配置

1.点击左侧导航栏 Mediation → 选择对应的广告单元→Add Instance。

2.填写相关信息后，点击 Save 。

Ad Network ：选择Tapjoy。
Instance Name ：您可以自行定义您的广告单元名称，我们建议您命名为:Placement ID _ Ad Network NameCountryFloor Price。 (例如：7047_Tapjoy_USA_40)
Unit ID ：在Tapjoy后台点击右上角账户→选择相应的应用→在左侧复制相应广告单元名称即为UnitID。

测试模式

1.进入Tapjoy后台，点击右上角账户并选择相应的应用。

2.点击上方设置→应用设置→在左侧导航栏中选择测试设备→创建测试设备，并输入您的设备名称及IDFA或GAID。

3.点击上方变现，选择左侧导航栏中的展示位置，在需要测试的广告单元（内容）中点击编辑。

4.勾选只适用于测试设备按钮后进行保存，开启测试模式。

Tip：请务必在测试成功后关闭此按钮。

添加 SDK 和 Adapter 到项目中

Android

1. 添加 Tapjoy SDK

将下面的脚本添加到您的 project-level build.gradle 文件中 repositories 分段内。

allprojects {
  repositories {
      maven {
          url "https://sdk.tapjoy.com/"
      }
   }
}

将下面的脚本添加到您的 application-level build.gradle 文件中 dependencies 分段内。

implementation 'com.tapjoy:tapjoy-android-sdk:+

2. 添加 Tapjoy Adapter

Adapter 的集成支持 Maven（Gradle依赖）自动下载和手动下载两种方式。

Gradle 依赖

将下面的脚本添加到您的 application-level build.gradle 文件中 dependencies 分段内。

implementation 'com.openmediation.adapters:tapjoy:+'

手动下载

点击下载 Tapjoy Adapter。
在工程中的 build.gradle 中添加 Adapter 依赖。

3. 仅针对使用 ProGuard

如果您将 ProGuard 与 Tapjoy 适配器一起使用，则必须将以下代码添加到 ProGuard 配置中 (Android Studio: proguard-rules.pro or Eclipse: proguard-project.txt)：

-keep class com.tapjoy.** { *; }
-keep class com.moat.** { *; }
-keepattributes JavascriptInterface
-keepattributes *Annotation*
-keep class * extends java.util.ListResourceBundle {
protected Object[][] getContents();
}
-keep public class com.google.android.gms.common.internal.safeparcel.SafeParcelable {
public static final *** NULL;
}
-keepnames @com.google.android.gms.common.annotation.KeepName class *
-keepclassmembernames class * {
@com.google.android.gms.common.annotation.KeepName *;
}
-keepnames class * implements android.os.Parcelable {
public static final ** CREATOR;
}
-keep class com.google.android.gms.ads.identifier.** { *; }
-dontwarn com.tapjoy.**

iOS

支持 Cocoapods 和手动下载两种方式。

Cocoapods

使用 Cocoapods 集成 Tapjoy SDK，请在podfile中输入一下命令即可。

pod 'TapjoySDK'