広告収益情報を記録する

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

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

AdjustAdRevenue(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

AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue('source');
Adjust.trackAdRevenue(adjustAdRevenue);

広告収益の送信

static void trackAdRevenue(AdjustAdRevenue adRevenue)

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

AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue('source');
Adjust.trackAdRevenue(adjustAdRevenue);

広告収益額を記録する

void setRevenue(num revenue, String currency)

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

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

AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue('source');
adjustAdRevenue.setRevenue(1.00, 'EUR');
Adjust.trackAdRevenue(adjustAdRevenue);

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

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

広告インプレッション数

num? adImpressionsCount

記録された広告インプレッション数を送信するには、広告収益インスタンスのadImpressionsCountプロパティにnum値を割り当てます。

AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue('source');
adjustAdRevenue.adImpressionsCount = 10;
Adjust.trackAdRevenue(adjustAdRevenue);

広告収益ネットワーク

String? adRevenueNetwork

広告収益ネットワークを送信するには、広告収益インスタンスのadRevenueNetworkプロパティにネットワーク名をString値として割り当てます。

AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue('source');
adjustAdRevenue.adRevenueNetwork = 'network1';
Adjust.trackAdRevenue(adjustAdRevenue);

広告収益ユニット

String? adRevenueUnit

広告収益ユニットを送信するには、広告収益インスタンスのadRevenueUnitプロパティにユニットをString値として割り当てます。

AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue('source');
adjustAdRevenue.adRevenueUnit = 'unit1';
Adjust.trackAdRevenue(adjustAdRevenue);

広告収益の配置

String? adRevenuePlacement

広告収益の配置を送信するには、広告収益インスタンスのadRevenuePlacementプロパティに配置をString値として割り当てます。

AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue('source');
adjustAdRevenue.adRevenuePlacement = 'banner';
Adjust.trackAdRevenue(adjustAdRevenue);

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

void addCallbackParameter(String key, 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}プレースホルダーは、単一の文字列での全てのコールバックパラメーターを表示します。

AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue('source');
adjustAdRevenue.addCallbackParameter('key', 'value')
Adjust.trackAdRevenue(adjustAdRevenue);

パートナーパラメーターの追加

void addPartnerParameter(String key, String value)

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

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

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

AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue('source');
adjustAdRevenue.addPartnerParameter('key', 'value');
Adjust.trackAdRevenue(adjustAdRevenue);

例

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

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

AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue('applovin_max_sdk');
adjustAdRevenue.setRevenue(1.00, 'EUR');
adjustAdRevenue.adImpressionsCount = 10;
adjustAdRevenue.adRevenueNetwork = 'network1';
adjustAdRevenue.adRevenueUnit = 'unit1';
adjustAdRevenue.adRevenuePlacement = 'banner';
adjustAdRevenue.addCallbackParameter('key1', 'value1');
adjustAdRevenue.addPartnerParameter('key2', 'value2');
Adjust.trackAdRevenue(adjustAdRevenue);