語言

AdSelectionManager.ReportEvent 方法

定義

通知服務,有新的廣告事件需回報,該廣告由廣告選擇執行所識別 adSelectionId。

[Android.Runtime.Register("reportEvent", "(Landroid/adservices/adselection/ReportEventRequest;Ljava/util/concurrent/Executor;Landroid/os/OutcomeReceiver;)V", "GetReportEvent_Landroid_adservices_adselection_ReportEventRequest_Ljava_util_concurrent_Executor_Landroid_os_OutcomeReceiver_Handler", ApiSince=35)]
public virtual void ReportEvent(Android.AdServices.AdSelection.ReportEventRequest request, Java.Util.Concurrent.IExecutor executor, Android.OS.IOutcomeReceiver receiver);
[<Android.Runtime.Register("reportEvent", "(Landroid/adservices/adselection/ReportEventRequest;Ljava/util/concurrent/Executor;Landroid/os/OutcomeReceiver;)V", "GetReportEvent_Landroid_adservices_adselection_ReportEventRequest_Ljava_util_concurrent_Executor_Landroid_os_OutcomeReceiver_Handler", ApiSince=35)>]
abstract member ReportEvent : Android.AdServices.AdSelection.ReportEventRequest * Java.Util.Concurrent.IExecutor * Android.OS.IOutcomeReceiver -> unit
override this.ReportEvent : Android.AdServices.AdSelection.ReportEventRequest * Java.Util.Concurrent.IExecutor * Android.OS.IOutcomeReceiver -> unit

參數

executor
IExecutor
receiver
IOutcomeReceiver
屬性

備註

通知服務,有新的廣告事件需回報,該廣告由廣告選擇執行所識別 adSelectionId。 廣告事件是指與特定 adSelectionId廣告相關的任何事件。 廣告事件何時會被報導,無法保證。 事件回報可能會延遲,報告也可以批次處理。

利用 ReportEventRequest#getKey(),服務會取得 reportingUri 註冊在 registerAdBeacon的 。 欲了解更多詳情registerAdBeacon,請參閱 的文件#reportImpression。 接著,服務會附加 ReportEventRequest#getData() 到 POST 請求的請求內容並發送請求。 POST 請求的主體將包含 content-type ,text/plain資料將以 傳送。charset=UTF-8

輸出由接收端傳遞,接收端要麼回傳 Empty Object 表示成功執行,要麼 Exception 包含拋出的異常類型及相應的錯誤訊息。

如果拋出 , IllegalArgumentException 是因為 API 收到的錯誤輸入參數來回報廣告事件所致。

若 IllegalStateException 拋出錯誤訊息為「廣告選擇服務失敗」,則是廣告選擇服務內部故障所致。

如果拋棄, LimitExceededException 通常是因為呼叫的套件超過允許的速率限制並被限速。

如果 SecurityException 被拋出,通常是因為呼叫者未被授權或未請求許可所致。

事件最多只會被報告一次,作為盡力而為的嘗試。

Java 文件 android.adservices.adselection.AdSelectionManager.reportEvent(android.adservices.adselection.ReportEventRequest, java.util.concurrent.Executor, android.os.OutcomeReceiver<java.lang.Object, java.lang.Exception>)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。

適用於