Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[zh-cn] create the translation of "Attribution Reporting API" #23368

Merged
merged 12 commits into from
Sep 9, 2024

Conversation

Pleasurecruise
Copy link
Contributor

Description

翻译文章“归因报告API”

Motivation

Additional details

Related issues and pull requests

@Pleasurecruise Pleasurecruise requested a review from a team as a code owner September 3, 2024 08:03
@Pleasurecruise Pleasurecruise requested review from t7yang and removed request for a team September 3, 2024 08:03
@github-actions github-actions bot added the l10n-zh Issues related to Chinese content. label Sep 3, 2024
Copy link
Contributor

github-actions bot commented Sep 3, 2024

Preview URLs

Flaws (10)

Note! 1 document with no flaws that don't need to be listed. 🎉

URL: /zh-CN/docs/Web/API/Attribution_Reporting_API
Title: 归因报告 API
Flaw count: 4

  • macros:
    • /zh-CN/docs/Web/API/HTMLAnchorElement/attributionSrc does not exist but fell back to /en-US/docs/Web/API/HTMLAnchorElement/attributionSrc
    • /zh-CN/docs/Web/API/HTMLImageElement/attributionSrc does not exist but fell back to /en-US/docs/Web/API/HTMLImageElement/attributionSrc
    • /zh-CN/docs/Web/API/HTMLScriptElement/attributionSrc does not exist but fell back to /en-US/docs/Web/API/HTMLScriptElement/attributionSrc
    • /zh-CN/docs/Web/API/XMLHttpRequest/setAttributionReporting does not exist but fell back to /en-US/docs/Web/API/XMLHttpRequest/setAttributionReporting

URL: /zh-CN/docs/Web/API/Attribution_Reporting_API/Registering_sources
Title: 注册归因来源
Flaw count: 4

  • macros:
    • /zh-CN/docs/Web/API/HTMLAnchorElement/attributionSrc does not exist but fell back to /en-US/docs/Web/API/HTMLAnchorElement/attributionSrc
    • /zh-CN/docs/Web/API/HTMLImageElement/attributionSrc does not exist but fell back to /en-US/docs/Web/API/HTMLImageElement/attributionSrc
    • /zh-CN/docs/Web/API/HTMLScriptElement/attributionSrc does not exist but fell back to /en-US/docs/Web/API/HTMLScriptElement/attributionSrc
    • /zh-CN/docs/Web/API/XMLHttpRequest/setAttributionReporting does not exist but fell back to /en-US/docs/Web/API/XMLHttpRequest/setAttributionReporting

URL: /zh-CN/docs/Web/API/Attribution_Reporting_API/Registering_triggers
Title: 注册归因触发器
Flaw count: 2

  • macros:
    • /zh-CN/docs/Web/API/HTMLImageElement/attributionSrc does not exist but fell back to /en-US/docs/Web/API/HTMLImageElement/attributionSrc
    • /zh-CN/docs/Web/API/XMLHttpRequest/setAttributionReporting does not exist but fell back to /en-US/docs/Web/API/XMLHttpRequest/setAttributionReporting
External URLs (21)

URL: /zh-CN/docs/Web/API/Attribution_Reporting_API
Title: 归因报告 API


URL: /zh-CN/docs/Web/API/Attribution_Reporting_API/Registering_sources
Title: 注册归因来源


URL: /zh-CN/docs/Web/API/Attribution_Reporting_API/Registering_triggers
Title: 注册归因触发器


URL: /zh-CN/docs/Web/API/Attribution_Reporting_API/Generating_reports
Title: 生成归因报告

(comment last updated: 2024-09-09 07:51:05)

Copy link
Contributor

@github-actions github-actions bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Remaining comments which cannot be posted as a review comment to avoid GitHub Rate Limit

mdn-linter

[mdn-linter] reported by reviewdog 🐶


[mdn-linter] reported by reviewdog 🐶


