展现级收入数据

集成展现级收入数据

开始之前

• 确保已集成 OpenMediation SDK v2.1.0 或更高版本。

展现级收入数据

展现级收入数据作为 ImpressionData 对象的一部分返回。这是相关数据字段的列表，包括说明和类型。

实现回调接口

OpenMediation SDK v2.1.0 及更高版本增加了公共接口 ImpressionDataListener。当任何格式的广告内容触发一次展示时，将通知此 Listener。

请注意，您需要先在 OpenMediation 前台启用了 ILRD 功能，否则 onImpression() 回调中的 ImpressionData 参数将会是空数据。

1. 实现 ImpressionDataListener 接口，并调用 OmAds.addImpressionDataListener(listener) 订阅事件以接收详细的展现数据。 我们建议您在应用程序启动时就订阅事件。

import com.openmediation.sdk.OmAds;
import com.openmediation.sdk.ImpressionData;
import com.openmediation.sdk.ImpressionDataListener;
import com.openmediation.sdk.utils.error.Error;

ImpressionDataListener listener = new ImpressionDataListener() {
    @Override
    public void onImpression(Error error, ImpressionData impressionData) {
        if (impressionData != null) {
            // To make it easy to use, you can refer to each field separately, 
            // or get all information using the allData method:
            impressionData.getAllData();
        } else {
            // impression data not available
        }
    }
});

2. 调用 OmAds.addImpressionDataListener(listener) 以开始监听展现级别的收入数据事件。

3. 调用 OmAds.removeImpressionDataListener(listener) 以取消订阅展现级别的收入数据事件。

OmAds.addImpressionDataListener(listener);
OmAds.removeImpressionDataListener(listener);

确保 ImpressionDataListener 不会产生内存泄漏。如果您的 Listener 与 Activity 生命周期相关联，请确保在销毁 Activity 时移除 Listener。

示例

import com.openmediation.sdk.OmAds;
import com.openmediation.sdk.ImpressionData;
import com.openmediation.sdk.ImpressionDataListener;

    private ImpressionDataListener mImpressionListener;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        mImpressionListener = new ImpressionDataListener() {
            @Override
            public void onImpression(Error error, ImpressionData impressionData) {
            }
        };
        // subscribe to start listening for impression data
        OmAds.addImpressionDataListener(mImpressionListener);
    }

    @Override
    protected void onDestroy() {
        // Remove the listener to unsubscribe
        OmAds.removeImpressionDataListener(mImpressionListener);
        super.onDestroy();
    }

将数据发送到其他工具或供应商

收到展示数据后，您可以将其提供给内部商务智能（BI）工具，或将其发送给第三方归因和分析提供商以进行进一步分析。

示例

以下示例显示了如何将ILRD发送到 Google Analytics for Firebase。 您可以进行一些必要的更改，以便与第三方报告工具或您自己专有的优化工具和数据库集成。

@Override
public void onImpression(Error error, ImpressionData impressionData) {
    if (impressionData != null) {
        // Feed impression data into internal tools or send to third-party analytics
        FirebaseAnalytics firebaseAnalytics = FirebaseAnalytics.getInstance(context);
        Bundle params = new Bundle();
        params.putString(FirebaseAnalytics.Param.AD_PLATFORM, "OpenMediation");
        params.putString(FirebaseAnalytics.Param.AD_SOURCE, impressionData.getAdNetworkName());
        params.putString(FirebaseAnalytics.Param.AD_FORMAT, impressionData.getPlacementAdType());
        params.putString(FirebaseAnalytics.Param.AD_UNIT_NAME, impressionData.getPlacementName());
        params.putDouble(FirebaseAnalytics.Param.VALUE, impressionData.getRevenue());
        params.putString(FirebaseAnalytics.Param.CURRENCY, impressionData.getCurrency());
        params.putString("precision", impressionData.getPrecision());
        firebaseAnalytics.logEvent(FirebaseAnalytics.Event.AD_IMPRESSION, params);
    }
}