Bằng cách sử dụng KeywordPlanIdeaService, bạn có thể tìm kiếm từ khoá mới có liên quan đến chiến dịch trong Mạng Tìm kiếm của Google, hoặc tìm các chỉ số trước đây của từ khoá.
Tạo ý tưởng
Tạo ý tưởng từ khoá cho chiến dịch bằng KeywordPlanIdeaService.GenerateKeywordIdeas.
Bạn có thể cung cấp nội dung gốc từ khoá và URL để tạo ý tưởng. Hãy đặt các thông số nhắm mục tiêu như vị trí, ngôn ngữ và chế độ cài đặt mạng để thu hẹp phạm vi tìm kiếm. Hệ thống sẽ trả về những số liệu thống kê trước đây, chẳng hạn như dữ liệu về lượng tìm kiếm, để giúp bạn xác định xem bạn có muốn sử dụng các từ khoá đó cho chiến dịch của mình hay không. Đối với những người dùng đã quen thuộc với giao diện người dùng Google Ads, tính năng này cũng tương tự như Công cụ lập kế hoạch từ khoá.
Có một số cách mà bạn có thể tạo hạt giống để tạo từ khoá mới:
Đối với các từ hoặc cụm từ mô tả các sản phẩm hoặc dịch vụ mà bạn đang quảng cáo, hãy dùng
KeywordSeed. Đây có thể là một loại hình doanh nghiệp chung mà bạn đang nhắm đến, chẳng hạn như thợ sửa ống nước hoặc có thể là một sản phẩm hoặc dịch vụ mà bạn cung cấp, chẳng hạn như vệ sinh ống nước.Đối với URL của một trang web hoặc toàn bộ trang web liên quan đến doanh nghiệp của bạn, hãy sử dụng
UrlSeed. Nội dung gốc URL chỉ nhắm đến một URL cụ thể. Nếu không có lượt truy cập, tính năng tìm kiếm sẽ tự động mở rộng đến các trang thuộc cùng một miền.Đối với hạt giống URL, nội dung của các siêu liên kết không được dùng để tạo ý tưởng từ khoá.
Đối với cả nội dung gốc từ khoá và nội dung gốc URL, hãy sử dụng
KeywordAndUrlSeed.Việc sử dụng
KeywordAndUrlSeedcó thể mang lại lượng ý tưởng từ khoá lớn hơn, so với chỉUrlSeed.Đối với toàn bộ trang web, hãy dùng
SiteSeed. Với một tên miền cấp cao nhất, chẳng hạn nhưwww.example.com, nguồn gốc trang web sẽ tạo tối đa 250.000 ý tưởng từ khoá từ thông tin có sẵn công khai.
Để thu hẹp phạm vi nhắm mục tiêu, bạn có thể:
- Đặt ngôn ngữ bằng
GenerateKeywordIdeasRequest.language. - Đặt vị trí bằng
GenerateKeywordIdeasRequest.geo_target_constants. - Thiết lập mạng bằng
GenerateKeywordIdeasRequest.keyword_plan_network. - Đặt xem có bao gồm từ khoá người lớn bằng
GenerateKeywordIdeasRequest.include_adult_keywordshay không. - Tinh chỉnh từ khoá bằng
GenerateKeywordIdeasRequest.keyword_annotation. - Đặt phạm vi ngày bằng
GenerateKeywordIdeasRequest.historical_metrics_options.
Kết quả được đặt trong phản hồi hỗ trợ tính năng phân trang.
Các ý tưởng được trả về cùng với các chỉ số trong quá khứ có thể dùng để lọc danh sách và dùng với thông tin dự đoán. Ví dụ: bạn có thể chỉ muốn nhắm đến lượng tìm kiếm cao để tối đa hoá phạm vi tiếp cận của chiến dịch, hoặc bạn có thể chỉ muốn nhắm đến điểm số cạnh tranh cao hơn để nâng cao mức độ nhận biết.
Java
private void runExample(
GoogleAdsClient googleAdsClient,
long customerId,
long languageId,
List<Long> locationIds,
List<String> keywords,
@Nullable String pageUrl) {
try (KeywordPlanIdeaServiceClient keywordPlanServiceClient =
googleAdsClient.getLatestVersion().createKeywordPlanIdeaServiceClient()) {
GenerateKeywordIdeasRequest.Builder requestBuilder =
GenerateKeywordIdeasRequest.newBuilder()
.setCustomerId(Long.toString(customerId))
// Sets the language resource using the provided language ID.
.setLanguage(ResourceNames.languageConstant(languageId))
// Sets the network. To restrict to only Google Search, change the parameter below to
// KeywordPlanNetwork.GOOGLE_SEARCH.
.setKeywordPlanNetwork(KeywordPlanNetwork.GOOGLE_SEARCH_AND_PARTNERS);
// Adds the resource name of each location ID to the request.
for (Long locationId : locationIds) {
requestBuilder.addGeoTargetConstants(ResourceNames.geoTargetConstant(locationId));
}
// Makes sure that keywords and/or page URL were specified. The request must have exactly one
// of urlSeed, keywordSeed, or keywordAndUrlSeed set.
if (keywords.isEmpty() && pageUrl == null) {
throw new IllegalArgumentException(
"At least one of keywords or page URL is required, but neither was specified.");
}
if (keywords.isEmpty()) {
// Only page URL was specified, so use a UrlSeed.
requestBuilder.getUrlSeedBuilder().setUrl(pageUrl);
} else if (pageUrl == null) {
// Only keywords were specified, so use a KeywordSeed.
requestBuilder.getKeywordSeedBuilder().addAllKeywords(keywords);
} else {
// Both page URL and keywords were specified, so use a KeywordAndUrlSeed.
requestBuilder.getKeywordAndUrlSeedBuilder().setUrl(pageUrl).addAllKeywords(keywords);
}
// Sends the keyword ideas request.
GenerateKeywordIdeasPagedResponse response =
keywordPlanServiceClient.generateKeywordIdeas(requestBuilder.build());
// Prints each result in the response.
for (GenerateKeywordIdeaResult result : response.iterateAll()) {
System.out.printf(
"Keyword idea text '%s' has %d average monthly searches and '%s' competition.%n",
result.getText(),
result.getKeywordIdeaMetrics().getAvgMonthlySearches(),
result.getKeywordIdeaMetrics().getCompetition());
}
}
}
C#
public void Run(GoogleAdsClient client, long customerId, long[] locationIds,
long languageId, string[] keywordTexts, string pageUrl)
{
KeywordPlanIdeaServiceClient keywordPlanIdeaService =
client.GetService(Services.V16.KeywordPlanIdeaService);
// Make sure that keywords and/or page URL were specified. The request must have
// exactly one of urlSeed, keywordSeed, or keywordAndUrlSeed set.
if (keywordTexts.Length == 0 && string.IsNullOrEmpty(pageUrl))
{
throw new ArgumentException("At least one of keywords or page URL is required, " +
"but neither was specified.");
}
// Specify the optional arguments of the request as a keywordSeed, UrlSeed,
// or KeywordAndUrlSeed.
GenerateKeywordIdeasRequest request = new GenerateKeywordIdeasRequest()
{
CustomerId = customerId.ToString(),
};
if (keywordTexts.Length == 0)
{
// Only page URL was specified, so use a UrlSeed.
request.UrlSeed = new UrlSeed()
{
Url = pageUrl
};
}
else if (string.IsNullOrEmpty(pageUrl))
{
// Only keywords were specified, so use a KeywordSeed.
request.KeywordSeed = new KeywordSeed();
request.KeywordSeed.Keywords.AddRange(keywordTexts);
}
else
{
// Both page URL and keywords were specified, so use a KeywordAndUrlSeed.
request.KeywordAndUrlSeed = new KeywordAndUrlSeed();
request.KeywordAndUrlSeed.Url = pageUrl;
request.KeywordAndUrlSeed.Keywords.AddRange(keywordTexts);
}
// Create a list of geo target constants based on the resource name of specified
// location IDs.
foreach (long locationId in locationIds)
{
request.GeoTargetConstants.Add(ResourceNames.GeoTargetConstant(locationId));
}
request.Language = ResourceNames.LanguageConstant(languageId);
// Set the network. To restrict to only Google Search, change the parameter below to
// KeywordPlanNetwork.GoogleSearch.
request.KeywordPlanNetwork = KeywordPlanNetwork.GoogleSearchAndPartners;
try
{
// Generate keyword ideas based on the specified parameters.
var response =
keywordPlanIdeaService.GenerateKeywordIdeas(request);
// Iterate over the results and print its detail.
foreach (GenerateKeywordIdeaResult result in response)
{
KeywordPlanHistoricalMetrics metrics = result.KeywordIdeaMetrics;
Console.WriteLine($"Keyword idea text '{result.Text}' has " +
$"{metrics.AvgMonthlySearches} average monthly searches and competition " +
$"is {metrics.Competition}.");
}
}
catch (GoogleAdsException e)
{
Console.WriteLine("Failure:");
Console.WriteLine($"Message: {e.Message}");
Console.WriteLine($"Failure: {e.Failure}");
Console.WriteLine($"Request ID: {e.RequestId}");
throw;
}
}
1.199
public static function runExample(
GoogleAdsClient $googleAdsClient,
int $customerId,
array $locationIds,
int $languageId,
array $keywords,
?string $pageUrl
) {
$keywordPlanIdeaServiceClient = $googleAdsClient->getKeywordPlanIdeaServiceClient();
// Make sure that keywords and/or page URL were specified. The request must have exactly one
// of urlSeed, keywordSeed, or keywordAndUrlSeed set.
if (empty($keywords) && is_null($pageUrl)) {
throw new \InvalidArgumentException(
'At least one of keywords or page URL is required, but neither was specified.'
);
}
// Specify the optional arguments of the request as a keywordSeed, urlSeed,
// or keywordAndUrlSeed.
$requestOptionalArgs = [];
if (empty($keywords)) {
// Only page URL was specified, so use a UrlSeed.
$requestOptionalArgs['url_seed'] = new UrlSeed(['url' => $pageUrl]);
} elseif (is_null($pageUrl)) {
// Only keywords were specified, so use a KeywordSeed.
$requestOptionalArgs['keyword_seed'] = new KeywordSeed(['keywords' => $keywords]);
} else {
// Both page URL and keywords were specified, so use a KeywordAndUrlSeed.
$requestOptionalArgs['keyword_and_url_seed'] =
new KeywordAndUrlSeed(['url' => $pageUrl, 'keywords' => $keywords]);
}
// Create a list of geo target constants based on the resource name of specified location
// IDs.
$geoTargetConstants = array_map(function ($locationId) {
return ResourceNames::forGeoTargetConstant($locationId);
}, $locationIds);
// Generate keyword ideas based on the specified parameters.
$response = $keywordPlanIdeaServiceClient->generateKeywordIdeas(
new GenerateKeywordIdeasRequest([
// Set the language resource using the provided language ID.
'language' => ResourceNames::forLanguageConstant($languageId),
'customer_id' => $customerId,
// Add the resource name of each location ID to the request.
'geo_target_constants' => $geoTargetConstants,
// Set the network. To restrict to only Google Search, change the parameter below to
// KeywordPlanNetwork::GOOGLE_SEARCH.
'keyword_plan_network' => KeywordPlanNetwork::GOOGLE_SEARCH_AND_PARTNERS
] + $requestOptionalArgs)
);
// Iterate over the results and print its detail.
foreach ($response->iterateAllElements() as $result) {
/** @var GenerateKeywordIdeaResult $result */
// Note that the competition printed below is enum value.
// For example, a value of 2 will be returned when the competition is 'LOW'.
// A mapping of enum names to values can be found at KeywordPlanCompetitionLevel.php.
printf(
"Keyword idea text '%s' has %d average monthly searches and competition as %d.%s",
$result->getText(),
is_null($result->getKeywordIdeaMetrics()) ?
0 : $result->getKeywordIdeaMetrics()->getAvgMonthlySearches(),
is_null($result->getKeywordIdeaMetrics()) ?
0 : $result->getKeywordIdeaMetrics()->getCompetition(),
PHP_EOL
);
}
}
Python
def main(
client, customer_id, location_ids, language_id, keyword_texts, page_url
):
keyword_plan_idea_service = client.get_service("KeywordPlanIdeaService")
keyword_competition_level_enum = (
client.enums.KeywordPlanCompetitionLevelEnum
)
keyword_plan_network = (
client.enums.KeywordPlanNetworkEnum.GOOGLE_SEARCH_AND_PARTNERS
)
location_rns = map_locations_ids_to_resource_names(client, location_ids)
language_rn = client.get_service("GoogleAdsService").language_constant_path(
language_id
)
# Either keywords or a page_url are required to generate keyword ideas
# so this raises an error if neither are provided.
if not (keyword_texts or page_url):
raise ValueError(
"At least one of keywords or page URL is required, "
"but neither was specified."
)
# Only one of the fields "url_seed", "keyword_seed", or
# "keyword_and_url_seed" can be set on the request, depending on whether
# keywords, a page_url or both were passed to this function.
request = client.get_type("GenerateKeywordIdeasRequest")
request.customer_id = customer_id
request.language = language_rn
request.geo_target_constants = location_rns
request.include_adult_keywords = False
request.keyword_plan_network = keyword_plan_network
# To generate keyword ideas with only a page_url and no keywords we need
# to initialize a UrlSeed object with the page_url as the "url" field.
if not keyword_texts and page_url:
request.url_seed.url = page_url
# To generate keyword ideas with only a list of keywords and no page_url
# we need to initialize a KeywordSeed object and set the "keywords" field
# to be a list of StringValue objects.
if keyword_texts and not page_url:
request.keyword_seed.keywords.extend(keyword_texts)
# To generate keyword ideas using both a list of keywords and a page_url we
# need to initialize a KeywordAndUrlSeed object, setting both the "url" and
# "keywords" fields.
if keyword_texts and page_url:
request.keyword_and_url_seed.url = page_url
request.keyword_and_url_seed.keywords.extend(keyword_texts)
keyword_ideas = keyword_plan_idea_service.generate_keyword_ideas(
request=request
)
for idea in keyword_ideas:
competition_value = idea.keyword_idea_metrics.competition.name
print(
f'Keyword idea text "{idea.text}" has '
f'"{idea.keyword_idea_metrics.avg_monthly_searches}" '
f'average monthly searches and "{competition_value}" '
"competition.\n"
)
Ruby
def generate_keyword_ideas(customer_id, location_ids, language_id, keywords,
page_url)
# GoogleAdsClient will read a config file from
# ENV['HOME']/google_ads_config.rb when called without parameters
client = Google::Ads::GoogleAds::GoogleAdsClient.new
# Make sure that keywords and/or page URL were specified. The request must
# have exactly one of urlSeed, keywordSeed, or keywordAndUrlSeed set.
if keywords.reject {|k| k.nil?}.empty? && page_url.nil?
raise "At least one of keywords or page URL is required."
end
kp_idea_service = client.service.keyword_plan_idea
options_hash = if keywords.empty?
seed = client.resource.url_seed do |seed|
seed.url = page_url
end
{url_seed: seed}
elsif page_url.nil?
seed = client.resource.keyword_seed do |seed|
keywords.each do |keyword|
seed.keywords << keyword
end
end
{keyword_seed: seed}
else
seed = client.resource.keyword_and_url_seed do |seed|
seed.url = page_url
keywords.each do |keyword|
seed.keywords << keyword
end
end
{keyword_and_url_seed: seed}
end
geo_target_constants = location_ids.map do |location_id|
client.path.geo_target_constant(location_id)
end
include_adult_keywords = true
response = kp_idea_service.generate_keyword_ideas(
customer_id: customer_id,
language: client.path.language_constant(language_id),
geo_target_constants: geo_target_constants,
include_adult_keywords: include_adult_keywords,
# To restrict to only Google Search, change the parameter below to
# :GOOGLE_SEARCH
keyword_plan_network: :GOOGLE_SEARCH_AND_PARTNERS,
**options_hash
)
response.each do |result|
monthly_searches = if result.keyword_idea_metrics.nil?
0
else
result.keyword_idea_metrics.avg_monthly_searches
end
competition = if result.keyword_idea_metrics.nil?
:UNSPECIFIED
else
result.keyword_idea_metrics.competition
end
puts "Keyword idea text #{result.text} has #{monthly_searches} average " +
"monthly searches and competition as #{competition}."
end
end
Perl
sub generate_keyword_ideas {
my (
$api_client, $customer_id, $location_ids,
$language_id, $keyword_texts, $page_url
) = @_;
# Make sure that keywords and/or page URL were specified. The request must have
# exactly one of urlSeed, keywordSeed, or keywordAndUrlSeed set.
if (not scalar @$keyword_texts and not $page_url) {
die "At least one of keywords or page URL is required, " .
"but neither was specified.";
}
# Specify the optional arguments of the request as a keywordSeed, urlSeed,
# or keywordAndUrlSeed.
my $request_option_args = {};
if (!scalar @$keyword_texts) {
# Only page URL was specified, so use a UrlSeed.
$request_option_args->{urlSeed} =
Google::Ads::GoogleAds::V16::Services::KeywordPlanIdeaService::UrlSeed->
new({
url => $page_url
});
} elsif (not $page_url) {
# Only keywords were specified, so use a KeywordSeed.
$request_option_args->{keywordSeed} =
Google::Ads::GoogleAds::V16::Services::KeywordPlanIdeaService::KeywordSeed
->new({
keywords => $keyword_texts
});
} else {
# Both page URL and keywords were specified, so use a KeywordAndUrlSeed.
$request_option_args->{keywordAndUrlSeed} =
Google::Ads::GoogleAds::V16::Services::KeywordPlanIdeaService::KeywordAndUrlSeed
->new({
url => $page_url,
keywords => $keyword_texts
});
}
# Create a list of geo target constants based on the resource name of specified
# location IDs.
my $geo_target_constants = [
map (
Google::Ads::GoogleAds::V16::Utils::ResourceNames::geo_target_constant(
$_),
@$location_ids)];
# Generate keyword ideas based on the specified parameters.
my $keyword_ideas_response =
$api_client->KeywordPlanIdeaService()->generate_keyword_ideas({
customerId => $customer_id,
# Set the language resource using the provided language ID.
language =>
Google::Ads::GoogleAds::V16::Utils::ResourceNames::language_constant(
$language_id),
# Add the resource name of each location ID to the request.
geoTargetConstants => $geo_target_constants,
# Set the network. To restrict to only Google Search, change the parameter below
# to GOOGLE_SEARCH.
keywordPlanNetwork => GOOGLE_SEARCH_AND_PARTNERS,
%$request_option_args
});
# Iterate over the results and print its detail.
foreach my $result (@{$keyword_ideas_response->{results}}) {
printf "Keyword idea text '%s' has %d average monthly searches " .
"and '%s' competition.\n", $result->{text},
$result->{keywordIdeaMetrics}{avgMonthlySearches}
? $result->{keywordIdeaMetrics}{avgMonthlySearches}
: 0,
$result->{keywordIdeaMetrics}{competition}
? $result->{keywordIdeaMetrics}{competition}
: "undef";
}
return 1;
}
Ánh xạ đến giao diện người dùng
KeywordPlanIdeaService.GenerateKeywordIdeas có chức năng tương tự trong Công cụ lập kế hoạch từ khoá của giao diện người dùng.
| Giao diện người dùng của Công cụ lập kế hoạch từ khoá | API Google Ads |
|---|---|
| Nhập từ khóa và URL | |
| Địa điểm | GenerateKeywordIdeasRequest.geo_target_constants |
| Từ khoá dành cho Người lớn | GenerateKeywordIdeasRequest.include_adult_keywords |
| Ngôn ngữ | GenerateKeywordIdeasRequest.language |
| Mạng tìm kiếm | GenerateKeywordIdeasRequest.keyword_plan_network |
| Tinh chỉnh từ khóa | GenerateKeywordIdeasRequest.keyword_annotation |
| Khoảng Ngày: | GenerateKeywordIdeasRequest.historical_metrics_options |
| Kết quả: Từ khoá | GenerateKeywordIdeaResult.text |
| Kết quả: Chỉ số | GenerateKeywordIdeaResult.keyword_idea_metrics |