Signals

Amazon 1P Signals is a valuable feature that allows publishers to share first-party data with advertisers through OpenRTB specifications. By using 1P Signals, advertisers can enhance their targeting capabilities and deliver personalized and relevant ads to their intended audience.

While it's important to include relevant data, keep in mind that a larger request payload may cause longer request latency. Avoid duplicating the same data in multiple fields, such as having identical information in both site.keywords and site.ext.data.keywords.

If you have custom site data that doesn't follow the OpenRTB specification, you can still send it using the site.ext.data object.

NOTE

The initial version of this feature will not support sending these signals in the bid stream to configured TAM bidders. Future iterations of this product will allow bidder recipients to be configured in the APS Publisher Portal.

Implementation

To implement 1P Signals, add the first-party data as a parameter to the ad/signals/define method.

Parameters

Parameter	Required	Type	Description
`context`	required	object	container for `site` object
`site`	optional	object	details of the website calling for the impression

Highly recommended signals

site.cat - site category
site.pagecat - page category
site.sectioncat - section category
site.keywords - site keywords

Example

// define signals
aps.record("ad/signals/define", {
  context: {
    // site details
    site: {
      name: "APS Integration Toolbox",
      domain: "aps-sandbox.net",
      page: "https://aps-sandbox.net/test-pages/signals.html",
      cattax: 7,
      cat: ["596", "599", "602"],
      pagecat: ["596", "599", "602"],
      sectioncat: ["596", "599", "602"],
      keywords: "ad tech, ad tools, javascript, documentation",
    },
  },
});

// define signals
aps.record("ad/signals/define", {
  context: {
    // site details
    site: {
      name: "APS Integration Toolbox",
      domain: "aps-sandbox.net",
      page: "https://aps-sandbox.net/test-pages/signals.html",
      cattax: 7,
      cat: ["596", "599", "602"],
      pagecat: ["596", "599", "602"],
      sectioncat: ["596", "599", "602"],
      keywords: "ad tech, ad tools, javascript, documentation",
    },
  },
});

OpenRTB parameters

site

Parameter	Required	Type	Description
`cattax`	required	integer	The taxonomy in use. Refer to the AdCOM list List: Category Taxonomies for values.
`cat`	required	string array	Array of IABTL content categories of the site. The taxonomy to be used is defined by the `cattax` field.
`sectioncat`	recommended	string array	Array of IABTL content categories that describe the current section of the site. The taxonomy to be used is defined by the `cattax` field.
`pagecat`	recommended	string array	Array of IABTL content categories that describe the current page or view of the site. The taxonomy to be used is defined by the `cattax` field.
`keywords`	recommended	string	Comma separated list of keywords about the site. Only one of ‘keywords’ or ‘kwarray’ may be present.
`name`	optional	string	Site name (may be aliased at the publisher’s request).
`domain`	optional	string	Domain of the site (e.g., “mysite.foo.com”).
`page`	optional	string	URL of the page where the impression will be shown.
`ref`	optional	string	Referrer URL that caused navigation to the current page.
`search`	optional	string	Search string that caused navigation to the current page.
`mobile`	optional	integer	Indicates if the site has been programmed to optimize layout when viewed on mobile devices, where 0 = no, 1 = yes.
`privacypolicy`	optional	integer	Indicates if the site has a privacy policy, where 0 = no, 1 = yes.
`publisher`	optional	object	Details about the Publisher (Section 3.2.15) of the site.
`content`	optional	object	Details about the Content (Section 3.2.16) within the site.
`kwarray`	optional	string array	Array of keywords about the site. Only one of ‘keywords’ or ‘kwarray’ may be present.
`ext`	optional	object	Placeholder for exchange-specific extensions to OpenRTB.

Signals ​

Implementation ​

Parameters ​

Example ​

OpenRTB parameters ​

site ​