Contact Locator

OVERVIEW

Using information gathered via IP Geolocation to update a contact record’s City, State, Postal Code and Country. You can also store a contact’s Timezone, IP Address, Latitude and Longitude.

INTEGRATIONS NEEDED FOR CONTACT LOCATOR

You are currently viewing this content for HubSpot.
Click here to switch your platform.

Contact Locator Configuration Options

click image to enlarge

In this section, you will find the options for building your Contact Locator tool. Follow along in your PlusThis app, or by viewing the numbered step in the screenshots.

1

Save the IP address:

If you would like to store the IP address, select what property on the contact you’d like to populate.
2

Save the Timezone:

If you would like to store the timezone, select what property on the contact you’d like to populate.
3

Save the Country:

If you would like to store the country, select what property on the contact you’d like to populate.
4

Save the State/Region:

If you would like to store the state/region, select what property on the contact you’d like to populate.
5

Save the City:

If you would like to store the city, select what property on the contact you’d like to populate.
6

Save the Postal Code:

If you would like to store the postal code, select what property on the contact you’d like to populate.
7

Save the Latitude:

If you would like to store the latitude, select what property on the contact you’d like to populate.
In order to preserve accuracy latitude/longitude values will be stored in text fields.
8

Save the Longitude:

If you would like to store the longitude, select what property on the contact you’d like to populate.
In order to preserve accuracy latitude/longitude values will be stored in text fields.

Additional Options and Save

9

Apply to a list after the contact's location is determined?

Select which list you would like applied after the location has been determined.
10

Overwrite existing values

By default, this toggle is set to "off", however, if you would like to update properties that already have a value with the newly found value.  
11

Get the IP address from a field on a contact record?

By default, this toggle is set to "Yes". As such, it provides you a Webhook for use in your Workflow which allows you to determine the location base on an IP address stored on a property on the contact record.  

If you do not want this functionality enabled, simply switch this toggle over to "No" If you leave this option enabled, you will want to select which property on the contact that the IP address is stored in.  
12

Tool Name

Enter a name for your tool in this field. The name is solely for use inside of PlusThis, and will not be visible to customers. 

click image to enlarge

"Need to Know" Items for Contact Locator

Data gathered via IP Geolocation is not 100% accurate. The data tends to be most accurate at the Country and State level.

Keep in mind that disabling the Contact Id Verification is less secure and less accurate than having it enabled. This is due to the fact that we will only be looking up contacts by email, rather than the email and id combination - and if there are multiple contacts that exist in you HubSpot app with the same email address, we will pick the oldest (ie. First created) contact with that email address.  

FAQs / Tips

Implementation Types

My Website

Locate your contact when they arrive on a page.

1
On the Usage and Instructions page, copy the code under the ‘My Website’ tab.
2
Embed the code in an HTML element on your page. Best practice is to embed it higher on your page so it loads first.
3
Be sure to pass contact details to the page the Contact Locator is embedded on. You can do this using the link generator, or by passing details through a HubSpot webform submission.

click image to enlarge

Thank You Page

Locate your contact when they arrive on a HubSpot Thank You page.

1
On the Usage and Instructions page, copy the code under the ‘HubSpot Thank You Page’ tab.
2
Embed the code in an HTML element on your HubSpot page. Best practice is to embed it higher on your page so it loads first.
3
Be sure to pass contact details to the page the Contact Locator is embedded on. You can do this using the link generator, or by passing details through a HubSpot webform submission.

click image to enlarge

Webhook

Run your tool virtually anywhere in your automation using a Webhook element.

1
Copy the Webhook URL from PlusThis.
2
Add an action in your Hubspot workflow where you would like the PlusThis tool to trigger.
3
Choose the Webhook Trigger at the bottom of the action list on the right hand side.
4
Paste the Webhook in the webhook URL area, and click ‘Save’.

click image to enlarge

Related Campaigns

Instantly Update Contact Records with PlusThis Contact Locator

PlusThis is a powerful tool that allows you to gather information via IP Geolocation and update contact records with their accurate City, State, Postal Code, and Country. With this tool,...