インプレッションレベルレベニューの実装

ImpressionDataListener の実装

ironSource SDK は、表示された広告の情報についてポストバックを発火して通知します。実装オプションとして、ImpressionDataListener でインプレッションデータを受信する事が出来ます。このリスナーはすべての広告ユニットに関する情報を提供するので、インプレッションレベルレベニューを使用して異なる広告を識別することができます。

アプリで ImpressionDataListener を使用する場合、情報の損失を防ぐため、必ず ironSource SDK を初期化する前にリスナーを設定してください。

public static void addImpressionDataListener(ImpressionDataListener listener)

ironSource SDK は、インプレッションデータに関するポストバックをリスナーに通知します：

public static void addImpressionDataListener(ImpressionDataListener listener)
 
   /**
    *Invoked when the ad was displayed successfully and the impression data was recorded 
    */
   @override 
   public void onImpressionSuccess (ImpressionData impressionData)
  
}

ImpressionDataListener を解除する

ImpressionDataListener の設定を解除したい場合は、以下の様に removeImpressionData API が使用できます：

public static void removeImpressionDataListener(ImpressionDataListener listener);

ILR データを実装する

ImpressionDataListener を実装すると、インプレッションデータを独自の BI ツールや DWH に送信したり、サードパーティツールと連携する事ができるようになります。

便利な仕様として、各フィールドを個別に参照する事も、allData メソッドで全ての情報を取得する事も出来ます：

public void onImpressionSuccess (ImpressionData impressionData)
{
    Double revenue = impressionData.getRevenue();
    String adNetwork = impressionData.getAdNetwork();
    JSONObject allData =  impressionData.getAllData(); 
}

フィールドの説明とタイプを含む、利用可能な IL​​R データの完全なリストはこちらで確認出来ます。

以下は、インプレッションレベルレベニュー SDK API のデータを Google Analytics for Firebase へ実装する方法の例です。そのまま使用することも、必要な変更を加えてサードパーティのレポートツールや、独自の最適化ツール、データベース等へ実装することもできます。

/**
 * Invoked when the ad was displayed successfully and the impression data was recorded 
 */ 
@Override 
public void onImpressionSuccess(ImpressionData impressionData) { 
    // The onImpressionSuccess will be reported when the rewarded video and interstitial ad is opened. 
    // For banners, the impression is reported on load success.
    Log.d(TAG, "onImpressionSuccess" + impressionData); 
    if (impressionData != null) { 
        Bundle bundle = new Bundle(); 
	bundle.putString(FirebaseAnalytics.Param.AD_PLATFORM, "ironSource");  
	bundle.putString(FirebaseAnalytics.Param.AD_SOURCE,impressionData.adNetwork());  
	bundle.putString(FirebaseAnalytics.Param.AD_FORMAT, impressionData.getAdUnit());  	
	bundle.putString(FirebaseAnalytics.Param.AD_UNIT_NAME, impressionData.getInstanceName());
	bundle.putString(FirebaseAnalytics.Param.CURRENCY, "USD");  
	bundle.putDouble(FirebaseAnalytics.Param.VALUE, impressionData.getRevenue());  
	
        mFirebaseAnalytics.logEvent(FirebaseAnalytics.Event.AD_IMPRESSION, bundle);  
    } 
}