측정 관리자

public class MeasurementManager
extends Object

java.lang.Object
   ↳ android.adservices.measurement.MeasurementManager

MeasurementManager는 소스 및 트리거 등록을 관리하는 API를 제공합니다.

요약

상수

int MEASUREMENT_API_STATE_DISABLED

이 상태는 Measurement API를 사용할 수 없음을 나타냅니다.

int MEASUREMENT_API_STATE_ENABLED

이 상태는 Measurement API가 사용 설정되었음을 나타냅니다.

공개 메서드

void deleteRegistrations(DeletionRequest deletionRequest, Executor executor, OutcomeReceiver<Object, Exception> callback)

이전 등록을 삭제합니다.

static MeasurementManager get(Context context)

MeasurementManager의 인스턴스를 생성하는 팩토리 메서드입니다.

void getMeasurementApiStatus(Executor executor, OutcomeReceiver<Integer, Exception> callback)

Measurement API 상태를 가져옵니다.

void registerSource(Uri attributionSource, InputEvent inputEvent, Executor executor, OutcomeReceiver<Object, Exception> callback)

기여 분석 소스 (클릭 또는 조회)를 등록합니다.

void registerSource(SourceRegistrationRequest request, Executor executor, OutcomeReceiver<Object, Exception> callback)

앱 컨텍스트에서 기여 분석 소스(클릭 또는 조회)를 등록합니다.

void registerTrigger(Uri trigger, Executor executor, OutcomeReceiver<Object, Exception> callback)

트리거 (전환)를 등록합니다.

void registerWebSource(WebSourceRegistrationRequest request, Executor executor, OutcomeReceiver<Object, Exception> callback)

웹 컨텍스트에서 기여 분석 소스(클릭 또는 조회)를 등록합니다.

void registerWebTrigger(WebTriggerRegistrationRequest request, Executor executor, OutcomeReceiver<Object, Exception> callback)

웹 컨텍스트에서 기여 분석 트리거(클릭 또는 조회)를 등록합니다.

상속된 메서드

상수

MEASUREMENT_API_STATE_DISABLED

API 수준 34에 추가됨
광고 서비스 확장 프로그램 4에도 추가됨 
public static final int MEASUREMENT_API_STATE_DISABLED

이 상태는 Measurement API를 사용할 수 없음을 나타냅니다. 이를 호출하면 UnsupportedOperationException

상수 값: 0 (0x00000000)

MEASUREMENT_API_STATE_ENABLED

API 수준 34에 추가됨
광고 서비스 확장 프로그램 4에도 추가됨 
public static final int MEASUREMENT_API_STATE_ENABLED

이 상태는 Measurement API가 사용 설정되었음을 나타냅니다.

상수 값: 1명 (0x00000001)

공개 메서드

deleteRegistrations

public void deleteRegistrations (DeletionRequest deletionRequest, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> callback)

이전 등록을 삭제합니다. 삭제에 성공하면 콜백의 OutcomeReceiver.onResult(R)가 null과 함께 호출됩니다. 실패할 경우 Exception는 다음과 같습니다. 콜백의 OutcomeReceiver#onError를 통해 전송됩니다. 성공과 실패 모두 의견은 제공된 Executor에서 실행됩니다.

매개변수
deletionRequest DeletionRequest: 데이터 삭제 요청입니다. 이 값은 null일 수 없습니다.
executor Executor: 콜백을 실행할 실행자입니다. 이 값은 null일 수 없습니다. 콜백과 리스너 이벤트는 다음을 통해 전달됩니다. Executor: 어떤 스레드를 실행할지 쉽게 제어할 수 있게 함 있습니다. 앱의 기본 스레드를 통해 이벤트를 애플리케이션의 Context.getMainExecutor() 그 외의 경우에는 적절한 스레드로 전달되는 Executor를 제공합니다.
callback OutcomeReceiver: API 결과를 비동기식으로 알립니다. 이 값은 null일 수 없습니다.

get

public static MeasurementManager get (Context context)

MeasurementManager의 인스턴스를 생성하는 팩토리 메서드입니다.

매개변수
context Context: 사용할 Context 이 값은 null일 수 없습니다.
반환 값
MeasurementManager MeasurementManager 인스턴스 이 값은 null일 수 없습니다.

getMeasurementApiStatus

public void getMeasurementApiStatus (Executor executor, 
                OutcomeReceiver<Integer, Exception> callback)

Measurement API 상태를 가져옵니다.

콜백의 Integer 값은 MeasurementApiState 중 하나입니다.
AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION 필요

매개변수
executor Executor: 결과를 전달하는 데 콜백에서 사용됩니다. 이 값은 null일 수 없습니다. 콜백과 리스너 이벤트는 다음을 통해 전달됩니다. Executor: 어떤 스레드를 실행할지 쉽게 제어할 수 있게 함 있습니다. 앱의 기본 스레드를 통해 이벤트를 애플리케이션의 Context.getMainExecutor() 그 외의 경우에는 적절한 스레드로 전달되는 Executor를 제공합니다.
callback OutcomeReceiver: API 결과를 비동기식으로 알립니다. 이 값은 null일 수 없습니다.

등록 소스

public void registerSource (Uri attributionSource, 
                InputEvent inputEvent, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> callback)

