In API-Level 34 hinzugefügt
Auch in Ad Services Extensions 4 hinzugefügt

CustomAudienceManager

public class CustomAudienceManager
extends Object

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


CustomAudienceManager stellt APIs für App- und Anzeigen-SDKs bereit, um benutzerdefinierte Zielgruppen zu verknüpfen oder zu verlassen.

Zusammenfassung

Öffentliche Methoden

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

Fügt den Nutzer dem von fetchUri abgerufenen CustomAudience hinzu.

static CustomAudienceManager get(Context context)

Factory-Methode zum Erstellen einer Instanz von CustomAudienceManager.

TestCustomAudienceManager getTestCustomAudienceManager()

Dienst mit APIs erstellen, die Tests ermöglichen

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

Fügt den Nutzer dem angegebenen CustomAudience hinzu.

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

Versucht, einen Nutzer aus einer benutzerdefinierten Zielgruppe zu entfernen, indem vorhandene CustomAudience-Daten gelöscht werden, die mit ownerPackageName, buyer und name identifiziert wurden.

Übernommene Methoden

Öffentliche Methoden

FetchAndJoinCustomAudience

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

Fügt den Nutzer dem von fetchUri abgerufenen CustomAudience hinzu.

Der Versuch, den Nutzer für eine benutzerdefinierte Zielgruppe mit derselben Kombination aus ownerPackageName, buyer und name zu registrieren, führt dazu, dass die Informationen, die überschrieben werden sollen, einschließlich der Liste der Anzeigendaten.

Beachten Sie, dass die Anzeigenliste durch den täglichen Hintergrundabrufjob vollständig überschrieben werden kann.

Dieser Aufruf schlägt mit SecurityException fehl, wenn

  1. ownerPackageName ruft nicht den Paketnamen der App auf und/oder
  2. Der Käufer ist nicht zur Nutzung der API berechtigt.

Dieser Aufruf schlägt mit IllegalArgumentException fehl, wenn

  1. Das Speicherlimit wurde von der aufrufenden Anwendung überschritten und/oder
  2. URI-Parameter in der angegebenen CustomAudience sind nicht mit dem CustomAudience Käufer.

Dieser Aufruf schlägt mit LimitExceededException fehl, wenn das aufrufende Paket die und wird gedrosselt.

Dieser Aufruf schlägt mit der Fehlermeldung IllegalStateException fehl, wenn ein interner Dienstfehler gefunden wurden.
Erfordert AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE

Parameter
fetchAndJoinCustomAudienceRequest FetchAndJoinCustomAudienceRequest: Dieser Wert darf nicht null sein.

executor Executor: Dieser Wert darf nicht null sein. Callback- und Listener-Ereignisse werden über dieses Mit Executor lässt sich ganz einfach steuern, welcher Thread verwendet. Um Ereignisse über den Hauptthread Ihres können Sie Context.getMainExecutor() Geben Sie andernfalls einen Executor an, der E-Mails an einen geeigneten Thread weiterleitet.

receiver OutcomeReceiver: Dieser Wert darf nicht null sein.

get

In API-Level 34 hinzugefügt
Auch in Ad Services Extensions 6 hinzugefügt
public static CustomAudienceManager get (Context context)

Factory-Methode zum Erstellen einer Instanz von CustomAudienceManager.

Parameter
context Context: Der zu verwendende Context Dieser Wert darf nicht null sein.

Returns
CustomAudienceManager Eine CustomAudienceManager-Instanz Dieser Wert darf nicht null sein.

getTestCustomAudienceManager

In API-Level 34 hinzugefügt
Auch in Ad Services Extensions 4 hinzugefügt
public TestCustomAudienceManager getTestCustomAudienceManager ()

Dienst mit APIs erstellen, die Tests ermöglichen

Returns
TestCustomAudienceManager Dieser Wert darf nicht null sein.

JoinCustomAudience