[mdn-linter] reported by reviewdog 🐶

基于事件的归因源会在某些事件触发时让浏览器存储源数据,例如在`<img>``<script>`元素中使用`attributionsrc`属性时(如上文中`<a>`元素的示例),或在你的JavaScript中设置的自定义事件。


[mdn-linter] reported by reviewdog 🐶


[mdn-linter] reported by reviewdog 🐶

基于HTML的事件源可以用于在页面首次加载时测量与发布者页面的交互——更准确地说,是在`<img>``<script>`加载时。要通过HTML注册基于事件的归因源,你可以将`attributionsrc`属性添加到合适的元素中——例如{{htmlelement("img")}}或{{htmlelement("script")}}。


[mdn-linter] reported by reviewdog 🐶

如果你将属性值留空,注册请求将发送到托管请求资源的服务器。也可以在值中指定一个或多个额外的URL,以便将注册请求发送到其他服务器;详情请参见[在attributionsrc中指定URL](#specifying_urls_inside_attributionsrc)。


[mdn-linter] reported by reviewdog 🐶

当浏览器接收到包含图像文件的响应时(即发生`load`事件时),浏览器会存储归因源数据。请记住,用户可能根本无法感知到图像——这可能是一个1x1的透明跟踪像素,仅用于归因报告。


[mdn-linter] reported by reviewdog 🐶


[mdn-linter] reported by reviewdog 🐶

基于脚本的归因源比基于HTML的归因源更灵活。你可以设置脚本来根据适合你的应用的请求发起注册归因源的请求。这是一种灵活的方法,适合在响应自定义交互(例如点击自定义元素或提交表单)时存储源数据。


[mdn-linter] reported by reviewdog 🐶

// 可选地设置keepalive以确保请求超出页面生命周期


[mdn-linter] reported by reviewdog 🐶


[mdn-linter] reported by reviewdog 🐶

// 在调用前检查setAttributionReporting的可用性


[mdn-linter] reported by reviewdog 🐶


[mdn-linter] reported by reviewdog 🐶

在这种情况下,当浏览器接收到fetch请求的响应时,交互发生,浏览器存储源数据。


[mdn-linter] reported by reviewdog 🐶

> [!注意]
> 请求可以是任何资源请求。它不需要直接与归因报告API相关,可以是JSON、纯文本、图像blob或其他适合你的应用的请求。


[mdn-linter] reported by reviewdog 🐶


[mdn-linter] reported by reviewdog 🐶

然而,可能请求的资源不在你控制的服务器上,或者你只是希望在不同的服务器上处理注册。在这种情况下,你可以在`attributionsrc`的值中指定一个或多个URL。当资源请求发生时,{{httpheader("Attribution-Reporting-Eligible")}}头将发送到`attributionsrc`中指定的URL以及资源的来源;这些URL可以响应{{httpheader("Attribution-Reporting-Register-Source")}}以注册源。


[mdn-linter] reported by reviewdog 🐶

例如,对于一个`<a>`元素,你可以在`attributionsrc`属性中声明URL


[mdn-linter] reported by reviewdog 🐶

或者通过JavaScript使用`attributionSrc`属性:


[mdn-linter] reported by reviewdog 🐶


[mdn-linter] reported by reviewdog 🐶

在调用{{domxref("Window.open()")}}时,不同的URL必须在[`windowFeatures`](/zh-CN/docs/Web/API/Window/open#windowfeatures)参数中列为多个独立的`attributionsrc`特性,用逗号或空格分隔:


[mdn-linter] reported by reviewdog 🐶


[mdn-linter] reported by reviewdog 🐶

> [!注意]
> 指定多个URL意味着可以在同一特性上注册多个归因源。例如,你可能有不同的活动需要测量其成功率,这些活动涉及在不同数据上生成不同的报告。


[mdn-linter] reported by reviewdog 🐶

Copy link
Contributor

@github-actions github-actions bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Remaining comments which cannot be posted as a review comment to avoid GitHub Rate Limit

markdownlint

[markdownlint] reported by reviewdog 🐶
search-replace Custom rule [force-pronoun: Consider using '你' instead of '您'] [Context: column: 15 text:您]

要注册基于脚本的归因触发器,您可以:


[markdownlint] reported by reviewdog 🐶
search-replace Custom rule [force-pronoun: Consider using '你' instead of '您'] [Context: column: 60 text:您]

> 请求可以是任何资源。不需要直接与归因报告 API 相关,可以是 JSON 请求、纯文本、图像 blob 或其他适合您应用的内容。


[markdownlint] reported by reviewdog 🐶
search-replace Custom rule [force-pronoun: Consider using '你' instead of '您'] [Context: column: 53 text:您]

在上述示例中,`attributionsrc` 属性被留空,取值为空字符串。如果请求的资源所在的服务器是您也想处理注册的服务器,即接收 {{httpheader("Attribution-Reporting-Eligible")}} 头部并响应 {{httpheader("Attribution-Reporting-Register-Trigger")}} 头部,这样的做法是合适的。


[markdownlint] reported by reviewdog 🐶
search-replace Custom rule [force-pronoun: Consider using '你' instead of '您'] [Context: column: 13 text:您]

然而,可能请求的资源不在您控制的服务器上,或者您只希望在不同的服务器上处理注册归因触发器。在这种情况下,您可以将一个或多个 URL 指定为 `attributionsrc` 的值。当资源请求发生时,`attributionsrc` 中指定的 URL 将接收到 {{httpheader("Attribution-Reporting-Eligible")}} 头部,除此之外还会发送到资源原点;这些 URL 可以响应 {{httpheader("Attribution-Reporting-Register-Trigger")}} 以完成注册。


[markdownlint] reported by reviewdog 🐶
search-replace Custom rule [force-pronoun: Consider using '你' instead of '您'] [Context: column: 24 text:您]

然而,可能请求的资源不在您控制的服务器上,或者您只希望在不同的服务器上处理注册归因触发器。在这种情况下,您可以将一个或多个 URL 指定为 `attributionsrc` 的值。当资源请求发生时,`attributionsrc` 中指定的 URL 将接收到 {{httpheader("Attribution-Reporting-Eligible")}} 头部,除此之外还会发送到资源原点;这些 URL 可以响应 {{httpheader("Attribution-Reporting-Register-Trigger")}} 以完成注册。


[markdownlint] reported by reviewdog 🐶
search-replace Custom rule [force-pronoun: Consider using '你' instead of '您'] [Context: column: 53 text:您]

然而,可能请求的资源不在您控制的服务器上,或者您只希望在不同的服务器上处理注册归因触发器。在这种情况下,您可以将一个或多个 URL 指定为 `attributionsrc` 的值。当资源请求发生时,`attributionsrc` 中指定的 URL 将接收到 {{httpheader("Attribution-Reporting-Eligible")}} 头部,除此之外还会发送到资源原点;这些 URL 可以响应 {{httpheader("Attribution-Reporting-Register-Trigger")}} 以完成注册。


[markdownlint] reported by reviewdog 🐶
search-replace Custom rule [force-pronoun: Consider using '你' instead of '您'] [Context: column: 21 text:您]

例如,在 `<img>` 元素的情况下,您可以在 `attributionsrc` 属性中声明 URL:

Copy link
Member

@yin1999 yin1999 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

存在的问题如下:

  • 图像文件已经存在于英文文档中,无需将图像再拷贝到本地化仓库中(平台会自动拷贝图像)
  • 备注块的部分请使用标准的 GFM 语法糖
  • 中英文之间应保留一个空格,具体的语法请参考翻译指南
  • 部分标题的翻译不正确,请参考术语表

请先修复以上的问题

Comment on lines 131 to 134
> [! 注意]
> 在设置像上面示例中的[`click`](/zh-CN/docs/Web/API/Element/click_event)事件时,建议将其设置在预期会点击的控件上,例如{{htmlelement("button")}}或{{htmlelement("a")}}元素上。这在语义上更合理,并且对屏幕阅读器和键盘用户更友好。

> [! 注意]
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.


{{SeeCompatTable}}{{DefaultAPISidebar("Attribution Reporting API")}}

本文介绍了[归因报告 API](/zh-CN/docs/Web/API/Attribution_Reporting_API)如何生成报告——包括归因报告和调试报告——以及如何控制生成的报告。内容包括处理噪声、优先处理报告、过滤报告和生成调试报告。
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

以下是中英文间加空格的示例,请做全文修正

Suggested change
本文介绍了[归因报告 API](/zh-CN/docs/Web/API/Attribution_Reporting_API)如何生成报告——包括归因报告和调试报告——以及如何控制生成的报告。内容包括处理噪声、优先处理报告、过滤报告和生成调试报告。
本文介绍了[归因报告 API](/zh-CN/docs/Web/API/Attribution_Reporting_API) 如何生成报告——包括归因报告和调试报告——以及如何控制生成的报告。内容包括处理噪声、优先处理报告、过滤报告和生成调试报告。


## 基本流程

当触发器和来源匹配时,浏览器会生成报告,并通过无凭证的[`POST`](/zh-CN/docs/Web/HTTP/Methods/POST)请求将报告发送到报告源的特定端点:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
当触发器和来源匹配时,浏览器会生成报告,并通过无凭证的[`POST`](/zh-CN/docs/Web/HTTP/Methods/POST)请求将报告发送到报告源的特定端点:
当触发器和来源匹配时,浏览器会生成报告,并通过无凭证的 [`POST`](/zh-CN/docs/Web/HTTP/Methods/POST) 请求将报告发送到报告源的特定端点:

- `"report_id"`
- :一个表示此报告的[通用唯一标识符 (UUID)](/zh-CN/docs/Glossary/UUID)的字符串,可用于防止重复计算。
- `"source_type"`
- :一个字符串,值为 `"navigation"` 或 `"event"`,分别表示相关的归因源是[基于导航的](/zh-CN/docs/Web/API/Attribution_Reporting_API/Registering_sources#navigation-based_attribution_sources),还是[基于事件的](/zh-CN/docs/Web/API/Attribution_Reporting_API/Registering_sources#event-based_attribution_sources)。
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

注意片段标识,不只有这一处,请做全文更新

Suggested change
- :一个字符串,值为 `"navigation"``"event"`,分别表示相关的归因源是[基于导航的](/zh-CN/docs/Web/API/Attribution_Reporting_API/Registering_sources#navigation-based_attribution_sources),还是[基于事件的](/zh-CN/docs/Web/API/Attribution_Reporting_API/Registering_sources#event-based_attribution_sources)
- :一个字符串,值为 `"navigation"``"event"`,分别表示相关的归因源是[基于导航的](/zh-CN/docs/Web/API/Attribution_Reporting_API/Registering_sources#基于导航的归因源),还是[基于事件的](/zh-CN/docs/Web/API/Attribution_Reporting_API/Registering_sources#基于事件的归因源)

Comment on lines 148 to 185
<!--
此信息不完整;我们暂时搁置它,以便发布这份文档,将来如果有需求,我们会进一步完善 ARA 噪声的部分。

在事件级别报告的情况下,噪声是通过随机响应算法添加的,工作方式如下:

1. 当存储归因源时,浏览器会生成可能来自源配置的所有可能报告集(包括不生成报告的情况)的列表。
2. 在一小部分情况下,浏览器会阻止归因源的归因,而是从列表中随机选择一个成员作为源报告的使用对象。发生这种情况的概率取决于列表的大小、浏览器的实现特定隐私参数以及源选择的 [`"event_level_epsilon"`](/zh-CN/docs/Web/HTTP/Headers/Attribution-Reporting-Register-Source#event_level_epsilon)。

{{httpheader("Attribution-Reporting-Register-Source")}}头中的典型设置可能如下所示:

```json
{
...,
"trigger_data": [0, 1, 2, 3, 4],
"trigger_data_matching": "exact",
...,
}
```

源 `"trigger_data"` 最多可以有 32 个值。增加值的数量和 `"event_report_windows"` 会增加整体报告集中的元素数量。

匹配的{{httpheader("Attribution-Reporting-Register-Trigger")}}可能包含以下内容:

```json
{
...,
"event_trigger_data": [
{
// 值 4 包含在源数据中,因此匹配是可能的
"trigger_data": "4"
},
],
...,
}
```

然而,根据上面描述的随机响应算法,匹配仍然可能不会发生。
-->
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

英文中被注释掉的内容可以先去掉(以后英文内容可能会做更改,其也仅对作者可见,我们无需保留)

Comment on lines 263 to 265
> **Note:** `"source_type"` 是在来源的 `"filter_data"` 上自动填充的字段。

> **Note:** `not_filters`,即否定过滤器,也受支持。
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

旧格式,不属于 GFM 语法,由于这一块还暂时无法转换为 GFM 语法(prettier 无法正确处理特殊的块引用

Suggested change
> **Note:** `"source_type"` 是在来源的 `"filter_data"` 上自动填充的字段。
> **Note:** `not_filters`,即否定过滤器,也受支持。
> **备注:** `"source_type"` 是在来源的 `"filter_data"` 上自动填充的字段。
> **备注:** `not_filters`,即否定过滤器,也受支持。

Comment on lines 297 to 298
- **成功调试报告** 跟踪特定归因报告的成功生成。成功调试报告在注册相应触发器后立即生成并发送。
- **详细调试报告** 为与归因报告关联的归因来源和归因触发事件提供更多可见性。它们使你能够确保来源已成功注册,或跟踪丢失的报告并确定其原因(例如,由于来源或触发事件注册失败或发送或生成报告时失败)。详细调试报告在来源或触发器注册时立即发送。
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

中文之间不加空格,不只这一处,请做全文检查

Suggested change
- **成功调试报告** 跟踪特定归因报告的成功生成。成功调试报告在注册相应触发器后立即生成并发送。
- **详细调试报告** 为与归因报告关联的归因来源和归因触发事件提供更多可见性。它们使你能够确保来源已成功注册,或跟踪丢失的报告并确定其原因(例如,由于来源或触发事件注册失败或发送或生成报告时失败)。详细调试报告在来源或触发器注册时立即发送。
- **成功调试报告**跟踪特定归因报告的成功生成。成功调试报告在注册相应触发器后立即生成并发送。
- **详细调试报告**为与归因报告关联的归因来源和归因触发事件提供更多可见性。它们使你能够确保来源已成功注册,或跟踪丢失的报告并确定其原因(例如,由于来源或触发事件注册失败或发送或生成报告时失败)。详细调试报告在来源或触发器注册时立即发送。

- {{htmlelement("a")}}, {{htmlelement("img")}}, 和 {{htmlelement("script")}} — `attributionsrc` 属性
- : 指定你希望浏览器在相关资源请求中发送 {{httpheader("Attribution-Reporting-Eligible")}} 头。在服务器端,此头用于触发发送 {{httpheader("Attribution-Reporting-Register-Source")}} 或 {{httpheader("Attribution-Reporting-Register-Trigger")}} 响应头。当注册归因来源时,这是必需的;当注册归因触发器时,只有在你希望指定与 `src` 属性指向的资源不同的注册服务器时才需要。请注意,`<a>` 元素不能用于注册归因触发器。

## HTTP 头
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

下同

Suggested change
## HTTP
## HTTP 标头


{{Compat}}

## 另见
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

其他的几个文件也许修改(注意对照我们的术语表

Suggested change
## 另见
## 参见


{{SeeCompatTable}}{{securecontext_header}}{{DefaultAPISidebar("Attribution Reporting API")}}

归因报告 API 使开发者能够衡量转化事件 —— 比如当用户点击嵌入在某个网站上的广告,然后在供应商的网站上购买商品 —— 并随后访问这些转化事件的报告。它在不依赖第三方跟踪 cookies 的情况下完成这一过程。
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
归因报告 API 使开发者能够衡量转化事件 —— 比如当用户点击嵌入在某个网站上的广告,然后在供应商的网站上购买商品 —— 并随后访问这些转化事件的报告。它在不依赖第三方跟踪 cookies 的情况下完成这一过程。
归因报告 API(Attribution Reporting API)使开发者能够衡量转化事件——比如当用户点击嵌入在某个网站上的广告,然后在供应商的网站上购买商品——并随后访问这些转化事件的报告。它在不依赖第三方跟踪 cookie 的情况下完成这一过程。

不使用复数(cookies),下同


在线商店的拥有者希望衡量从与广告互动、查看其网站上的产品页面并将产品放入购物车的用户那里获得多少转化。

![Image representation of the steps described below](ara-flow.png)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

图片文字也翻译一下


之后,当用户决定访问广告主的网站时,只要该网站来自与广告相同的域名,该网站就可以访问之前由广告设置的第三方 cookie。广告主可以将广告的数据与自己的第一方数据关联起来,以回答诸如“用户在与另一个网站的产品广告互动后是否购买了该产品?”的问题。

这对用户 [隐私](/zh-CN/docs/Web/Privacy) 不友好。在这种情况下,来自相同域名的任何页面都可以访问该 cookie,以及嵌入这些页面的网站的信息。许多方可以访问这些数据,并根据用户的浏览习惯推测其他数据。
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
这对用户 [隐私](/zh-CN/docs/Web/Privacy) 不友好。在这种情况下,来自相同域名的任何页面都可以访问该 cookie,以及嵌入这些页面的网站的信息。许多方可以访问这些数据,并根据用户的浏览习惯推测其他数据。
这对用户[隐私](/zh-CN/docs/Web/Privacy)不友好。在这种情况下,来自相同域名的任何页面都可以访问该 cookie,以及嵌入这些页面的网站的信息。许多方可以访问这些数据,并根据用户的浏览习惯推测其他数据。

- 一个链接。在这种情况下,交互是用户点击链接(直接通过 {{htmlelement("a")}} 元素,或通过 {{domxref("Window.open()")}} 调用)。通过对导航请求的响应来注册来源。
- 一张图片,例如广告横幅或 1x1 透明跟踪像素。在这种情况下,交互是用户访问页面。图片加载时,即服务器响应图片请求时,注册来源。
- 一个 fetch 请求(即 {{domxref("Window/fetch", "fetch()")}} 或 {{domxref("XMLHttpRequest")}})。在这种情况下,交互可以根据你的应用程序的需要进行指定——例如,fetch 请求可以由 `click` 或 `submit` 事件触发。来源在响应返回时注册。
2. 当归因来源交互发生时,{{httpheader("Attribution-Reporting-Register-Source")}} 头中返回的来源数据会存储在仅浏览器可访问的私有本地缓存中。此数据包括页面和广告主可用的上下文和第一方数据、收集转化数据的广告技术公司的来源以及一个或多个期望从该广告发生转化的目标 ([eTLD+1](/zh-CN/docs/Glossary/eTLD)s)(即广告主的网站,例如 shop.example)。
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
2. 当归因来源交互发生时,{{httpheader("Attribution-Reporting-Register-Source")}} 头中返回的来源数据会存储在仅浏览器可访问的私有本地缓存中。此数据包括页面和广告主可用的上下文和第一方数据、收集转化数据的广告技术公司的来源以及一个或多个期望从该广告发生转化的目标 ([eTLD+1](/zh-CN/docs/Glossary/eTLD)s)(即广告主的网站,例如 shop.example)。
2. 当归因来源交互发生时,{{httpheader("Attribution-Reporting-Register-Source")}} 头中返回的来源数据会存储在仅浏览器可访问的私有本地缓存中。此数据包括页面和广告主可用的上下文和第一方数据、收集转化数据的广告技术公司的来源以及一个或多个期望从该广告发生转化的目标[eTLD+1](/zh-CN/docs/Glossary/eTLD)(即广告主的网站,例如 shop.example)。

3. 当用户稍后访问 `shop.example` 时,当交互指示转化发生时,该网站可以注册一个**归因触发器**(例如,用户点击 `shop.example` 上的“添加到购物车”按钮)。浏览器将发送一个带有 {{httpheader("Attribution-Reporting-Eligible")}} 头的请求,以表明响应有资格注册归因触发器,如果响应中包含适当的 {{httpheader("Attribution-Reporting-Register-Trigger")}} 头,则完成注册。归因触发器可以是,例如:
- 一张图片,例如购物车图标或 1x1 透明跟踪像素。在这种情况下,交互是用户访问页面。触发器在图片加载时注册,即当服务器响应图片请求时。
- 一个 fetch 请求(即 {{domxref("Window/fetch", "fetch()")}} 或 {{domxref("XMLHttpRequest")}})。在这种情况下,交互可以根据你的应用程序的需要进行指定——例如,fetch 请求可以由 `click` 或 `submit` 事件触发。触发器在响应返回时注册。
4. 当触发器归因完成后,浏览器会尝试将 [归因报告注册触发器](/zh-CN/docs/Web/HTTP/Headers/Attribution-Reporting-Register-Trigger) 头中的数据与私有本地缓存中保存的来源数据条目进行匹配(见第 2 步)。有关匹配方法和要求,请参阅 [注册归因触发器](/zh-CN/docs/Web/API/Attribution_Reporting_API/Registering_triggers)。
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
4. 当触发器归因完成后,浏览器会尝试将 [归因报告注册触发器](/zh-CN/docs/Web/HTTP/Headers/Attribution-Reporting-Register-Trigger) 头中的数据与私有本地缓存中保存的来源数据条目进行匹配(见第 2 步)。有关匹配方法和要求,请参阅 [注册归因触发器](/zh-CN/docs/Web/API/Attribution_Reporting_API/Registering_triggers)
4. 当触发器归因完成后,浏览器会尝试将 [归因报告注册触发器](/zh-CN/docs/Web/HTTP/Headers/Attribution-Reporting-Register-Trigger) 头中的数据与私有本地缓存中保存的来源数据条目进行匹配(见第 2 步)。有关匹配方法和要求,请参阅[注册归因触发器](/zh-CN/docs/Web/API/Attribution_Reporting_API/Registering_triggers)


## HTML 元素

- {{htmlelement("a")}}, {{htmlelement("img")}}, 和 {{htmlelement("script")}} — `attributionsrc` 属性
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- {{htmlelement("a")}}, {{htmlelement("img")}}, 和 {{htmlelement("script")}}`attributionsrc` 属性
- {{htmlelement("a")}}, {{htmlelement("img")}}, 和 {{htmlelement("script")}}——`attributionsrc` 属性


归因报告 API 并未定义任何独立的接口。

### 扩展到其他接口
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
### 扩展到其他接口
### 其他接口的扩展

与现有保持一致(或对其他接口的扩展


## 注册和本地测试

要在你的网站上使用归因报告 API,你必须在 [隐私沙盒注册过程](/zh-CN/docs/Web/Privacy/Privacy_sandbox/Enrollment) 中指定它。如果不这样做,API 流程将在响应时被阻止,即响应头将被忽略,来源和触发器将不会被注册。
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
要在你的网站上使用归因报告 API,你必须在 [隐私沙盒注册过程](/zh-CN/docs/Web/Privacy/Privacy_sandbox/Enrollment) 中指定它。如果不这样做,API 流程将在响应时被阻止,即响应头将被忽略,来源和触发器将不会被注册。
要在你的网站上使用归因报告 API,你必须在[隐私沙盒注册过程](/zh-CN/docs/Web/Privacy/Privacy_sandbox/Enrollment)中指定它。如果不这样做,API 流程将在响应时被阻止,即响应头将被忽略,来源和触发器将不会被注册。


## 示例

请参阅 [示例:归因报告 API](https://arapi-home.web.app/) 以获取示例实现(也可查看 [源代码](https://github.com/GoogleChromeLabs/trust-safety-demo/tree/main/attribution-reporting))。
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
请参阅 [示例:归因报告 API](https://arapi-home.web.app/) 以获取示例实现(也可查看 [源代码](https://github.com/GoogleChromeLabs/trust-safety-demo/tree/main/attribution-reporting))。
请参阅[示例:归因报告 API](https://arapi-home.web.app/) 以获取示例实现(也可查看[源代码](https://github.com/GoogleChromeLabs/trust-safety-demo/tree/main/attribution-reporting))。

## 参见

- [归因报告头验证工具](https://wicg.github.io/attribution-reporting-api/validate-headers)
- [开发者.google.com 上的归因报告](https://developers.google.com/privacy-sandbox/private-advertising/attribution-reporting/)(2023)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- [开发者.google.com 上的归因报告](https://developers.google.com/privacy-sandbox/private-advertising/attribution-reporting/)(2023)
- [developers.google.com 上的归因报告](https://developers.google.com/privacy-sandbox/private-advertising/attribution-reporting/)(2023)

下同

@yin1999 yin1999 self-assigned this Sep 7, 2024
Copy link
Member

@yin1999 yin1999 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

感谢 @PleasePerfunctory。我根据 Android developers 上的翻译调整了所涉及到的术语的翻译。下面列出了常见的问题(已修正),请在未来的贡献中注意这几点:

- `"source_type"`
- :一个字符串,值为 `"navigation"` 或 `"event"`,分别表示相关的归因源是[基于导航的](/zh-CN/docs/Web/API/Attribution_Reporting_API/Registering_sources#基于导航的归因源),还是[基于事件的](/zh-CN/docs/Web/API/Attribution_Reporting_API/Registering_sources#基于事件的归因源)。
- `"randomized_trigger_rate"`
- :一个介于 0 和 1 之间的随机数,表示此特定来源配置应用噪声的频率。[噪声](#adding_noise_to_reports)处理见下文。
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

未翻译片段标识

- `"source_event_id"`
- :一个表示归因源 ID 的字符串。这等同于在来源注册时通过关联的{{httpheader("Attribution-Reporting-Register-Source")}}响应标头中设置的[`"source_event_id"`](/zh-CN/docs/Web/HTTP/Headers/Attribution-Reporting-Register-Source#source_event_id)。
- `"trigger_data"`
- :一个表示归因触发器来源数据的字符串,在触发器注册时设置(通过关联的 {{httpheader("Attribution-Reporting-Register-Trigger")}} 响应标头设置的[`"trigger_data"`](/zh-CN/docs/Web/HTTP/Headers/Attribution-Reporting-Register-Trigger#trigger_data))。
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

空格问题

属性如下:

- `"shared_info"`
- : 这是一个序列化的 JSON 对象,提供汇总报告服务使用的信息。这些数据使用[AEAD](https://en.wikipedia.org/wiki/Authenticated_encryption)进行加密,以防篡改。序列化字符串中包含以下属性:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

未使用本地化的维基百科页面

@yin1999 yin1999 merged commit 32b5677 into mdn:main Sep 9, 2024
7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
l10n-zh Issues related to Chinese content.
Projects
Development

Successfully merging this pull request may close these issues.

3 participants