Optimizasyon puanı ve öneriler

ondemand_video. Video: Ayrıntılı inceleme

Öneriler iyileştirilebilir birkaç şekilde ayarlayabilirsiniz:

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

Optimizasyon puanlarını artırmak için Almak için RecommendationService ve ardından bunları uygun şekilde uygulayın veya reddedin. 15. sürümden itibaren Google Ads API'sine abone olarak, otomatik olarak uygulama önerileri görmek için RecommendationSubscriptionService'yı kullanabilirsiniz.

Optimizasyon puanı

ondemand_video. Video: Optimizasyon puanı

Optimizasyon puanı, Google Ads hesabınızın ne kadar iyi performans gösterecek şekilde ayarlandığına ve kullanılabilir olduğuna dair tahmini Customer ve Campaign düzeyler.

İlgili içeriği oluşturmak için kullanılan Customer.optimization_score_weight yalnızca yönetici olmayan hesaplar tarafından kullanılabilir ve genel birden fazla hesabın optimizasyon puanını Optimizasyon puanını alın ve hesapların optimizasyon puanı ağırlıklarını birbiriyle çarparak Hesaplamak için (Customer.optimization_score * Customer.optimization_score_weight) ve genel optimizasyon puanını etkiler.

customer ve campaign için optimizasyonla ilgili metrikler var. raporlar:

1. İlgili içeriği oluşturmak için kullanılan metrics.optimization_score_url hesapla ilgili bilgileri görüntülemek için hesaba bir derin bağlantı sağlar. Google Ads kullanıcı arayüzündeki öneriler.
2. İlgili içeriği oluşturmak için kullanılan metrics.optimization_score_uplift tüm ilgili tüm dönüşümler sağlandığında optimizasyon puanının ne kadar artacağını emin olun. Mevcut tüm tahminlere göre yapılmış bir tahmindir toplam olarak değil, her bir aylık artış puanının öneririz.

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

Öneri türleri

Önerileri al

ondemand_video. Video: Canlı kodlama

Google Ads API'deki diğer birçok varlık gibi, Recommendation nesneleri GoogleAdsService.SearchStream Google Ads Sorgu Dili sorgusuyla çalışabilirsiniz.

Her öneri türü için ayrıntılar bir belirli bir alan adı kullanabilirsiniz. Örneğin, CAMPAIGN_BUDGET önerisi ayrıntılara campaign_budget_recommendation alanı içine alır ve bir CampaignBudgetRecommendation nesnesini tanımlayın.

Öneriye özel tüm alanları recommendation birleşim alanı.

Öneri etkisi

Bazı öneri türleri, impact alanında görünür. RecommendationImpact bilgi edinmenin bir sonucu olarak hesap performansı üzerindeki geri dönelim. Aşağıdakiler öneri metriklerinin impact.base_metrics ve impact.potential_metrics alanlarında kullanılabilir:

• impressions

• clicks

• cost_micros

• conversions

