questionnaire docs
Integrations

Taboola Integration

Taboola Web Push and on-page widget integration.

Taboola Integration

Taboola provides Web Push notifications and native content recommendation widgets.

Products

ProductPurpose
Web PushBrowser push notification subscription
WidgetsMid Article, Below Article, Right Rail recommendation ads

Architecture

Config resolution

  1. tenant.taboolaConfig (DB) — takes precedence
  2. Static hostname map in lib/taboola.js

Widget placement

WidgetLocation
Mid ArticleSplit within article HTML content
Below ArticleAfter article body
Right RailSidebar on desktop (TaboolaPageLayout)

Key files

FilePurpose
lib/taboola.jsConfig resolution, hostname map
lib/taboolaBootstrap.jsInline loader script
components/layout/TaboolaWidgets.jsWidget div rendering
components/layout/TaboolaRouteSync.jsRoute change sync
components/ui/TaboolaPageLayout.jsTwo-column layout wrapper

DB schema

taboolaConfig: {
  enabled: true,
  accountName: "unibotsindpush-domaincom",
  accountId: "1234568"
}

ads.txt

Taboola requires an entry in the tenant's ads.txt file. Served via app/ads.txt/route.js from tenant.adConfig.adsTxtContent.

Adding a new domain

  1. Add hostname to static map in lib/taboola.js, OR
  2. Set taboolaConfig on the tenant document in MongoDB (preferred)

On this page