Proximity
Stay organized with collections
Save and categorize content based on your preferences.
Add a proximity target to a campaign
function addProximityTargets(campaignName) {
const campaignIterator = AdsApp.campaigns()
.withCondition(`campaign.name = "${campaignName}"`)
.get();
if (!campaignIterator.hasNext()) {
throw new Error(`No campaign with name "${campaignName}" found`);
}
const campaign = campaignIterator.next();
// Add a proximity target of 20 kilometers around Google New York office.
// To obtain coordinates of a given point on Google Maps,
// see https://support.google.com/maps/answer/18539
campaign.addProximity(40.741144, -74.002086, 20, 'KILOMETERS');
// You could also add proximity by an address. However, we don't validate
// if the address you put matches the given latitude and longitude. It has
// no functionality except to change what shows up in the Campaign
// Management interface.
// Add a proximity target of 10 kilometers around Google Mountain View
// office.
campaign.addProximity({
latitude: 37.423021,
longitude: -122.083739,
radius: 10,
radiusUnits: 'KILOMETERS',
bidModifier: 0.75,
address: {
streetAddress: '1600 Amphitheatre Parkway',
cityName: 'Mountain View',
provinceName: 'California',
provinceCode: 'CA',
postalCode: '94043',
countryCode: 'US'
}
});
}
Get the list of all proximity targets for a campaign
function getTargetedProximities(campaignName) {
const campaignIterator = AdsApp.campaigns()
.withCondition(`campaign.name = "${campaignName}"`)
.get();
if (!campaignIterator.hasNext()) {
throw new Error(`No campaign with name "${campaignName}" found`);
}
const campaign = campaignIterator.next();
return campaign.targeting().targetedProximities().get();
}
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2022-03-14 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2022-03-14 UTC."],[[["This script provides functions to add and retrieve proximity targets for Google Ads campaigns."],["`addProximityTargets` enables adding location-based targeting by specifying coordinates, radius, and optionally an address for display purposes."],["You can target a specific radius around a point using latitude, longitude, and radius with units (e.g., kilometers)."],["`getTargetedProximities` retrieves all existing proximity targets associated with a given campaign."]]],[]]