Skip to content

Commit d714a9d

Browse files
Merge pull request #3298 from MicrosoftDocs/user/pabrosse/ad-selection-ot
New OT form for the Ad Selection API
2 parents 4419044 + 48717af commit d714a9d

3 files changed

Lines changed: 39 additions & 29 deletions

File tree

Binary file not shown.
-29.8 KB
Loading

microsoft-edge/web-platform/ad-selection-api.md

Lines changed: 39 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -57,27 +57,34 @@ The **Ad Selection API** flag enables the Ad Selection API and associated featur
5757

5858
Developers interested in alpha testing can join the origin trial for the Ad Selection API. This origin trial enables end-to-end testing of Ad Selection API features, covering both the API usage and the deployment of secure container images.
5959

60-
For each top-level domain that you intend to use with the Ad Selection API, fill in the **Origin Trial Registration** form for that domain, and then submit the form.
60+
For each top-level domain that you intend to use with the Ad Selection API, fill in the **Origin Trial Registration** form for that domain, and then submit the form.
6161

6262
To sign up for the **Ad Selection API** origin trial for a domain:
6363

64-
1. Open [Microsoft Edge Origin Trials](https://microsoftedge.github.io/MSEdgeExplainers/origin-trials/) in a new window or tab:
64+
1. Open [Ad Selection API Origin Trial Registration in Microsoft Edge](https://forms.office.com/r/eBhJt58Lks) in a new window or tab.
6565

66-
![The "Ad Selection API" origin trial listing at "Microsoft Edge Origin Trials"](./ad-selection-api-images/origin-trials.png)
66+
1. Click the **Start now** button.
6767

68-
1. In the **Ad Selection API** section, click the **Register** button. The **Origin Trial Registration** form opens:
68+
1. Read and agree to the terms of use, and then click the **Next** button. The **Ad Selection API Origin Trial Registration** form opens:
6969

7070
![Registration form](./ad-selection-api-images/reg-form.png)
7171

72-
1. Fill in the form.
72+
1. In the **Domain** text box, enter a single top-level domain:
7373

74-
* In the **Domain** text box, enter a single top-level domain. For example, a top-level domain is `contoso.example`, and optionally includes subdomains such as `subdomain.contoso.example`.
74+
You can configure the origin trial to support any of the following:
75+
* A single domain, such as `https://example.com`, without supporting its subdomains.
76+
* A single subdomain, such as `https://beta.example.com`.
77+
* A domain, such as `https://example.com`, and its subdomains, such as `https://beta.example.com`.
7578

76-
* In the **Subdomain Support** section, select the **Yes** or **No** option button.
79+
Trailing paths and query parameters aren't supported. If a URI is entered that has a trailing path or a query parameter, such as `https://example.com/path/new-feature`, the root domain (such as `https://example.com`) or subdomain will be registered, ignoring any trailing path or query parameters.
7780

78-
* In the **Email Address** text box, provide a valid developer contact for the domain.
81+
1. In the **Subdomain Support** section, select the **Yes** or **No** option button:
7982

80-
* In the **Origin Trial Name** text box, enter **AdSelectionAPI** (with no spaces). This is the ID of this origin trial.
83+
* To use the origin trial at a domain (such as `https://example.com`) without supporting its subdomains (such as `https://beta.example.com`), select **No**.
84+
* To use the origin trial only at a specific subdomain (such as `https://beta.example.com`), select **No**.
85+
* To use the origin trial at a domain (such as `https://example.com`) and its subdomains (such as `https://beta.example.com`), select **Yes**.
86+
87+
1. In the **Email Address** text box, provide a valid developer contact for the domain.
8188

8289
1. Click the **Submit** button.
8390

@@ -277,46 +284,49 @@ To learn more about which API methods are available and to view example code, se
277284
<!-- ====================================================================== -->
278285
## Provide feedback about the origin trial
279286

280-
To provide feedback about the Ad Selection API origin trial:
281-
282-
1. Go to the [Microsoft Edge Origin Trials](https://microsoftedge.github.io/MSEdgeExplainers/origin-trials/) portal at Github.io.
283-
284-
1. Go to the row for the **Ad Selection API** origin trial.
287+
To provide feedback about the Ad Selection API origin trial, create a new issue on the WICG/privacy-preserving-ads GitHub repo:
285288

286-
1. Click the **issues** button in the row. The `privacy-preserving-ads` repo opens.
289+
* To view existing issues, go to the [Issues tab of the WICG/privacy-preserving-ads repo](https://github.com/WICG/privacy-preserving-ads/issues).
287290

288-
1. Submit a new issue, or click the **Issues** tab to view the issues.
291+
* To submit a new issue, go to the [new issue form](https://github.com/WICG/privacy-preserving-ads/issues/new?labels=Ad+Selection%20API,OriginTrialFeedback&title=%5BAd%20Selection%20API%5D+Feedback).
289292

290293

291294
<!-- ====================================================================== -->
292295
## See also
293296
<!-- all links in article -->
294297

295-
Design and technical documents
296-
* [Ad Selection Overview](https://github.com/WICG/privacy-preserving-ads/blob/main/Ad%20Selection%20Overview.md)
297-
* [Ad Selection API Proposal](https://github.com/WICG/privacy-preserving-ads?tab=readme-ov-file#ad-selection-api-proposal)<!-- not in article body -->
298-
* [Ad Selection API details](https://github.com/WICG/privacy-preserving-ads/blob/main/API%20Details.md)
298+
Origin trials:
299+
300+
* [Ad Selection API Origin Trial Registration in Microsoft Edge](https://forms.office.com/r/eBhJt58Lks)
301+
* [Use origin trials in Microsoft Edge](../origin-trials/index.md)<!-- not in article body -->
302+
303+
Design and technical documents:
304+
305+
* [Ad Selection Overview](https://github.com/WICG/privacy-preserving-ads/blob/main/Ad%20Selection%20Overview.md)
306+
* [Ad Selection API Proposal](https://github.com/WICG/privacy-preserving-ads?tab=readme-ov-file#ad-selection-api-proposal)<!-- not in article body -->
307+
* [Ad Selection API details](https://github.com/WICG/privacy-preserving-ads/blob/main/API%20Details.md)
299308

300309
Images for deployment:
310+
301311
* Sellers
302-
* [Ad Selection Seller Front End Service](https://mcr.microsoft.com/product/ad-selection/azure/seller-frontend-service)
303-
* [Ad Selection Auction Service](https://mcr.microsoft.com/product/ad-selection/azure/auction-service)
312+
* [Ad Selection Seller Front End Service](https://mcr.microsoft.com/product/ad-selection/azure/seller-frontend-service)
313+
* [Ad Selection Auction Service](https://mcr.microsoft.com/product/ad-selection/azure/auction-service)
304314
* Buyers
305-
* [Ad Selection Buyer Front End Service](https://mcr.microsoft.com/product/ad-selection/azure/buyer-frontend-service)
306-
* [Ad Selection Bidding Service](https://mcr.microsoft.com/product/ad-selection/azure/bidding-service)
307-
* [Ad Selection K-Anonymity Service](https://mcr.microsoft.com/product/ad-selection/azure/k-anonymity-service)
315+
* [Ad Selection Buyer Front End Service](https://mcr.microsoft.com/product/ad-selection/azure/buyer-frontend-service)
316+
* [Ad Selection Bidding Service](https://mcr.microsoft.com/product/ad-selection/azure/bidding-service)
317+
* [Ad Selection K-Anonymity Service](https://mcr.microsoft.com/product/ad-selection/azure/k-anonymity-service)
308318
* Sellers and buyers
309-
* [Ad Selection Key Value Service](https://mcr.microsoft.com/product/ad-selection/azure/key-value-service/)
319+
* [Ad Selection Key Value Service](https://mcr.microsoft.com/product/ad-selection/azure/key-value-service/)
310320

311321
Deployment scripts:
312-
* [Terraform deployment scripts](https://go.microsoft.com/fwlink/?linkid=2290115)
313322

314-
Origin trials:
315-
* [Microsoft Edge Origin Trials](https://microsoftedge.github.io/MSEdgeExplainers/origin-trials/)
323+
* [Terraform deployment scripts](https://go.microsoft.com/fwlink/?linkid=2290115)
316324

317325
Trusted execution environment (TEE):
326+
318327
* [Confidential Computing: Hardware-Based Trusted Execution for Applications and Data](https://confidentialcomputing.io/wp-content/uploads/sites/85/2021/03/confidentialcomputing_outreach_whitepaper-8-5x11-1.pdf)
319328

320329
Azure:
330+
321331
* [Microsoft Azure](https://azure.microsoft.com)
322332
* [Confidential containers on Azure Container Instances](/azure/container-instances/container-instances-confidential-overview)

0 commit comments

Comments
 (0)