이 가이드에서는 위치 타겟팅에 대해 설명하고, Google Ads API를 이용해 캠페인의 위치 타겟팅을 추가, 검색, 업데이트하는 방법을 설명합니다.
지역 타겟팅이 중요한 이유는 무엇인가요?
위치 타겟팅을 사용하면 특정 지역의 사용자에게 광고를 게재할 수 있습니다. 예를 들어 슈퍼마켓 체인을 광고한다고 가정해 보겠습니다. 위치 타겟팅을 사용하지 않으면 전 세계 모든 지역에 광고가 게재되고 슈퍼마켓 위치가 없는 지역의 사용자로부터 광고 클릭이 발생할 수 있습니다. 이렇게 하면 비용이 발생하지만 투자 수익 가능성은 없습니다. 위치 타겟팅을 사용하면 캠페인에서 오픈 슈퍼마켓이 있는 지역에만 광고를 게재합니다. 이 방법을 사용하면 지역에서 슈퍼마켓을 검색하는 고객을 직접 타겟팅할 수도 있습니다.
Google Ads API를 사용하면 국가, 지역 또는 특정 지리적 지점 주변의 근접도를 기준으로 광고를 타겟팅할 수 있습니다.
지리적 위치에 광고를 타겟팅하는 방법을 자세히 알아보세요.
지역의 지역 타겟팅 캠페인
국가, 주, 도시, 우편 지역 등 Google Ads에서 위치 타겟팅을 지원하는 모든 지역으로 캠페인을 타겟팅할 수 있습니다. 타겟팅 가능한 각 위치는 기준 ID를 통해 고유하게 식별됩니다. GeoTargetConstantService.SuggestGeoTargetConstants를 사용하여 기준 ID를 조회할 수 있습니다.
각 GeoTargetConstant의 resource_name는 geoTargetConstants/{Criterion ID} 형식입니다. 예를 들어 뉴욕주의 resource_name 값은 geoTargetConstants/21167입니다.
CampaignCriterionService를 사용하여 캠페인에 지역 타겟을 추가할 수 있습니다. 다음 코드 스니펫은 기준 ID를 사용하여 캠페인을 타겟팅하는 방법을 보여줍니다.
Java
private static CampaignCriterion buildLocationIdCriterion(
long locationId, String campaignResourceName) {
Builder criterionBuilder = CampaignCriterion.newBuilder().setCampaign(campaignResourceName);
criterionBuilder
.getLocationBuilder()
.setGeoTargetConstant(ResourceNames.geoTargetConstant(locationId));
return criterionBuilder.build();
}
C#
private CampaignCriterion buildLocationCriterion(long locationId,
string campaignResourceName)
{
GeoTargetConstantName location = new GeoTargetConstantName(locationId.ToString());
return new CampaignCriterion()
{
Campaign = campaignResourceName,
Location = new LocationInfo()
{
GeoTargetConstant = location.ToString()
}
};
}
2,399필리핀
private static function createLocationCampaignCriterionOperation(
int $locationId,
string $campaignResourceName
) {
// Constructs a campaign criterion for the specified campaign ID using the specified
// location ID.
$campaignCriterion = new CampaignCriterion([
// Creates a location using the specified location ID.
'location' => new LocationInfo([
// Besides using location ID, you can also search by location names using
// GeoTargetConstantServiceClient::suggestGeoTargetConstants() and directly
// apply GeoTargetConstant::$resourceName here. An example can be found
// in GetGeoTargetConstantByNames.php.
'geo_target_constant' => ResourceNames::forGeoTargetConstant($locationId)
]),
'campaign' => $campaignResourceName
]);
return new CampaignCriterionOperation(['create' => $campaignCriterion]);
}
Python
def create_location_op(client, customer_id, campaign_id, location_id):
campaign_service = client.get_service("CampaignService")
geo_target_constant_service = client.get_service("GeoTargetConstantService")
# Create the campaign criterion.
campaign_criterion_operation = client.get_type("CampaignCriterionOperation")
campaign_criterion = campaign_criterion_operation.create
campaign_criterion.campaign = campaign_service.campaign_path(
customer_id, campaign_id
)
# Besides using location_id, you can also search by location names from
# GeoTargetConstantService.suggest_geo_target_constants() and directly
# apply GeoTargetConstant.resource_name here. An example can be found
# in get_geo_target_constant_by_names.py.
campaign_criterion.location.geo_target_constant = (
geo_target_constant_service.geo_target_constant_path(location_id)
)
return campaign_criterion_operation
Ruby
def create_location(client, customer_id, campaign_id, location_id)
client.operation.create_resource.campaign_criterion do |criterion|
criterion.campaign = client.path.campaign(customer_id, campaign_id)
criterion.location = client.resource.location_info do |li|
# Besides using location_id, you can also search by location names from
# GeoTargetConstantService.suggest_geo_target_constants() and directly
# apply GeoTargetConstant.resource_name here. An example can be found
# in get_geo_target_constant_by_names.rb.
li.geo_target_constant = client.path.geo_target_constant(location_id)
end
end
end
Perl
sub create_location_campaign_criterion_operation {
my ($location_id, $campaign_resource_name) = @_;
# Construct a campaign criterion for the specified campaign using the
# specified location ID.
my $campaign_criterion =
Google::Ads::GoogleAds::V16::Resources::CampaignCriterion->new({
# Create a location using the specified location ID.
location => Google::Ads::GoogleAds::V16::Common::LocationInfo->new({
# Besides using location ID, you can also search by location names
# using GeoTargetConstantService::suggest() and directly apply
# GeoTargetConstant->{resourceName} here. An example can be found
# in get_geo_target_constants_by_names.pl.
geoTargetConstant =>
Google::Ads::GoogleAds::V16::Utils::ResourceNames::geo_target_constant(
$location_id)}
),
campaign => $campaign_resource_name
});
return
Google::Ads::GoogleAds::V16::Services::CampaignCriterionService::CampaignCriterionOperation
->new({
create => $campaign_criterion
});
}
Google은 다양한 이유로 일부 위치 기준을 단계적으로 폐지할 수 있습니다.
위치가 더 작은 지역이나 넓은 지역, 지정학적 변경사항 등으로 재구성될 수 있습니다.
GeoTargetConstant 객체의 status 필드를 참조하여 위치가
ENABLED 또는 REMOVAL_PLANNED인지
확인합니다.
타겟 위치의 단계적 지원 중단 방법에
대해 자세히 알아보세요.
위치 이름으로 찾기
GeoTargetConstantService.SuggestGeoTargetConstants를 사용하여 위치 이름으로 기준 ID를 조회할 수도 있습니다.
다음 코드 예는 위치 이름으로 위치 기준 ID를 찾는 방법을 보여줍니다.
Java
private void runExample(GoogleAdsClient googleAdsClient) {
try (GeoTargetConstantServiceClient geoTargetClient =
googleAdsClient.getLatestVersion().createGeoTargetConstantServiceClient()) {
SuggestGeoTargetConstantsRequest.Builder requestBuilder =
SuggestGeoTargetConstantsRequest.newBuilder();
// Locale is using ISO 639-1 format. If an invalid locale is given, 'en' is used by default.
requestBuilder.setLocale("en");
// A list of country codes can be referenced here:
// https://developers.google.com/google-ads/api/reference/data/geotargets
requestBuilder.setCountryCode("FR");
requestBuilder
.getLocationNamesBuilder()
.addAllNames(ImmutableList.of("Paris", "Quebec", "Spain", "Deutschland"));
SuggestGeoTargetConstantsResponse response =
geoTargetClient.suggestGeoTargetConstants(requestBuilder.build());
for (GeoTargetConstantSuggestion suggestion :
response.getGeoTargetConstantSuggestionsList()) {
System.out.printf(
"%s (%s,%s,%s,%s) is found in locale (%s) with reach (%d) for search term (%s).%n",
suggestion.getGeoTargetConstant().getResourceName(),
suggestion.getGeoTargetConstant().getName(),
suggestion.getGeoTargetConstant().getCountryCode(),
suggestion.getGeoTargetConstant().getTargetType(),
suggestion.getGeoTargetConstant().getStatus().name(),
suggestion.getLocale(),
suggestion.getReach(),
suggestion.getSearchTerm());
}
}
}
C#
public void Run(GoogleAdsClient client)
{
// Get the GeoTargetConstantServiceClient.
GeoTargetConstantServiceClient geoService =
client.GetService(Services.V16.GeoTargetConstantService);
// Locale is using ISO 639-1 format. If an invalid locale is given,
// 'en' is used by default.
string locale = "en";
// A list of country codes can be referenced here:
// https://developers.google.com/google-ads/api/reference/data/geotargets
string countryCode = "FR";
string[] locations = { "Paris", "Quebec", "Spain", "Deutschland" };
SuggestGeoTargetConstantsRequest request = new SuggestGeoTargetConstantsRequest()
{
Locale = locale,
CountryCode = countryCode,
LocationNames = new SuggestGeoTargetConstantsRequest.Types.LocationNames()
};
request.LocationNames.Names.AddRange(locations);
try
{
SuggestGeoTargetConstantsResponse response =
geoService.SuggestGeoTargetConstants(request);
foreach (GeoTargetConstantSuggestion suggestion
in response.GeoTargetConstantSuggestions)
{
Console.WriteLine(
$"{suggestion.GeoTargetConstant.ResourceName} " +
$"({suggestion.GeoTargetConstant.Name}, " +
$"{suggestion.GeoTargetConstant.CountryCode}, " +
$"{suggestion.GeoTargetConstant.TargetType}, " +
$"{suggestion.GeoTargetConstant.Status}) is found in locale " +
$"({suggestion.Locale}) with reach ({suggestion.Reach}) " +
$"for search term ({suggestion.SearchTerm}).");
}
}
catch (GoogleAdsException e)
{
Console.WriteLine("Failure:");
Console.WriteLine($"Message: {e.Message}");
Console.WriteLine($"Failure: {e.Failure}");
Console.WriteLine($"Request ID: {e.RequestId}");
throw;
}
}
2,399필리핀
public static function runExample(
GoogleAdsClient $googleAdsClient,
array $locationNames,
string $locale,
string $countryCode
) {
$geoTargetConstantServiceClient = $googleAdsClient->getGeoTargetConstantServiceClient();
$response = $geoTargetConstantServiceClient->suggestGeoTargetConstants(
new SuggestGeoTargetConstantsRequest([
'locale' => $locale,
'country_code' => $countryCode,
'location_names' => new LocationNames(['names' => $locationNames])
])
);
// Iterates over all geo target constant suggestion objects and prints the requested field
// values for each one.
foreach ($response->getGeoTargetConstantSuggestions() as $geoTargetConstantSuggestion) {
/** @var GeoTargetConstantSuggestion $geoTargetConstantSuggestion */
printf(
"Found '%s' ('%s','%s','%s',%s) in locale '%s' with reach %d"
. " for the search term '%s'.%s",
$geoTargetConstantSuggestion->getGeoTargetConstant()->getResourceName(),
$geoTargetConstantSuggestion->getGeoTargetConstant()->getName(),
$geoTargetConstantSuggestion->getGeoTargetConstant()->getCountryCode(),
$geoTargetConstantSuggestion->getGeoTargetConstant()->getTargetType(),
GeoTargetConstantStatus::name(
$geoTargetConstantSuggestion->getGeoTargetConstant()->getStatus()
),
$geoTargetConstantSuggestion->getLocale(),
$geoTargetConstantSuggestion->getReach(),
$geoTargetConstantSuggestion->getSearchTerm(),
PHP_EOL
);
}
}
Python
def main(client):
gtc_service = client.get_service("GeoTargetConstantService")
gtc_request = client.get_type("SuggestGeoTargetConstantsRequest")
gtc_request.locale = LOCALE
gtc_request.country_code = COUNTRY_CODE
# The location names to get suggested geo target constants.
gtc_request.location_names.names.extend(
["Paris", "Quebec", "Spain", "Deutschland"]
)
results = gtc_service.suggest_geo_target_constants(gtc_request)
for suggestion in results.geo_target_constant_suggestions:
geo_target_constant = suggestion.geo_target_constant
print(
f"{geo_target_constant.resource_name} "
f"({geo_target_constant.name}, "
f"{geo_target_constant.country_code}, "
f"{geo_target_constant.target_type}, "
f"{geo_target_constant.status.name}) "
f"is found in locale ({suggestion.locale}) "
f"with reach ({suggestion.reach}) "
f"from search term ({suggestion.search_term})."
)
Ruby
def get_geo_target_constants_by_names
# GoogleAdsClient will read a config file from
# ENV['HOME']/google_ads_config.rb when called without parameters
client = Google::Ads::GoogleAds::GoogleAdsClient.new
gtc_service = client.service.geo_target_constant
location_names = client.resource.location_names do |ln|
['Paris', 'Quebec', 'Spain', 'Deutschland'].each do |name|
ln.names << name
end
end
# Locale is using ISO 639-1 format. If an invalid locale is given,
# 'en' is used by default.
locale = 'en'
# A list of country codes can be referenced here:
# https://developers.google.com/google-ads/api/reference/data/geotargets
country_code = 'FR'
response = gtc_service.suggest_geo_target_constants(
locale: locale,
country_code: country_code,
location_names: location_names
)
response.geo_target_constant_suggestions.each do |suggestion|
puts sprintf("%s (%s,%s,%s,%s) is found in locale (%s) with reach (%d)" \
" from search term (%s).", suggestion.geo_target_constant.resource_name,
suggestion.geo_target_constant.name,
suggestion.geo_target_constant.country_code,
suggestion.geo_target_constant.target_type,
suggestion.geo_target_constant.status,
suggestion.locale,
suggestion.reach,
suggestion.search_term)
end
end
Perl
sub get_geo_target_constants_by_names {
my ($api_client, $location_names, $locale, $country_code) = @_;
my $suggest_response = $api_client->GeoTargetConstantService()->suggest({
locale => $locale,
countryCode => $country_code,
locationNames =>
Google::Ads::GoogleAds::V16::Services::GeoTargetConstantService::LocationNames
->new({
names => $location_names
})});
# Iterate over all geo target constant suggestion objects and print the requested
# field values for each one.
foreach my $geo_target_constant_suggestion (
@{$suggest_response->{geoTargetConstantSuggestions}})
{
printf "Found '%s' ('%s','%s','%s',%s) in locale '%s' with reach %d" .
" for the search term '%s'.\n",
$geo_target_constant_suggestion->{geoTargetConstant}{resourceName},
$geo_target_constant_suggestion->{geoTargetConstant}{name},
$geo_target_constant_suggestion->{geoTargetConstant}{countryCode},
$geo_target_constant_suggestion->{geoTargetConstant}{targetType},
$geo_target_constant_suggestion->{geoTargetConstant}{status},
$geo_target_constant_suggestion->{locale},
$geo_target_constant_suggestion->{reach},
$geo_target_constant_suggestion->{searchTerm};
}
return 1;
}
특정 위치와 인접한 캠페인 타겟팅
도시나 국가보다 더 정밀한 타겟팅이 필요한 경우가 있습니다. 예를 들어 매장 위치에서 10km 이내에 있는 슈퍼마켓을 광고할 수 있습니다. 이러한 경우 인접 타겟팅을 사용할 수 있습니다.
인접 타겟을 만드는 코드는 위치 타겟을 추가하는 방법과
비슷합니다. 단, LocationInfo 객체 대신
ProximityInfo 객체를 만들어야 합니다.
Java
private static CampaignCriterion buildProximityLocation(String campaignResourceName) {
Builder builder = CampaignCriterion.newBuilder().setCampaign(campaignResourceName);
ProximityInfo.Builder proximityBuilder = builder.getProximityBuilder();
proximityBuilder.setRadius(10.0).setRadiusUnits(ProximityRadiusUnits.MILES);
AddressInfo.Builder addressBuilder = proximityBuilder.getAddressBuilder();
addressBuilder
.setStreetAddress("38 avenue de l'Opéra")
.setCityName("Paris")
.setPostalCode("75002")
.setCountryCode("FR");
return builder.build();
}
C#
private CampaignCriterion buildProximityCriterion(string campaignResourceName)
{
ProximityInfo proximity = new ProximityInfo()
{
Address = new AddressInfo()
{
StreetAddress = "38 avenue de l'Opéra",
CityName = "Paris",
PostalCode = "75002",
CountryCode = "FR"
},
Radius = 10d,
// Default is kilometers.
RadiusUnits = ProximityRadiusUnits.Miles
};
return new CampaignCriterion()
{
Campaign = campaignResourceName,
Proximity = proximity
};
}
2,399필리핀
private static function createProximityCampaignCriterionOperation(string $campaignResourceName)
{
// Constructs a campaign criterion as a proximity.
$campaignCriterion = new CampaignCriterion([
'proximity' => new ProximityInfo([
'address' => new AddressInfo([
'street_address' => '38 avenue de l\'Opéra',
'city_name' => 'Paris',
'postal_code' => '75002',
'country_code' => 'FR',
]),
'radius' => 10.0,
// Default is kilometers.
'radius_units' => ProximityRadiusUnits::MILES
]),
'campaign' => $campaignResourceName
]);
return new CampaignCriterionOperation(['create' => $campaignCriterion]);
}
Python
def create_proximity_op(client, customer_id, campaign_id):
campaign_service = client.get_service("CampaignService")
# Create the campaign criterion.
campaign_criterion_operation = client.get_type("CampaignCriterionOperation")
campaign_criterion = campaign_criterion_operation.create
campaign_criterion.campaign = campaign_service.campaign_path(
customer_id, campaign_id
)
campaign_criterion.proximity.address.street_address = "38 avenue de l'Opera"
campaign_criterion.proximity.address.city_name = "Paris"
campaign_criterion.proximity.address.postal_code = "75002"
campaign_criterion.proximity.address.country_code = "FR"
campaign_criterion.proximity.radius = 10
# Default is kilometers.
campaign_criterion.proximity.radius_units = (
client.enums.ProximityRadiusUnitsEnum.MILES
)
return campaign_criterion_operation
Ruby
def create_proximity(client, customer_id, campaign_id)
client.operation.create_resource.campaign_criterion do |criterion|
criterion.campaign = client.path.campaign(customer_id, campaign_id)
criterion.proximity = client.resource.proximity_info do |proximity|
proximity.address = client.resource.address_info do |address|
address.street_address = "38 avenue de l'Opéra"
address.city_name = "Paris"
address.postal_code = "75002"
address.country_code = "FR"
end
proximity.radius = 10
proximity.radius_units = :MILES
end
end
end
Perl
sub create_proximity_campaign_criterion_operation {
my ($campaign_resource_name) = @_;
# Construct a campaign criterion as a proximity.
my $campaign_criterion =
Google::Ads::GoogleAds::V16::Resources::CampaignCriterion->new({
proximity => Google::Ads::GoogleAds::V16::Common::ProximityInfo->new({
address => Google::Ads::GoogleAds::V16::Common::AddressInfo->new({
streetAddress => "38 avenue de l'Opéra",
cityName => "cityName",
postalCode => "75002",
countryCode => "FR"
}
),
radius => 10.0,
# Default is kilometers.
radiusUnits => MILES
}
),
campaign => $campaign_resource_name
});
return
Google::Ads::GoogleAds::V16::Services::CampaignCriterionService::CampaignCriterionOperation
->new({
create => $campaign_criterion
});
}
지역 타겟 가져오기
GoogleAdsService.SearchStream를 사용하여 캠페인의 지역 타겟을 가져올 수 있습니다. WHERE 절에서 결과를 필터링할 수 있습니다.
SELECT
campaign_criterion.campaign,
campaign_criterion.location.geo_target_constant,
campaign_criterion.proximity.geo_point.longitude_in_micro_degrees,
campaign_criterion.proximity.geo_point.latitude_in_micro_degrees,
campaign_criterion.proximity.radius,
campaign_criterion.negative
FROM campaign_criterion
WHERE
campaign_criterion.campaign = 'customers/{customer_id}/campaigns/{campaign_id}'
AND campaign_criterion.type IN (LOCATION, PROXIMITY)
지역 타겟 업데이트
캠페인의 타겟 위치를 업데이트하려면 기존 지역 타겟의 목록을
가져와 새 타겟의 목록과 비교해야 합니다. 그런 다음 remove 작업을 사용하여 필요하지 않은 타겟을 삭제하고 create 작업을 사용하여 필요한 새 지역 타겟 (기존 캠페인에는 없음)을 추가할 수 있습니다.
지역 타겟 제외
또한 LocationInfo를 제외할 수 있지만 ProximityInfo는 제외할 수 없습니다. 이 기능은 한 지역을 타겟팅하고 싶지만 하위 지역은 제외하고자 할 때 (예: 뉴욕시를 제외한 미국 전체를 타겟팅하는 경우) 가장 유용합니다. 리전을 제외하려면 CampaignCriterion의 negative 필드를 true로 설정합니다.
여러 지역 타겟팅
LocationGroupInfo를 사용하면 캠페인이 여러 지역을 타겟팅하도록 설정할 수 있습니다. 지역은 캠페인의 위치 광고 확장으로
정의된 위치를 중심으로 이루어집니다.
LocationGroupInfo에서 정의된 반경은 각 위치 주변의
원형 영역을 지정하며 radius 객체, 길이, radius_units(미터 또는 마일(LocationGroupRadiusUnitsEnum))로
구성됩니다.
LocationGroupInfo의 위치는 geo_target_constant 필드에 정의된 지역 타겟팅 기준 ID 목록으로 필터링할 수 있습니다. 정의된 경우 지정된 기준 ID 외부에 있는 위치는
타겟팅되지 않습니다.