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<Object, Exception> receiver)
Fügt den Nutzer dem von |
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<Object, Exception> receiver)
Fügt den Nutzer dem angegebenen |
void
|
leaveCustomAudience(LeaveCustomAudienceRequest leaveCustomAudienceRequest, Executor executor, OutcomeReceiver<Object, Exception> receiver)
Versucht, einen Nutzer aus einer benutzerdefinierten Zielgruppe zu entfernen, indem vorhandene |
Übernommene Methoden | |
---|---|
Öffentliche Methoden
FetchAndJoinCustomAudience
public void fetchAndJoinCustomAudience (FetchAndJoinCustomAudienceRequest fetchAndJoinCustomAudienceRequest, Executor executor, OutcomeReceiver<Object, Exception> 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
ownerPackageName
ruft nicht den Paketnamen der App auf und/oder- Der Käufer ist nicht zur Nutzung der API berechtigt.
Dieser Aufruf schlägt mit IllegalArgumentException
fehl, wenn
- Das Speicherlimit wurde von der aufrufenden Anwendung überschritten und/oder
- URI-Parameter in der angegebenen
CustomAudience
sind nicht mit demCustomAudience
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
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
public TestCustomAudienceManager getTestCustomAudienceManager ()
Dienst mit APIs erstellen, die Tests ermöglichen
Returns | |
---|---|
TestCustomAudienceManager |
Dieser Wert darf nicht null sein. |
JoinCustomAudience
public void joinCustomAudience (JoinCustomAudienceRequest joinCustomAudienceRequest, Executor executor, OutcomeReceiver<Object, Exception> 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
ownerPackageName
ruft nicht den Paketnamen der App auf und/oder- Der Käufer ist nicht zur Nutzung der API berechtigt.
Dieser Aufruf schlägt mit IllegalArgumentException
fehl, wenn
- Das Speicherlimit wurde von der aufrufenden Anwendung überschritten und/oder
- URI-Parameter in der angegebenen
CustomAudience
sind nicht mit demCustomAudience
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
public void leaveCustomAudience (LeaveCustomAudienceRequest leaveCustomAudienceRequest, Executor executor, OutcomeReceiver<Object, Exception> 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
ownerPackageName
ruft nicht den Paketnamen der App auf. und/oder- 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. |