広告収益情報を送信する

Adjust SDKを使用して、サポートされているネットワークパートナーの広告収益を記録することができます。

AdjustAdRevenueオブジェクトをインスタンス化する

public AdjustAdRevenue(final String source)

Adjust SDKで広告収益情報を送信するには、AdjustAdRevenueオブジェクトをインスタンス化する必要があります。このオブジェクトには、アプリで広告収益が記録されたときにAdjustに送信される変数が含まれます。

広告収益オブジェクトをインスタンス化するには、新しいAdjustAdRevenueインスタンスを作成して以下のパラメーターをパスしてください：

source （String）：広告収益のソース。利用可能なソースについては、以下の表を参照してください。

引数	広告収益ソース
`"applovin_max_sdk"`	AppLovin MAX
`"admob_sdk"`	AdMob
`"ironsource_sdk"`	ironSource
`"admost_sdk"`	Admost
`"unity_sdk"`	Unity
`"helium_chartboost_sdk"`	Helium Chartboost
`"adx_sdk"`	Ad(X)
`"publisher_sdk"`	汎用ソース
`"tradplus_sdk"`	TradPlus
`"topon_sdk"`	TopOn
`"mopub"`	MoPub

Kotlin
Java

1
val adjustAdRevenue = AdjustAdRevenue("applovin_max_sdk")
2
Adjust.trackAdRevenue(adjustAdRevenue)

1
AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("applovin_max_sdk");
2
Adjust.trackAdRevenue(adjustAdRevenue);

広告収益を送信する

public static void trackAdRevenue(AdjustAdRevenue adRevenue)

広告収益をAdjustに送信するには、広告収益のインスタンスを引数としてtrackAdRevenueメソッドを呼び出します。

Kotlin
Java

1
val adjustAdRevenue = AdjustAdRevenue("applovin_max_sdk")
2
Adjust.trackAdRevenue(adjustAdRevenue)

1
AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("applovin_max_sdk");
2
Adjust.trackAdRevenue(adjustAdRevenue)

広告収益額を記録する

public void setRevenue(final Double revenue, final String currency)

広告収益額を送信するには、setRevenueメソッドを呼び出し、以下の引数をパスします：

revenue Double）：収益額
currency （String）：レポート通貨の3桁のISO 4217コード

Kotlin
Java

1
val adjustAdRevenue = AdjustAdRevenue("applovin_max_sdk")
2
adjustAdRevenue.setRevenue(1.00, "EUR")
3
Adjust.trackAdRevenue(adjustAdRevenue)

1
AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("applovin_max_sdk");
2
adjustAdRevenue.setRevenue(1.00, "EUR");
3
Adjust.trackAdRevenue(adjustAdRevenue);

広告キャンペーンの詳細を記録する

AdjustAdRevenueクラスには、広告キャンペーンのレポート作成に使用できるプロパティが含まれています。

広告インプレッション数

public void setAdImpressionsCount(final Integer adImpressionsCount)

記録された広告インプレッションを送信するには、setAdImpressionsCountメソッドを呼び出し、以下の引数をパスします：

adImpressionsCount （Integer）：広告インプレッションの数。

Kotlin
Java

1
val adjustAdRevenue = AdjustAdRevenue("applovin_max_sdk")
2
adjustAdRevenue.setAdImpressionsCount(10)
3
Adjust.trackAdRevenue(adjustAdRevenue)

1
AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("applovin_max_sdk");
2
adjustAdRevenue.setAdImpressionsCount(10);
3
Adjust.trackAdRevenue(adjustAdRevenue);

広告収益ネットワーク

public void setAdRevenueNetwork(final String adRevenueNetwork)

広告収益ネットワークを送信するには、setAdRevenueNetworkメソッドを呼び出し、以下の引数をパスします：

adRevenueNetwork （String）：ネットワーク名

Kotlin
Java

1
val adjustAdRevenue = AdjustAdRevenue("applovin_max_sdk")
2
adjustAdRevenue.setAdRevenueNetwork("network1")
3
Adjust.trackAdRevenue(adjustAdRevenue)

1
AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("applovin_max_sdk");
2
adjustAdRevenue.setAdRevenueNetwork("network1");
3
Adjust.trackAdRevenue(adjustAdRevenue);

広告収益ユニット

public void setAdRevenueUnit(final String adRevenueUnit)

広告収益ユニットを送信するには、setAdRevenueUnitメソッドを呼び出し、以下の引数をパスします：

adRevenueUnit （String）：広告ユニット

Kotlin
Java

1
val adjustAdRevenue = AdjustAdRevenue("applovin_max_sdk")
2
adjustAdRevenue.setAdRevenueUnit("unit1")
3
Adjust.trackAdRevenue(adjustAdRevenue)

1
AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("applovin_max_sdk");
2
adjustAdRevenue.setAdRevenueUnit("unit1");
3
Adjust.trackAdRevenue(adjustAdRevenue);

広告収益の配置

public void setAdRevenuePlacement(final String adRevenuePlacement)

広告収益の配置を送信するには、setAdRevenuePlacementメソッドを呼び出し、以下の引数をパスします：

