Personyze Wiki Personyze Wiki docs
English
Open Personyze
Docs/ ABM & Visitor Identification/ Demandbase Integration — Company Identification and Target-Account Audiences
ABM & Visitor Identification

Demandbase Integration — Company Identification and Target-Account Audiences

Read the company, industry, size and target-account audiences your Demandbase tag identifies onto each visitor’s profile, and target campaigns on them.

8 min read Updated 2 weeks ago

Use what Demandbase knows about the company behind each anonymous B2B visit — its name, industry, size, and whether it is one of your target accounts — to personalize your website for it in Personyze.

One click, no key The Demandbase tag already on your website identifies the company. Personyze reads the tag’s answer off the page and stores each field on the visitor’s profile, where it becomes a targeting rule.

What it does

Demandbase identifies the company behind a visit from the visitor’s network, and tells you which of your Demandbase audiences it belongs to. If you use Demandbase, its tag is already on your website and does this lookup on every visit. Personyze reads the tag’s answer in the visitor’s browser and stores each field on the visitor’s profile:

  • Company — the company’s name.
  • Website — its domain.
  • Industry and Sub-industry.
  • Employee range and Revenue range — its size.
  • Audience and Audience segment — your Demandbase audiences, for example your target account list.
  • Any other field in Demandbase’s answer, added by name — including the Account Connector fields your Demandbase admin chose to share with your website: segments, scores, journey stages, CRM fields.

Then, for example: show a banner to your target accounts only, swap the hero image by industry, or lead companies in a given journey stage to a demo page.

What you need

  • A Demandbase subscription, with the Demandbase tag on your website — the script from tag.demandbase.com that Demandbase gives you. Installing it through Google Tag Manager works too. Personyze does not install it for you.
  • Or, instead of the tag, the Account Connector token Demandbase issues for Personyze — for the server-side connection, which needs no Demandbase tag.
  • The Personyze tag on your pages.

The tag way has no key to enter in Personyze: the Demandbase tag carries your Demandbase key, and Personyze only reads what the tag has already fetched. The server-side way takes one, the Account Connector token.

Set it up

  1. In Personyze, go to Integrations and open Demandbase (search for it, or choose the Lead Intelligence category).
  2. Click Turn on Demandbase.
The Demandbase drawer in Personyze, before Turn on Demandbase
Integrations → Demandbase, before turning it on: the eight fields, the Turn on Demandbase button, and Another field for anything else in Demandbase’s answer. Click to enlarge.

That is all. Personyze creates eight visitor attributes — Demandbase company, Demandbase website, Demandbase industry, Demandbase sub-industry, Demandbase employee range, Demandbase revenue range, Demandbase audience and Demandbase audience segment — and the containers that fill them. Each row in the drawer then shows a check and reads “Capturing into demandbase_…”, the drawer says All set., and the Demandbase card reads Configured. The attributes are ordinary ones: you find them under Settings → Visitor Attributes, and can pause or edit them there like any other.

Connect server-side, without the Demandbase tag

Instead of reading the Demandbase tag on your page, Personyze can ask Demandbase itself about each visitor, from Personyze’s servers. Use it when the Demandbase tag is not on your site, or when you want the company data to be there before the page’s campaigns are chosen.

What you need

  • A Demandbase subscription that includes the Account Connector.
  • In Demandbase, Settings → Demandbase-Wide Settings → Account Connector: add Personyze and choose the fields to share with it. Demandbase then issues a token for Personyze. Keep it safe — you enter it in Personyze next.

Connect

  1. In Personyze, go to Integrations and open Demandbase.
  2. Under Server-side connection, enter the token in the Account Connector token box and click Connect.
  3. Personyze checks the token with Demandbase before saving it. When Demandbase accepts it, the drawer reads Connected, with “Demandbase is asked on every page view.” under it.

Personyze keeps the token safe: it is stored encrypted and is never shown again.

Connecting also switches the fields on for the server: each field already capturing is filled from the server as well — or, when none is on yet, the eight standard fields are switched on. A field filled from the server reads “Capturing into demandbase_… · server-side”. While you are connected, a field you add under Another field is filled from the server, Account Connector fields included — still added as custom_fields_ followed by the label, as in Add more fields.

