시즌성 조정은 향후 이벤트의 예상되는 전환율 변화를 스마트 자동 입찰에 알리는 데 사용할 수 있는 고급 도구입니다. 시즌성 조정의 작동 방식에 대한 자세한 내용은 시즌성 조정 도움말 페이지를 참고하세요.
BiddingSeasonalityAdjustments를 사용하여 프로그래매틱 방식으로 시즌성 조정을 만듭니다.
범위
BiddingSeasonalityAdjustments에는 다음 값으로 설정할 수 있는 필수 scope가 있습니다. 추가적인 범위별 구성 옵션은 사용되는 범위에 따라 설정됩니다.
CAMPAIGN- 조정이 특정 캠페인에 적용됩니다.campaigns필드를 이 조정을 적용할 캠페인 리소스 이름 목록으로 설정합니다.BiddingSeasonalityAdjustment당 최대 캠페인 수는 2,000개입니다.
CHANNEL- 특정 채널 유형에 속한 캠페인에 조정이 적용됩니다.advertising_channel_types필드를 이 조정이 적용될AdvertisingChannelTypes목록으로 설정합니다.
기기
범위 외에도 조정이 적용될 기기 유형 목록(선택사항)을 사용하여 시즌성 조정을 구성할 수 있습니다. devices가 설정된 경우 시즌성 조정은 지정된 기기 유형의 트래픽에만 적용됩니다. 지정하지 않으면 모든 기기 유형이 조정에 포함됩니다.
날짜, 시간, 전환율 조정
범위 및 선택적 기기 외에 각 시즌성 조정에는 start_date_time, end_date_time, conversion_rate_modifier가 있습니다.
날짜와 시간은 조정을 적용할 미래 간격을 정의하며, 수정자는 적용할 예상 전환율 배율입니다. 날짜 시간은 계정의 시간대입니다.
예
다음 예시는 CHANNEL 범위를 사용하여 시즌성 조정을 만드는 방법을 보여줍니다. 주석 처리된 섹션은 CAMPAIGN 범위를 대신 설정하는 경우 캠페인을 지정하는 방법을 보여줍니다.
Java
BiddingSeasonalityAdjustment seasonalityAdjustment =
BiddingSeasonalityAdjustment.newBuilder()
// A unique name is required for every seasonality adjustment.
.setName("Seasonality adjustment #" + getPrintableDateTime())
// The CHANNEL scope applies the conversionRateModifier to all campaigns of specific
// advertising channel types. In this example, the conversionRateModifier will only
// apply to Search campaigns. Use the CAMPAIGN scope to instead limit the scope to
// specific campaigns.
.setScope(SeasonalityEventScope.CHANNEL)
.addAdvertisingChannelTypes(AdvertisingChannelType.SEARCH)
// If setting scope CAMPAIGN, add individual campaign resource name(s) according to
// the commented out line below.
// .addCampaigns("INSERT_CAMPAIGN_RESOURCE_NAME_HERE")
.setStartDateTime(startDateTime)
.setEndDateTime(endDateTime)
// The conversionRateModifier is the expected future conversion rate change. When this
// field is unset or set to 1.0, no adjustment will be applied to traffic. The allowed
// range is 0.1 to 10.0.
.setConversionRateModifier(conversionRateModifier)
.build();
BiddingSeasonalityAdjustmentOperation operation =
BiddingSeasonalityAdjustmentOperation.newBuilder()
.setCreate(seasonalityAdjustment)
.build();
MutateBiddingSeasonalityAdjustmentsResponse response =
seasonalityAdjustmentServiceClient.mutateBiddingSeasonalityAdjustments(
customerId.toString(), ImmutableList.of(operation));
System.out.printf(
"Added seasonality adjustment with resource name: %s%n",
response.getResults(0).getResourceName());
C#
BiddingSeasonalityAdjustment seasonalityAdjustment =
new BiddingSeasonalityAdjustment()
{
// A unique name is required for every seasonality adjustment.
Name = "Seasonality adjustment #" + ExampleUtilities.GetRandomString(),
// The CHANNEL scope applies the conversionRateModifier to all campaigns of
// specific advertising channel types. In this example, the
// conversionRateModifier will only apply to Search campaigns. Use the
// CAMPAIGN scope to instead limit the scope to specific campaigns.
Scope = SeasonalityEventScope.Channel,
AdvertisingChannelTypes = { AdvertisingChannelType.Search },
// If setting scope CAMPAIGN, add individual campaign resource name(s)
// according to the commented out line below.
// Campaigns = { "INSERT_CAMPAIGN_RESOURCE_NAME_HERE" },
// The date range should be less than 14 days.
StartDateTime = startDateTime,
EndDateTime = endDateTime,
// The conversionRateModifier is the expected future conversion rate change.
// When this field is unset or set to 1.0, no adjustment will be applied to
// traffic. The allowed range is 0.1 to 10.0.
ConversionRateModifier = conversionRateModifier
};
BiddingSeasonalityAdjustmentOperation operation =
new BiddingSeasonalityAdjustmentOperation()
{
Create = seasonalityAdjustment
};
try
{
MutateBiddingSeasonalityAdjustmentsResponse response =
biddingSeasonalityAdjustmentService.MutateBiddingSeasonalityAdjustments(
customerId.ToString(), new[] { operation });
Console.WriteLine($"Added seasonality adjustment with resource name: " +
$"{response.Results[0].ResourceName}");
}
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필리핀
// Creates a bidding seasonality adjustment.
$seasonalityAdjustment = new BiddingSeasonalityAdjustment([
// A unique name is required for every seasonality adjustment.
'name' => 'Seasonality adjustment #' . Helper::getPrintableDatetime(),
// The CHANNEL scope applies the conversionRateModifier to all campaigns of specific
// advertising channel types. In this example, the conversionRateModifier will only
// apply to Search campaigns. Use the CAMPAIGN scope to instead limit the scope to
// specific campaigns.
'scope' => SeasonalityEventScope::CHANNEL,
'advertising_channel_types' => [AdvertisingChannelType::SEARCH],
// If setting scope CAMPAIGN, add individual campaign resource name(s) according to
// the commented out line below.
// 'campaigns' => ['INSERT_CAMPAIGN_RESOURCE_NAME_HERE'],
'start_date_time' => $startDateTime,
'end_date_time' => $endDateTime,
// The conversionRateModifier is the expected future conversion rate change. When this
// field is unset or set to 1.0, no adjustment will be applied to traffic. The allowed
// range is 0.1 to 10.0.
'conversion_rate_modifier' => $conversionRateModifier
]);
// Creates a bidding seasonality adjustment operation.
$biddingSeasonalityAdjustmentOperation = new BiddingSeasonalityAdjustmentOperation();
$biddingSeasonalityAdjustmentOperation->setCreate($seasonalityAdjustment);
// Submits the bidding seasonality adjustment operation to add the bidding seasonality
// adjustment.
$biddingSeasonalityAdjustmentServiceClient =
$googleAdsClient->getBiddingSeasonalityAdjustmentServiceClient();
$response = $biddingSeasonalityAdjustmentServiceClient->mutateBiddingSeasonalityAdjustments(
MutateBiddingSeasonalityAdjustmentsRequest::build(
$customerId,
[$biddingSeasonalityAdjustmentOperation]
)
);
printf(
"Added seasonality adjustment with resource name: '%s'.%s",
$response->getResults()[0]->getResourceName(),
PHP_EOL
);
Python
bidding_seasonality_adjustment_service = client.get_service(
"BiddingSeasonalityAdjustmentService"
)
operation = client.get_type("BiddingSeasonalityAdjustmentOperation")
bidding_seasonality_adjustment = operation.create
# A unique name is required for every seasonality adjustment.
bidding_seasonality_adjustment.name = f"Seasonality adjustment #{uuid4()}"
# The CHANNEL scope applies the conversion_rate_modifier to all campaigns of
# specific advertising channel types. In this example, the
# conversion_rate_modifier will only apply to Search campaigns. Use the
# CAMPAIGN scope to instead limit the scope to specific campaigns.
bidding_seasonality_adjustment.scope = (
client.enums.SeasonalityEventScopeEnum.CHANNEL
)
bidding_seasonality_adjustment.advertising_channel_types.append(
client.enums.AdvertisingChannelTypeEnum.SEARCH
)
# If setting scope CAMPAIGN, add individual campaign resource name(s)
# according to the commented out line below.
#
# bidding_seasonality_adjustment.campaigns.append(
# "INSERT_CAMPAIGN_RESOURCE_NAME_HERE"
# )
bidding_seasonality_adjustment.start_date_time = start_date_time
bidding_seasonality_adjustment.end_date_time = end_date_time
# The conversion_rate_modifier is the expected future conversion rate
# change. When this field is unset or set to 1.0, no adjustment will be
# applied to traffic. The allowed range is 0.1 to 10.0.
bidding_seasonality_adjustment.conversion_rate_modifier = (
conversion_rate_modifier
)
response = bidding_seasonality_adjustment_service.mutate_bidding_seasonality_adjustments(
customer_id=customer_id, operations=[operation]
)
resource_name = response.results[0].resource_name
print(f"Added seasonality adjustment with resource name: '{resource_name}'")
Ruby
client = Google::Ads::GoogleAds::GoogleAdsClient.new
operation = client.operation.create_resource.bidding_seasonality_adjustment do |bsa|
# A unique name is required for every seasonality adjustment.
bsa.name = "Seasonality Adjustment #{(Time.new.to_f * 1000).to_i}"
# The CHANNEL scope applies the conversion_rate_modifier to all campaigns
# of specific advertising channel types. In this example, the
# conversion_rate_modifier will only apply to Search campaigns. Use the
# CAMPAIGN scope to instead limit the scope to specific campaigns.
bsa.scope = :CHANNEL
bsa.advertising_channel_types << :SEARCH
# If setting scope CAMPAIGN, add individual campaign resource name(s)
# according to the commented out line below.
#
# bsa.campaigns << "INSERT_CAMPAIGN_RESOURCE_NAME_HERE"
bsa.start_date_time = start_date_time
bsa.end_date_time = end_date_time
# The conversion_rate_modifier is the expected future conversion rate
# change. When this field is unset or set to 1.0, no adjustment will be
# applied to traffic. The allowed range is 0.1 to 10.0.
bsa.conversion_rate_modifier = conversion_rate_modifier
end
response = client.service.bidding_seasonality_adjustment.mutate_bidding_seasonality_adjustments(
customer_id: customer_id,
operations: [operation],
)
puts "Added seasonality adjustment with resource name #{response.results.first.resource_name}"
Perl
my $seasonality_adjustment =
Google::Ads::GoogleAds::V16::Resources::BiddingSeasonalityAdjustment->new({
# A unique name is required for every seasonality adjustment.
name => "Seasonality adjustment #" . uniqid(),
# The CHANNEL scope applies the conversion_rate_modifier to all campaigns
# of specific advertising channel types. In this example, the conversion_rate_modifier
# will only apply to Search campaigns. Use the CAMPAIGN scope to instead
# limit the scope to specific campaigns.
scope => CHANNEL,
advertisingChannelTypes => [SEARCH],
# If setting scope CAMPAIGN, add individual campaign resource name(s)
# according to the commented out line below.
# campaigns => ["INSERT_CAMPAIGN_RESOURCE_NAME_HERE"],
startDateTime => $start_date_time,
endDateTime => $end_date_time,
# The conversion_rate_modifier is the expected future conversion rate change.
# When this field is unset or set to 1.0, no adjustment will be applied to traffic.
# The allowed range is 0.1 to 10.0.
conversionRateModifier => $conversion_rate_modifier
});
my $operation =
Google::Ads::GoogleAds::V16::Services::BiddingSeasonalityAdjustmentService::BiddingSeasonalityAdjustmentOperation
->new({
create => $seasonality_adjustment
});
my $response = $api_client->BiddingSeasonalityAdjustmentService()->mutate({
customerId => $customer_id,
operations => [$operation]});
printf "Added seasonality adjustment with resource name: '%s'.\n",
$response->{results}[0]{resourceName};