Skip to content

Commit 11f236c

Browse files
committed
Add the HTTP parts
1 parent f4c9229 commit 11f236c

File tree

1 file changed

+13
-1
lines changed

1 file changed

+13
-1
lines changed

api.bs

Lines changed: 13 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1686,7 +1686,7 @@ set on a response requesting that the user agent invoke the
16861686
<a method for=Attribution>saveImpression()</a> API.
16871687

16881688
<pre class=example id=ex-save-impression-header>
1689-
Save-Impression: conversion-sites=("advertiser.example"), histogram-index=2, match-value=12, lifetime-days=7
1689+
Save-Impression: conversion-sites=("advertiser.example"), conversion-callers=("intermediary.example"), histogram-index=2, match-value=12, lifetime-days=7
16901690
</pre>
16911691

16921692
The following keys are defined, corresponding to the members of
@@ -1702,6 +1702,14 @@ the {{AttributionImpressionOptions}} dictionary passed to
17021702
[[RFC5890|Internationalized Domain Names]] therefore need to use [[RFC3492|punycode]].
17031703
This key is optional. If not supplied, an empty set is saved for [=impression/Conversion Sites=].
17041704
</dd>
1705+
<dt><dfn noexport><code>conversion-callers</code></dfn></dt>
1706+
<dd>
1707+
Value of <a dict-member for=AttributionImpressionOptions>conversionCallers</a>,
1708+
an [=structured header/inner list=] containing [=structured header/string|strings=].
1709+
Each string value includes a domain name using A-labels only;
1710+
[[RFC5890|Internationalized Domain Names]] therefore need to use [[RFC3492|punycode]].
1711+
This key is optional. If not supplied, an empty set is saved for [=impression/Conversion Callers=].
1712+
</dd>
17051713
<dt><dfn noexport><code>histogram-index</code></dfn></dt>
17061714
<dd>
17071715
Value of <a dict-member for=AttributionImpressionOptions>histogramIndex</a>,
@@ -1734,6 +1742,8 @@ To <dfn noexport>parse a `Save-Impression` header</dfn> given a [=header value=]
17341742
1. Let |histogramIndex| be |dict|["<code>[=save-impression/histogram-index=]</code>"].
17351743
1. Let |conversionSites| be |dict|["<code>[=save-impression/conversion-sites=]</code>"]
17361744
[=map/with default=] an empty [=structured header/inner list=].
1745+
1. Let |conversionCallers| be |dict|["<code>[=save-impression/conversion-callers=]</code>"]
1746+
[=map/with default=] an empty [=structured header/inner list=].
17371747
1. If any of |conversionSites|' [=list/items=] is not a [=structured header/string=], return an error.
17381748
1. Let |matchValue| be |dict|["<code>[=save-impression/match-value=]</code>"] [=map/with default=] 0.
17391749
1. If |matchValue| is not an [=structured header/integer=] or is less than 0, return an error.
@@ -1746,6 +1756,8 @@ To <dfn noexport>parse a `Save-Impression` header</dfn> given a [=header value=]
17461756
:: |matchValue|
17471757
: {{AttributionImpressionOptions/conversionSites}}
17481758
:: |conversionSites|
1759+
: {{AttributionImpressionOptions/conversionCallers}}
1760+
:: |conversionCallers|
17491761
: {{AttributionImpressionOptions/lifetimeDays}}
17501762
:: |lifetimeDays|
17511763

0 commit comments

Comments
 (0)