How it works

  • On every page view, Personyze sends Demandbase the visitor’s IP address, the page address and the referring page, and Demandbase answers with the company profile. Demandbase requires a call on every page: it is what its analytics count.
  • On the first page of a visit, Personyze waits for Demandbase’s answer — at most 2 seconds — and stores the fields, so they are available to targeting rules on that first page. On later pages the call is made without making the visitor wait, and the fields keep the values from the first page. If Demandbase has not answered within the 2 seconds, the page goes ahead without it, and that visit records nothing from the server.
  • With the Demandbase tag on the site as well, both fill the same fields with the same values. Nothing to choose.

Disconnect

In the Demandbase drawer, click the bin icon beside Connected and confirm. Personyze deletes the stored token. Fields filled from the tag keep working wherever the tag is on your site; a field that was filled only from the server — one added while you were connected — stops filling.

Add more fields

Demandbase’s answer has many more fields than these eight. To add one:

  1. Open a page of your own website, open the browser’s developer console, and type Demandbase.IP.CompanyProfile. You see every field Demandbase returned for your own visit, by name.
  2. In the Demandbase drawer in Personyze, type the field’s name under Another field (for example city) and click Add.

The new attribute is named “Demandbase” and the field’s name — for example Demandbase city.

Account Connector fields appear in the console as custom_fields_ followed by the field’s label, spaces included — for example custom_fields_Journey Stage. Add them exactly as written.

A field name starts with a letter or an underscore, and may contain letters, digits, spaces, hyphens and underscores — no dots, brackets or quotes. Anything else is refused with “Use the field name as it appears in the Demandbase response — no dots, brackets or quotes.”

Use it in a campaign

The Demandbase fields appear in the User CRM/ABM/Profile rule in any campaign’s audience, alongside your other profile fields. For example:

  • Demandbase audience contains “Target Accounts” — content for your target account list only.
  • Demandbase industry is “Software” — a hero image and case study for that industry.
  • Demandbase custom_fields_Journey Stage is a stage — lead companies at that stage to a demo page.

You can also print a field in your content with dynamic variables — give each one a fallback, because many visitors have no company. For the whole account-based playbook, see Target visitors from specific companies (ABM).

Good to know

  • It arrives a moment into the visit. The Demandbase tag looks the company up while the page loads. Personyze keeps watching the page and records each field as soon as it appears, so it is normally available within the first page view — but not in its very first instant. With the server-side connection it is there from the first page.
  • Many visitors record nothing, and that is correct. Home and mobile connections often do not resolve to a company, and a field Demandbase leaves empty records nothing.
  • With the tag, Personyze does not call Demandbase. It reads the answer the Demandbase tag already gave your page, in the visitor’s browser. With the server-side connection, Personyze sends Demandbase the visitor’s IP address, page address and referring page on every page view.
Excluding by company or audience? When a rule excludes visitors by a Demandbase field — “everyone except our target accounts”, “not from our own company” — switch on Only match after a value is recorded on that rule. Otherwise it treats “we do not know yet” as “does not match”, and matches every visitor Demandbase did not identify.

Troubleshooting

The attributes stay empty

Check that the Demandbase tag runs on the page: in the browser console, Demandbase.IP.CompanyProfile should show an object. If it is undefined, the tag is missing or blocked — for example by a consent tool until the visitor accepts. From a home connection, an empty answer is normal: test from an office network that Demandbase recognizes.

With the server-side connection there is nothing to check in the console: make sure the drawer reads Connected rather than “Switched off”, and test in a new visit from an office network that Demandbase recognizes — the server fills the fields on the first page of a visit.

An added field stays empty

Check the name against the console exactly, including capitals and the spaces in Account Connector fields.

A row reads “Not mapped yet” again

Someone paused or removed its attribute under Settings → Visitor Attributes. Click Turn on Demandbase again: it switches back on what was paused and leaves the rest as it is.

“That does not look like a Demandbase token”

A token is 32 to 48 letters, digits and underscores, with no spaces or other characters. Check it against the token in Demandbase’s Account Connector and enter it again.

“Demandbase did not accept this token”

Check that the Personyze entry in Demandbase’s Account Connector is active, then enter the token again.

The drawer says “Switched off” with a reason

Demandbase refused the token for over an hour — for example, the Account Connector entry was removed or the token was replaced. Personyze stopped asking, so visitors are not slowed down by a call that cannot work. Enter the current token and click Connect.

Get an AI plan for your site

Inspire me reads your website and suggests the personalization campaigns to run first, and who should see each one. Free.

Scan your site
Did this page answer your question?
Thank you — that goes to whoever maintains this page.