Share via

AdSelectionManager.UpdateAdCounterHistogram Method

Definition

Namespace:
Android.AdServices.AdSelection
Assembly:
Mono.Android.dll

Updates the counter histograms for an ad which was previously selected by a call to #selectAds(AdSelectionConfig, Executor, OutcomeReceiver).

[Android.Runtime.Register("updateAdCounterHistogram", "(Landroid/adservices/adselection/UpdateAdCounterHistogramRequest;Ljava/util/concurrent/Executor;Landroid/os/OutcomeReceiver;)V", "GetUpdateAdCounterHistogram_Landroid_adservices_adselection_UpdateAdCounterHistogramRequest_Ljava_util_concurrent_Executor_Landroid_os_OutcomeReceiver_Handler", ApiSince=35)]
public virtual void UpdateAdCounterHistogram(Android.AdServices.AdSelection.UpdateAdCounterHistogramRequest updateAdCounterHistogramRequest, Java.Util.Concurrent.IExecutor executor, Android.OS.IOutcomeReceiver outcomeReceiver);
[<Android.Runtime.Register("updateAdCounterHistogram", "(Landroid/adservices/adselection/UpdateAdCounterHistogramRequest;Ljava/util/concurrent/Executor;Landroid/os/OutcomeReceiver;)V", "GetUpdateAdCounterHistogram_Landroid_adservices_adselection_UpdateAdCounterHistogramRequest_Ljava_util_concurrent_Executor_Landroid_os_OutcomeReceiver_Handler", ApiSince=35)>]
abstract member UpdateAdCounterHistogram : Android.AdServices.AdSelection.UpdateAdCounterHistogramRequest * Java.Util.Concurrent.IExecutor * Android.OS.IOutcomeReceiver -> unit
override this.UpdateAdCounterHistogram : Android.AdServices.AdSelection.UpdateAdCounterHistogramRequest * Java.Util.Concurrent.IExecutor * Android.OS.IOutcomeReceiver -> unit

Parameters

updateAdCounterHistogramRequest
UpdateAdCounterHistogramRequest
executor
IExecutor
outcomeReceiver
IOutcomeReceiver
Attributes
RegisterAttribute

Remarks

Updates the counter histograms for an ad which was previously selected by a call to #selectAds(AdSelectionConfig, Executor, OutcomeReceiver).

The counter histograms are used in ad selection to inform frequency cap filtering on candidate ads, where ads whose frequency caps are met or exceeded are removed from the bidding process during ad selection.

Counter histograms can only be updated for ads specified by the given adSelectionId returned by a recent call to FLEDGE ad selection from the same caller app.

A SecurityException is returned via the outcomeReceiver if:

<ol> <li>the app has not declared the correct permissions in its manifest, or <li>the app or entity identified by the callerAdTechIdentifier are not authorized to use the API. </ol>

An IllegalStateException is returned via the outcomeReceiver if the call does not come from an app with a foreground activity.

A LimitExceededException is returned via the outcomeReceiver if the call exceeds the calling app's API throttle.

In all other failure cases, the outcomeReceiver will return an empty Object. Note that to protect user privacy, internal errors will not be sent back via an exception.

Java documentation for android.adservices.adselection.AdSelectionManager.updateAdCounterHistogram(android.adservices.adselection.UpdateAdCounterHistogramRequest, java.util.concurrent.Executor, android.os.OutcomeReceiver<java.lang.Object, java.lang.Exception>).

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Applies to