This article will provide a guideline for the installations steps involved with setting up the Search Ads 360 (previously known as DoubleClick) integration with Jet Interactive Call Tracking.
With the integration enabled, phone calls (represented through offline floodlight tags) will be associated with your online Web Calls.
This integration will require assistance from Jet Support to complete.
Please ensure you have submitted a ticket with our team before starting your integration steps below.
CONTENTS
- Part 1 - Set Up Floodlight
- Part 2 - Activate your conversion API
- Part 3 - Establishing your integration
- Referenced material
Part 1 - Set up Floodlight activities for tracking offline conversions
Special permissions required
To create or edit Floodlight activity groups and Floodlight activities in Search Ads 360, your Google account needs all of the following permissions;
-
In Search Ads 360, your account needs agency manager or advertiser manager permissions.
-
Your account also needs a user profile in Campaign Manager with the following permissions:
-
Floodlight: full access
-
Shared Floodlight configurations
If your advertiser is part of a shared Floodlight configuration, you can only create Floodlight activities from the parent advertiser. All of the child advertisers will have access to the Floodlight activities created in the parent.
- In Search Ads 360, sign into the advertiser that is associated with the parent Campaign Manager advertiser and create Floodlight groups and activities from there. You’ll need agency manager or advertiser manager permissions for this Search Ads 360 advertiser.
- In Campaign Manager, your account needs full Floodlight access and API access for the Campaign Manager parent advertiser.
Set up Floodlight activities for tracking offline conversions
-
Navigate to the settings for the Floodlight activity:
-
In the left navigation panel, click Advertiser settings.
-
Click the Floodlight tab and select Floodlight activity groups or Floodlight activities.
-
In the table, select the check box next to Floodlight activity or Floodlight activity group.
-
Click Edit in the toolbar above the table and select Edit details from the list.
-
-
Select the Primary source is offline (conversion API or bulk sheets) check box.
-
Click save.
-
Take note of your Floodlight activity name, this will need to be provided to your Jet Interactive
representative after you have completed the rest of this document.
Part 2 - Activate the conversion API for an advertiser
Before you can use the conversion API or attribute offline conversions to a Google click ID, a Search Ads 360 user with agency manager or advertiser manager access needs to sign in to Search Ads 360 and activate the conversion API for the advertiser. If no one in your organisation has agency manager or advertiser manager access, contact Google customer support, who can enable the conversion API for you.
Before you start: Two URL parameters will be added to all landing pages
Caution: Make sure your landing pages can handle the addition of two URL parameters: gclid and gclsrc.
Once you activate the conversion API, Search Ads 360 will automatically append the gclid and gclsrc parameters to all landing page URLs in the advertiser. The data in the URL parameters enable Search Ads 360 to attribute conversions to specific visits. Search Ads 360 appends the parameters just before forwarding to the advertiser’s landing page. You won’t see these parameters in the effective landing page URL.
URLs without other parameters
Search Ads 360 always precedes both parameters with the & character. If your landing page URLs don't include other URL parameters, your landing page URLs may not be recognized by your site. For example:
-
Landing page before enabling the conversion API:
-
http://www.example.com
-
-
Landing page after enabling the conversion API:
-
http://www.example.com&gclid=123456&gclsrc=ds
-
Note that this URL is invalid because the query string should always be preceded by the ? character.
If your landing page URLs don't include URL parameters -- either directly or in a URL template -- add the ?character to the end of the URLs. You can easily do this for an entire account by specifying the following account-level URL template:
{unescapedlpurl}?
With this URL template, the landing page URL from the preceding example will be:
http://www.example.com?gclid=123456&gclsrc=ds
URLs with fragments
If your landing page URLs include a fragment, Search Ads 360 appends the gclid and gclsrc parameters right before the # character. For example:
- Landing page before enabling the conversion API:
- http://www.example.com#page
- Landing page after enabling the conversion API:
Note that this URL is invalid because the query string should always be preceded by the ? character.
If your landing page URLs don't include URL parameters -- either directly or in a URL template -- add the ?character just before the fragment (fragments should always the last part of a URL). For example:
http://www.example.com?#page
You can use a URL template to do this, but be careful using URL templates with URLs that include fragments, especially in Google Ads accounts.
Learn more about using URL templates and URL fragments.
Activate the conversion API
To activate the conversion API, sign into a Google account with Search Ads 360 agency manager or advertiser manager permissions. Then do the following:
- Navigate to an advertiser.
- In the left navigation panel, click Advertiser settings.
- Click the Integrations tab and select Conversion API.
- Toggle Conversion API to On and click Save.
Part 3 - Establishing your integration
Create a Google API Console project and OAuth credentials
-
Start the Google API Console setup tool.
-
The setup tool guides you through creating a project (or using an existing project), enabling the
Search Ads 360 API, and creating OAuth 2.0 credentials.
-
On the Register your application page, select an existing project or select Create a project.
Then click Continue.
-
After the Google API Console enables the Search Ads 360 API, click the Go to credentials
button.
-
On the Add credentials to your project page, enter the following information:
-
Which API are you using? : Search Ads 360 API
-
Where will you be calling the API from? : Other UI (e.g., Windows, CLI tool)
-
What data will you be accessing? : User data
-
-
Click the What credentials do I need? button.
-
The setup tool now offers to help you create an OAuth 2.0 client ID.
-
Click Create client ID and follow the rest of the steps in the setup tool.
Authorising your SA360 Integration in Jet Hub
INFORMATION UPDATE PENDING NEW RELEASE.
PLEASE CONTACT JET SUPPORT FOR MORE INFORMATION.
Comments
0 comments
Please sign in to leave a comment.