AdSelectionManager.SelectAds Methode

Definition

Namespace:: Android.AdServices.AdSelection

Assembly:: Mono.Android.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Überlädt

Name	Beschreibung
SelectAds(AdSelectionConfig, IExecutor, IOutcomeReceiver)	Führt den Anzeigenauswahlprozess auf dem Gerät aus, um eine Werbeanzeigenanzeige für die Anruferanwendung auszuwählen.
SelectAds(AdSelectionFromOutcomesConfig, IExecutor, IOutcomeReceiver)	Wählt eine Anzeige aus den Ergebnissen der zuvor ausgeführten Anzeigenauswahl aus.

SelectAds(AdSelectionConfig, IExecutor, IOutcomeReceiver)

Führt den Anzeigenauswahlprozess auf dem Gerät aus, um eine Werbeanzeigenanzeige für die Anruferanwendung auszuwählen.

[Android.Runtime.Register("selectAds", "(Landroid/adservices/adselection/AdSelectionConfig;Ljava/util/concurrent/Executor;Landroid/os/OutcomeReceiver;)V", "GetSelectAds_Landroid_adservices_adselection_AdSelectionConfig_Ljava_util_concurrent_Executor_Landroid_os_OutcomeReceiver_Handler", ApiSince=34)]
public virtual void SelectAds(Android.AdServices.AdSelection.AdSelectionConfig adSelectionConfig, Java.Util.Concurrent.IExecutor executor, Android.OS.IOutcomeReceiver receiver);

[<Android.Runtime.Register("selectAds", "(Landroid/adservices/adselection/AdSelectionConfig;Ljava/util/concurrent/Executor;Landroid/os/OutcomeReceiver;)V", "GetSelectAds_Landroid_adservices_adselection_AdSelectionConfig_Ljava_util_concurrent_Executor_Landroid_os_OutcomeReceiver_Handler", ApiSince=34)>]
abstract member SelectAds : Android.AdServices.AdSelection.AdSelectionConfig * Java.Util.Concurrent.IExecutor * Android.OS.IOutcomeReceiver -> unit
override this.SelectAds : Android.AdServices.AdSelection.AdSelectionConfig * Java.Util.Concurrent.IExecutor * Android.OS.IOutcomeReceiver -> unit

Parameter

adSelectionConfig: AdSelectionConfig

executor: IExecutor

receiver: IOutcomeReceiver

Attribute: RegisterAttribute

Hinweise

Führt den Anzeigenauswahlprozess auf dem Gerät aus, um eine Werbeanzeigenanzeige für die Anruferanwendung auszuwählen.

Die Eingabe adSelectionConfig wird vom Ads SDK bereitgestellt und das AdSelectionConfig Objekt wird über einen Binder-Aufruf übertragen. Aus diesem Grund ist die Gesamtgröße dieser Objekte an die Android IPC-Einschränkungen gebunden. Fehler beim Übertragen des AdSelectionConfig Vorgangs werden ausgelöst TransactionTooLargeException.

Die Eingabe adSelectionConfig enthält Decision Logic Uri , die entweder den vordefinierten HTTPS- oder Ad Selection-Schemas folgen kann.

Wenn der URI dem HTTPS-Schema folgt, sollte der Host mit dem seller. IllegalArgumentException Andernfalls wird dies ausgelöst.

Vordefinierte URIs sind eine Möglichkeit zum Substituieren einer generischen vordefinierten Logik für die erforderlichen JavaScripts für scoreAds. Der vordefinierte URI für diesen Endpunkt sollte folgen;

<ul><li>ad-selection-prebuilt://ad-selection/<name>?<script-generation-parameters></ul>

Wenn ein nicht unterstützter vordefinierter URI übergeben wird oder ein vordefiniertes URI-Feature vom Dienst deaktiviert wird, IllegalArgumentException wird dieses ausgelöst.

Siehe AdSelectionConfig.Builder#setDecisionLogicUri unterstützte <name> und erforderliche <script-generation-parameters>Informationen.

Die Ausgabe wird vom Empfänger übergeben, der entweder eine AdSelectionOutcome erfolgreiche Ausführung zurückgibt, oder eine Exception enthält den Typ der ausgelösten Ausnahme und die entsprechende Fehlermeldung.

Wenn der IllegalArgumentException Fehler ausgelöst wird, wird es durch ungültiges Eingabeargument verursacht, das die API empfangen hat, um die Anzeigenauswahl auszuführen.

