📘

注意

Please contact your MoPub account representative to have this feature enabled in your account.

概述

MoPub 的 Impression-Level Revenue Data（ILRD，即展示级别收入数据）解决方案使发行商能够利用数据更好地了解用户，并通过提供以下好处优化付费获客：

• 在展示级别访问用户收入数据：触发广告展示后实时获得收入数据；包括许多其他数据字段，例如需求来源，广告展示位置，货币和国家/地区信息。

• 明确收入精确度：指示收入是否准确或估计的标记，为发行商提供对数据更多的可观性。

• 数据提取和处理的灵活性 ：自己处理数据或将其发送给第三方合作伙伴以进行更深入的分析和报告。

通过完成以下操作，您可在 Branch 操作后台 (Dashboard)把 MoPub 展示级别收入数据作为 “Purchase” commerce 事件来查看，以进行进一步的分析和导出。

!!!信息“注意事项”
—根据您的流量，Volume 可能会很大。如果您有任何疑问，请联系您的客户经理以获取更多详细信息。

- If you already recording purchase commerce events, you can create a custom event with custom data to track the ILRD from MoPub instead by editing the code snippets below.

要求

• 请联系 MoPub 客户代表以在您的帐户中启用此功能。
• MoPub SDK 5.7.0
• 应用中实现的 Branch 特定侦听器代码
• 使用 v2事件的 Branch SDK
  —iOS SDK v0.21.9 +
  —Android SDK v2.14 +

Branch 特定侦听器代码示例

为了使 Branch 能够从 MoPub 接收展示级别收入数据，您必须在应用中包含侦听器，才能将这些数据发送给 Branch。在应用中实现侦听器时，请使用下面引用的代码示例。

Please refer to MoPub’s developer documentation for more detail.

Android 代码

MoPub SDK v5.7.0及更高版本具有公共接口，ImpressionListener。当任何格式的被显示广告触发一次展示时，将通知此侦听器。

protected void trackMoPubImpression(ImpressionData impression) {
        BranchEvent event = new BranchEvent(BRANCH_STANDARD_EVENT.PURCHASE);
        event.setRevenue(impression.getPublisherRevenue());
        event.setDescription(impression.getAdGroupType());


        String precision = impression.getPrecision();
        String json = impression.getJsonRepresentation().toString();
        String encodedJson = Base64.encodeToString(json.getBytes(), Base64.DEFAULT);

        event.addCustomDataProperty("precision", precision);
        event.addCustomDataProperty("mopub_ad_information", encodedJson);

        // modify with appropriate context
        event.logEvent(getApplicationContext());
    }

iOS 代码

接收展示数据有两种方法，一种是注册到NSNotificationCenter以接收展示数据，另一种是设置展示回调委托，这是发行商接收展示回调的最方便方法。

统一广告委托可用于所有格式，但奖励视频除外，该视频使用MPRewardedVideoDelegate。

- (void)trackMoPubImpression:(MPImpressionData *)data {

    BranchEvent *event = [BranchEvent standardEvent:BranchStandardEventPurchase];
    event.revenue = [NSDecimalNumber decimalNumberWithDecimal:[data.publisherRevenue decimalValue]];
    event.eventDescription = data.adGroupType;

    NSString *precision = [NSNumber numberWithInteger:data.precision].stringValue;
    NSString *json = [data.jsonRepresentation base64EncodedStringWithOptions:0];
    if (json && precision) {
        event.customData = (NSMutableDictionary *) @{ @"precision": precision, @"mopub_ad_information": json };
    }
    [event logEvent];
}

MoPub < >Branch 数据映射

ILRD 报告与导出

当 MoPub 展示级别收入数据作为标准 purchase commerce 事件导入：

• 收入值在广告分析和 Cohort（同期群）报告中提供。

• Postback 和 Export 包括 MoPob 在 Branch custom_data 中为 PURCHASE commerce 事件提供的整个 JSON blob。

• 注意：收入值是 base64编码 string。