측정 관리자

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일 수 없습니다.

registerSource

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가 아닌 경우

registerSource

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일 수 있습니다.

registerTrigger

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가 아닌 경우

등록 웹 소스

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일 수 있습니다.