Yaleo & BTA Feed

Preview Pages

Standalone preview pages are hosted on CDN and can be used for quick testing without a publisher environment. They are also used as targets for integration tests.

App	Dev	Prod
Yaleo	dev-cdn.adnz.co/yaleo/index.html	cdn.adnz.co/yaleo/index.html
BTA Feed	dev-cdn.adnz.co/bta-feed/index.html	cdn.adnz.co/bta-feed/index.html

URL Search Params

Various app behaviours can be overridden via URL search params — useful when testing on the preview pages above or on a publisher’s page.

Yaleo

Param	Description
`yaleo_placement_id`	Overrides the placement used on the page.
`yaleo_debug`	Enables app-specific debug logging and test mode for ads.
`yaleo_creative_id`	Forces a specific Xandr creative ID.
`yaleo_force_mobile`	If `true`, forces the placement to use mobile configuration.
`yaleo_iframe_mode`	Indicates that the root element is an iframe child, overriding the default auto-detection.
`yaleo_mock_recommendations`	If `true`, uses mock data instead of fetching real article recommendations.
`yaleo_url`	Overrides the page URL used for targeting and analytics.
`yaleo_shadow_dom_removed`	If `true`, replaces Shadow DOM with an iframe for encapsulation.

To open the Yaleo preview page with a specific placement:

https://cdn.adnz.co/yaleo/index.html?yaleo_placement_id=3ab4b912-6f81-4ec7-9b8a-b415e300671a

BTA Feed

Param	Description
`bta_feed_id`	Overrides the placement used on the page.
`bta_debug`	Enables app-specific debug logging and test mode for ads, and changes Shadow DOM mode to `open`.
`bta_force_enabled`	If `true`, forces the feed to load even if disabled in the backend configuration.
`bta_force_mobile`	If `true`, forces the placement to use mobile configuration.
`bta_creative_id`	Forces all native ads to use a specific Xandr creative ID. Disables non-Xandr bidders when set.
`bta_force_bidders`	Restricts the native Prebid auction to the given bidder codes (comma-separated, case-insensitive), e.g. `appnexus,criteo`. Ignored when `bta_creative_id` is set.
`bta_iframe_mode`	Indicates that the root element is an iframe child, overriding the default auto-detection. Hides the parent iframe and renders the BTA Feed container directly below it.
`bta_mock_recommendations`	If `true`, uses mock data instead of fetching real feed data.
`bta_new_item_markup`	If `true`, uses updated HTML markup for articles and ads.
`bta_endless_scroll_enabled`	If `true`, enables infinite scroll on the last Yaleo placement widget in the feed.
`bta_prebid_migrated`	Overrides `prebidConfig.migrated` for local testing. When `true`, native ads use API `prebidConfig` bidders and floor prices.

To open the BTA Feed preview page with a specific placement:

https://cdn.adnz.co/bta-feed/index.html?bta_feed_id=a819380d-14d6-47c0-9397-99eae69d1fc8

Displaying Logs

adnz_debug is required for console.dev logging to work across all apps. It can be set as a URL search param or persisted in localStorage to keep logging enabled across page loads.

https://dev-cdn.adnz.co/yaleo/index.html?adnz_debug=true&yaleo_debug=true

// Enable
localStorage.setItem('adnz_debug', 'true');

// Disable
localStorage.removeItem('adnz_debug');

Running a Local Dev Server

To test code changes without building for production:

make run-yaleo

make run-bta-feed-prebid

Testing on a Publisher’s Page

To test on a live publisher’s page, use your browser’s built-in resource override to replace the CDN script with a local build.

App	CDN script
Yaleo	`https://cdn.adnz.co/yaleo/index.js`
BTA Feed	`https://cdn.adnz.co/bta-feed/index.js`

The steps below describe the setup process.

Produce the build output — choose one:
- Watch mode — rebuilds automatically on file changes:
  Yaleo
```
make override-yaleo OVERRIDE_DIR=~/browser_override
```
  BTA Feed
```
make override-bta-feed-prebid OVERRIDE_DIR=~/browser_override CDN_DIR=bta-feed
```
  HMR is not available. Reload the page manually after each rebuild.
- One-time build — build once and copy the output file manually:
  Yaleo
```
./bazel build //js/apps/yaleo:bundle_prod
```
  BTA Feed
```
./bazel build //js/apps/bta-feed-prebid:bundle_prod
```
  Copy the output file to its matching path inside your browser’s overrides folder. The path segment darwin_arm64-fastbuild varies by OS and architecture.
  - Yaleo: bazel-out/darwin_arm64-fastbuild/bin/js/apps/yaleo/bundle_prod/index.js
  - BTA Feed: bazel-out/darwin_arm64-fastbuild/bin/js/apps/bta-feed-prebid/bundle_prod/index.js
Configure local overrides in your browser to serve files from ~/browser_override:
Open the publisher’s page and reload to verify local changes are applied.