Adjust SDKを使用して、サポートされているネットワークパートナーの広告収益を記録することができます。
AdjustAdRevenueオブジェクトをインスタンス化する
public 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("applovin_max_sdk");Adjust.TrackAdRevenue(adjustAdRevenue);広告収益の送信
public static void TrackAdRevenue(AdjustAdRevenue adRevenue);広告収益をAdjustに送信するには、広告収益のインスタンスを引数としてAdjust.TrackAdRevenueメソッドを呼び出します。
AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("applovin_max_sdk");//...Adjust.TrackAdRevenue(adjustAdRevenue);広告収益額を記録する
public void SetRevenue(double revenue, string currency);広告収益額を送信するには、AdjustAdRevenueインスタンスのSetRevenueメソッドを呼び出して、以下の引数をパスします：
revenuedouble）：収益額currency（string）：レポート通貨の3桁のISO 4217コード
AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("applovin_max_sdk");//...adjustAdRevenue.SetRevenue(1.00, "EUR");//...Adjust.TrackAdRevenue(adjustAdRevenue);広告キャンペーンの詳細を記録する
AdjustAdRevenueクラスには、広告キャンペーンのレポート作成に使用できるプロパティが含まれています。
広告インプレッション数
public int? AdImpressionsCount { get; set; }記録された広告インプレッション数を送信するには、 AdjustAdRevenueインスタンスのAdImpressionsCountプロパティを広告インプレッション数に設定してください。
AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("applovin_max_sdk");//...adjustAdRevenue.AdImpressionsCount = 10;//...Adjust.TrackAdRevenue(adjustAdRevenue);広告収益ネットワーク
public string AdRevenueNetwork { get; set; }広告収益に関連するネットワークを記録するには、 AdjustAdRevenueインスタンスのAdRevenueNetworkプロパティにネットワーク名を割り当てます。
AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("applovin_max_sdk");//...adjustAdRevenue.AdRevenueNetwork = "network1";//...Adjust.TrackAdRevenue(adjustAdRevenue);広告収益ユニット
public string AdRevenueUnit { get; set; }広告収益ユニットを送信するには、広告収益インスタンスのAdjustAdRevenueプロパティにユニットをAdRevenueUnit値として割り当てます。
AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source");//...adjustAdRevenue.AdRevenueUnit = "unit1";//...Adjust.TrackAdRevenue(adjustAdRevenue);広告収益の配置
public string AdRevenuePlacement { get; set; }広告収益の配置を送信するには、広告収益インスタンスのAdjustAdRevenueプロパティに配置をAdRevenuePlacement値として割り当てます。
AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source");//...adjustAdRevenue.AdRevenuePlacement = "banner";//...Adjust.TrackAdRevenue(adjustAdRevenue);コールバックパラメーターを追加する
public 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=barCSVレポートを使用している場合、CSVの定義欄にパラメーターを追加するようにしてください。
Adjustでは、SDKからURLに情報をパスするための様々なプレースホルダーをサポートしています。例えば、iOSの{idfa}プレースホルダーやAndroidの{gps_adid}プレースホルダーなどです。{publisher_parameter}プレースホルダーは、単一の文字列での全てのコールバックパラメーターを表示します。
AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source");//...adjustAdRevenue.AddCallbackParameter("key", "value");//...Adjust.TrackAdRevenue(adjustAdRevenue);パートナーパラメーターの追加
public 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);