Tenjin SDKは、TradPlusのインプレッション単位の収益データを取得し、収益イベントをTenjinに送信することができます。
実装手順 #
- https://docs.tradplusad.com/en/docs/tradplussdk_android_doc_v6/ から、最新バージョンのTradPlus SDKをアプリレベルの
build.gradleファイルに追加してください。 - TradPlusの
onAdImpressionコールバック内で、eventAdImpressionTradPlus(json)メソッドを使用して、インプレッションデータをTenjinに渡します。
コードサンプル #
Java
public class DemoActivity extends Activity {
private TenjinSDK tenjinInstance;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
tenjinInstance = TenjinSDK.getInstance(this, "<SDK_KEY>");
}
public void onAdImpression(TPAdInfo tpAdInfo) {
try {
JSONObject json = new JSONObject();
json.put("revenue", Double.parseDouble(tpAdInfo.ecpm));
json.put("network_name", tpAdInfo.adSourceName);
json.put("ad_unit_id", tpAdInfo.tpAdUnitId);
json.put("revenue_precision", tpAdInfo.ecpmPrecision);
json.put("format", tpAdInfo.format);
json.put("segment", tpAdInfo.segmentId);
json.put("ab_test", tpAdInfo.bucketId);
json.put("country", tpAdInfo.isoCode);
json.put("creative_id", tpAdInfo.creativeId);
tenjinInstance.eventAdImpressionTradPlus(json);
} catch (JSONException e) {
e.printStackTrace();
}
}
}インプレッションレベル収益データパラメータ #
| パラメータ | TradPlusのフィールド | 必須? | 例 |
|---|---|---|---|
revenue | ecpm | はい | 2.5 |
network_name | adSourceName | いいえ | Admob |
ad_unit_id | tpAdUnitId | いいえ | id-69082 |
revenue_precision | ecpmPrecision | いいえ | exact |
format | format | いいえ | interstitial |
segment | segmentId | いいえ | id-2 |
ab_test | bucketId | いいえ | id-1 |
country | isoCode | いいえ | US |
creative_id | creativeId | いいえ | id-41203 |
注記 #
revenueには、1インプレッションあたりの収益ではなく、eCPMの値を指定してください。TradPlusのecpmの値をそのまま渡す必要があります。Tenjin側で1,000で割ることで、1インプレッションあたりの収益が算出されます。送信前にあらかじめご自身で1,000で割ってしまうと、Tenjinに記録される収益が実際の値の1,000分の1になってしまいます。- TradPlusは、
ecpmを米ドル (USD)で報告します。 revenueパラメータには、文字列型ではなくdouble型を使用してください。TradPlusはecpmを文字列型で返すため、送信前に変換を行う必要があります。revenueのみが必須です。その他のパラメータはすべて任意です。segmentIdおよびbucketIdを利用するには、TradPlus SDK v7.6.0.1以降が必要です。creativeIdを利用するには v15.0.0.1以降が必要であり、この値はInMobiおよびMintegralの場合にのみ返されます。