• all_conversions (Google Ads API'nin 16 sürümünden itibaren kullanılabilir)

• video_views

Kod örneği

Aşağıdaki örnek kod mevcut ve reddedilen tüm önerileri alır bir hesaptan KEYWORD türünü kullanır ve bu verilerin 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.V17.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
      

Harekete geçin

Alınan öneriler uygulanabilir veya reddedilebilir.

Öneri türüne bağlı olarak, öneriler günlük olarak değişebilir. hatta günde birkaç kez. Bu durumda bir öneri resource_name öneri alındıktan sonra geçerliliğini yitirir.

Önerileri aldıktan kısa bir süre sonra gerekli işlemleri yapmak iyi bir uygulamadır.

Önerileri uygula

ondemand_video. Video: Önerileri uygulayın

Etkin veya reddedilmiş önerileri ApplyRecommendation yöntemindeki RecommendationService.

Öneri türlerinde zorunlu veya isteğe bağlı parametreler olabilir. En sık öneriler, varsayılan olarak kullanılan önerilen değerlerle birlikte sunulur.

Önerilerin otomatik olarak uygulanması için hesap oluşturulamaz tüm öneri türleri için desteklenir. Ancak, daha fazla bilgi edinmek için Google Ads API tarafından tam olarak desteklenen öneri türleri için geçerlidir. DetectAndApplyRecommendations koduna bakın. örnek bölümüne bakın.

Şunu kullanın: apply_parameters önerilerin uygulanacağı ApplyRecommendationOperation birlik alanı belirli parametre değerleri. Her uygun öneri türünün kendi alanı vardır. apply_parameters alanında listelenmeyen hiçbir öneri türünde kullanılmaz bu parametre değerlerini içerir.

Kod örneği

Aşağıdaki kod, ApplyRecommendationOperation ve önerilen değerleri sahip olmalıdır.

/** 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::V17::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::V17::Resources::Ad->new({
  #   id => "INSERT_AD_ID_AS_INTEGER_HERE"
  # });
  # my $text_ad_parameters =
  #   Google::Ads::GoogleAds::V17::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::V17::Services::RecommendationService::ApplyRecommendationOperation
    ->new({
      resourceName => $recommendation->{resourceName}});

  return $apply_recommendation_operation;
}
detect_and_apply_recommendations.pl
      

Bir sonraki örnek ApplyRecommendation önceki adımda oluşturulan öneri uygulama işlemlerini göndererek girin.

// 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.V17.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. Kod yapısı, önerileri uygulamaya benzer ancak bunun yerine DismissRecommendationOperation ve RecommendationService.DismissRecommendation.

Önerileri otomatik olarak uygulayın

Google Ads API'nin 15. sürümünden itibaren, RecommendationSubscriptionService özelliğini kullanabilirsiniz.

Belirli bir öneri türüne abone olmak için RecommendationSubscription nesne, type alanını şu değerlerden birine ayarlayın: desteklenen öneri türlerini belirleyin ve status alanını ENABLED olarak ayarlayın.

Abonelikleri alma

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

Otomatik olarak uygulanan değişiklikleri görüntülemek için change_event kaynağını filtreler. change_client_type - GOOGLE_ADS_RECOMMENDATIONS_SUBSCRIPTION.

Kampanya oluştururken öneriler

Google Ads API'nin 16. sürümünden itibaren, RecommendationService.GenerateRecommendationsRequest kampanya oluşturma sırasında belirli bir grup için öneriler yardımcı olur.

GenerateRecommendations; müşteri kimliği veya reklam kanalı olarak kabul eder. veya olmalıdır. SEARCH veya PERFORMANCE_MAX, oluşturulacak öneri türlerinin listesi ve bunlara bağlı çeşitli veri noktaları belirtilen türlerde. Şuna dayalı olarak Recommendation nesnenin bir listesini çıkarır: bu kapsamdadır. Öneri oluşturmak için yeterli veri yoksa istenen recommendation_types Kampanya zaten önerilen durumdaysa sonuç kümesi o tür için bir öneri içerir. Uygulamanızın şu gereksinimleri karşıladığından emin olun: istenen öneri için hiçbir önerinin döndürülmediği durum bulunur.

Aşağıdaki tabloda, Google'ın kitle hedefleme özelliğini GenerateRecommendations tarafından desteklenen alanlar ve bu verileri almak için size yardımcı olabilir. En iyi uygulama olarak Tüm bilgiler toplandıktan sonra GenerateRecommendations isteği alakalı olması gerekir. Ayrıntılı bilgi için iç içe geçmiş alanlar dahil olmak üzere zorunlu ve isteğe bağlı alanlar için referans belgeleri.

Örnek kullanım akışı

Şirketinizin bir reklam ajansı olduğunu varsayalım. kullanıcılara inşaat iş akışı sunar ve kullanıcılara bu akışta geri dönüyor. Tekliflerinizi otomatikleştirmek ve optimize etmek için GenerateRecommendationsRequest isteğe bağlı öneriler oluşturmak ve bu önerileri uygulamak için kullanıcı arayüzünüze entegre edebilirsiniz.

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 kapsamında bazı başlangıç bilgileri sağlar en iyi yöntemin ne olduğunu öğreneceğiz. Örneğin, tek bir web sitesi için SitelinkAsset ve TARGET_SPEND Akıllı Teklif olarak kullanıyor. üzerine konuşacağız.

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

   • campaign_sitelink_count: 1 olarak ayarlanmıştır. Bu sayı, devam eden çalışmalardaki site bağlantısı öğelerinin sayısı pek de iyi olmadığını unutmayın.

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

   • conversion_tracking_status: değerine ayarlayın ConversionTrackingStatus . Bu alanın nasıl alınacağıyla ilgili yardım için şu sayfayı ziyaret edin: Başlarken rehberini okuyun.

   • 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. Şuradaki önerileri uygulayabilirsiniz: GenerateRecommendationsResponse - Bu örnekte, SitelinkAssetRecommendation ve MaximizeClicksOptInRecommendation ve kampanyanızda görüntüleyerek kullanıcılara bu reklamları önerin inşaat arayüzü. Kullanıcı bir öneriyi kabul ederse şunu yapabilirsiniz: Kullanıcı işlemi tamamladıktan sonra bunu kampanya oluşturma isteğine dahil edebilir adımları uygulayın.