Understanding API Priority


This article will walk you through how Demandbase selects a value to be returned to the Form Connector.


As explained in Understanding Visitor Identification, Demandbase returns firmographic information using three APIs: IP, Domain, and Company Autocomplete.

The Company Profile that Demandbase returns to the Form Connector, however, will choose only one of the API return values. The Company Profile value is determined by the Form Connector's API priority order.

The default API priority order is Domain API -> IP API -> Company Autocomplete API. This means that if all three APIs identify the visitor, the Demandbase Forms Connector will use the information returned by the Domain API. Likewise, if the IP API and Company Autocomplete APIs return data, but the Domain API does not, the Forms Connector will use the information returned by the IP API.


Below is a demo that demonstrates how the default priority works.

Demo form using API priority: http://codepen.io/demandbase/full/dGVzmR/

Any data within the object Demandbase.Connectors.WebForm.CompanyProfile is the data the Forms Connector has currently selected. Demandbase.Connectors.WebForm.dataSource indicates the API source of the data (domain, ip, and company).

Was this article helpful?
0 out of 0 found this helpful