Punteggio di ottimizzazione e consigli

ondemand_video Video: approfondimento

I consigli possono migliorare le tue campagne in diversi modi:

• Introduci funzionalità nuove e pertinenti
• Ottimizza il budget con offerte, parole chiave e annunci migliorati
• Aumentare il rendimento e l'efficienza complessivi delle campagne

Per aumentare i punteggi di ottimizzazione, puoi utilizzare RecommendationService per recuperare i consigli, quindi applicarli o ignorarli di conseguenza. Puoi anche scegliere di applicare automaticamente i consigli utilizzando RecommendationSubscriptionService.

Punteggio di ottimizzazione

ondemand_video Video: punteggio di ottimizzazione

Il punteggio di ottimizzazione è una stima del livello di efficacia del rendimento del tuo account Google Ads ed è disponibile a livello di Customer e Campaign.

Customer.optimization_score_weight è disponibile solo per gli account diversi dall'account amministratore e viene utilizzato per calcolare il punteggio di ottimizzazione complessivo di più account. Recupera il punteggio di ottimizzazione e il relativo peso degli account e moltiplicali tra loro (Customer.optimization_score * Customer.optimization_score_weight) per calcolare il punteggio di ottimizzazione complessivo.

Per i report customer e campaign sono disponibili le seguenti metriche relative all'ottimizzazione:

1. metrics.optimization_score_url fornisce un link diretto all'account per visualizzare le informazioni sui consigli correlati nell'interfaccia utente di Google Ads.
2. metrics.optimization_score_uplift indica di quanto aumenterebbe il punteggio di ottimizzazione se venissero applicati tutti i consigli correlati. Si tratta di una stima basata su tutti i consigli disponibili nel loro complesso, non solo sulla somma dei punteggi di incremento per ogni consiglio.

Per raggruppare e ordinare i consigli restituiti, puoi segmentare entrambe queste metriche in base al tipo di consiglio utilizzando segments.recommendation_type nella query.

Tipi di suggerimento

Recuperare i consigli

ondemand_video Video: programmazione in tempo reale

Come la maggior parte delle altre entità nell'API Google Ads, gli oggetti Recommendation vengono recuperati utilizzando GoogleAdsService.SearchStream con una query in linguaggio di query di Google Ads.

Per ogni tipo di consiglio, i dettagli vengono forniti in un campo specifico per i consigli. Ad esempio, i dettagli del consiglio CAMPAIGN_BUDGET sono nel campo campaign_budget_recommendation e sono racchiusi in un oggetto CampaignBudgetRecommendation.

Trova tutti i campi specifici per i consigli nel campo unione recommendation.

Impatto dei consigli

Alcuni tipi di consigli compilano il impact campo del consiglio. RecommendationImpact contiene una stima dell'impatto sull'account derivante dall'applicazione del consiglio. Nei campi impact.base_metrics e impact.potential_metrics sono disponibili le seguenti metriche dei consigli:

• impressions

• clicks

• cost_micros

• conversions

• all_conversions

• video_views

Esempio di codice

Il seguente codice di esempio recupera da un account tutti i consigli disponibili e ignorati di tipo KEYWORD e stampa alcuni dei relativi dettagli:

