Adjust SDKを使用して、サポートされているネットワークパートナーの広告収益を記録することができます。
AdjustAdRevenueオブジェクトをインスタンス化する
constructor(source: string)
Adjust SDKで広告収益情報を送信するには、AdjustAdRevenue
オブジェクトをインスタンス化する必要があります。このオブジェクトには、アプリで広告収益が記録されたときにAdjustに送信される変数が含まれます。
広告収益オブジェクトをインスタンス化するには、新しいAdjustAdRevenue
インスタンスを作成して以下のパラメーターをパスしてください:
source
(string
):広告収益のソース。利用可能なソースについては、以下の表を参照してください。
パラメーター | ソース |
---|---|
AdjustConfig.AdRevenueSourceAppLovinMAX | AppLovin MAX |
AdjustConfig.AdRevenueSourceMopub | MoPub |
AdjustConfig.AdRevenueSourceAdMob | AdMob |
AdjustConfig.AdRevenueSourceIronSource | ironSource |
AdjustConfig.AdRevenueSourceAdmost | Admost |
AdjustConfig.AdRevenueSourceUnity | Unity |
AdjustConfig.AdRevenueSourceHeliumChartboost | Helium Chartboost |
AdjustConfig.AdRevenueSourcePublisher | 汎用ソース |
var adjustAdRevenue = new AdjustAdRevenue("source");
Adjust.trackAdRevenue(adjustAdRevenue);
広告収益を送信する
trackAdRevenue: ((source: string, payload: string) => void) & ((source: AdjustAdRevenue) => void)
広告収益をAdjustに送信するには、広告収益のインスタンスを引数としてtrackAdRevenue
メソッドを呼び出します。
var adjustAdRevenue = new AdjustAdRevenue("source");
Adjust.trackAdRevenue(adjustAdRevenue);
広告収益額を記録する
public setRevenue(revenue: number, currency: string): void
広告収益額を送信するには、setRevenue
メソッドを呼び出し、以下の引数をパスします:
revenue
number
):収益額currency
(string
):レポート通貨の3桁のISO 4217コード
var adjustAdRevenue = new AdjustAdRevenue("source");
adjustAdRevenue.setRevenue(1.0, "EUR");
Adjust.trackAdRevenue(adjustAdRevenue);
広告キャンペーンの詳細を記録する
AdjustAdRevenue
クラスには、広告キャンペーンのレポート作成に使用できるプロパティが含まれています。
広告インプレッション数
public setAdImpressionsCount(adImpressionsCount: number): void
記録された広告インプレッションを送信するには、setAdImpressionsCount
メソッドを呼び出し、以下の引数をパスします:
adImpressionsCount
(number
):広告インプレッションの数。
var adjustAdRevenue = new AdjustAdRevenue("source");
adjustAdRevenue.setAdImpressionsCount(10);
Adjust.trackAdRevenue(adjustAdRevenue);
広告収益ネットワーク
public setAdRevenueNetwork(adRevenueNetwork: string): void
広告収益ネットワークを送信するには、setAdRevenueNetwork
メソッドを呼び出し、以下の引数をパスします:
adRevenueNetwork
(string
):ネットワーク名
var adjustAdRevenue = new AdjustAdRevenue("source");
adjustAdRevenue.setAdRevenueNetwork("network1");
Adjust.trackAdRevenue(adjustAdRevenue);
広告収益ユニット
public setAdRevenueUnit(adRevenueUnit: string): void
広告収益ユニットを送信するには、setAdRevenueUnit
メソッドを呼び出し、以下の引数をパスします:
adRevenueUnit
(string
):広告ユニット
var adjustAdRevenue = new AdjustAdRevenue("source");
adjustAdRevenue.setAdRevenueUnit("unit1");
Adjust.trackAdRevenue(adjustAdRevenue);
広告収益の配置
public setAdRevenuePlacement(adRevenuePlacement: string): void
setAdRevenuePlacement
メソッドにstring
値をパスすることで、広告の配置先を記録します。
var adjustAdRevenue = new AdjustAdRevenue("source");
adjustAdRevenue.setAdRevenuePlacement("banner");
Adjust.trackAdRevenue(adjustAdRevenue);
コールバックパラメーターを追加する
public addCallbackParameter(key: string, value: string): void
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}
プレースホルダーは、単一の文字列での全てのコールバックパラメーターを表示します。
var adjustAdRevenue = new AdjustAdRevenue("source");
adjustAdRevenue.addCallbackParameter("key", "value");
Adjust.trackAdRevenue(adjustAdRevenue);
パートナーパラメーターを追加する
public addPartnerParameter(key: string, value: string): void
パートナーパラメーターを追加することで、ネットワークパートナーに追加情報を送信することができます。
Adjustは、設定した外部パートナーにパートナーパラメーターを送信します。この情報は、より詳細な分析やリターゲティング施策にご利用いただけます。パートナー用にパラメーターの設定が完了し、機能が有効化されると、Adjustのサーバーはデータ転送を開始します。
イベントにパートナーパラメーターを追加するには、string
key-value引数を指定してaddPartnerParameter
メソッドを呼び出してください。このメソッドを複回呼び出すことで、複数のパラメーターを追加することができます。
var adjustAdRevenue = new AdjustAdRevenue("source");
adjustAdRevenue.addPartnerParameter("key", "value");
Adjust.trackAdRevenue(adjustAdRevenue);
例
この例では、以下のプロパティを含む広告収益オブジェクトを設定し、記録する方法を示しています:
- 収益ソースをAppLovin MAXとする
- 収益額を1 Euroとする
- 10広告インプレッション数
- 広告収益ネットワークを
"network1"
とする - 広告収益ユニットを
"unit1"
とする - 広告収益の配置を
"banner"
とする - コールバックパラメーター:
"key1" = "value1"
- パートナーパラメーター:
"key2" = "value2"
var adjustAdRevenue = new AdjustAdRevenue( AdjustConfig.AdRevenueSourceAppLovinMAX,);adjustAdRevenue.setRevenue(1.0, "EUR");adjustAdRevenue.setAdImpressionsCount(10);adjustAdRevenue.setAdRevenueNetwork("network1");adjustAdRevenue.setAdRevenueUnit("unit1");adjustAdRevenue.setAdRevenuePlacement("banner");adjustAdRevenue.addCallbackParameter("key1", "value1");adjustAdRevenue.addPartnerParameter("key2", "value2");Adjust.trackAdRevenue(adjustAdRevenue);