📘

Note

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

Overview

퍼블리셔는 MoPub의 임프레션 레벨 수익 데이터 솔루션 (ILRD)을 통해 데이터를 활용하여 다음과 같은 이점을 제공함으로써 유저를 더 잘 이해하고 페이드 유저 획득 캠페인을 최적화할 수 있습니다.

• 임프레션 레벨에서 유저 수익 데이터에 액세스 : 광고 임프레션이 트리거되면 demand source, 광고 게재 위치, 통화 및 국가 정보와 같은 기타 여러 데이터 필드를 포함한 실시간 수익 데이터를 확인할 수 있습니다.

• 매출 정밀도의 명확성 : 수익이 정확한지 또는 추정되는지를 나타내는 플래그로, 퍼블리셔에게 데이터에 대한 가시성을 제공합니다.

• 데이터 수집 및 처리 유연성 : 데이터를 직접 처리하거나 심층 분석 및 리포트를 위해 써드파티 파트너에게 보냅니다.

다음을 완료하면 추가 분석 및 추출을 위해 Branch 대시보드의 MoPub 임프레션 레벨 수익 데이터를 "Purchase" Commerce Event로 볼 수 있습니다.

!!! info "유의 사항"
-트래픽에 따라 볼륨이 매우 높을 수 있습니다. 우려 사항이 있으면 계정 관리자에게 자세한 내용을 문의하십시오.

- 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 이상
  -안드로이드 SDK v2.14 +

Branch에 특화된 리스너 코드 샘플

Branch가 MoPub에서 임프레션 레벨 수익 데이터를 수신하기 위해서는, 이 데이터를 Branch으로 보내기 위한 리스너를 앱에 포함시켜야 합니다. 리스너를 앱에 구현할 때 아래 레퍼런스 코드 샘플을 사용하십시오.

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

안드로이드 코드

MoPub SDK v5.7.0 and above has the public interface, ImpressionListener. This listener is notified when an impression is fired for any format of ad shown.

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 코드

There are two approaches to receive Impression data, one is register to NSNotificationCenter to receive impression data and the other approach is to set the impression callback delegate which is the most convenient way for publishers to receive callback for every impression.

A unified ad delegate is used by all formats except for rewarded video, which uses 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 데이터 매핑

리포트 및 Export의 ILRD

MoPub 임프레션 레벨 수익 데이터를 표준 purchase Commerce Event로 가져오는 경우 :

• revenue 가치는 Ads Analytics 및 코호트 리포트에 제공됩니다.

• Postback & Exports 사용 시, 구매 commerce event의 Branch custom_data 내에서 MoPob이 제공한 전체 JSON Blob이 포함됩니다.

• 참고: 수익 값은 base64로 인코딩된 string입니다.