Il s'agit d'un outil avancé qui permet d'informer les stratégies d'enchères intelligentes des variations attendues des taux de conversion pour des événements à venir. Pour en savoir plus sur le fonctionnement des ajustements de saisonnalité, consultez la page d'aide correspondante.
Créez un ajustement de saisonnalité par programmation à l'aide de BiddingSeasonalityAdjustments.
Définition du champ d'application
BiddingSeasonalityAdjustments sont associées à un scope obligatoire pouvant être défini sur les valeurs suivantes. Des options de configuration supplémentaires propres à un champ d'application sont définies en fonction du champ d'application utilisé.
CAMPAIGN: l'ajustement est appliqué à des campagnes spécifiques. Définissez le champcampaignssur une liste de noms de ressources de campagne auxquelles cet ajustement s'appliquera.BiddingSeasonalityAdjustmentpeut contenir jusqu'à 2 000 campagnes.
CHANNEL: l'ajustement est appliqué aux campagnes appartenant à des types de canaux spécifiques. Définissez le champadvertising_channel_typessur une liste deAdvertisingChannelTypesauxquels cet ajustement s'appliquera.
Appareils
En plus de leur champ d'application, vous pouvez configurer les ajustements de saisonnalité avec une liste facultative de types d'appareils auxquels l'ajustement s'appliquera. Si devices est défini, l'ajustement de saisonnalité n'est appliqué qu'au trafic provenant des types d'appareils spécifiés. Si aucune valeur n'est spécifiée, tous les types d'appareils sont inclus dans l'ajustement.
Dates, heures et modificateur du taux de conversion
En plus du champ d'application et des appareils facultatifs, chaque ajustement de saisonnalité est associé à start_date_time, end_date_time et conversion_rate_modifier.
La date et les heures définissent l'intervalle futur auquel l'ajustement s'applique, et le modificateur est le multiplicateur du taux de conversion attendu à appliquer. Elles correspondent au fuseau horaire du compte.
Exemple
L'exemple suivant montre comment créer un ajustement de saisonnalité avec une portée CHANNEL. Les sections commentées montrent comment spécifier des campagnes si vous devez plutôt définir un champ d'application 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;
}
PHP
// 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};