adRevenuePlacement （String）：広告配置

Kotlin
Java

1
val adjustAdRevenue = AdjustAdRevenue("applovin_max_sdk")
2
adjustAdRevenue.setAdRevenuePlacement("banner")
3
Adjust.trackAdRevenue(adjustAdRevenue)

1
AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("applovin_max_sdk");
2
adjustAdRevenue.setAdRevenuePlacement("banner");
3
Adjust.trackAdRevenue(adjustAdRevenue);

コールバックパラメーターを追加する

public void addCallbackParameter(final String key, final String value)

AdjustダッシュボードでコールバックURLを登録した場合、SDKがイベントを記録する際にコールバックURLにGETリクエストを送信します。

コールバックパラメーターをサーバーに設定できます。イベントにパラメーターを設定すると、SDKはそれらをコールバックURLに追加します。この情報を使用して、自社のBIシステムでユーザーのアプリ内行動を分析することが可能です。

イベントにコールバックパラメーターを追加するには、String key-value引数を指定してaddCallbackParameterメソッドを呼び出してください。このメソッドを複回呼び出すことで、複数のパラメーターを追加することができます。

Adjust SDKはイベントを計測し、コールバックパラメーターが追加されたURLにリクエストを送信します。例えば、URL https://www.mydomain.com/callbackが登録されている場合、コールバックは以下のようになります：

https://www.mydomain.com/callback?key=value&foo=bar

CSVレポートを使用している場合、CSVの定義欄にパラメーターを追加するようにしてください。

Adjustでは、SDKからURLに情報をパスするための様々なプレースホルダーをサポートしています。例えば、iOSの{idfa}プレースホルダーやAndroidの{gps_adid}プレースホルダーなどです。{publisher_parameter}プレースホルダーは、単一の文字列での全てのコールバックパラメーターを表示します。

Kotlin
Java

1
val adjustAdRevenue = AdjustAdRevenue("applovin_max_sdk")
2
adjustAdRevenue.addCallbackParameter("key", "value")
3
Adjust.trackAdRevenue(adjustAdRevenue)

1
AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("applovin_max_sdk");
2
adjustAdRevenue.addCallbackParameter("key", "value");
3
Adjust.trackAdRevenue(adjustAdRevenue);

パートナーパラメーターを追加する

public void addPartnerParameter(String key, String value)

パートナーパラメーターを追加することで、ネットワークパートナーに追加情報を送信することができます。

Adjustは、設定した外部パートナーにパートナーパラメーターを送信します。この情報は、より詳細な分析やリターゲティング施策にご利用いただけます。パートナー用にパラメーターの設定が完了し、機能が有効化されると、Adjustのサーバーはデータ転送を開始します。

イベントにパートナーパラメーターを追加するには、String key-value引数を指定してaddPartnerParameterメソッドを呼び出してください。このメソッドを複回呼び出すことで、複数のパラメーターを追加することができます。

Kotlin
Java

1
val adjustAdRevenue = AdjustAdRevenue("applovin_max_sdk")
2
adjustAdRevenue.addPartnerParameter("key", "value")
3
Adjust.trackAdRevenue(adjustAdRevenue)

1
AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("applovin_max_sdk");
2
adjustAdRevenue.addPartnerParameter("key", "value");
3
Adjust.trackAdRevenue(adjustAdRevenue);

例

この例では、以下のプロパティを含む広告収益オブジェクトを設定し、記録する方法を示しています：

収益ソースをAppLovin MAXとする
収益額を1 Euroとする
10広告インプレッション数
広告収益ネットワークを "network1" とする
広告収益ユニットを "unit1" とする
広告収益の配置を "banner" とする
コールバックパラメーター： "key1" = "value1"
パートナーパラメーター： "key2" = "value2"

Kotlin
Java

1
val adjustAdRevenue = AdjustAdRevenue(AdjustConfig.AD_REVENUE_APPLOVIN_MAX)
2
adjustAdRevenue.setRevenue(1.00, "EUR")
3
adjustAdRevenue.setAdImpressionsCount(10)
4
adjustAdRevenue.setAdRevenueNetwork("network1")
5
adjustAdRevenue.setAdRevenueUnit("unit1")
6
adjustAdRevenue.setAdRevenuePlacement("banner")
7
adjustAdRevenue.addCallbackParameter("key1", "value1")
8
adjustAdRevenue.addPartnerParameter("key2", "value2")
9
Adjust.trackAdRevenue(adjustAdRevenue)

1
AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue(AdjustConfig.AD_REVENUE_APPLOVIN_MAX);
2
adjustAdRevenue.setRevenue(1.00, "EUR");
3
adjustAdRevenue.setAdImpressionsCount(10);
4
adjustAdRevenue.setAdRevenueNetwork("network1");
5
adjustAdRevenue.setAdRevenueUnit("unit1");
6
adjustAdRevenue.setAdRevenuePlacement("banner");
7
adjustAdRevenue.addCallbackParameter("key1", "value1");
8
adjustAdRevenue.addPartnerParameter("key2", "value2");
9
Adjust.trackAdRevenue(adjustAdRevenue);