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