In Vorschläge abrufen wurde gezeigt, wie Sie eine Reihe von KeywordThemeConstant-Objekten mit einem Wort oder einer Wortgruppe abrufen. In diesem Schritt werden dieselben Keyword-Themenkonstanten verwendet, um eine Reihe von CampaignCriterion-Objekten zu erstellen, auf die die smarte Kampagne ausgerichtet werden soll.
Ähnlich wie beim Erstellen eines Budgets, das wir beim Erstellen eines Budgets vom SmartCampaignSuggestService vorgeschlagen haben, sollten Sie Kampagnenkriterien auf Grundlage der Keyword-Themenkonstanten erstellen, die aus der KeywordThemeConstantService unter Vorschläge abrufen abgerufen wurden.
Die wichtigsten Anforderungen für smarte Kampagnen:
In smarten Kampagnen werden nur die folgenden Kriterientypen unterstützt:
Wenn für die geografische Ausrichtung kein Standort angegeben ist, werden standardmäßig alle Regionen eingeschlossen.
Einer smarten Kampagne können mehrere
location-Kriterien zugeordnet werden, es kann aber nur einproximity-Kriterium verwendet werden.Die Ausrichtung auf
locationundproximitykann nicht gleichzeitig verwendet werden.
Im folgenden Beispiel wurden die Keyword-Themenkonstanten in KeywordThemeInfo-Objekte konvertiert, indem der Ressourcenname auf das Feld KeywordThemeInfo.keyword_theme_constant festgelegt wurde. Für das Feld campaign wird der temporäre Ressourcenname verwendet, der im vorherigen Schritt für die Kampagne festgelegt wurde.
Java
/**
* Creates {@link com.google.ads.googleads.v16.resources.CampaignCriterion} operations for add
* each {@link KeywordThemeInfo}.
*/
private Collection<? extends MutateOperation> createCampaignCriterionOperations(
long customerId,
List<KeywordThemeInfo> keywordThemeInfos,
SmartCampaignSuggestionInfo suggestionInfo) {
List<MutateOperation> keywordThemeOperations =
keywordThemeInfos.stream()
.map(
keywordTheme -> {
MutateOperation.Builder builder = MutateOperation.newBuilder();
builder
.getCampaignCriterionOperationBuilder()
.getCreateBuilder()
.setCampaign(ResourceNames.campaign(customerId, SMART_CAMPAIGN_TEMPORARY_ID))
.setKeywordTheme(keywordTheme);
return builder.build();
})
.collect(Collectors.toList());
List<MutateOperation> locationOperations =
suggestionInfo.getLocationList().getLocationsList().stream()
.map(
location -> {
MutateOperation.Builder builder = MutateOperation.newBuilder();
builder
.getCampaignCriterionOperationBuilder()
.getCreateBuilder()
.setCampaign(ResourceNames.campaign(customerId, SMART_CAMPAIGN_TEMPORARY_ID))
.setLocation(location);
return builder.build();
})
.collect(Collectors.toList());
return Stream.concat(keywordThemeOperations.stream(), locationOperations.stream())
.collect(Collectors.toList());
}
C#
/// <summary>
/// Creates a list of MutateOperations that create new campaign criteria.
/// </summary>
/// <param name="customerId">The Google Ads customer ID.</param>
/// <param name="keywordThemeInfos">A list of KeywordThemeInfos.</param>
/// <param name="suggestionInfo">A SmartCampaignSuggestionInfo instance.</param>
/// <returns>A list of MutateOperations that create new campaign criteria.</returns>
private IEnumerable<MutateOperation> CreateCampaignCriterionOperations(long customerId,
IEnumerable<KeywordThemeInfo> keywordThemeInfos, SmartCampaignSuggestionInfo
suggestionInfo)
{
List<MutateOperation> mutateOperations = keywordThemeInfos.Select(
keywordThemeInfo => new MutateOperation
{
CampaignCriterionOperation = new CampaignCriterionOperation
{
Create = new CampaignCriterion
{
// Set the campaign ID to a temporary ID.
Campaign = ResourceNames.Campaign(
customerId, SMART_CAMPAIGN_TEMPORARY_ID),
// Set the keyword theme to each KeywordThemeInfo in turn.
KeywordTheme = keywordThemeInfo,
}
}
}).ToList();
// Create a location criterion for each location in the suggestion info.
mutateOperations.AddRange(
suggestionInfo.LocationList.Locations.Select(
locationInfo => new MutateOperation()
{
CampaignCriterionOperation = new CampaignCriterionOperation()
{
Create = new CampaignCriterion()
{
// Set the campaign ID to a temporary ID.
Campaign = ResourceNames.Campaign(customerId,
SMART_CAMPAIGN_TEMPORARY_ID),
// Set the location to the given location.
Location = locationInfo
}
}
}).ToList()
);
return mutateOperations;
}
PHP
private static function createCampaignCriterionOperations(
int $customerId,
array $keywordThemeInfos,
SmartCampaignSuggestionInfo $smartCampaignSuggestionInfo
): array {
$operations = [];
foreach ($keywordThemeInfos as $info) {
// Creates the campaign criterion object.
$campaignCriterion = new CampaignCriterion([
// Sets the campaign ID to a temporary ID.
'campaign' =>
ResourceNames::forCampaign($customerId, self::SMART_CAMPAIGN_TEMPORARY_ID),
// Sets the keyword theme to the given KeywordThemeInfo.
'keyword_theme' => $info
]);
// Creates the MutateOperation that creates the campaign criterion and adds it to the
// list of operations.
$operations[] = new MutateOperation([
'campaign_criterion_operation' => new CampaignCriterionOperation([
'create' => $campaignCriterion
])
]);
}
// Create a location criterion for each location in the suggestion info object to add
// corresponding location targeting to the Smart campaign.
foreach ($smartCampaignSuggestionInfo->getLocationList()->getLocations() as $location) {
// Creates the campaign criterion object.
$campaignCriterion = new CampaignCriterion([
// Sets the campaign ID to a temporary ID.
'campaign' =>
ResourceNames::forCampaign($customerId, self::SMART_CAMPAIGN_TEMPORARY_ID),
// Set the location to the given location.
'location' => $location
]);
// Creates the MutateOperation that creates the campaign criterion and adds it to the
// list of operations.
$operations[] = new MutateOperation([
'campaign_criterion_operation' => new CampaignCriterionOperation([
'create' => $campaignCriterion
])
]);
}
return $operations;
}
Python
def create_campaign_criterion_operations(
client, customer_id, keyword_theme_infos, suggestion_info
):
"""Creates a list of MutateOperations that create new campaign criteria.
Args:
client: an initialized GoogleAdsClient instance.
customer_id: a client customer ID.
keyword_theme_infos: a list of KeywordThemeInfos.
suggestion_info: A SmartCampaignSuggestionInfo instance.
Returns:
a list of MutateOperations that create new campaign criteria.
"""
campaign_service = client.get_service("CampaignService")
operations = []
for info in keyword_theme_infos:
mutate_operation = client.get_type("MutateOperation")
campaign_criterion = (
mutate_operation.campaign_criterion_operation.create
)
# Set the campaign ID to a temporary ID.
campaign_criterion.campaign = campaign_service.campaign_path(
customer_id, _SMART_CAMPAIGN_TEMPORARY_ID
)
# Set the keyword theme to the given KeywordThemeInfo.
campaign_criterion.keyword_theme = info
# Add the mutate operation to the list of other operations.
operations.append(mutate_operation)
# Create a location criterion for each location in the suggestion info
# object to add corresponding location targeting to the Smart campaign
for location_info in suggestion_info.location_list.locations:
mutate_operation = client.get_type("MutateOperation")
campaign_criterion = (
mutate_operation.campaign_criterion_operation.create
)
# Set the campaign ID to a temporary ID.
campaign_criterion.campaign = campaign_service.campaign_path(
customer_id, _SMART_CAMPAIGN_TEMPORARY_ID
)
# Set the location to the given location.
campaign_criterion.location = location_info
# Add the mutate operation to the list of other operations.
operations.append(mutate_operation)
return operations
Ruby
# Creates a list of mutate_operations that create new campaign criteria.
def create_campaign_criterion_operations(
client,
customer_id,
keyword_theme_infos,
suggestion_info)
operations = []
keyword_theme_infos.each do |info|
operations << client.operation.mutate do |m|
m.campaign_criterion_operation =
client.operation.create_resource.campaign_criterion do |cc|
# Sets the campaign ID to a temporary ID.
cc.campaign = client.path.campaign(
customer_id, SMART_CAMPAIGN_TEMPORARY_ID)
# Sets the keyword theme to the given keyword_theme_info.
cc.keyword_theme = info
end
end
end
# Create a location criterion for each location in the suggestion info object
# to add corresponding location targeting to the Smart campaign
suggestion_info.location_list.locations.each do |location|
operations << client.operation.mutate do |m|
m.campaign_criterion_operation =
client.operation.create_resource.campaign_criterion do |cc|
# Sets the campaign ID to a temporary ID.
cc.campaign = client.path.campaign(
customer_id, SMART_CAMPAIGN_TEMPORARY_ID)
# Sets the location to the given location.
cc.location = location
end
end
end
operations
end
Perl
# Creates a list of MutateOperations that create new campaign criteria.
sub _create_campaign_criterion_operations {
my ($customer_id, $keyword_theme_infos, $suggestion_info) = @_;
my $campaign_criterion_operations = [];
foreach my $keyword_theme_info (@$keyword_theme_infos) {
push @$campaign_criterion_operations,
Google::Ads::GoogleAds::V16::Services::GoogleAdsService::MutateOperation
->new({
campaignCriterionOperation =>
Google::Ads::GoogleAds::V16::Services::CampaignCriterionService::CampaignCriterionOperation
->new({
create =>
Google::Ads::GoogleAds::V16::Resources::CampaignCriterion->new({
# Set the campaign ID to a temporary ID.
campaign =>
Google::Ads::GoogleAds::V16::Utils::ResourceNames::campaign(
$customer_id, SMART_CAMPAIGN_TEMPORARY_ID
),
# Set the keyword theme to the given KeywordThemeInfo.
keywordTheme => $keyword_theme_info
})})});
}
# Create a location criterion for each location in the suggestion info object
# to add corresponding location targeting to the Smart campaign.
foreach my $location_info (@{$suggestion_info->{locationList}{locations}}) {
push @$campaign_criterion_operations,
Google::Ads::GoogleAds::V16::Services::GoogleAdsService::MutateOperation
->new({
campaignCriterionOperation =>
Google::Ads::GoogleAds::V16::Services::CampaignCriterionService::CampaignCriterionOperation
->new({
create =>
Google::Ads::GoogleAds::V16::Resources::CampaignCriterion->new({
# Set the campaign ID to a temporary ID.
campaign =>
Google::Ads::GoogleAds::V16::Utils::ResourceNames::campaign(
$customer_id, SMART_CAMPAIGN_TEMPORARY_ID
),
# Set the location to the given location.
location => $location_info
})})});
}
return $campaign_criterion_operations;
}
Kampagnenkriterien mit auszuschließenden Keyword-Thema
Wenn Sie in einer smarten Kampagne ein ausschließendes Targeting auf ein Kampagnenkriterium für Keyword-Themen festlegen möchten, müssen Sie ein Keyword-Design im freien Format verwenden. Dazu müssen Sie das Feld free_form_keyword_theme in einer KeywordThemeInfo-Instanz festlegen.
Themenkriterien für auszuschließende Keywords funktionieren anders als solche für einzuschließende Keywords. Während ein einzuschließendes Keyword-Thema automatisch so angepasst wird, dass es auf ähnliche Kriterien ausgerichtet ist, wird bei einem auszuschließenden Keyword-Thema nur genau der angegebene Begriff ausgeschlossen. Das Verhalten entspricht der Funktionsweise eines Keywords mit auszuschließender Wortgruppe.