Skor pengoptimalan dan rekomendasi

ondemand_video Video: Pembahasan mendalam

Rekomendasi dapat meningkatkan performa kampanye Anda dalam beberapa cara:

• Memperkenalkan fitur baru dan relevan
• Optimalkan anggaran Anda dengan bid, kata kunci, dan iklan yang ditingkatkan
• Meningkatkan keseluruhan performa dan efisiensi kampanye Anda

Untuk meningkatkan skor pengoptimalan, Anda dapat menggunakan RecommendationService untuk mengambil rekomendasi, lalu menerapkan atau menolaknya. Mulai Google Ads API v15, Anda juga dapat berlangganan untuk menerapkan rekomendasi secara otomatis menggunakan RecommendationSubscriptionService.

Skor pengoptimalan

ondemand_video Video: Skor pengoptimalan

Skor pengoptimalan adalah estimasi seberapa baik performa akun Google Ads Anda dan tersedia di tingkat Customer dan Campaign.

Customer.optimization_score_weight hanya tersedia untuk akun non-pengelola dan digunakan untuk menghitung skor pengoptimalan secara keseluruhan dari beberapa akun. Ambil skor pengoptimalan dan bobot skor pengoptimalan akun, lalu kalikan keduanya (Customer.optimization_score * Customer.optimization_score_weight) untuk menghitung skor pengoptimalan keseluruhan.

Ada metrik terkait pengoptimalan yang tersedia untuk laporan customer dan campaign:

1. metrics.optimization_score_url menyediakan deep link ke akun untuk melihat informasi tentang rekomendasi terkait di UI Google Ads.
2. metrics.optimization_score_uplift memberi tahu seberapa besar skor pengoptimalan akan meningkat jika semua rekomendasi terkait diterapkan. Estimasi yang didasarkan pada semua rekomendasi yang tersedia secara keseluruhan, bukan hanya jumlah skor peningkatan untuk setiap rekomendasi.

Untuk mengelompokkan dan mengurutkan rekomendasi yang ditampilkan, Anda dapat menyegmentasikan kedua metrik ini menurut jenis rekomendasi menggunakan segments.recommendation_type di kueri Anda.

Jenis rekomendasi

Ambil rekomendasi

ondemand_video Video: Coding langsung

Seperti sebagian besar entitas lain di Google Ads API, objek Recommendation diambil menggunakan GoogleAdsService.SearchStream dengan kueri Bahasa Kueri Google Ads.

Untuk setiap jenis rekomendasi, detailnya diberikan di kolom khusus rekomendasi. Misalnya, detail rekomendasi CAMPAIGN_BUDGET berada di kolom campaign_budget_recommendation, dan digabungkan dalam objek CampaignBudgetRecommendation.

Temukan semua kolom khusus rekomendasi di kolom union recommendation.

Dampak rekomendasi

Beberapa jenis rekomendasi mengisi kolom impact rekomendasi. RecommendationImpact berisi estimasi dampak terhadap performa akun sebagai hasil dari penerapan rekomendasi. Metrik rekomendasi berikut tersedia di kolom impact.base_metrics dan impact.potential_metrics:

• impressions

• clicks

• cost_micros

• conversions

• all_conversions (tersedia mulai Google Ads API v16)

• video_views

Contoh kode

Kode contoh berikut mengambil semua rekomendasi jenis KEYWORD yang tersedia dan ditolak dari akun dan mencetak beberapa detailnya:

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.V16.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
      

Ambil tindakan

Setiap rekomendasi yang diambil dapat diterapkan atau ditolak.

Bergantung pada jenis rekomendasi, rekomendasi dapat berubah setiap hari atau bahkan beberapa kali sehari. Jika hal itu terjadi, resource_name objek rekomendasi dapat menjadi tidak digunakan lagi setelah rekomendasi diambil.

Sebaiknya ambil tindakan berdasarkan rekomendasi segera setelah data diambil.

Menerapkan rekomendasi

ondemand_video Video: Menerapkan rekomendasi

Anda dapat menerapkan rekomendasi yang aktif atau ditolak dengan metode ApplyRecommendation dari RecommendationService.

Jenis rekomendasi dapat memiliki parameter wajib atau opsional. Sebagian besar rekomendasi disertai dengan nilai yang direkomendasikan yang digunakan secara default.

Menetapkan akun untuk penerapan rekomendasi secara otomatis tidak didukung untuk semua jenis rekomendasi. Namun, Anda dapat menerapkan perilaku serupa untuk jenis rekomendasi yang sepenuhnya didukung oleh Google Ads API. Lihat contoh kode DetectAndApplyRecommendations untuk mempelajari lebih lanjut.

Gunakan kolom union apply_parameters dari ApplyRecommendationOperation untuk menerapkan rekomendasi dengan parameter value tertentu. Setiap jenis rekomendasi yang sesuai memiliki kolomnya sendiri. Jenis rekomendasi yang tidak tercantum dalam kolom apply_parameters tidak akan menggunakan parameter value ini.

Contoh kode

Kode berikut menunjukkan cara mem-build ApplyRecommendationOperation dan cara mengganti nilai yang direkomendasikan jika ingin menggantinya dengan nilai Anda sendiri.

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

  return $apply_recommendation_operation;
}
detect_and_apply_recommendations.pl
      

