adjust-icon

広告収益情報の記録

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

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

メソッドシグネチャー
constructor(source: string)

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

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

  • sourcestring):広告収益のソース。利用可能なソースについては、以下の表を参照してください。
パラメーターソース
AdjustAdRevenueSource.AdRevenueSourceAppLovinMAXAppLovin MAX
AdjustAdRevenueSource.AdRevenueSourceMopubMoPub
AdjustAdRevenueSource.AdRevenueSourceAdMobAdMob
AdjustAdRevenueSource.AdRevenueSourceIronSourceironSource
AdjustAdRevenueSource.AdRevenueSourceAdmostAdmost
AdjustAdRevenueSource.AdRevenueSourceUnityUnity
AdjustAdRevenueSource.AdRevenueSourceHeliumChartboostHelium Chartboost
AdjustAdRevenueSource.AdRevenueSourceTopOnTopOn
AdjustAdRevenueSource.AdRevenueSourceAdxAd(X)
AdjustAdRevenueSource.AdRevenueSourcePublisher汎用ソース
var adjustAdRevenue = new AdjustAdRevenue(
AdjustAdRevenueSource.AdRevenueSourceAppLovinMAX,
);
Adjust.trackAdRevenue(adjustAdRevenue);

広告収益の送信

メソッドシグネチャー
trackAdRevenue(adRevenue: AdjustAdRevenue): void;

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

var adjustAdRevenue = new AdjustAdRevenue(
AdjustAdRevenueSource.AdRevenueSourceAppLovinMAX,
);
Adjust.trackAdRevenue(adjustAdRevenue);

広告収益額を記録する

メソッドシグネチャー
setRevenue(revenue: number, currency: string): void

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

  • revenue number):収益額
  • currencystring):レポート通貨の3桁のISO 4217コード
var adjustAdRevenue = new AdjustAdRevenue(
AdjustAdRevenueSource.AdRevenueSourceAppLovinMAX,
);
adjustAdRevenue.setRevenue(1.0, "EUR");
Adjust.trackAdRevenue(adjustAdRevenue);

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

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

広告インプレッション数

メソッドシグネチャー
setAdImpressionsCount(adImpressionsCount: number)

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

  • adImpressionsCountnumber):広告インプレッションの数。
var adjustAdRevenue = new AdjustAdRevenue(
AdjustAdRevenueSource.AdRevenueSourceAppLovinMAX,
);
adjustAdRevenue.setAdImpressionsCount(10);
Adjust.trackAdRevenue(adjustAdRevenue);

広告収益ネットワーク

メソッドシグネチャー
setAdRevenueNetwork(adRevenueNetwork: string)

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

  • adRevenueNetwork ( string ):ネットワークの名前。
var adjustAdRevenue = new AdjustAdRevenue(
AdjustAdRevenueSource.AdRevenueSourceAppLovinMAX,
);
adjustAdRevenue.setAdRevenueNetwork("network1");
Adjust.trackAdRevenue(adjustAdRevenue);

広告収益ユニット

メソッドシグネチャー
setAdRevenueUnit(adRevenueUnit: string)

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

  • adRevenueUnit ( string ):広告収益ユニットの名前。
var adjustAdRevenue = new AdjustAdRevenue(
AdjustAdRevenueSource.AdRevenueSourceAppLovinMAX,
);
adjustAdRevenue.setAdRevenueUnit("unit1");
Adjust.trackAdRevenue(adjustAdRevenue);

広告収益の配置

メソッドシグネチャー
setAdRevenuePlacement(adRevenuePlacement: string)

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

  • adRevenuePlacement ( string ):広告収益の配置。
var adjustAdRevenue = new AdjustAdRevenue(
AdjustAdRevenueSource.AdRevenueSourceAppLovinMAX,
);
adjustAdRevenue.setAdRevenuePlacement("banner");
Adjust.trackAdRevenue(adjustAdRevenue);

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

メソッドシグネチャー
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(
AdjustAdRevenueSource.AdRevenueSourceAppLovinMAX,
);
adjustAdRevenue.addCallbackParameter("key", "value");
Adjust.trackAdRevenue(adjustAdRevenue);

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

メソッドシグネチャー
addPartnerParameter(key: string, value: string): void

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

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

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

var adjustAdRevenue = new AdjustAdRevenue(
AdjustAdRevenueSource.AdRevenueSourceAppLovinMAX,
);
adjustAdRevenue.addPartnerParameter("key", "value");
Adjust.trackAdRevenue(adjustAdRevenue);

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

  • 収益ソースをAppLovin MAXとする
  • 収益額を1 Euroとする
  • 10広告インプレッション数
  • 広告収益ネットワークを "network1" とする
  • 広告収益ユニットを "unit1" とする
  • 広告収益の配置を "banner" とする
  • コールバックパラメーター: "key1" = "value1"
  • パートナーパラメーター: "key2" = "value2"
var adjustAdRevenue = new AdjustAdRevenue(
AdjustAdRevenueSource.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);