In API-Level 34 hinzugefügt
Auch in Ad Services Extensions 4 hinzugefügt
public void joinCustomAudience (JoinCustomAudienceRequest joinCustomAudienceRequest, 
                Executor executor, 
                OutcomeReceiver<ObjectException> receiver)

Fügt den Nutzer dem angegebenen CustomAudience hinzu.

Der Versuch, den Nutzer für eine benutzerdefinierte Zielgruppe mit derselben Kombination aus ownerPackageName, buyer und name zu registrieren, führt dazu, dass die Informationen, die überschrieben werden sollen, einschließlich der Liste der Anzeigendaten.

Beachten Sie, dass die Anzeigenliste durch den täglichen Hintergrundabrufjob vollständig überschrieben werden kann.

Dieser Aufruf schlägt mit SecurityException fehl, wenn

  1. ownerPackageName ruft nicht den Paketnamen der App auf und/oder
  2. Der Käufer ist nicht zur Nutzung der API berechtigt.

Dieser Aufruf schlägt mit IllegalArgumentException fehl, wenn

  1. Das Speicherlimit wurde von der aufrufenden Anwendung überschritten und/oder
  2. URI-Parameter in der angegebenen CustomAudience sind nicht mit dem CustomAudience Käufer.

Dieser Aufruf schlägt mit LimitExceededException fehl, wenn das aufrufende Paket die und wird gedrosselt.

Dieser Aufruf schlägt mit der Fehlermeldung IllegalStateException fehl, wenn ein interner Dienstfehler gefunden wurden.
Erfordert AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE

Parameter
joinCustomAudienceRequest JoinCustomAudienceRequest: Dieser Wert darf nicht null sein.

executor Executor: Dieser Wert darf nicht null sein. Callback- und Listener-Ereignisse werden über dieses Mit Executor lässt sich ganz einfach steuern, welcher Thread verwendet. Um Ereignisse über den Hauptthread Ihres können Sie Context.getMainExecutor() Geben Sie andernfalls einen Executor an, der E-Mails an einen geeigneten Thread weiterleitet.

receiver OutcomeReceiver: Dieser Wert darf nicht null sein.

verlassenBenutzerdefinierte Zielgruppe

In API-Level 34 hinzugefügt
Auch in Ad Services Extensions 4 hinzugefügt
public void leaveCustomAudience (LeaveCustomAudienceRequest leaveCustomAudienceRequest, 
                Executor executor, 
                OutcomeReceiver<ObjectException> receiver)

Versucht, einen Nutzer aus einer benutzerdefinierten Zielgruppe zu entfernen, indem vorhandene CustomAudience-Daten gelöscht werden, die mit ownerPackageName, buyer und name identifiziert wurden.

Dieser Aufruf schlägt mit SecurityException fehl, wenn

  1. ownerPackageName ruft nicht den Paketnamen der App auf. und/oder
  2. Der Käufer ist nicht zur Nutzung der API berechtigt.

Dieser Aufruf schlägt mit LimitExceededException fehl, wenn das aufrufende Paket die und wird gedrosselt.

Der Aufrufer wird durch diesen Aufruf nicht darüber informiert, ob die angegebene benutzerdefinierte Zielgruppe in auf dem Gerät. Sie scheitert also ohne Ton, wenn ein Käufer versucht, benutzerdefinierte Zielgruppe, der nicht beigetreten ist.
Erfordert AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE

Parameter
leaveCustomAudienceRequest LeaveCustomAudienceRequest: Dieser Wert darf nicht null sein.

executor Executor: Dieser Wert darf nicht null sein. Callback- und Listener-Ereignisse werden über dieses Mit Executor lässt sich ganz einfach steuern, welcher Thread verwendet. Um Ereignisse über den Hauptthread Ihres können Sie Context.getMainExecutor() Geben Sie andernfalls einen Executor an, der E-Mails an einen geeigneten Thread weiterleitet.

receiver OutcomeReceiver: Dieser Wert darf nicht null sein.