Contoh berikutnya memanggil ApplyRecommendation, yang mengirim operasi rekomendasi penerapan yang telah dibuat dalam kode sebelumnya.

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

Menolak rekomendasi

ondemand_video Video: Menolak rekomendasi

Anda dapat menolak rekomendasi dengan RecommendationService. Struktur kodenya mirip dengan menerapkan rekomendasi, tetapi Anda menggunakan DismissRecommendationOperation dan RecommendationService.DismissRecommendation.

Terapkan rekomendasi secara otomatis

Mulai Google Ads API v15, Anda dapat menggunakan RecommendationSubscriptionService untuk menerapkan rekomendasi dari jenis tertentu secara otomatis.

Untuk berlangganan jenis rekomendasi tertentu, buat objek RecommendationSubscription, tetapkan kolom type ke salah satu jenis rekomendasi yang didukung, dan tetapkan kolom status ke ENABLED.

Mengambil langganan

Untuk mendapatkan informasi tentang langganan rekomendasi akun, buat kueri resource recommendation_subscription.

Untuk melihat perubahan yang diterapkan secara otomatis, buat kueri resource change_event, filter change_client_type ke GOOGLE_ADS_RECOMMENDATIONS_SUBSCRIPTION.

Rekomendasi dalam pembuatan kampanye

Mulai Google Ads API v16, Anda dapat menggunakan RecommendationService.GenerateRecommendationsRequest untuk membuat rekomendasi selama pembuatan kampanye, untuk kumpulan jenis rekomendasi tertentu.

GenerateRecommendations menerima ID pelanggan sebagai input, yaitu jenis saluran iklan yang harus berupa SEARCH atau PERFORMANCE_MAX, daftar jenis rekomendasi yang akan dibuat, dan berbagai titik data yang bergantung pada jenis yang ditentukan. Fungsi ini menghasilkan daftar objek Recommendation berdasarkan data yang Anda berikan. Jika tidak ada data yang memadai untuk membuat rekomendasi untuk recommendation_types yang diminta, atau jika kampanye sudah dalam status yang direkomendasikan, kumpulan hasil tidak akan berisi rekomendasi untuk jenis tersebut. Pastikan aplikasi Anda menangani kasus saat tidak ada rekomendasi yang ditampilkan untuk jenis rekomendasi yang diminta.

Tabel berikut menjelaskan jenis rekomendasi yang didukung GenerateRecommendations, dan kolom yang harus Anda berikan agar dapat menerima rekomendasi untuk jenis tersebut. Sebagai praktik terbaik, kirim permintaan GenerateRecommendations setelah semua informasi dikumpulkan yang terkait dengan jenis rekomendasi yang diminta. Untuk mengetahui detail tambahan tentang kolom wajib diisi dan opsional, termasuk kolom bertingkat, lihat dokumentasi referensi.

Contoh alur penggunaan

Misalkan perusahaan Anda adalah agensi iklan yang menyediakan alur kerja pembuatan kampanye kepada pengguna, dan Anda ingin menawarkan saran kepada pengguna selama alur tersebut. Anda dapat menggunakan GenerateRecommendationsRequest untuk menghasilkan rekomendasi sesuai permintaan, dan menyertakan rekomendasi tersebut ke dalam antarmuka pengguna konstruksi kampanye.

Alur penggunaan mungkin terlihat seperti berikut:

1. Pengguna membuka aplikasi Anda untuk membuat kampanye Performa Maksimal.

2. Pengguna memberikan beberapa informasi awal sebagai bagian dari alur konstruksi kampanye. Misalnya, mereka memberikan detail untuk membuat satu SitelinkAsset, lalu memilih TARGET_SPEND sebagai strategi Smart Bidding.

3. Anda mengirim GenerateRecommendationsRequest yang menetapkan kolom berikut:

   • campaign_sitelink_count: ditetapkan ke 1, yang merupakan jumlah aset sitelink di kampanye yang sedang berlangsung.

   • bidding_info: menetapkan kolom bidding_strategy_type bertingkat ke TARGET_SPEND.

   • conversion_tracking_status: ditetapkan ke ConversionTrackingStatus pelanggan ini. Untuk mendapatkan panduan tentang cara mengambil kolom ini, kunjungi panduan Memulai pengelolaan konversi.

   • recommendation_types: tetapkan ke [SITELINK_ASSET, MAXIMIZE_CLICKS_OPT_IN].

   • advertising_channel_type: tetapkan ke PERFORMANCE_MAX.

   • customer_id: ditetapkan ke ID pelanggan yang membuat kampanye.

4. Anda dapat mengambil rekomendasi di GenerateRecommendationsResponse — dalam hal ini, SitelinkAssetRecommendation dan MaximizeClicksOptInRecommendation —dan menyarankannya kepada pengguna dengan menampilkannya dalam antarmuka pembuatan kampanye. Jika pengguna menerima saran, Anda dapat menyertakannya ke dalam permintaan pembuatan kampanye setelah pengguna menyelesaikan alur konstruksi kampanye.