This page explains how to integrate Taboola recommendations within your website, using JS Tags.
- This page explains how to prepare JS Tags, using the param values provided by Taboola.
- During onboarding, you also received prefilled JS Tags from Taboola. You can copy and paste those 'as is', instead of editing param values.
If this is a new integration, please provide Taboola with a timeframe for launch, so we can plan post-launch QA.
- Add the Taboola loader tag to your page, just before the closing
Make sure to fill in your specific param values (see below).
- Replace the default text with the param values provided by Taboola (or use the prefilled tag that was sent to you):
Replace this with the relevant page type, as provided by Taboola - e.g.
To obtain an automated ID, leave this param as is:
Else, insert your own, internal ID:
Specifies the ID of this page, for the given page type.
Fill in your Publisher ID, as provided by Taboola.
If your Publisher ID is
Your Publisher ID is a unique, alphabetic String, provided by Taboola.
loader.js initiates communication with Taboola and contains publisher-specific resources and configurations for your integration.
For each placement on a given page:
- Add a placement tag to the
<body>, in the location that the placement should display.
Each placement has both a
<script>tag, as shown below.
- Edit the tag (or use the prefilled tag that was sent to you):
- Choose an ID for the
<div>container - e.g.
- Fill in the
<script>param values, as provided by Taboola.
- Choose an ID for the
These are sample values only. Make sure to fill in your own values, as provided by Taboola.
mode- The UI Mode IDUI Mode ID - The UI template (layout and properties) for this placement. for this placement, as provided by Taboola:
container- The ID of the
<div>container for this placement's content:
- E.g. '
placement- The placement nameplacement name - A descriptive name for the placement - used for reporting., as provided by Taboola:
target_type- The target type, as provided by Taboola:
- Each placement must have its own JS tag.
- On a given page, each JS tag must have unique values for
placement. Do not duplicate a JS tag on the same page.
- The value for
containermust match the ID of the
<div>container for the placement's content.
If your Taboola account has been configured for custom segment targeting, you can optionally pass a
For example, if your account has been configured with a custom segment called 'subscriber':
- Pass the custom segment name, as agreed upon with Taboola.
- You can pass 1 custom segment only, per placement.
- Add the Taboola flush tag to the page
<body>, immediately after the last placement tag:
flushflag instructs Taboola to fetch the requested placements (and not wait for additional data).
- Pass the
flushflag once only - after passing all placements for that page.
- If you have unique requirements, reach out to Taboola to discuss alternative flows.
Updated about 2 months ago