AdSelectionManager.SelectAds Método

[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)]
[Android.Runtime.RequiresPermission("android.permission.ACCESS_ADSERVICES_CUSTOM_AUDIENCE")]
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)]
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)>]
[<Android.Runtime.RequiresPermission("android.permission.ACCESS_ADSERVICES_CUSTOM_AUDIENCE")>]
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

[<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

Parâmetros

Atributos

RegisterAttribute RequiresPermissionAttribute

Comentários

Executa o processo de seleção de anúncios no dispositivo para selecionar um anúncio de remarketing para o aplicativo de chamador.

A entrada adSelectionConfig é fornecida pelo SDK de Anúncios e o AdSelectionConfig objeto é transferido por meio de uma chamada do Binder. Por esse motivo, o tamanho total desses objetos está associado às limitações de IPC do Android. Falhas ao transferir a AdSelectionConfig vontade lança um TransactionTooLargeException.

A entrada adSelectionConfig contém Decision Logic Uri que pode seguir os esquemas predefinidos https ou de seleção de anúncios.

Se o URI seguir o esquema HTTPS, o host deverá corresponder ao seller. Caso contrário, IllegalArgumentException será lançada.

URIs predefinidas são uma maneira de substituir uma lógica predefinida genérica para os JavaScripts necessários para scoreAds. O Uri predefinido para esse ponto de extremidade deve seguir;

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

Se um URI predefinido sem suporte for passado ou o recurso de URI predefinido for desabilitado pelo serviço, será IllegalArgumentException gerado.

Consulte AdSelectionConfig.Builder#setDecisionLogicUri o suporte <name> e a necessidade <script-generation-parameters>.

A saída é passada pelo receptor, que retorna uma execução AdSelectionOutcome bem-sucedida ou Exception inclui o tipo da exceção gerada e a mensagem de erro correspondente.

Se for IllegalArgumentException gerada, ela será causada pelo argumento de entrada inválido que a API recebeu para executar a seleção de anúncios.

Se for gerada com a IllegalStateException mensagem de erro "Falha dos serviços do AdSelection.", ela será causada por uma falha interna do serviço de seleção de anúncios.

Se o TimeoutException for lançado, isso será causado quando um tempo limite é encontrado durante o processo de licitação, pontuação ou seleção geral para encontrar o Anúncio vencedor.

Se for LimitExceededException gerado, ele será causado quando o pacote de chamada exceder os limites de taxa permitidos e for limitado.

Se a opção SecurityException for gerada, ela será causada quando o chamador não estiver autorizado ou a permissão não for solicitada.

Java documentação para android.adservices.adselection.AdSelectionManager.selectAds(android.adservices.adselection.AdSelectionConfig, java.util.concurrent.Executor, android.os.OutcomeReceiver<android.adservices.adselection.AdSelectionOutcome, java.lang.Exception>).

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.

[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

Parâmetros

Atributos

RegisterAttribute

Comentários

Seleciona um anúncio dos resultados de seleções de anúncios executadas anteriormente.

A entrada adSelectionFromOutcomesConfig é fornecida pelo SDK de Anúncios e o AdSelectionFromOutcomesConfig objeto é transferido por meio de uma chamada do Binder. Por esse motivo, o tamanho total desses objetos está associado às limitações de IPC do Android. Falhas ao transferir a AdSelectionFromOutcomesConfig vontade lança um TransactionTooLargeException.

A saída é passada pelo receptor, que retorna uma execução AdSelectionOutcome bem-sucedida ou Exception inclui o tipo da exceção gerada e a mensagem de erro correspondente.

A entrada adSelectionFromOutcomesConfig contém:

<ul><li>Seller é necessário para ser um registrado android.adservices.common.AdTechIdentifier. Caso contrário, IllegalStateException será lançada. <li>List of ad selection ids deve existir e vir de AdSelectionManager#selectAds chamadas originadas do mesmo aplicativo. Caso contrário, IllegalArgumentException a validação de entrada gerará a listagem violando as IDs de seleção de anúncios. <li>Selection logic URI que poderia seguir os esquemas predefinidos HTTPS ou Ad Selection.

Se o URI seguir o esquema HTTPS, o host deverá corresponder ao seller. Caso contrário, IllegalArgumentException será lançada.

URIs predefinidas são uma maneira de substituir uma lógica predefinida genérica para os JavaScripts necessários para selectOutcome. O Uri predefinido para esse ponto de extremidade deve seguir; <ul><li>ad-selection-prebuilt://ad-selection-from-outcomes/<name>?<script-generation-parameters></ul>

Se um URI predefinido sem suporte for passado ou o recurso de URI predefinido for desabilitado pelo serviço, será IllegalArgumentException gerado.

Consulte AdSelectionFromOutcomesConfig.Builder#setSelectionLogicUri o suporte <name> e a necessidade <script-generation-parameters>. </ul>

Se for IllegalArgumentException gerada, ela será causada pelo argumento de entrada inválido que a API recebeu para executar a seleção de anúncios.

Se for gerada com a IllegalStateException mensagem de erro "Falha dos serviços do AdSelection.", ela será causada por uma falha interna do serviço de seleção de anúncios.

Se o TimeoutException for lançado, isso será causado quando um tempo limite é encontrado durante o processo de licitação, pontuação ou seleção geral para encontrar o Anúncio vencedor.

Se for LimitExceededException gerado, ele será causado quando o pacote de chamada exceder os limites de taxa permitidos e for limitado.

Se a opção SecurityException for gerada, ela será causada quando o chamador não estiver autorizado ou a permissão não for solicitada.

Java documentação para android.adservices.adselection.AdSelectionManager.selectAds(android.adservices.adselection.AdSelectionFromOutcomesConfig, java.util.concurrent.Executor, android.os.OutcomeReceiver<android.adservices.adselection.AdSelectionOutcome, java.lang.Exception>).

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.