Creare esclusioni di dati

Punto chiave: le esclusioni di dati sono ideate per tenere conto di interruzioni o problemi critici. L'utilizzo frequente o per lunghi periodi di queste esclusioni potrebbe influire negativamente sul rendimento di Smart Bidding.

Le esclusioni di dati sono uno strumento avanzato che può essere utilizzato per indicare a Smart Bidding di ignorare tutti i dati relativi alle date in cui si sono verificati problemi con il monitoraggio delle conversioni di un account. Per ulteriori dettagli su come funzionano le esclusioni di dati, consulta la pagina di assistenza relativa alle esclusioni di dati.

Crea, aggiorna o rimuovi le esclusioni di dati a livello di programmazione utilizzando la BiddingDataExclusion risorsa e BiddingDataExclusionService.MutateBiddingDataExclusions con BiddingDataExclusionOperation (create, update, o remove; tieni presente che BiddingDataExclusion.status è di sola lettura/OUTPUT_ONLY). Non puoi creare un BiddingDataExclusion in un account amministratore; devi crearlo in un account di intermediazione con un ambito CAMPAIGN o CHANNEL.

Ambito

Un BiddingDataExclusion ha un scope obbligatorio che può essere impostato sui seguenti valori. Le opzioni di configurazione aggiuntive specifiche per l'ambito vengono impostate in base all'ambito utilizzato.

Nota: esiste anche un ambito CUSTOMER di sola lettura, ma non può essere utilizzato per creare nuove esclusioni di dati.

• CAMPAIGN: l'esclusione viene applicata a campagne specifiche. Imposta il campo campaigns su un elenco di nomi di risorse della campagna a cui verrà applicata questa esclusione.
• CHANNEL: l'esclusione viene applicata alle campagne che appartengono a tipi di canali specifici. Imposta il campo advertising_channel_types su un elenco di valori AdvertisingChannelType a cui verrà applicata questa esclusione.

Dispositivi

Oltre all'ambito, le esclusioni di dati possono essere configurate con un elenco facoltativo di tipi di dispositivi a cui verrà applicata l'esclusione. Se devices è impostato, vengono esclusi solo i dati sulle conversioni dei tipi di dispositivi specificati. Se non specificato, verranno esclusi i dati sulle conversioni di tutti i tipi di dispositivi.

Date e ore

Oltre all'ambito e ai dispositivi facoltativi, ogni esclusione di dati deve avere una data e un'ora di inizio e di fine nel formato yyyy-MM-dd HH:mm:ss. Un'esclusione di dati è retroattiva e deve essere utilizzata per gli eventi con un start_date_time nel passato e un end_date_time nel passato o nel futuro. Gli orari sono espressi nel fuso orario dell'account.

Limiti

Quando utilizzi le risorse BiddingDataExclusion, tieni presente i seguenti limiti:

• Un singolo BiddingDataExclusion può essere applicato a un massimo di 2000 campagne quando l'ambito è impostato su CAMPAIGN.
• Ogni account cliente, inclusi gli account amministratore e di test, può avere un massimo di 500 esclusioni di dati di offerta attive in un determinato momento. Il superamento di questo limite genera un errore RESOURCE_LIMIT.

Esempio

L'esempio seguente mostra come creare un'esclusione di dati con ambito CHANNEL. Le sezioni commentate mostrano come specificare le campagne se invece imposti un ambito 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());
AddBiddingDataExclusion.java
      

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;
}
AddBiddingDataExclusion.cs
      

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
);
AddBiddingDataExclusion.php
      

Python

bidding_data_exclusion_service: BiddingDataExclusionServiceClient = (
    client.get_service("BiddingDataExclusionService")
)
operation: BiddingDataExclusionOperation = client.get_type(
    "BiddingDataExclusionOperation"
)
bidding_data_exclusion: BiddingDataExclusion = 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: MutateBiddingDataExclusionsResponse = (
    bidding_data_exclusion_service.mutate_bidding_data_exclusions(
        customer_id=customer_id, operations=[operation]
    )
)

resource_name: str = response.results[0].resource_name

print(f"Added data exclusion with resource name: '{resource_name}'")
add_bidding_data_exclusion.py
      

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}."
add_bidding_data_exclusion.rb
      

Perl

my $data_exclusion =
  Google::Ads::GoogleAds::V26::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::V26::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};
add_bidding_data_exclusion.pl
      

curl

Nota: anche se qui non viene fornito un esempio di codice REST diretto per questo passaggio, puoi ottenerlo utilizzando una richiesta REST manuale.

Consulta la documentazione dell'interfaccia REST dell'API Google Ads e le pagine di riferimento specifiche per il metodo. Dovrai creare il payload JSON in base alle definizioni proto.

Key Resources:

• Using REST
• REST Interface Structure
• JSON Field Mappings
• Consulta il Riferimento API REST per il servizio e il metodo specifici.