기여 분석 소스 (클릭 또는 조회)를 등록합니다.
AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION 필요

매개변수
attributionSource Uri: 플랫폼이 메타데이터를 가져오기 위해 이 URI에 요청을 보냅니다. 기여 분석 소스와 연결됩니다. 소스 메타데이터는 기기에 저장되어 향후 트리거에 일치시킬 수 있습니다. 이 값은 null일 수 없습니다.
inputEvent InputEvent: InputEvent 객체 (클릭 이벤트의 경우) 또는 null (뷰의 경우) 이벤트).
executor Executor: 결과를 전달하는 데 콜백에서 사용됩니다. 이 값은 null일 수 있습니다. 콜백과 리스너 이벤트는 다음을 통해 전달됩니다. Executor: 어떤 스레드를 실행할지 쉽게 제어할 수 있게 함 있습니다. 앱의 기본 스레드를 통해 이벤트를 애플리케이션의 Context.getMainExecutor() 그 외의 경우에는 적절한 스레드로 전달되는 Executor를 제공합니다.
callback OutcomeReceiver: API 결과를 비동기식으로 알립니다. 이 값은 null일 수 있습니다.
생성 값
IllegalArgumentException attributionSource의 스키마가 HTTPS가 아닌 경우

등록 소스

public void registerSource (SourceRegistrationRequest request, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> callback)

앱 컨텍스트에서 기여 분석 소스(클릭 또는 조회)를 등록합니다. 이 API는 모든 등록 URL이 요청과 함께 제공되어야 합니다.
AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION 필요

매개변수
request SourceRegistrationRequest: 앱 소스 등록 요청 이 값은 null일 수 없습니다.
executor Executor: 결과를 전달하는 데 콜백에서 사용됩니다. 이 값은 null일 수 있습니다. 콜백과 리스너 이벤트는 다음을 통해 전달됩니다. Executor: 어떤 스레드를 실행할지 쉽게 제어할 수 있게 함 있습니다. 앱의 기본 스레드를 통해 이벤트를 애플리케이션의 Context.getMainExecutor() 그 외의 경우에는 적절한 스레드로 전달되는 Executor를 제공합니다.
callback OutcomeReceiver: API 결과를 비동기식으로 알립니다. 이 값은 null일 수 있습니다.

등록 트리거

public void registerTrigger (Uri trigger, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> callback)

트리거 (전환)를 등록합니다.
AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION 필요

매개변수
trigger Uri: API가 이 URI에 요청을 실행하여 트리거입니다. 트리거 메타데이터는 기기에 저장되며 소스 데이터를 집계할 수 있습니다. 이 값은 null일 수 없습니다.
executor Executor: 결과를 전달하는 데 콜백에서 사용됩니다. 이 값은 null일 수 있습니다. 콜백과 리스너 이벤트는 다음을 통해 전달됩니다. Executor: 어떤 스레드를 실행할지 쉽게 제어할 수 있게 함 있습니다. 앱의 기본 스레드를 통해 이벤트를 애플리케이션의 Context.getMainExecutor() 그 외의 경우에는 적절한 스레드로 전달되는 Executor를 제공합니다.
callback OutcomeReceiver: API 결과를 비동기식으로 알립니다. 이 값은 null일 수 있습니다.
생성 값
IllegalArgumentException trigger의 스키마가 HTTPS가 아닌 경우

registerWebSource

public void registerWebSource (WebSourceRegistrationRequest request, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> callback)

웹 컨텍스트에서 기여 분석 소스(클릭 또는 조회)를 등록합니다. 이 API는 모든 등록 URL을 요청과 함께 제공해야 합니다. 다음 중 하나 이상 appDestination 또는 webDestination 매개변수를 입력해야 합니다. 만약 성공하면 callback의 OutcomeReceiver#onResult가 null로 호출됩니다. 포함 실패하면 Exception가 callback의 OutcomeReceiver.onError(E)를 통해 전송됩니다. 성공 및 실패 피드백 모두 제공된 Executor
AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION 필요

매개변수
request WebSourceRegistrationRequest: 소스 등록 요청 이 값은 null일 수 없습니다.
executor Executor: 결과를 전달하는 데 콜백에서 사용됩니다. 이 값은 null일 수 있습니다.
callback OutcomeReceiver: API 결과를 비동기식으로 알립니다. 이 값은 null일 수 있습니다.

registerWebTrigger

public void registerWebTrigger (WebTriggerRegistrationRequest request, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> callback)

웹 컨텍스트에서 기여 분석 트리거(클릭 또는 조회)를 등록합니다. 이 API는 모든 등록 URL이 요청과 함께 제공되어야 합니다. 만약 성공하면 callback의 OutcomeReceiver#onResult가 null로 호출됩니다. 포함 실패하면 Exception가 callback의 OutcomeReceiver.onError(E)를 통해 전송됩니다. 성공 및 실패 피드백 모두 제공된 Executor
AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION 필요

매개변수
request WebTriggerRegistrationRequest: 등록 요청을 트리거합니다. 이 값은 null일 수 없습니다.
executor Executor: 결과를 전달하는 데 콜백에서 사용됩니다. 이 값은 null일 수 있습니다.
callback OutcomeReceiver: API 결과를 비동기식으로 알립니다. 이 값은 null일 수 있습니다.