CustomAudienceManager

public class CustomAudienceManager
extends Object

java.lang.Object
   ↳ android.adservices.customaudience.CustomAudienceManager

CustomAudienceManager가 맞춤 잠재고객에 가입 또는 탈퇴하는 데 사용할 수 있는 API를 제공합니다.

요약

공개 메서드

void fetchAndJoinCustomAudience(FetchAndJoinCustomAudienceRequest fetchAndJoinCustomAudienceRequest, Executor executor, OutcomeReceiver<Object, Exception> receiver)

fetchUri에서 가져온 CustomAudience에 사용자를 추가합니다.

static CustomAudienceManager get(Context context)

CustomAudienceManager의 인스턴스를 만드는 팩토리 메서드입니다.

TestCustomAudienceManager getTestCustomAudienceManager()

테스트 사용 설정 API로 서비스 만들기

void joinCustomAudience(JoinCustomAudienceRequest joinCustomAudienceRequest, Executor executor, OutcomeReceiver<Object, Exception> receiver)

지정된 CustomAudience에 사용자를 추가합니다.

void leaveCustomAudience(LeaveCustomAudienceRequest leaveCustomAudienceRequest, Executor executor, OutcomeReceiver<Object, Exception> receiver)

ownerPackageName, buyer, name로 식별된 기존 CustomAudience 데이터를 삭제하여 맞춤 잠재고객에서 사용자 삭제를 시도합니다.

상속된 메서드

공개 메서드

fetchAndJoinCustomAudience

public void fetchAndJoinCustomAudience (FetchAndJoinCustomAudienceRequest fetchAndJoinCustomAudienceRequest, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> receiver)

fetchUri에서 가져온 CustomAudience에 사용자를 추가합니다.

ownerPackageName, buyer, name의 동일한 조합을 사용하여 맞춤 잠재고객에 사용자를 등록하려고 하면 광고 데이터 목록을 포함한 기존 맞춤 잠재고객의 정보가 덮어써집니다.

일일 백그라운드 가져오기 작업으로 광고 목록을 완전히 덮어쓸 수 있습니다.

다음과 같은 경우 SecurityException이 반환되고 호출이 실패합니다.

  1. ownerPackageName가 앱의 패키지 이름을 호출하지 않거나
  2. 구매자에게 API를 사용할 권한이 없습니다.

다음과 같은 경우 IllegalArgumentException이 반환되고 호출이 실패합니다.

  1. 호출하는 애플리케이션이 저장용량 한도를 초과했거나
  2. 주어진 CustomAudience의 URI 매개변수는 CustomAudience 구매자로 인증되지 않습니다.

호출 패키지가 허용된 비율 제한을 초과하여 제한되면 이 호출은 LimitExceededException와 함께 실패합니다.

내부 서비스 오류가 발생하면 이 호출이 IllegalStateException 오류와 함께 실패합니다.
AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE 필요

매개변수
fetchAndJoinCustomAudienceRequest FetchAndJoinCustomAudienceRequest: 이 값은 null일 수 없습니다.
executor Executor: 이 값은 null일 수 없습니다. 콜백 및 리스너 이벤트가 이 Executor를 통해 전달되므로 사용되는 스레드를 쉽게 제어할 수 있습니다. 애플리케이션의 기본 스레드를 통해 이벤트를 전달하려면 Context.getMainExecutor()를 사용하면 됩니다. 그 외의 경우에는 적절한 스레드에 전달되는 Executor를 제공합니다.
receiver OutcomeReceiver: 이 값은 null일 수 없습니다.

get

public static CustomAudienceManager get (Context context)

CustomAudienceManager의 인스턴스를 만드는 팩토리 메서드입니다.

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

getTestCustomAudienceManager

public TestCustomAudienceManager getTestCustomAudienceManager ()

테스트 사용 설정 API로 서비스 만들기

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

조인 맞춤 잠재고객

public void joinCustomAudience (JoinCustomAudienceRequest joinCustomAudienceRequest, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> receiver)

지정된 CustomAudience에 사용자를 추가합니다.

ownerPackageName, buyer, name의 동일한 조합을 사용하여 맞춤 잠재고객에 사용자를 등록하려고 하면 광고 데이터 목록을 포함한 기존 맞춤 잠재고객의 정보가 덮어써집니다.

일일 백그라운드 가져오기 작업으로 광고 목록을 완전히 덮어쓸 수 있습니다.

다음과 같은 경우 SecurityException이 반환되고 호출이 실패합니다.

  1. ownerPackageName가 앱의 패키지 이름을 호출하지 않거나
  2. 구매자에게 API를 사용할 권한이 없습니다.

다음과 같은 경우 IllegalArgumentException이 반환되고 호출이 실패합니다.

  1. 호출하는 애플리케이션이 저장용량 한도를 초과했거나
  2. 주어진 CustomAudience의 URI 매개변수는 CustomAudience 구매자로 인증되지 않습니다.

호출 패키지가 허용된 비율 제한을 초과하여 제한되면 이 호출은 LimitExceededException와 함께 실패합니다.

내부 서비스 오류가 발생하면 이 호출이 IllegalStateException 오류와 함께 실패합니다.
AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE 필요

매개변수
joinCustomAudienceRequest JoinCustomAudienceRequest: 이 값은 null일 수 없습니다.
executor Executor: 이 값은 null일 수 없습니다. 콜백 및 리스너 이벤트가 이 Executor를 통해 전달되므로 사용되는 스레드를 쉽게 제어할 수 있습니다. 애플리케이션의 기본 스레드를 통해 이벤트를 전달하려면 Context.getMainExecutor()를 사용하면 됩니다. 그 외의 경우에는 적절한 스레드에 전달되는 Executor를 제공합니다.
receiver OutcomeReceiver: 이 값은 null일 수 없습니다.

이탈 맞춤 잠재고객

public void leaveCustomAudience (LeaveCustomAudienceRequest leaveCustomAudienceRequest, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> receiver)

ownerPackageName, buyer, name로 식별된 기존 CustomAudience 데이터를 삭제하여 맞춤 잠재고객에서 사용자 삭제를 시도합니다.

다음과 같은 경우 SecurityException이 반환되고 호출이 실패합니다.

  1. ownerPackageName가 앱의 패키지 이름을 호출하지 않는 경우 또는
  2. 구매자에게 API를 사용할 권한이 없습니다.

호출 패키지가 허용된 비율 제한을 초과하여 제한되면 이 호출은 LimitExceededException와 함께 실패합니다.

이 호출은 지정된 맞춤 잠재고객이 기기 내 저장소에 있는지 여부를 호출자에게 알리지 않습니다. 즉, 구매자가 참여하지 않은 맞춤 잠재고객을 나가려고 하면 자동으로 실패합니다.
AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE 필요

매개변수
leaveCustomAudienceRequest LeaveCustomAudienceRequest: 이 값은 null일 수 없습니다.
executor Executor: 이 값은 null일 수 없습니다. 콜백 및 리스너 이벤트가 이 Executor를 통해 전달되므로 사용되는 스레드를 쉽게 제어할 수 있습니다. 애플리케이션의 기본 스레드를 통해 이벤트를 전달하려면 Context.getMainExecutor()를 사용하면 됩니다. 그 외의 경우에는 적절한 스레드에 전달되는 Executor를 제공합니다.
receiver OutcomeReceiver: 이 값은 null일 수 없습니다.