飯店廣告群組支援將您的飯店劃分成多個飯店商家資訊群組， ，就能據此調整各個群組的出價。 請參考下方的樹狀圖，第一層是飯店廣泛採用的結構 分為 5 星級飯店、4 星級飯店和其他飯店星級。第二次 其他飯店星級的飯店現在劃分為「美國」 旅館、「英國」其他地區的飯店
樹狀結構中的每個節點都是子產品群組或單元，如
ListingGroupType。
子產品群組會導入
新關卡，而單元則是樹狀結構的樹葉。每個子產品群組都必須
一律會完全分區，因此必須包含代表
其他。在這個範例中，根節點和飯店類別：(其他) 節點
細分。這種包含子產品群組和單元的樹狀結構
對單位層級的出價，同時確保每則飯店商家資訊
而且樹狀結構中只有一個單位節點
節點是 ListingGroupInfo 類別的物件，
其中包含的 ListingGroupType 欄位
會指出節點是單位還是子部門。將「ListingGroupInfo」設為
AdGroupCriterion的listing_group將連結至下列地點：
AdGroup。
設定單次點擊出價百分比
您可以將 percent_cpc_bid_micros 設為
只有單位節點上的 AdGroupCriterion。正在嘗試
如對子節點執行這項作業，就會失敗並產生錯誤。
房源資訊維度
ListingGroupInfo 也有
case_value，也就是
包含下列任一項目的 ListingDimensionInfo
ListingGroupInfo 代表相關聯的值
，例如飯店 ID、飯店所在國家/地區或飯店星級。完整的
您可以參閱參考資料，取得可用的 ListingDimensionInfo 類型
說明文件。
每個子產品群組的子子項都必須有相同的 case_value
ListingDimensionInfo 子類型。只有根節點不含 case_value。
請注意，每個子產品群組都必須包含「空白」case_value
正確類型，代表「所有其他值」。
詳情請參閱下列程式碼片段 商家資訊群組樹狀結構的層級
Java
private static String addLevel1Nodes(
long customerId,
long adGroupId,
String rootResourceName,
List<AdGroupCriterionOperation> operations,
long percentCpcBidMicroAmount) {
// Creates hotel class info and dimension info for 5-star hotels.
ListingDimensionInfo fiveStarredDimensionInfo =
ListingDimensionInfo.newBuilder()
.setHotelClass(HotelClassInfo.newBuilder().setValue(5).build())
.build();
// Creates listing group info for 5-star hotels as a UNIT node.
ListingGroupInfo fiveStarredUnit =
ListingGroupInfo.newBuilder()
.setType(ListingGroupType.UNIT)
.setParentAdGroupCriterion(rootResourceName)
.setCaseValue(fiveStarredDimensionInfo)
.build();
// Creates an ad group criterion for 5-star hotels.
AdGroupCriterion fiveStarredAdGroupCriterion =
createAdGroupCriterion(customerId, adGroupId, fiveStarredUnit, percentCpcBidMicroAmount);
// Decrements the temp ID for the next ad group criterion.
AdGroupCriterionOperation operation = generateCreateOperation(fiveStarredAdGroupCriterion);
operations.add(operation);
// You can also create more UNIT nodes for other hotel classes by copying the above code in
// this method and modifying the value passed to HotelClassInfo() to the value you want.
// For instance, passing 4 instead of 5 in the above code will create a UNIT node of 4-star
// hotels instead.
// Creates hotel class info and dimension info for other hotel classes by not specifying
// any attributes on those object.
ListingDimensionInfo otherHotelsDimensionInfo =
ListingDimensionInfo.newBuilder()
.setHotelClass(HotelClassInfo.newBuilder().build())
.build();
// Creates listing group info for other hotel classes as a SUBDIVISION node, which will be
// used as a parent node for children nodes of the next level.
ListingGroupInfo otherHotelsSubdivision =
createListingGroupInfo(
ListingGroupType.SUBDIVISION, rootResourceName, otherHotelsDimensionInfo);
// Creates an ad group criterion for other hotel classes.
AdGroupCriterion otherHotelsAdGroupCriterion =
createAdGroupCriterion(
customerId, adGroupId, otherHotelsSubdivision, percentCpcBidMicroAmount);
operation = generateCreateOperation(otherHotelsAdGroupCriterion);
operations.add(operation);
return otherHotelsAdGroupCriterion.getResourceName();
}
C#
private string AddLevel1Nodes(long customerId, long adGroupId, string rootResourceName,
List<AdGroupCriterionOperation> operations, long percentCpcBidMicroAmount)
{
// Create listing dimension info for 5-star class hotels.
ListingDimensionInfo fiveStarredListingDimensionInfo = new ListingDimensionInfo
{
HotelClass = new HotelClassInfo
{
Value = 5
}
};
// Create a listing group info for 5-star hotels as a UNIT node.
ListingGroupInfo fiveStarredUnit = CreateListingGroupInfo(ListingGroupType.Unit,
rootResourceName, fiveStarredListingDimensionInfo);
// Create an ad group criterion for 5-star hotels.
AdGroupCriterion fiveStarredAdGroupCriterion = CreateAdGroupCriterion(customerId,
adGroupId, fiveStarredUnit, percentCpcBidMicroAmount);
// Create an operation and add it to the list of operations.
operations.Add(new AdGroupCriterionOperation
{
Create = fiveStarredAdGroupCriterion
});
// Decrement the temp ID for the next ad group criterion.
nextTempId--;
// You can also create more UNIT nodes for other hotel classes by copying the above code
// in this method and modifying the value passed to HotelClassInfo().
// For instance, passing 4 instead of 5 in the above code will instead create a UNIT
// node of 4-star hotels.
// Create hotel class info and dimension info for other hotel classes by *not*
// specifying any attributes on those object.
ListingDimensionInfo otherHotelsListingDimensionInfo = new ListingDimensionInfo
{
HotelClass = new HotelClassInfo()
};
// Create listing group info for other hotel classes as a SUBDIVISION node, which will
// be used as a parent node for children nodes of the next level.
ListingGroupInfo otherHotelsSubdivisionListingGroupInfo = CreateListingGroupInfo
(ListingGroupType.Subdivision, rootResourceName, otherHotelsListingDimensionInfo);
// Create an ad group criterion for other hotel classes.
AdGroupCriterion otherHotelsAdGroupCriterion = CreateAdGroupCriterion(customerId,
adGroupId, otherHotelsSubdivisionListingGroupInfo, percentCpcBidMicroAmount);
// Create an operation and add it to the list of operations.
operations.Add(new AdGroupCriterionOperation
{
Create = otherHotelsAdGroupCriterion
});
// Decrement the temp ID for the next ad group criterion.
nextTempId--;
return otherHotelsAdGroupCriterion.ResourceName;
}
PHP
private static function addLevel1Nodes(
int $customerId,
int $adGroupId,
string $rootResourceName,
array &$operations,
int $percentCpcBidMicroAmount
) {
// Creates hotel class info and dimension info for 5-star hotels.
$fiveStarredDimensionInfo = new ListingDimensionInfo([
'hotel_class' => new HotelClassInfo(['value' => 5])
]);
// Creates listing group info for 5-star hotels as a UNIT node.
$fiveStarredUnit = self::createListingGroupInfo(
ListingGroupType::UNIT,
$rootResourceName,
$fiveStarredDimensionInfo
);
// Creates an ad group criterion for 5-star hotels.
$fiveStarredAdGroupCriterion = self::createAdGroupCriterion(
$customerId,
$adGroupId,
$fiveStarredUnit,
$percentCpcBidMicroAmount
);
// Decrements the temp ID for the next ad group criterion.
self::$nextTempId--;
$operation = self::generateCreateOperation($fiveStarredAdGroupCriterion);
$operations[] = $operation;
// You can also create more UNIT nodes for other hotel classes by copying the above code in
// this method and modifying the value passed to HotelClassInfo() to the value you want.
// For instance, passing 4 instead of 5 in the above code will create a UNIT node of 4-star
// hotels instead.
// Creates hotel class info and dimension info for other hotel classes by *not* specifying
// any attributes on those object.
$othersHotelsDimensionInfo = new ListingDimensionInfo([
'hotel_class' => new HotelClassInfo()
]);
// Creates listing group info for other hotel classes as a SUBDIVISION node, which will be
// used as a parent node for children nodes of the next level.
$otherHotelsSubDivision = self::createListingGroupInfo(
ListingGroupType::SUBDIVISION,
$rootResourceName,
$othersHotelsDimensionInfo
);
// Creates an ad group criterion for other hotel classes.
$otherHotelsAdGroupCriterion = self::createAdGroupCriterion(
$customerId,
$adGroupId,
$otherHotelsSubDivision,
$percentCpcBidMicroAmount
);
$operation = self::generateCreateOperation($otherHotelsAdGroupCriterion);
$operations[] = $operation;
self::$nextTempId--;
return $otherHotelsAdGroupCriterion->getResourceName();
}
Python
def add_level1_nodes(
client,
customer_id,
ad_group_id,
root_resource_name,
operations,
percent_cpc_bid_micro_amount,
):
"""Creates child nodes on level 1, partitioned by the hotel class info.
Args:
client: The Google Ads API client.
customer_id: The Google Ads customer ID.
ad_group_id: The ad group ID to which the hotel listing group will be
added.
root_resource_name: The string resource name of the listing group's root
node.
operations: A list of AdGroupCriterionOperations.
percent_cpc_bid_micro_amount: The CPC bid micro amount to be set on
created ad group criteria.
Returns:
The string resource name of the "other hotel classes" node, which serves
as the parent node for the next level of the listing tree.
"""
global next_temp_id
# Create listing dimension info for 5-star class hotels.
five_starred_listing_dimension_info = client.get_type(
"ListingDimensionInfo"
)
five_starred_listing_dimension_info.hotel_class.value = 5
# Create a listing group info for 5-star hotels as a UNIT node.
five_starred_unit = create_listing_group_info(
client,
client.enums.ListingGroupTypeEnum.UNIT,
root_resource_name,
five_starred_listing_dimension_info,
)
# Create an ad group criterion for 5-star hotels.
five_starred_ad_group_criterion = create_ad_group_criterion(
client,
customer_id,
ad_group_id,
five_starred_unit,
percent_cpc_bid_micro_amount,
)
# Create an operation and add it to the list of operations.
five_starred_ad_group_criterion_operation = client.get_type(
"AdGroupCriterionOperation"
)
client.copy_from(
five_starred_ad_group_criterion_operation.create,
five_starred_ad_group_criterion,
)
operations.append(five_starred_ad_group_criterion_operation)
# Decrement the temp ID for the next ad group criterion.
next_temp_id -= 1
# You can also create more UNIT nodes for other hotel classes by copying the
# above code in this method and modifying the hotel class value.
# For instance, passing 4 instead of 5 in the above code will instead create
# a UNIT node of 4-star hotels.
# Create hotel class info and dimension info without any specifying
# attributes. This node will then represent hotel classes other than those
# already covered by UNIT nodes at this level.
other_hotels_listing_dimension_info = client.get_type(
"ListingDimensionInfo"
)
# Set "hotel_class" as the oneof field on the ListingDimensionInfo object
# without specifying the optional hotel_class field.
client.copy_from(
other_hotels_listing_dimension_info.hotel_class,
client.get_type("HotelClassInfo"),
)
# Create listing group info for other hotel classes as a SUBDIVISION node,
# which will be used as a parent node for children nodes of the next level.
other_hotels_subdivision_listing_group_info = create_listing_group_info(
client,
client.enums.ListingGroupTypeEnum.SUBDIVISION,
root_resource_name,
other_hotels_listing_dimension_info,
)
# Create an ad group criterion for other hotel classes.
other_hotels_ad_group_criterion = create_ad_group_criterion(
client,
customer_id,
ad_group_id,
other_hotels_subdivision_listing_group_info,
percent_cpc_bid_micro_amount,
)
# Create an operation and add it to the list of operations.
other_hotels_ad_group_criterion_operation = client.get_type(
"AdGroupCriterionOperation"
)
client.copy_from(
other_hotels_ad_group_criterion_operation.create,
other_hotels_ad_group_criterion,
)
operations.append(other_hotels_ad_group_criterion_operation)
# Decrement the temp ID for the next ad group criterion.
next_temp_id -= 1
return other_hotels_ad_group_criterion.resource_name
小茹
def add_level1_nodes(
client,
customer_id,
ad_group_id,
root_resource_name,
operations,
percent_cpc_bid_micro_amount)
# Creates hotel class info and dimension info for 5-star hotels.
five_starred_dimension_info = client.resource.listing_dimension_info do |d|
d.hotel_class = client.resource.hotel_class_info do |c|
c.value = 5
end
end
# Creates listing group info for 5-star hotels as a UNIT node.
five_starred_unit = create_listing_group_info(
client,
:UNIT,
root_resource_name,
five_starred_dimension_info,
)
# Creates an ad group criterion for 5-star hotels.
five_starred_ad_group_criterion = create_ad_group_criterion(
client,
customer_id,
ad_group_id,
five_starred_unit,
percent_cpc_bid_micro_amount,
)
operations << generate_create_operation(
client,
five_starred_ad_group_criterion,
)
# You can also create more UNIT nodes for other hotel classes by copying the
# above code in this method and modifying the value passed to HotelClassInfo()
# to the value you want.
# For instance, passing 4 instead of 5 in the above code will create a UNIT
# node of 4-star hotels instead.
# Creates hotel class info and dimension info for other hotel classes
# by *not* specifying any attributes on those object.
other_hotels_dimention_info = client.resource.listing_dimension_info do |d|
d.hotel_class = client.resource.hotel_class_info
end
# Creates listing group info for other hotel classes as a SUBDIVISION node,
# which will be used as a parent node for children nodes of the next level.
other_hotels_subdivision = create_listing_group_info(
client,
:SUBDIVISION,
root_resource_name,
other_hotels_dimention_info,
)
# Creates an ad group criterion for other hotel classes.
other_hotels_ad_group_criterion = create_ad_group_criterion(
client,
customer_id,
ad_group_id,
other_hotels_subdivision,
percent_cpc_bid_micro_amount,
)
operations << generate_create_operation(
client,
other_hotels_ad_group_criterion,
)
other_hotels_ad_group_criterion.resource_name
end
Perl
sub add_level_1_nodes {
my ($customer_id, $ad_group_id, $root_resource_name, $operations,
$percent_cpc_bid_micro_amount)
= @_;
# Create hotel class info and dimension info for 5-star hotels.
my $five_starred_dimension_info =
Google::Ads::GoogleAds::V17::Common::ListingDimensionInfo->new({
hotelClass => Google::Ads::GoogleAds::V17::Common::HotelClassInfo->new({
value => 5
})});
# Create listing group info for 5-star hotels as a UNIT node.
my $five_starred_unit = create_listing_group_info(UNIT, $root_resource_name,
$five_starred_dimension_info);
# Create an ad group criterion for 5-star hotels.
my $five_starred_ad_group_criterion =
create_ad_group_criterion($customer_id, $ad_group_id, $five_starred_unit,
$percent_cpc_bid_micro_amount);
my $operation = generate_create_operation($five_starred_ad_group_criterion);
push @$operations, $operation;
# You can also create more UNIT nodes for other hotel classes by copying the
# above code in this method and modifying the value passed to HotelClassInfo
# to the value you want. For instance, passing 4 instead of 5 in the above code
# will create a UNIT node of 4-star hotels instead.
# Create hotel class info and dimension info for other hotel classes by *not*
# specifying any attributes on those object.
my $others_hotels_dimension_info =
Google::Ads::GoogleAds::V17::Common::ListingDimensionInfo->new({
hotelClass => Google::Ads::GoogleAds::V17::Common::HotelClassInfo->new()}
);
# Create listing group info for other hotel classes as a SUBDIVISION node, which
# will be used as a parent node for children nodes of the next level.
my $other_hotels_subdivision =
create_listing_group_info(SUBDIVISION, $root_resource_name,
$others_hotels_dimension_info);
# Create an ad group criterion for other hotel classes.
my $other_hotels_ad_group_criterion =
create_ad_group_criterion($customer_id, $ad_group_id,
$other_hotels_subdivision, $percent_cpc_bid_micro_amount);
$operation = generate_create_operation($other_hotels_ad_group_criterion);
push @$operations, $operation;
return $other_hotels_ad_group_criterion->{resourceName};
}
ListingDimensionsInfo 可用的維度
下列 ListingDimensionInfo 類型適用於飯店廣告：
臨時編號
廣告群組條件並未指定 ID，直到建立的 變更 請求為止
而會由伺服器處理。不過，ListingGroupInfo 在下列日期前無效：
因此，當您建立子產品群組時
至少有一個子項
為了讓您設定 parent_ad_group_criterion
對於子節點的 ListingGroupInfo，您可以使用
臨時條件編號。這些名稱在本機上獨有 (而非全域唯一性)
僅適用於單一 Mutate 請求情境的識別碼。不限
暫時 ID 可以使用負整數 (例如 -1)。
要求處理後，系統會為每個 AdGroupCriterion
系統會照常指派正值的全域 ID