Optimizasyon puanı ve öneriler

ondemand_video Video: Ayrıntılı inceleme

Öneriler, kampanyalarınızı birkaç şekilde iyileştirebilir:

• Yeni ve alakalı özellikler tanıtın
• İyileştirilmiş teklifler, anahtar kelimeler ve reklamlarla bütçenizden daha fazla yararlanın
• Kampanyalarınızın genel performansını ve verimliliğini artırın

Optimizasyon puanlarını artırmak için RecommendationService'ü kullanarak önerileri alabilir ve ardından bunları uygun şekilde uygulayabilir veya reddedebilirsiniz. Ayrıca RecommendationSubscriptionService simgesini kullanarak önerileri otomatik olarak uygulama özelliğine abone olabilirsiniz.

Optimizasyon puanı

ondemand_video Video: Optimizasyon puanı

Optimizasyon puanı, Google Ads hesabınızın iyi performans sergileyecek şekilde ayarlanıp ayarlanmadığına dair bir tahmindir ve Customer ile Campaign düzeylerinde kullanılabilir.

Customer.optimization_score_weight yalnızca yönetici olmayan hesaplar tarafından kullanılabilir ve birden fazla hesabın toplam optimizasyon puanını hesaplamak için kullanılır. Hesapların optimizasyon puanını ve optimizasyon puanı ağırlığını alın ve toplam optimizasyon puanını hesaplamak için bunları çarpın (Customer.optimization_score * Customer.optimization_score_weight).

customer ve campaign raporları için optimizasyonla ilgili metrikler mevcuttur:

1. metrics.optimization_score_url, Google Ads kullanıcı arayüzünde ilgili önerilerle ilgili bilgileri görüntülemek için hesaba derin bağlantı sağlar.
2. metrics.optimization_score_uplift, ilgili tüm öneriler uygulanırsa optimizasyon puanının ne kadar artacağını gösterir. Bu, yalnızca her önerinin artış puanlarının toplamı değil, mevcut tüm önerileri bir bütün olarak temel alan bir tahmindir.

Döndürülen önerileri gruplandırmak ve sıralamak için sorgunuzda segments.recommendation_type kullanarak bu metriklerin ikisini de öneri türüne göre segmentlere ayırabilirsiniz.

Öneri türleri

Önerileri alma

ondemand_video Video: Canlı kodlama

Google Ads API'deki diğer öğelerin çoğu gibi Recommendation nesneleri de Google Ads Sorgu Dili sorgusuyla GoogleAdsService.SearchStream kullanılarak getirilir.

Her öneri türü için öneriye özel bir alanda ayrıntılar sağlanır. Örneğin, CAMPAIGN_BUDGET öneri ayrıntıları campaign_budget_recommendation alanındadır ve CampaignBudgetRecommendation nesnesine sarılmıştır.

Öneriye özgü tüm alanları recommendation birleştirme alanında bulabilirsiniz.

Öneri etkisi

Bazı öneri türleri, önerinin impact alanını doldurur. RecommendationImpact, önerinin uygulanmasının hesap performansı üzerindeki etkisine dair bir tahmin içerir. impact.base_metrics ve impact.potential_metrics alanlarında aşağıdaki öneri metrikleri kullanılabilir:

• impressions

• clicks

• cost_micros

• conversions

• all_conversions

• video_views

Kod örneği

Aşağıdaki örnek kod, bir hesaptaki KEYWORD türündeki tüm mevcut ve reddedilen önerileri alır ve ayrıntılarının bir kısmını yazdırır:

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
      

İşlem yapın

Alınan tüm öneriler uygulanabilir veya reddedilebilir.

Öneriler, öneri türüne bağlı olarak günlük olarak veya hatta günde birden çok kez değişebilir. Bu durumda, öneri nesnesinin resource_name değeri, öneri alındıktan sonra geçersiz hale gelebilir.

Öneriler alındıktan kısa bir süre sonra işlem yapmanız önerilir.

Önerileri uygula

ondemand_video Video: Önerileri uygulama

Etkin veya reddedilen önerileri RecommendationService sınıfının ApplyRecommendation yöntemiyle uygulayabilirsiniz.

Öneri türlerinde zorunlu veya isteğe bağlı parametreler olabilir. Çoğu öneri, varsayılan olarak kullanılan önerilen değerlerle birlikte gelir.

Hesapları önerileri otomatik olarak uygulama için ayarlama özelliği tüm öneri türleri için desteklenmemektedir. Ancak Google Ads API tarafından tam olarak desteklenen öneri türleri için benzer davranışları uygulayabilirsiniz. Daha fazla bilgi edinmek için DetectAndApplyRecommendations kod örneğine bakın.

Belirli parametre değerlerine sahip önerileri uygulamak için ApplyRecommendationOperation'ın apply_parameters birleştirme alanını kullanın. Her uygun öneri türünün kendi alanı vardır. apply_parameters alanında listelenmeyen öneri türleri bu parametre değerlerini kullanmaz.

Kod örneği

Aşağıdaki kodda, ApplyRecommendationOperation öğesinin nasıl oluşturulacağı ve önerilen değerleri kendi değerlerinizle değiştirmek isterseniz bunların nasıl geçersiz kılınacağı gösterilmektedir.