Wenn der IllegalStateException Fehler mit der Fehlermeldung "Fehler von AdSelection-Diensten" ausgelöst wird, wird dies durch einen internen Fehler des Anzeigenauswahldiensts verursacht.

Wenn der TimeoutException Wurf ausgelöst wird, wird es verursacht, wenn während des Gebots, der Bewertung oder des allgemeinen Auswahlprozesses ein Timeout auftritt, um eine gewinnbringende Anzeige zu finden.

Wenn der LimitExceededException Fehler ausgelöst wird, wird dies verursacht, wenn das aufrufende Paket die zulässigen Ratengrenzwerte überschreitet und gedrosselt wird.

Wenn der SecurityException Fehler ausgelöst wird, wird dies verursacht, wenn der Anrufer nicht autorisiert ist oder die Berechtigung nicht angefordert wird.

Java Dokumentation für android.adservices.adselection.AdSelectionManager.selectAds(android.adservices.adselection.AdSelectionConfig, java.util.concurrent.Executor, android.os.OutcomeReceiver<android.adservices.adselection.AdSelectionOutcome, java.lang.Exception>).

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Gilt für:

SelectAds(AdSelectionFromOutcomesConfig, IExecutor, IOutcomeReceiver)

Wählt eine Anzeige aus den Ergebnissen der zuvor ausgeführten Anzeigenauswahl aus.

[Android.Runtime.Register("selectAds", "(Landroid/adservices/adselection/AdSelectionFromOutcomesConfig;Ljava/util/concurrent/Executor;Landroid/os/OutcomeReceiver;)V", "GetSelectAds_Landroid_adservices_adselection_AdSelectionFromOutcomesConfig_Ljava_util_concurrent_Executor_Landroid_os_OutcomeReceiver_Handler", ApiSince=35)]
public virtual void SelectAds(Android.AdServices.AdSelection.AdSelectionFromOutcomesConfig adSelectionFromOutcomesConfig, Java.Util.Concurrent.IExecutor executor, Android.OS.IOutcomeReceiver receiver);

[<Android.Runtime.Register("selectAds", "(Landroid/adservices/adselection/AdSelectionFromOutcomesConfig;Ljava/util/concurrent/Executor;Landroid/os/OutcomeReceiver;)V", "GetSelectAds_Landroid_adservices_adselection_AdSelectionFromOutcomesConfig_Ljava_util_concurrent_Executor_Landroid_os_OutcomeReceiver_Handler", ApiSince=35)>]
abstract member SelectAds : Android.AdServices.AdSelection.AdSelectionFromOutcomesConfig * Java.Util.Concurrent.IExecutor * Android.OS.IOutcomeReceiver -> unit
override this.SelectAds : Android.AdServices.AdSelection.AdSelectionFromOutcomesConfig * Java.Util.Concurrent.IExecutor * Android.OS.IOutcomeReceiver -> unit

Parameter

adSelectionFromOutcomesConfig: AdSelectionFromOutcomesConfig

executor: IExecutor

receiver: IOutcomeReceiver

Attribute: RegisterAttribute

Hinweise

Wählt eine Anzeige aus den Ergebnissen der zuvor ausgeführten Anzeigenauswahl aus.

Die Eingabe adSelectionFromOutcomesConfig wird vom Ads SDK bereitgestellt und das AdSelectionFromOutcomesConfig Objekt wird über einen Binder-Aufruf übertragen. Aus diesem Grund ist die Gesamtgröße dieser Objekte an die Android IPC-Einschränkungen gebunden. Fehler beim Übertragen des AdSelectionFromOutcomesConfig Vorgangs werden ausgelöst TransactionTooLargeException.

Die Eingabe adSelectionFromOutcomesConfig enthält:

<ul><li>Seller muss registriert android.adservices.common.AdTechIdentifiersein. IllegalStateException Andernfalls wird dies ausgelöst. <li>List of ad selection ids sollte vorhanden sein und von Anrufen stammen AdSelectionManager#selectAds , die aus derselben Anwendung stammen. IllegalArgumentException Andernfalls löst die Eingabeüberprüfung die Anzeigeauswahl-IDs aus. <li>Selection logic URI , die entweder den Schemas "HTTPS" oder "Ad Selection Prebuilt" folgen könnten.