보고서 이벤트 요청

public class ReportEventRequest
extends Object

java.lang.Object
   ↳ android.adservices.adselection.ReportEventRequest


광고 이벤트를 보고하는 데 필요한 필수 인수를 래핑하는 객체를 요청합니다.

요약

중첩된 클래스

class ReportEventRequest.Builder

ReportEventRequest 객체의 빌더입니다. 

상수

int FLAG_REPORTING_DESTINATION_BUYER

int FLAG_REPORTING_DESTINATION_SELLER

공개 메서드

long getAdSelectionId()

광고 선택 프로세스의 기본 식별자인 adSelectionId를 반환합니다.

String getData()

광고 이벤트 데이터를 반환합니다.

InputEvent getInputEvent()

사용자 상호작용과 연결된 입력 이벤트를 반환합니다.

String getKey()

보고할 광고 이벤트 유형인 이벤트 키를 반환합니다.

int getReportingDestinations()

보고할 대상(구매자, 판매자 또는 둘 다)의 비트 필드를 반환합니다.

상속된 메서드

상수

FLAG_REPORTING_DESTINATION_BUYER

public static final int FLAG_REPORTING_DESTINATION_BUYER

상수 값: 2 (0x00000002)

FLAG_REPORTING_DESTINATION_SELLER

public static final int FLAG_REPORTING_DESTINATION_SELLER

상수 값: 1 (0x00000001)

공개 메서드

getAdSelectionId

public long getAdSelectionId ()

광고 선택 프로세스의 기본 식별자인 adSelectionId를 반환합니다.

반환 값
long

데이터 가져오기

public String getData ()

광고 이벤트 데이터를 반환합니다.

광고 선택 후 이 데이터는 호출자에 의해 생성됩니다. 그러면 호출자는 AdSelectionManager.reportEvent(ReportEventRequest, Executor, OutcomeReceiver)를 호출할 수 있습니다. 이 데이터는 registerAdBeacon에 등록된 reportingUri에 대한 POST 요청에 첨부됩니다.

UTF-8 형식의 String#getBytes() 크기는 64KB 미만이어야 합니다.

반환 값
String 이 값은 null일 수 없습니다.

getInputEvent

public InputEvent getInputEvent ()

사용자 상호작용과 연결된 입력 이벤트를 반환합니다.

이 필드는 view 이벤트를 나타내는 null이거나 click 이벤트를 나타내는 InputEvent 객체를 포함합니다.

반환 값
InputEvent

getKey

public String getKey ()

보고할 광고 이벤트 유형인 이벤트 키를 반환합니다.

이 필드는 광고 선택 후 registerAdBeacon에 등록된 eventKey와 연결된 reportingUri를 가져오는 데 사용됩니다.

이 필드는 registerAdBeacon에 등록된 eventKey와 정확히 일치해야 합니다. registerAdBeacon에 관한 자세한 내용은 AdSelectionManager#reportImpression 문서에서 확인할 수 있습니다.

UTF-8 형식의 이벤트 키 (String#getBytes()로 바이트 배열을 검사할 때)는 40바이트를 초과하면 안 됩니다. 이 한도를 초과하는 키는 registerAdBeacon 호출 중에 등록되지 않습니다.

반환 값
String 이 값은 null일 수 없습니다.

getReportingDestinations

public int getReportingDestinations ()

보고할 대상(구매자, 판매자 또는 둘 다)의 비트 필드를 반환합니다.

이 비트 필드를 만들려면 보고할 각 reportingDestination 사이에 | 비트 연산자를 배치합니다. 예를 들어 구매자에게만 보고하려면 reportingDestinations 필드를 FLAG_REPORTING_DESTINATION_BUYER로 설정합니다. 판매자에게만 보고하려면 reportingDestinations 필드를 FLAG_REPORTING_DESTINATION_SELLER로 설정합니다. 구매자와 판매자에게 모두 보고하려면 reportingDestinations 필드를 FLAG_REPORTING_DESTINATION_BUYER | FLAG_REPORTING_DESTINATION_SELLER로 설정합니다.

반환 값
int 값은 0 또는 FLAG_REPORTING_DESTINATION_SELLERFLAG_REPORTING_DESTINATION_BUYER의 조합입니다.