try (GoogleAdsServiceClient googleAdsServiceClient =
        googleAdsClient.getLatestVersion().createGoogleAdsServiceClient();
    RecommendationServiceClient recommendationServiceClient =
        googleAdsClient.getLatestVersion().createRecommendationServiceClient()) {
  // Creates a query that retrieves keyword recommendations.
  String query =
      "SELECT recommendation.resource_name, "
          + "  recommendation.campaign, "
          + "  recommendation.keyword_recommendation "
          + "FROM recommendation "
          + "WHERE recommendation.type = KEYWORD";
  // Constructs the SearchGoogleAdsStreamRequest.
  SearchGoogleAdsStreamRequest request =
      SearchGoogleAdsStreamRequest.newBuilder()
          .setCustomerId(Long.toString(customerId))
          .setQuery(query)
          .build();

  // Issues the search stream request to detect keyword recommendations that exist for the
  // customer account.
  ServerStream<SearchGoogleAdsStreamResponse> stream =
      googleAdsServiceClient.searchStreamCallable().call(request);

  // Creates apply operations for all the recommendations found.
  List<ApplyRecommendationOperation> applyRecommendationOperations = new ArrayList<>();
  for (SearchGoogleAdsStreamResponse response : stream) {
    for (GoogleAdsRow googleAdsRow : response.getResultsList()) {
      Recommendation recommendation = googleAdsRow.getRecommendation();
      System.out.printf(
          "Keyword recommendation '%s' was found for campaign '%s'%n",
          recommendation.getResourceName(), recommendation.getCampaign());
      KeywordInfo keyword = recommendation.getKeywordRecommendation().getKeyword();
      System.out.printf("\tKeyword = '%s'%n", keyword.getText());
      System.out.printf("\tMatch type = '%s'%n", keyword.getMatchType());

      // Creates an ApplyRecommendationOperation that will apply this recommendation, and adds
      // it to the list of operations.
      applyRecommendationOperations.add(buildRecommendationOperation(recommendation));
    }
  }
DetectAndApplyRecommendations.java
      

// Get the GoogleAdsServiceClient.
GoogleAdsServiceClient googleAdsService = client.GetService(
    Services.V18.GoogleAdsService);

// Creates a query that retrieves keyword recommendations.
string query = "SELECT recommendation.resource_name, " +
    "recommendation.campaign, recommendation.keyword_recommendation " +
    "FROM recommendation WHERE " +
    $"recommendation.type = KEYWORD";

List<ApplyRecommendationOperation> operations =
    new List<ApplyRecommendationOperation>();

try
{
    // Issue a search request.
    googleAdsService.SearchStream(customerId.ToString(), query,
        delegate (SearchGoogleAdsStreamResponse resp)
        {
            Console.WriteLine($"Found {resp.Results.Count} recommendations.");
            foreach (GoogleAdsRow googleAdsRow in resp.Results)
            {
                Recommendation recommendation = googleAdsRow.Recommendation;
                Console.WriteLine("Keyword recommendation " +
                    $"{recommendation.ResourceName} was found for campaign " +
                    $"{recommendation.Campaign}.");

                if (recommendation.KeywordRecommendation != null)
                {
                    KeywordInfo keyword =
                        recommendation.KeywordRecommendation.Keyword;
                    Console.WriteLine($"Keyword = {keyword.Text}, type = " +
                        "{keyword.MatchType}");
                }

                operations.Add(
                    BuildApplyRecommendationOperation(recommendation.ResourceName)
                );
            }
        }
    );
}
catch (GoogleAdsException e)
{
    Console.WriteLine("Failure:");
    Console.WriteLine($"Message: {e.Message}");
    Console.WriteLine($"Failure: {e.Failure}");
    Console.WriteLine($"Request ID: {e.RequestId}");
    throw;
}
DetectAndApplyRecommendations.cs
      

$googleAdsServiceClient = $googleAdsClient->getGoogleAdsServiceClient();
// Creates a query that retrieves keyword recommendations.
$query = 'SELECT recommendation.resource_name, recommendation.campaign, '
    . 'recommendation.keyword_recommendation '
    . 'FROM recommendation '
    . 'WHERE recommendation.type = KEYWORD ';
// Issues a search request to detect keyword recommendations that exist for the
// customer account.
$response =
    $googleAdsServiceClient->search(SearchGoogleAdsRequest::build($customerId, $query));

$operations = [];
// Iterates over all rows in all pages and prints the requested field values for
// the recommendation in each row.
foreach ($response->iterateAllElements() as $googleAdsRow) {
    /** @var GoogleAdsRow $googleAdsRow */
    $recommendation = $googleAdsRow->getRecommendation();
    printf(
        "Keyword recommendation with resource name '%s' was found for campaign "
        . "with resource name '%s':%s",
        $recommendation->getResourceName(),
        $recommendation->getCampaign(),
        PHP_EOL
    );
    if (!is_null($recommendation->getKeywordRecommendation())) {
        $keyword = $recommendation->getKeywordRecommendation()->getKeyword();
        printf(
            "\tKeyword = '%s'%s\ttype = '%s'%s",
            $keyword->getText(),
            PHP_EOL,
            KeywordMatchType::name($keyword->getMatchType()),
            PHP_EOL
        );
    }
    // Creates an ApplyRecommendationOperation that will be used to apply this
    // recommendation, and adds it to the list of operations.
    $operations[] = self::buildRecommendationOperation($recommendation->getResourceName());
}
DetectAndApplyRecommendations.php
      

googleads_service = client.get_service("GoogleAdsService")
query = f"""
    SELECT
      recommendation.campaign,
      recommendation.keyword_recommendation
    FROM recommendation
    WHERE
      recommendation.type = KEYWORD"""

# Detects keyword recommendations that exist for the customer account.
response = googleads_service.search(customer_id=customer_id, query=query)

operations = []
for row in response.results:
    recommendation = row.recommendation
    print(
        f"Keyword recommendation ('{recommendation.resource_name}') "
        f"was found for campaign '{recommendation.campaign}."
    )

    keyword = recommendation.keyword_recommendation.keyword
    print(
        f"\tKeyword = '{keyword.text}'\n" f"\tType = '{keyword.match_type}'"
    )

    # Create an ApplyRecommendationOperation that will be used to apply
    # this recommendation, and add it to the list of operations.
    operations.append(
        build_recommendation_operation(client, recommendation.resource_name)
    )
detect_and_apply_recommendations.py
      

query = <<~QUERY
  SELECT recommendation.resource_name, recommendation.campaign,
      recommendation.keyword_recommendation
  FROM recommendation
  WHERE recommendation.type = KEYWORD
QUERY

google_ads_service = client.service.google_ads

response = google_ads_service.search(
  customer_id: customer_id,
  query: query,
)

operations = response.each do |row|
  recommendation = row.recommendation

  puts "Keyword recommendation ('#{recommendation.resource_name}') was found for "\
    "campaign '#{recommendation.campaign}'."

  if recommendation.keyword_recommendation
    keyword = recommendation.keyword_recommendation.keyword
    puts "\tKeyword = '#{keyword.text}'"
    puts "\ttype = '#{keyword.match_type}'"
  end

  build_recommendation_operation(client, recommendation.resource_name)
end
detect_and_apply_recommendations.rb
      

# Create the search query.
my $search_query =
  "SELECT recommendation.resource_name, " .
  "recommendation.campaign, recommendation.keyword_recommendation " .
  "FROM recommendation " .
  "WHERE recommendation.type = KEYWORD";

# Get the GoogleAdsService.
my $google_ads_service = $api_client->GoogleAdsService();

my $search_stream_handler =
  Google::Ads::GoogleAds::Utils::SearchStreamHandler->new({
    service => $google_ads_service,
    request => {
      customerId => $customer_id,
      query      => $search_query
    }});

# Create apply operations for all the recommendations found.
my $apply_recommendation_operations = ();
$search_stream_handler->process_contents(
  sub {
    my $google_ads_row = shift;
    my $recommendation = $google_ads_row->{recommendation};
    printf "Keyword recommendation '%s' was found for campaign '%s'.\n",
      $recommendation->{resourceName}, $recommendation->{campaign};
    my $keyword = $recommendation->{keywordRecommendation}{keyword};
    printf "\tKeyword = '%s'\n",    $keyword->{text};
    printf "\tMatch type = '%s'\n", $keyword->{matchType};
    # Creates an ApplyRecommendationOperation that will apply this recommendation, and adds
    # it to the list of operations.
    push @$apply_recommendation_operations,
      build_recommendation_operation($recommendation);
  });
detect_and_apply_recommendations.pl
      

Intervieni

Qualsiasi consiglio recuperato può essere applicato o ignorato.

A seconda del tipo, i consigli possono cambiare su base giornaliera o anche più volte al giorno. In questo caso, resource_name di un oggetto consiglio può diventare obsoleto dopo il recupero del consiglio.

È buona norma intervenire in base ai consigli poco dopo il recupero.

Applicare i consigli

ondemand_video Video: applicare i consigli

Puoi applicare i consigli attivi o ignorati con il metodo ApplyRecommendation del RecommendationService.

I tipi di consigli possono avere parametri obbligatori o facoltativi. La maggior parte delle raccomandazioni è dotata di valori consigliati che vengono utilizzati per impostazione predefinita.

L'impostazione degli account per l'applicazione automatica dei consigli non è supportata per tutti i tipi di consiglio. Tuttavia, puoi implementare un comportamento simile per i tipi di consigli completamente supportati dall'API Google Ads. Per scoprire di più, consulta l'esempio di codice DetectAndApplyRecommendations.

Utilizza il campo unione apply_parameters ApplyRecommendationOperation per applicare consigli con valori parametro specifici. Ogni tipo di consiglio adatto ha il proprio campo. Qualsiasi tipo di consiglio non elencato nel campo apply_parameters non utilizza questi valori di parametro.

Esempio di codice

Il codice seguente mostra come creare il messaggio ApplyRecommendationOperation e come ignorare i valori consigliati se vuoi sostituirli con i tuoi.

/** Creates and returns an ApplyRecommendationOperation to apply the given recommendation. */
private ApplyRecommendationOperation buildRecommendationOperation(Recommendation recommendation) {
  // If you have a recommendation ID instead of a resource name, you can create a resource name
  // like this:
  // String resourceName = ResourceNames.recommendation(customerId, recommendationId);

  // Creates a builder to construct the operation.
  Builder operationBuilder = ApplyRecommendationOperation.newBuilder();

  // Each recommendation type has optional parameters to override the recommended values. Below is
  // an example showing how to override a recommended ad when a TextAdRecommendation is applied.
  // operationBuilder.getTextAdBuilder().getAdBuilder().setResourceName("INSERT_AD_RESOURCE_NAME");

  // Sets the operation's resource name to the resource name of the recommendation to apply.
  operationBuilder.setResourceName(recommendation.getResourceName());
  return operationBuilder.build();
}
DetectAndApplyRecommendations.java
      

private ApplyRecommendationOperation BuildApplyRecommendationOperation(
    string recommendationResourceName
)
{
    // If you have a recommendation_id instead of the resource_name you can create a
    // resource name from it like this:
    // string recommendationResourceName =
    //    ResourceNames.Recommendation(customerId, recommendationId)

    // Each recommendation type has optional parameters to override the recommended values.
    // This is an example to override a recommended ad when a TextAdRecommendation is
    // applied.
    // For details, please read
    // https://developers.google.com/google-ads/api/reference/rpc/latest/ApplyRecommendationOperation.
    /*
    Ad overridingAd = new Ad()
    {
        Id = "INSERT_AD_ID_AS_LONG_HERE"
    };
    applyRecommendationOperation.TextAd = new TextAdParameters()
    {
        Ad = overridingAd
    };
    */

    ApplyRecommendationOperation applyRecommendationOperation =
    new ApplyRecommendationOperation()
    {
        ResourceName = recommendationResourceName
    };

    return applyRecommendationOperation;
}
DetectAndApplyRecommendations.cs
      

private static function buildRecommendationOperation(
    string $recommendationResourceName
): ApplyRecommendationOperation {
    // If you have a recommendation_id instead of the resource name, you can create a resource
    // name from it like this:
    /*
    $recommendationResourceName =
        ResourceNames::forRecommendation($customerId, $recommendationId);
    */

    // Each recommendation type has optional parameters to override the recommended values.
    // This is an example to override a recommended ad when a TextAdRecommendation is applied.
    // For details, please read
    // https://developers.google.com/google-ads/api/reference/rpc/latest/ApplyRecommendationOperation.
    /*
    $overridingAd = new Ad([
        'id' => 'INSERT_AD_ID_AS_INTEGER_HERE'
    ]);
    $applyRecommendationOperation->setTextAd(new TextAdParameters(['ad' => $overridingAd]));
    */

    // Issues a mutate request to apply the recommendation.
    $applyRecommendationOperation = new ApplyRecommendationOperation();
    $applyRecommendationOperation->setResourceName($recommendationResourceName);
    return $applyRecommendationOperation;
}
DetectAndApplyRecommendations.php
      

def build_recommendation_operation(client, recommendation):
    """Creates a ApplyRecommendationOperation to apply the given recommendation.

    Args:
        client: an initialized GoogleAdsClient instance.
        customer_id: a client customer ID.
        recommendation: a resource name for the recommendation to be applied.
    """
    # If you have a recommendation ID instead of a resource name, you can create
    # a resource name like this:
    #
    # googleads_service = client.get_service("GoogleAdsService")
    # resource_name = googleads_service.recommendation_path(
    #   customer_id, recommendation.id
    # )

    operation = client.get_type("ApplyRecommendationOperation")

    # Each recommendation type has optional parameters to override the
    # recommended values. Below is an example showing how to override a
    # recommended ad when a TextAdRecommendation is applied.
    #
    # operation.text_ad.ad.resource_name = "INSERT_AD_RESOURCE_NAME"
    #
    # For more details, see:
    # https://developers.google.com/google-ads/api/reference/rpc/latest/ApplyRecommendationOperation#apply_parameters

    operation.resource_name = recommendation
    return operation
detect_and_apply_recommendations.py
      

def build_recommendation_operation(client, recommendation)
  # If you have a recommendation_id instead of the resource_name
  # you can create a resource name from it like this:
  # recommendation_resource =
  #    client.path.recommendation(customer_id, recommendation_id)

  operations = client.operation.apply_recommendation
  operations.resource_name = recommendation_resource

  # Each recommendation type has optional parameters to override the recommended
  # values. This is an example to override a recommended ad when a
  # TextAdRecommendation is applied.
  #
  # text_ad_parameters = client.resource.text_ad_parameters do |tap|
  #   tap.ad = client.resource.ad do |ad|
  #     ad.id = "INSERT_AD_ID_AS_INTEGER_HERE"
  #   end
  # end
  # operation.text_ad = text_ad_parameters
  #
  # For more details, see:
  # https://developers.google.com/google-ads/api/reference/rpc/latest/ApplyRecommendationOperation#apply_parameters

  return operation
end
detect_and_apply_recommendations.rb
      

sub build_recommendation_operation {
  my ($recommendation) = @_;

  # If you have a recommendation ID instead of a resource name, you can create a resource
  # name like this:
  # my $recommendation_resource_name =
  #   Google::Ads::GoogleAds::V18::Utils::ResourceNames::recommendation(
  #   $customer_id, $recommendation_id);

  # Each recommendation type has optional parameters to override the recommended values.
  # Below is an example showing how to override a recommended ad when a TextAdRecommendation
  # is applied.
  # my $overriding_ad = Google::Ads::GoogleAds::V18::Resources::Ad->new({
  #   id => "INSERT_AD_ID_AS_INTEGER_HERE"
  # });
  # my $text_ad_parameters =
  #   Google::Ads::GoogleAds::V18::Services::RecommendationService::TextAdParameters
  #   ->new({ad => $overriding_ad});
  # $apply_recommendation_operation->{textAd} = $text_ad_parameters;

  # Create an apply recommendation operation.
  my $apply_recommendation_operation =
    Google::Ads::GoogleAds::V18::Services::RecommendationService::ApplyRecommendationOperation
    ->new({
      resourceName => $recommendation->{resourceName}});

  return $apply_recommendation_operation;
}
detect_and_apply_recommendations.pl
      

L'esempio seguente chiama ApplyRecommendation inviando le operazioni di applicazione dei consigli create nel codice precedente.

// Issues a mutate request to apply the recommendations.
ApplyRecommendationResponse applyRecommendationsResponse =
    recommendationServiceClient.applyRecommendation(
        Long.toString(customerId), applyRecommendationOperations);
for (ApplyRecommendationResult applyRecommendationResult :
    applyRecommendationsResponse.getResultsList()) {
  System.out.printf(
      "Applied recommendation with resource name: '%s'.%n",
      applyRecommendationResult.getResourceName());
}
DetectAndApplyRecommendations.java
      

private void ApplyRecommendation(GoogleAdsClient client, long customerId,
    List<ApplyRecommendationOperation> operations)
{
    // Get the RecommendationServiceClient.
    RecommendationServiceClient recommendationService = client.GetService(
        Services.V18.RecommendationService);

    ApplyRecommendationRequest applyRecommendationRequest = new ApplyRecommendationRequest()
    {
        CustomerId = customerId.ToString(),
    };

    applyRecommendationRequest.Operations.AddRange(operations);

    ApplyRecommendationResponse response =
        recommendationService.ApplyRecommendation(applyRecommendationRequest);
    foreach (ApplyRecommendationResult result in response.Results)
    {
        Console.WriteLine("Applied a recommendation with resource name: " +
            result.ResourceName);
    }
}
DetectAndApplyRecommendations.cs
      

private static function applyRecommendations(
    GoogleAdsClient $googleAdsClient,
    int $customerId,
    array $operations
): void {
    // Issues a mutate request to apply the recommendations.
    $recommendationServiceClient = $googleAdsClient->getRecommendationServiceClient();
    $response = $recommendationServiceClient->applyRecommendation(
        ApplyRecommendationRequest::build($customerId, $operations)
    );
    foreach ($response->getResults() as $appliedRecommendation) {
        /** @var Recommendation $appliedRecommendation */
        printf(
            "Applied a recommendation with resource name: '%s'.%s",
            $appliedRecommendation->getResourceName(),
            PHP_EOL
        );
    }
}
DetectAndApplyRecommendations.php
      

def apply_recommendations(client, customer_id, operations):
    """Applies a batch of recommendations.

    Args:
        client: an initialized GoogleAdsClient instance.
        customer_id: a client customer ID.
        operations: a list of ApplyRecommendationOperation messages.
    """
    # Issues a mutate request to apply the recommendations.
    recommendation_service = client.get_service("RecommendationService")
    response = recommendation_service.apply_recommendation(
        customer_id=customer_id, operations=operations
    )

    for result in response.results:
        print(
            "Applied a recommendation with resource name: "
            f"'{result[0].resource_name}'."
        )
detect_and_apply_recommendations.py
      

def apply_recommendations(client, customer_id, operations)
  # Issues a mutate request to apply the recommendation.
  recommendation_service = client.service.recommendation

  response = recommendation_service.apply_recommendation(
    customer_id: customer_id,
    operations: [operations],
  )

  response.results.each do |applied_recommendation|
    puts "Applied recommendation with resource name: '#{applied_recommendation.resource_name}'."
  end
end
detect_and_apply_recommendations.rb
      

# Issue a mutate request to apply the recommendations.
my $apply_recommendation_response =
  $api_client->RecommendationService()->apply({
    customerId => $customer_id,
    operations => $apply_recommendation_operations
  });

foreach my $result (@{$apply_recommendation_response->{results}}) {
  printf "Applied recommendation with resource name: '%s'.\n",
    $result->{resourceName};
}
detect_and_apply_recommendations.pl
      

Ignorare i consigli

ondemand_video Video: ignorare i consigli

Puoi ignorare i consigli con RecommendationService. La struttura del codice è simile all'applicazione dei consigli, ma utilizzi DismissRecommendationOperation e RecommendationService.DismissRecommendation.

Applicare automaticamente i consigli

Puoi utilizzare il pulsante RecommendationSubscriptionService per applicare automaticamente i consigli di un tipo specifico.

Per iscriverti a un determinato tipo di consiglio, crea un oggetto RecommendationSubscription, imposta il campo type su uno dei tipi di consigli supportati e imposta il campo status su ENABLED.

Recuperare gli abbonamenti

Per informazioni sugli abbonamenti ai consigli di un account, esegui una query sulla risorsa recommendation_subscription.

Per visualizzare le modifiche applicate automaticamente, esegui una query sulla risorsa change_event, filtrando change_event.client_type su GOOGLE_ADS_RECOMMENDATIONS_SUBSCRIPTION.

Consigli per la creazione delle campagne

Puoi utilizzare RecommendationService.GenerateRecommendationsRequest per generare consigli durante la creazione della campagna, per un determinato insieme di tipi di consigli.

GenerateRecommendations accetta come input un ID cliente, un tipo di canale pubblicitario che deve essere SEARCH o PERFORMANCE_MAX, un elenco di tipi di consigli da generare e vari punti dati dipendenti dai tipi specificati. Consente di generare un elenco di oggetti Recommendation in base ai dati forniti. Se non sono disponibili dati sufficienti per generare un consiglio per il recommendation_types richiesto o se la campagna è già nello stato consigliato, il set di risultati non conterrà un consiglio per quel tipo. Assicurati che la tua applicazione gestisca il caso in cui non vengano restituiti consigli per i tipi di consigli richiesti.

La tabella seguente descrive i tipi di consigli supportati da GenerateRecommendations e i campi che devi fornire per ricevere consigli di quel tipo. Come best practice, invia la richiestaGenerateRecommendations dopo aver raccolto tutte le informazioni relative ai tipi di consigli richiesti. Per ulteriori dettagli sui campi obbligatori e facoltativi, inclusi i campi nidificati, consulta la documentazione di riferimento.

Esempio di flusso di utilizzo

Supponiamo che la tua azienda sia un'agenzia pubblicitaria che fornisce agli utenti un flusso di lavoro per la creazione di campagne e che tu voglia offrire loro suggerimenti durante questo flusso. Puoi utilizzare GenerateRecommendationsRequest per generare consigli on demand e incorporarli nell'interfaccia utente per la creazione della campagna.

Il flusso di utilizzo potrebbe essere il seguente:

1. Un utente visita la tua applicazione per creare una campagna Performance Max.

2. L'utente fornisce alcune informazioni iniziali nell'ambito del flusso di creazione della campagna. Ad esempio, fornisce i dettagli per creare un singolo SitelinkAsset e seleziona TARGET_SPEND come strategia Smart Bidding.

3. Invii un GenerateRecommendationsRequest che imposta i seguenti campi:

   • campaign_sitelink_count: impostato su 1, ovvero il numero di asset sitelink della campagna in corso di elaborazione.

   • bidding_info: imposta il campo bidding_strategy_type nidificato su TARGET_SPEND.

   • conversion_tracking_status: impostato su ConversionTrackingStatus di questo cliente. Per indicazioni su come recuperare questo campo, consulta la Guida introduttiva alla gestione delle conversioni.

   • recommendation_types: impostato su [SITELINK_ASSET, MAXIMIZE_CLICKS_OPT_IN].

   • advertising_channel_type: impostato su PERFORMANCE_MAX.

   • customer_id: impostato sull'ID del cliente che crea la campagna.

4. Puoi utilizzare i consigli in GenerateRecommendationsResponse, in questo caso un SitelinkAssetRecommendation e un MaximizeClicksOptInRecommendation, e suggerirli all'utente mostrandoli nell'interfaccia di creazione della campagna. Se l'utente accetta un suggerimento, puoi incorporarlo nella richiesta di creazione della campagna una volta completato il flusso di creazione della campagna.