/** 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
      

Sonraki örnekte, önceki kodda oluşturulan öneri uygulama işlemlerini göndererek ApplyRecommendation çağrılıyor.

// 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
      

Önerileri kapatma

ondemand_video Video: Önerileri reddetme

Önerileri RecommendationService simgesini kullanarak reddedebilirsiniz. Kod yapısı, önerileri uygulamaya benzer ancak bunun yerine DismissRecommendationOperation ve RecommendationService.DismissRecommendation kullanılır.

Önerileri otomatik olarak uygulayın

Belirli bir türdeki önerileri otomatik olarak uygulamak için RecommendationSubscriptionService simgesini kullanabilirsiniz.

Belirli bir öneri türüne abone olmak için bir RecommendationSubscription nesnesi oluşturun, type alanını desteklenen öneri türlerinden birine ve status alanını ENABLED olarak ayarlayın.

Abonelikleri alma

Bir hesabın öneri abonelikleri hakkında bilgi edinmek için recommendation_subscription kaynağını sorgulayın.

Otomatik olarak uygulanan değişiklikleri görüntülemek için change_event.client_type kaynağını GOOGLE_ADS_RECOMMENDATIONS_SUBSCRIPTION olarak filtreleyerek change_event kaynağını sorgulayın.

Kampanya oluşturma sırasında sunulan öneriler

Belirli bir öneri türü grubu için kampanya oluşturma sırasında öneri oluşturmak üzere RecommendationService.GenerateRecommendationsRequest öğesini kullanabilirsiniz.

GenerateRecommendations, giriş olarak bir müşteri kimliği, SEARCH veya PERFORMANCE_MAX olması gereken bir reklam kanal türü, oluşturulacak öneri türlerinin bir listesini ve belirtilen türlere bağlı çeşitli veri noktalarını kabul eder. Sağladığınız verilere göre Recommendation nesnelerinin bir listesini döndürür. İstenen recommendation_types için öneri oluşturmaya yetecek kadar veri yoksa veya kampanya zaten önerilen durumdaysa sonuç kümesi bu tür için öneri içermez. Uygulamanızın, istenen öneri türleri için hiçbir öneri döndürülmediğinde bu durumu ele aldığından emin olun.

Aşağıdaki tabloda, GenerateRecommendations'ün desteklediği öneri türleri ve bu tür için öneri almak üzere sağlamanız gereken alanlar açıklanmaktadır. En iyi uygulama olarak, istenen öneri türleriyle ilgili tüm bilgiler toplandıktan sonra GenerateRecommendations isteğini gönderin. İç içe yerleştirilmiş alanlar da dahil olmak üzere zorunlu ve isteğe bağlı alanlar hakkında daha fazla bilgi için referans dokümanlarına bakın.

Örnek kullanım akışı

Şirketinizin, kullanıcılara kampanya oluşturma iş akışı sağlayan bir reklam ajansı olduğunu ve bu akış sırasında kullanıcılara öneriler sunmak istediğinizi varsayalım. İsteğe bağlı olarak öneri oluşturmak ve bu önerileri kampanya oluşturma kullanıcı arayüzünüze dahil etmek için GenerateRecommendationsRequest'i kullanabilirsiniz.

Kullanım akışı aşağıdaki gibi görünebilir:

1. Bir kullanıcı, Maksimum Performans kampanyası oluşturmak için uygulamanıza gelir.

2. Kullanıcı, kampanya oluşturma akışı kapsamında bazı başlangıç bilgilerini sağlar. Örneğin, tek bir SitelinkAsset oluşturmak için ayrıntılar sağlar ve Akıllı Teklif stratejisi olarak TARGET_SPEND'i seçer.

3. Aşağıdaki alanları ayarlayan bir GenerateRecommendationsRequest gönderirsiniz:

   • campaign_sitelink_count: Devam eden kampanyadaki site bağlantısı öğelerinin sayısı olan 1 olarak ayarlanır.

   • bidding_info: İç içe yerleştirilmiş bidding_strategy_type alanını TARGET_SPEND olarak ayarlayın.

   • conversion_tracking_status: Bu müşterinin ConversionTrackingStatus değerine ayarlanır. Bu alanın nasıl alınacağı hakkında bilgi edinmek için dönüşüm yönetimiyle ilgili Başlangıç kılavuzunu ziyaret edin.

   • recommendation_types: [SITELINK_ASSET, MAXIMIZE_CLICKS_OPT_IN] olarak ayarlandı.

   • advertising_channel_type: PERFORMANCE_MAX olarak ayarlandı.

   • customer_id: Kampanyayı oluşturan müşterinin kimliğine ayarlanır.

4. GenerateRecommendationsResponse bölümündeki önerileri (bu örnekte bir SitelinkAssetRecommendation ve bir MaximizeClicksOptInRecommendation) kampanya oluşturma arayüzünüzde göstererek kullanıcıya önerebilirsiniz. Kullanıcı bir öneriyi kabul ederse kullanıcı kampanya oluşturma akışını tamamladıktan sonra öneriyi kampanya oluşturma isteğine dahil edebilirsiniz.