EventUrlProvider

public class EventUrlProvider
继承自 Object

java.lang.Object
   ↳ android.adservices.ondevicepersonalization.EventUrlProvider


为请求生成事件跟踪 URL。服务可以根据需要将这些 URL 嵌入到 HTML 输出中。当 HTML 在 ODP WebView 中呈现时,ODP 将拦截对这些 URL 的请求,调用 IsolatedWorker#onEvent(EventInput, java.util.function.Consumer),并将返回的输出记录在 EVENTS 表中。

摘要

公共方法

Uri createEventTrackingUrlWithRedirect(PersistableBundle eventParams, Uri destinationUrl)

创建一个事件跟踪 URL,当其在 ODP webview 中被点击时,该 URL 会重定向到提供的目标 URL。

Uri createEventTrackingUrlWithResponse(PersistableBundle eventParams, byte[] responseData, String mimeType)

创建一个返回提供的响应的事件跟踪 URL。

继承的方法

公共方法

createEventTrackingUrlWithRedirect

public Uri createEventTrackingUrlWithRedirect (PersistableBundle eventParams, 
                Uri destinationUrl)

创建一个事件跟踪 URL,当其在 ODP webview 中被点击时,该 URL 会重定向到提供的目标 URL。
此方法可能需要几秒钟才能完成,因此只能从工作线程调用。

参数
eventParams PersistableBundle:事件发生时要传递给 IsolatedWorker#onEvent(EventInput, java.util.function.Consumer) 的数据。此值不能为空 (null)。

destinationUrl Uri:要重定向到的 URL。此值可能为 null

返回
Uri 一个可插入到 WebView 中的 ODP 事件 URL。此值不能为空 (null)。

createEventTrackingUrlWithResponse

public Uri createEventTrackingUrlWithResponse (PersistableBundle eventParams, 
                byte[] responseData, 
                String mimeType)

创建一个返回提供的响应的事件跟踪 URL。如果响应数据不为空,则返回 HTTP 状态码 200 (OK)。如果响应数据为空,则返回 HTTP 状态码 204 (No Content)。
此方法可能需要几秒钟才能完成,因此只能从工作线程调用。

参数
eventParams PersistableBundle:事件发生时要传递给 IsolatedWorker#onEvent(EventInput, java.util.function.Consumer) 的数据。此值不能为空 (null)。

responseData byte:在获取 URL 时要返回给 WebView 的内容。此值可能为 null

mimeType String:URL 响应的 Mime 类型。此值可能为 null

返回
Uri 一个可插入到 WebView 中的 ODP 事件 URL。此值不能为空 (null)。