Skip to content

Commit

Permalink
Merge pull request #3286 from MicrosoftDocs/user/mikehoffms/server-im…
Browse files Browse the repository at this point in the history 
…ages

Update link text in "Sign up for the Ad Selection API"
  • Loading branch information
@captainbrosset
captainbrosset authored Oct 10, 2024
2 parents fa4e10d + e55eefa commit fd74664
Show file tree
Hide file tree
Showing 2 changed files with 37 additions and 37 deletions.
2 changes: 1 addition & 1 deletion microsoft-edge/devtools-guide-chromium/resources/index.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -118,7 +118,7 @@ For example, to go from the **Page** tab's resource list in the **Sources** tool

1. In DevTools, on the **Activity Bar**, select the **Network** tab. If that tab isn't visible, click the **More Tools** (![More Tools icon](./index-images/more-tools-icon-light-theme.png)) button.

1. Press **Ctrl+R** to refresh the page. The received resource files that make up the webpage are now added as rows in the **Network** tab. The **network-tutorial/** folder row represents the HTML page - in this case, [index.html](https://github.com/MicrosoftEdge/Demos/tree/main/network-tutoriql).
1. Press **Ctrl+R** to refresh the page. The received resource files that make up the webpage are now added as rows in the **Network** tab. The **network-tutorial/** folder row represents the HTML page - in this case, [index.html](https://github.com/MicrosoftEdge/Demos/blob/main/network-tutorial/index.html).

1. In DevTools, on the **Activity Bar**, click the **Sources** tab.

Expand Down
72 changes: 36 additions & 36 deletions microsoft-edge/web-platform/ad-selection-api.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -5,12 +5,12 @@ author: MSEdgeTeam
ms.author: msedgedevrel
ms.topic: conceptual
ms.service: microsoft-edge
ms.date: 10/08/2024
ms.date: 10/10/2024
---
# Sign up for the Ad Selection API
<!-- https://go.microsoft.com/fwlink/?linkid=2289906 -->

The Ad Selection API provides user-relevant ads on your site without using third-party cookies. See [Ad Selection Overview](https://github.com/WICG/privacy-preserving-ads/blob/main/Ad%20Selection%20Overview.md) in the "WICG / privacy-preserving-ads" repo.
The Ad Selection API provides user-relevant ads on your site without using third-party cookies. See [Ad Selection Overview](https://github.com/WICG/privacy-preserving-ads/blob/main/Ad%20Selection%20Overview.md) in the `privacy-preserving-ads` repo.

The Ad Selection API can be used by:
* **Sellers** running a supply-side platform (SSP), who can use the API to provide higher-quality ads for their publishers.
Expand All @@ -19,13 +19,13 @@ The Ad Selection API can be used by:
To get started using the Ad Selection API and test out the end-to-end flow, sign up for the limited preview of the Ad Selection API.

As a seller operating a supply-side platform or a buyer operating a demand-side platform, use this guide to:
* Test the Ad Selection API on your site.
* Sign up for the Ad Selection API limited preview.
* Register for the Origin Trial.
* Complete API attestation.
* See the Ad Selection API and its usage, and deploy your services to Azure.
* Sign up for the Ad Selection API limited preview by registering for the origin trial.
* Complete the API attestation by publishing your attestations JSON file.
* Set up an evaluation environment with a supported cloud provider.
* Prepare all needed UDF functions and be able to work with Edge Web API.
* View the Ad Selection API documentation.
* Prepare your User-Defined Functions (UDFs).
* Deploy your services to Azure.
* Test the Ad Selection API on your site.


<!-- ====================================================================== -->
Expand Down Expand Up @@ -55,15 +55,15 @@ The **Ad Selection API** flag enables the Ad Selection API and associated featur
<!-- ------------------------------ -->
#### Sign-up and attestation requirements and process

Developers interested in alpha testing can join the [Origin Trial](https://microsoftedge.github.io/MSEdgeExplainers/origin-trials/). This trial enables end-to-end testing of Ad Selection API features, covering both the API usage and the deployment of secure container images.
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.

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.

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

1. Open [Microsoft Edge Origin Trials](https://microsoftedge.github.io/MSEdgeExplainers/origin-trials/) in a new window or tab:

![Origin trials](./ad-selection-api-images/origin-trials.png)
![The "Ad Selection API" origin trial listing at "Microsoft Edge Origin Trials"](./ad-selection-api-images/origin-trials.png)

1. In the **Ad Selection API** section, click the **Register** button. The **Origin Trial Registration** form opens:

Expand All @@ -81,7 +81,7 @@ To sign up for the **Ad Selection API** origin trial for a domain:

1. Click the **Submit** button.

An Origin Trial token is generated for the top-level domain and is sent to you.
An origin trial token is generated for the top-level domain and is sent to you.

1. Create a file that's named `ad-selection-attestations.json`, and host the file at the top-level domain, in the `/.well-known/` directory. For example:

Expand Down Expand Up @@ -138,7 +138,7 @@ The attestations JSON file must be named `ad-selection-attestations.json`, and m
<!-- ---------- -->
###### Important fields and values

* The `ad-selection-attestations.json` file must include the Origin Trial token that was generated and sent to you for this top-level domain. `"ownership_token":` is the Origin Trial token that was generated when registering this domain for the **Ad Selection API** origin trial.
* The `ad-selection-attestations.json` file must include the origin trial token that was generated and sent to you for this top-level domain. `"ownership_token":` is the origin trial token that was generated when registering this domain for the **Ad Selection API** origin trial.

* In the `"platform_attestations":` section, `"platform":` must be `"edge"` or `"android"`.

Expand All @@ -156,28 +156,28 @@ The attestations JSON file must be named `ad-selection-attestations.json`, and m

The Ad Selection API uses a trusted execution environment (TEE) to provide a level of assurance for data integrity, data confidentiality, and code integrity; see [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). Services provided by the Ad Selection API must run in a TEE to secure the data used by these services.

Ad Selection Services running in a TEE should be deployed on a cloud platform that supports the necessary security features. Initially, services can be deployed in Azure using [Confidential ACI containers](/azure/container-instances/container-instances-confidential-overview).
Ad Selection Services running in a TEE should be deployed on a cloud platform that supports the necessary security features. Initially, services can be deployed in Azure by using confidential ACI containers; see [Confidential containers on Azure Container Instances](/azure/container-instances/container-instances-confidential-overview).

The Ad Selection API provides different services that need to be deployed by sellers or buyers.


<!-- ------------------------------ -->
#### Images for deploying services

Add your User-Defined Functions within the provided images of services. The User-Defined Functions can run custom business logic. The User-Defined Functions run in private containers within the deployed services.
Add your User-Defined Functions (UDFs) within the provided images of services. The User-Defined Functions can run custom business logic. The User-Defined Functions run in private containers within the deployed services.

Each image defines one service. Some images don't contain UDFs, and consist entirely of predefined code. Some images contain UDFs, as functions with an empty body or starter code, that are the relevant User-Defined Functions for that service. Fill in the bodies of the User-Defined Functions in these images with your own custom code.

Microsoft provides an image for each service, which can be deployed on a cloud provider. These are the public images that must be used for deployment. Only official images from Microsoft are able to run private auctions.

Images for seller services:
* [SellerFrontEnd service](https://mcr.microsoft.com/product/ad-selection/azure/seller-frontend-service)
* [Auction service](https://mcr.microsoft.com/product/ad-selection/azure/auction-service)
Images for sellers:
* [Ad Selection Seller Front End Service](https://mcr.microsoft.com/product/ad-selection/azure/seller-frontend-service)
* [Ad Selection Auction Service](https://mcr.microsoft.com/product/ad-selection/azure/auction-service)

Images for buyer services:
* [BuyerFrontEnd service](https://mcr.microsoft.com/product/ad-selection/azure/buyer-frontend-service)
* [Bidding service](https://mcr.microsoft.com/product/ad-selection/azure/bidding-service)
* [K-Anonymity service](https://mcr.microsoft.com/product/ad-selection/azure/k-anonymity-service)
Images for buyers:
* [Ad Selection Buyer Front End Service](https://mcr.microsoft.com/product/ad-selection/azure/buyer-frontend-service)
* [Ad Selection Bidding Service](https://mcr.microsoft.com/product/ad-selection/azure/bidding-service)
* [Ad Selection K-Anonymity Service](https://mcr.microsoft.com/product/ad-selection/azure/k-anonymity-service)


<!-- ------------------------------ -->
Expand Down Expand Up @@ -242,7 +242,7 @@ To deploy the Ad Selection API service to Azure:

1. Choose the **Confidential ACO containers** option.

1. Download the Terraform [deployment scripts and guide](https://go.microsoft.com/fwlink/?linkid=2290115). **Note:** Make sure the hash of the image you downloaded matches the hash in the script you download.
1. Go to [Terraform deployment scripts](https://go.microsoft.com/fwlink/?linkid=2290115) in a new window or tab, and then download the Terraform deployment scripts and view the deployment documentation. **Note:** Make sure the hash of the image you downloaded matches the hash in the script you download.

1. The Terraform scripts already include links to public images that are provided by Microsoft. Choose the required services and deploy them by following the steps in the included `readme.md`.

Expand Down Expand Up @@ -271,29 +271,29 @@ To learn more about which API methods are available and to view example code, se
## See also
<!-- all links in article -->

Design and technical documents:
* [Ad Selection API Proposal](https://github.com/WICG/privacy-preserving-ads?tab=readme-ov-file#ad-selection-api-proposal)
* [Ad Selection Overview](https://github.com/WICG/privacy-preserving-ads/blob/main/Ad%20Selection%20Overview.md)
* [Ad Selection API details](https://github.com/WICG/privacy-preserving-ads/blob/main/API%20Details.md)
Design and technical documents
* [Ad Selection Overview](https://github.com/WICG/privacy-preserving-ads/blob/main/Ad%20Selection%20Overview.md)
* [Ad Selection API Proposal](https://github.com/WICG/privacy-preserving-ads?tab=readme-ov-file#ad-selection-api-proposal)<!-- not in article body -->
* [Ad Selection API details](https://github.com/WICG/privacy-preserving-ads/blob/main/API%20Details.md)

Images for deployment:
* Sellers
* [SellerFrontEnd service](https://mcr.microsoft.com/product/ad-selection/azure/seller-frontend-service)
* [Auction service](https://mcr.microsoft.com/product/ad-selection/azure/auction-service)
* [Ad Selection Seller Front End Service](https://mcr.microsoft.com/product/ad-selection/azure/seller-frontend-service)
* [Ad Selection Auction Service](https://mcr.microsoft.com/product/ad-selection/azure/auction-service)
* Buyers
* [BuyerFrontEnd service](https://mcr.microsoft.com/product/ad-selection/azure/buyer-frontend-service)
* [Bidding service](https://mcr.microsoft.com/product/ad-selection/azure/bidding-service)
* [K-Anonymity service](https://mcr.microsoft.com/product/ad-selection/azure/k-anonymity-service)
* [Ad Selection Buyer Front End Service](https://mcr.microsoft.com/product/ad-selection/azure/buyer-frontend-service)
* [Ad Selection Bidding Service](https://mcr.microsoft.com/product/ad-selection/azure/bidding-service)
* [Ad Selection K-Anonymity Service](https://mcr.microsoft.com/product/ad-selection/azure/k-anonymity-service)

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

Origin trials:
* [Origin Trials](https://microsoftedge.github.io/MSEdgeExplainers/origin-trials/)
* [Microsoft Edge Origin Trials](https://microsoftedge.github.io/MSEdgeExplainers/origin-trials/)

Trusted execution environment (TEE):
* [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)

Azure:
* [Microsoft Azure](https://azure.microsoft.com)
* [Confidential ACI containers](/azure/container-instances/container-instances-confidential-overview)

Terraform:
* [Terraform deployment scripts and guide](https://go.microsoft.com/fwlink/?linkid=2290115)
* [Confidential containers on Azure Container Instances](/azure/container-instances/container-instances-confidential-overview)

0 comments on commit fd74664

Please sign in to comment.