AdSelectionManager.ReportEvent 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
通知服務,有新的廣告事件需回報,該廣告由廣告選擇執行所識別 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
參數
- request
- ReportEventRequest
- 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 被拋出,通常是因為呼叫者未被授權或未請求許可所致。
事件最多只會被報告一次,作為盡力而為的嘗試。
本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。