Les exclusions de données sont un outil avancé qui permet aux stratégies d'enchères intelligentes d'ignorer toutes les données correspondant aux dates auxquelles le suivi des conversions d'un compte a rencontré des problèmes. Pour en savoir plus sur le fonctionnement des exclusions de données, consultez la page d'aide correspondante.
Créez des exclusions de données de manière automatisée à l'aide de BiddingDataExclusions.
Champ d'application
Les BiddingDataExclusions ont un élément scope obligatoire qui peut être défini sur les valeurs suivantes. D'autres options de configuration spécifiques au champ d'application sont définies en fonction du champ d'application utilisé.
CAMPAIGN: l'exclusion est appliquée à des campagnes spécifiques. Définissez le champcampaignssur une liste de noms de ressources de campagne auxquels cette exclusion s'appliquera.- Le nombre maximal de campagnes par
BiddingDataExclusionest de 2 000.
- Le nombre maximal de campagnes par
CHANNEL: l'exclusion est appliquée aux campagnes qui appartiennent à des types de canaux spécifiques. Définissez le champadvertising_channel_typessur une liste deAdvertisingChannelTypesauxquels cette exclusion s'appliquera.
Appareils
En plus de leur champ d'application, les exclusions de données peuvent être configurées avec une liste facultative des types d'appareils auxquels l'exclusion s'applique. Si devices est défini, seules les données de conversion des types d'appareils spécifiés sont exclues. Si aucune valeur n'est spécifiée, les données de conversion de tous les types d'appareils seront exclues.
Dates et heures
Hormis le champ d'application et les appareils facultatifs, chaque exclusion de données doit comporter une date et une heure de début et de fin. Une exclusion de données est rétroactive et doit être utilisée pour les événements qui ont un start_date_time dans le passé et un end_date_time dans le passé ou le futur. Les heures sont exprimées dans le fuseau horaire du compte.
Exemple
L'exemple suivant montre comment créer une exclusion de données avec le champ d'application CHANNEL.
Les sections commentées montrent comment spécifier des campagnes si vous définissez plutôt un champ d'application CAMPAIGN.
Java
BiddingDataExclusion DataExclusion =
BiddingDataExclusion.newBuilder()
// A unique name is required for every data exclusion.
.setName("Data exclusion #" + getPrintableDateTime())
// The CHANNEL scope applies the data exclusion to all campaigns of specific
// advertising channel types. In this example, the exclusion 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)
.build();
BiddingDataExclusionOperation operation =
BiddingDataExclusionOperation.newBuilder().setCreate(DataExclusion).build();
MutateBiddingDataExclusionsResponse response =
DataExclusionServiceClient.mutateBiddingDataExclusions(
customerId.toString(), ImmutableList.of(operation));
System.out.printf(
"Added data exclusion with resource name: %s%n",
response.getResults(0).getResourceName());
C#
BiddingDataExclusion dataExclusion = new BiddingDataExclusion()
{
// A unique name is required for every data exclusion.
Name = "Data exclusion #" + ExampleUtilities.GetRandomString(),
// The CHANNEL scope applies the data exclusion to all campaigns of specific
// advertising channel types. In this example, the the exclusion will only apply to
// Search campaigns. Use the CAMPAIGN scope to instead limit the scope to specific
// campaigns.
Scope = SeasonalityEventScope.Channel,
AdvertisingChannelTypes = { AdvertisingChannelType.Search },
// The date range should be less than 14 days.
StartDateTime = startDateTime,
EndDateTime = endDateTime,
};
BiddingDataExclusionOperation operation = new BiddingDataExclusionOperation()
{
Create = dataExclusion
};
try
{
MutateBiddingDataExclusionsResponse response =
biddingDataExclusionService.MutateBiddingDataExclusions(
customerId.ToString(), new[] { operation });
Console.WriteLine($"Added data exclusion 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 data exclusion.
$dataExclusion = new BiddingDataExclusion([
// A unique name is required for every data exclusion.
'name' => 'Data exclusion #' . Helper::getPrintableDatetime(),
// The CHANNEL scope applies the data exclusion to all campaigns of specific
// advertising channel types. In this example, the exclusion 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
]);
// Creates a bidding data exclusion operation.
$biddingDataExclusionOperation = new BiddingDataExclusionOperation();
$biddingDataExclusionOperation->setCreate($dataExclusion);
// Submits the bidding data exclusion operation to add the bidding data exclusion.
$biddingDataExclusionServiceClient =
$googleAdsClient->getBiddingDataExclusionServiceClient();
$response = $biddingDataExclusionServiceClient->mutateBiddingDataExclusions(
MutateBiddingDataExclusionsRequest::build($customerId, [$biddingDataExclusionOperation])
);
printf(
"Added bidding data exclusion with resource name: '%s'.%s",
$response->getResults()[0]->getResourceName(),
PHP_EOL
);
Python
bidding_data_exclusion_service = client.get_service(
"BiddingDataExclusionService"
)
operation = client.get_type("BiddingDataExclusionOperation")
bidding_data_exclusion = operation.create
# A unique name is required for every data exclusion
bidding_data_exclusion.name = f"Data exclusion #{uuid4()}"
# The CHANNEL scope applies the data exclusion to all campaigns of specific
# advertising channel types. In this example, the exclusion will only
# apply to Search campaigns. Use the CAMPAIGN scope to instead limit the
# scope to specific campaigns.
bidding_data_exclusion.scope = (
client.enums.SeasonalityEventScopeEnum.CHANNEL
)
bidding_data_exclusion.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_data_exclusion.campaigns.append(
# "INSERT_CAMPAIGN_RESOURCE_NAME_HERE"
# )
bidding_data_exclusion.start_date_time = start_date_time
bidding_data_exclusion.end_date_time = end_date_time
response = bidding_data_exclusion_service.mutate_bidding_data_exclusions(
customer_id=customer_id, operations=[operation]
)
resource_name = response.results[0].resource_name
print(f"Added data exclusion with resource name: '{resource_name}'")
Ruby
client = Google::Ads::GoogleAds::GoogleAdsClient.new
operation = client.operation.create_resource.bidding_data_exclusion do |bda|
# A unique name is required for every data excluseion.
bda.name = "Seasonality Adjustment #{(Time.new.to_f * 1000).to_i}"
# The CHANNEL scope applies the data exclusion 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.
bda.scope = :CHANNEL
bda.advertising_channel_types << :SEARCH
# If setting scope CAMPAIGN, add individual campaign resource name(s)
# according to the commented out line below.
#
# bda.campaigns << "INSERT_CAMPAIGN_RESOURCE_NAME_HERE"
bda.start_date_time = start_date_time
bda.end_date_time = end_date_time
end
response = client.service.bidding_data_exclusion.mutate_bidding_data_exclusions(
customer_id: customer_id,
operations: [operation],
)
puts "Added data exclusion with resource name #{response.results.first.resource_name}."
Perl
my $data_exclusion =
Google::Ads::GoogleAds::V17::Resources::BiddingDataExclusion->new({
# A unique name is required for every data exclusion.
name => "Data exclusion #" . uniqid(),
# The CHANNEL scope applies the data exclusion to all campaigns of specific
# advertising channel types. In this example, the exclusion 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
});
my $operation =
Google::Ads::GoogleAds::V17::Services::BiddingDataExclusionService::BiddingDataExclusionOperation
->new({
create => $data_exclusion
});
my $response = $api_client->BiddingDataExclusionService()->mutate({
customerId => $customer_id,
operations => [$operation]});
printf "Added data exclusion with resource name: '%s'.\n",
$response->{results}[0]{resourceName};