이 가이드에서는 위치 타겟팅에 대해 설명하고 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
루비
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::V17::Resources::CampaignCriterion->new({
# Create a location using the specified location ID.
location => Google::Ads::GoogleAds::V17::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::V17::Utils::ResourceNames::geo_target_constant(
$location_id)}
),
campaign => $campaign_resource_name
});
return
Google::Ads::GoogleAds::V17::Services::CampaignCriterionService::CampaignCriterionOperation
->new({
create => $campaign_criterion
});
}
Google에서는 위치가 더 작거나 넓은 지역으로 재구성되거나 지정학적인 변화 등으로 재구성되는 등의 다양한 이유로 일부 위치 기준을 단계적으로 중단할 수 있습니다. 위치가 ENABLED 또는 REMOVAL_PLANNED인지 확인하려면 GeoTargetConstant 객체의 status 필드를 참고하세요.
타겟 위치 관련 지원을 단계적으로 중단하는 방법을
자세히 알아보세요.
위치 이름으로 조회
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.V17.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})."
)
루비
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::V17::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
루비
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::V17::Resources::CampaignCriterion->new({
proximity => Google::Ads::GoogleAds::V17::Common::ProximityInfo->new({
address => Google::Ads::GoogleAds::V17::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::V17::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 외부에 있는 위치는 타겟팅되지 않습니다.