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

요약: 상수 | 메서드 | 상속된 메서드

측정 관리자

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) 웹 컨텍스트에서 기여 분석 트리거(클릭 또는 조회)를 등록합니다.

상속된 메서드

java.lang.Object 클래스에서 상속 Object clone() 이 개체의 사본을 만들어 반환합니다. boolean equals(Object obj) 일부 다른 개체가 이 개체와 '같은'지 여부를 나타냅니다. void finalize() 가비지 컬렉션이 더 이상 객체에 관한 참조가 없다고 판단하는 경우 객체의 가비지 컬렉터에서 호출합니다. final Class<?> getClass() 이 Object의 런타임 클래스를 반환합니다. int hashCode() 객체의 해시 코드 값을 반환합니다. final void notify() 이 객체의 모니터에서 대기 중인 단일 스레드의 대기 모드를 해제합니다. final void notifyAll() 이 개체의 모니터에서 대기 중인 모든 스레드의 대기 모드를 해제합니다. String toString() 객체의 문자열 표현을 반환합니다. final void wait(long timeoutMillis, int nanos) 일반적으로 알림을 받거나 중단되어 절전 모드에서 해제될 때까지 또는 일정 시간이 경과할 때까지 현재 스레드가 대기하도록 합니다. final void wait(long timeoutMillis) 일반적으로 알림을 받거나 중단되어 절전 모드에서 해제될 때까지 또는 일정 시간이 경과할 때까지 현재 스레드가 대기하도록 합니다. final void wait() 일반적으로 알림을 받거나 중단되어 절전 모드에서 해제될 때까지 현재 스레드가 대기하도록 합니다.

상수

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

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

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

API 수준 34에 추가됨
광고 서비스 확장 프로그램 6에도 추가됨

public static MeasurementManager get (Context context)

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

매개변수
context	Context: 사용할 Context 이 값은 null일 수 없습니다.

반환 값
MeasurementManager	MeasurementManager 인스턴스 이 값은 null일 수 없습니다.

getMeasurementApiStatus

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

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

등록 소스

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

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

등록 소스

Android UpsideDownCakePrivacySandbox에 추가됨
광고 서비스 확장 프로그램 4에도 추가됨

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

등록 트리거

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

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

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

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

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

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