نتيجة التحسين والاقتراحات

ondemand_video فيديو: نظرة متعمّقة

الاقتراحات يمكن أن تتحسن حملاتك بعدة طرق:

• تقديم ميزات جديدة وذات صلة
• الاستفادة إلى أقصى حد من ميزانيتك باستخدام عروض الأسعار والكلمات الرئيسية والإعلانات المحسّنة
• رفع مستوى أداء حملاتك وكفاءتها بشكلٍ عام

لزيادة نتائج التحسين، يمكنك استخدام RecommendationService لاسترداد والاقتراحات، ومن ثم تطبيقها أو رفضها وفقًا لذلك. بدءًا من الإصدار 15 Google Ads API، يمكنك أيضًا الاشتراك في خدمة التطبيق التلقائي والتوصيات باستخدام RecommendationSubscriptionService.

نتيجة التحسين

ondemand_video فيديو: نتيجة التحسين

نتيجة التحسين هي تقدير لمدى توفّر حسابك على "إعلانات Google" ومستوى أدائه في Customer مستويات Campaign.

تشير رسالة الأشكال البيانية Customer.optimization_score_weight متاحة فقط للحسابات غير الإدارية، ويتم استخدامها لاحتساب نتيجة التحسين لعدة حسابات استرداد نتيجة التحسين وزن نتيجة التحسين للحسابات وضربها معًا (Customer.optimization_score * Customer.optimization_score_weight) للحساب نتيجة التحسين الإجمالية

تتوفّر مقاييس ذات صلة بالتحسين لكلٍّ من customer وcampaign. التقارير:

1. تشير رسالة الأشكال البيانية metrics.optimization_score_url رابطًا لموضع معيّن في الحساب لعرض معلومات عن الاقتراحات في واجهة مستخدم "إعلانات Google"
2. تشير رسالة الأشكال البيانية metrics.optimization_score_uplift مقدار الزيادة في نتيجة التحسين إذا كانت جميع القيم المرتبطة تطبيق التوصيات. إنه تقدير بناءً على كل ما هو متاح والتوصيات ككل، وليس فقط مجموع درجات التحسين لكل والتوصية بها.

لتجميع الاقتراحات المعروضة وترتيبها، يمكنك تقسيم كليهما المقاييس حسب نوع الاقتراح باستخدام segments.recommendation_type في طلب البحث.

أنواع الاقتراحات

استرداد الاقتراحات

ondemand_video فيديو: الترميز المباشر

مثل معظم الكيانات الأخرى في Google Ads API، Recommendation التي يتم استرجاعها باستخدام دالة GoogleAdsService.SearchStream باستخدام طلب بحث بلغة طلب البحث في "إعلانات Google".

يتم تقديم التفاصيل لكل نوع من أنواع الاقتراحات في الخاص بالتوصية. على سبيل المثال، اقتراح واحد (CAMPAIGN_BUDGET) التفاصيل موجودة في campaign_budget_recommendation ويتم تضمينها في CampaignBudgetRecommendation الخاص بك.

يمكنك العثور على جميع الحقول الخاصة بالاقتراحات في حقل اتحاد recommendation.

تأثير الاقتراح

تتم تعبئة بعض أنواع الاقتراحات impact ضمن الاقتراح. RecommendationImpact يحتوي على تقدير للتأثير في أداء الحساب نتيجةً وتطبيق التوصية. ما يلي: مقاييس الاقتراحات هي متوفّرة في الحقلَين impact.base_metrics وimpact.potential_metrics:

• impressions

• clicks

• cost_micros

• conversions

• all_conversions (متوفّرة بدءًا من الإصدار 16 من Google Ads API)

• video_views

مثال على الرمز البرمجي

يسترد الرمز النموذجي التالي جميع الاقتراحات المتاحة والمرفوضة للنوع KEYWORD من حساب ويطبع بعض التفاصيل:

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
      

اتخاذ إجراء

يمكن تطبيق أي اقتراح تم استرداده أو رفضه.

واعتمادًا على نوع التوصية، يمكن أن تتغير المقترحات بشكلٍ يومي أو حتى عدة مرات في اليوم. عندما يحدث ذلك، يمكن للتوصية يمكن للكائن resource_name تصبح عفا عليها الزمن بعد استرداد التوصية.

من الممارسات الجيدة اتخاذ إجراءات بشأن التوصيات بعد الاسترداد بوقت قصير.

تطبيق الاقتراحات

ondemand_video الفيديو: تطبيق الاقتراحات

يمكنك تطبيق الاقتراحات النشطة أو المرفوضة من خلال ApplyRecommendation طريقة RecommendationService

يمكن أن تحتوي أنواع الاقتراحات على مَعلمات إلزامية أو اختيارية. معظم الأقسام تأتي الاقتراحات مع القيم المقترَحة التي يتم استخدامها تلقائيًا.

لم يتم إعداد حسابات للتطبيق التلقائي للاقتراحات. متاحة لجميع أنواع الاقتراحات ومع ذلك، يمكنك تنفيذ إجراءات السلوك لأنواع الاقتراحات التي تتوافق بالكامل مع Google Ads API. يُرجى الرجوع إلى رمز DetectAndApplyRecommendations. مثال للاطّلاع على مزيد من المعلومات.

يمكنك استخدام apply_parameters حقل الاتحاد ApplyRecommendationOperation لتطبيق الاقتراحات مع قيم المعلمات المحددة. ولكل نوع من أنواع الاقتراحات المناسبة حقله الخاص. أي نوع اقتراح غير مُدرَج في الحقل "apply_parameters" لا يستخدم قيم المعاملات هذه.

مثال على الرمز البرمجي

توضح التعليمة البرمجية التالية كيفية إنشاء ApplyRecommendationOperation و كيفية إلغاء القيم المقترَحة إذا أردت استبدالها تمتلكه.

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

المثال التالي يستدعي ApplyRecommendation، عن طريق إرسال عمليات تطبيق الاقتراحات التي تم إنشاؤها خلال الفترة السابقة الرمز.

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

رفض الاقتراحات

ondemand_video فيديو: رفض الاقتراحات

يمكنك رفض الاقتراحات باستخدام RecommendationService الرمز تشبه تطبيق الاقتراحات، ولكن بدلاً من ذلك، عليك DismissRecommendationOperation أو RecommendationService.DismissRecommendation

تطبيق الاقتراحات تلقائيًا

بدءًا من الإصدار 15 من Google Ads API، يمكنك استخدام RecommendationSubscriptionService لتطبيق اقتراحات من نوع محدّد تلقائيًا

للاشتراك في نوع معيّن من الاقتراحات، أنشئ RecommendationSubscription، اضبط الحقل type على أحد الاقتراح المتوافق الأنواع وضبط status إلى ENABLED.

استرداد الاشتراكات

للحصول على معلومات عن الاشتراكات في الاقتراحات لحساب ما، يمكنك إجراء طلب بحث عن recommendation_subscription.

لعرض التغييرات التي تم تطبيقها تلقائيًا، يمكنك إجراء طلب بحث عن change_event، وفلترة change_client_type إلى GOOGLE_ADS_RECOMMENDATIONS_SUBSCRIPTION

الاقتراحات في إطار إنشاء الحملات

بدءًا من الإصدار 16 من Google Ads API، يمكنك استخدام RecommendationService.GenerateRecommendationsRequest لإنشاء اقتراحات أثناء إنشاء الحملة، وذلك لمجموعة محدّدة من والتوصيات لدينا.

تقبل "GenerateRecommendations" إدخال الرقم التعريفي للعميل، وهي قناة إعلانية النوع الذي يجب أن يكون إما SEARCH أو PERFORMANCE_MAX, وقائمة بأنواع التوصيات التي سيتم إنشاؤها، ونقاط بيانات متنوعة تعتمد على الأنواع المحددة. تنتج قائمة بكائنات Recommendation استنادًا إلى البيانات التي تقدمها. في حال عدم توفّر بيانات كافية لتقديم اقتراح مقابل الطلب recommendation_types، أو إذا كانت الحملة في الحالة المقترَحة، لن تظهر مجموعة النتائج سيحتوي على توصية لهذا النوع. تأكَّد من أنّ تطبيقك يعالج الحالة التي لا يتم فيها عرض أي توصيات للتوصية المطلوبة الأنواع.

يوضّح الجدول التالي أنواع الاقتراحات التي يمكن استخدام "GenerateRecommendations" والحقول التي يجب توفيرها لتلقّي توصيات لهذا النوع. كأفضل ممارسة، أرسل طلب "GenerateRecommendations" بعد جمع كل المعلومات المرتبطة بأنواع الاقتراحات المطلوبة للحصول على تفاصيل إضافية عن والحقول المطلوبة والاختيارية، بما في ذلك الحقول المتداخلة، يُرجى الرجوع إلى المستندات المرجعية

مثال على تدفق الاستخدام

لنفترض أن شركتك وكالة إعلانية تقدم حملة سير العمل والبناء للمستخدمين، وتريد تقديم اقتراحات للمستخدمين خلال هذا التدفق. يمكنك استخدام GenerateRecommendationsRequest لإنشاء اقتراحات عند الطلب ودمجها في واجهة المستخدم لإنشاء حملتك

قد يبدو تدفق الاستخدام كما يلي:

1. يزور أحد المستخدِمين تطبيقك لإنشاء "حملة أداء أفضل".

2. يقدّم المستخدِم بعض المعلومات الأولية كجزء من الحملة. تدفق البناء. على سبيل المثال، يقدمون تفاصيل لإنشاء مخطط SitelinkAsset، ويختار TARGET_SPEND بمثابة عروض الأسعار الذكية الاستراتيجية.

3. عليك إرسال GenerateRecommendationsRequest، ما يؤدّي إلى ضبط الحقول التالية:

   • campaign_sitelink_count: تم ضبطها على "1"، وهي عدد مواد عرض روابط أقسام الموقع قيد التنفيذ .

   • bidding_info: لضبط حقل bidding_strategy_type المدمج على TARGET_SPEND.

   • conversion_tracking_status: ضبط على ConversionTrackingStatus لهذا العميل. للحصول على إرشادات حول كيفية استرداد هذا الحقل، يمكنك الانتقال إلى البدء دليل لإدارة الإحالات الناجحة

   • recommendation_types: تم ضبطه على [SITELINK_ASSET, MAXIMIZE_CLICKS_OPT_IN].

   • advertising_channel_type: تم ضبطه على PERFORMANCE_MAX.

   • customer_id: يتم ضبطها على رقم تعريف العميل الذي يُنشئ الحملة.

4. يمكنك اتّباع الاقتراحات في GenerateRecommendationsResponse — وهو في هذه الحالة SitelinkAssetRecommendation و MaximizeClicksOptInRecommendation — واقترحها على المستخدم من خلال عرضها ضمن حملتك واجهة البناء. إذا قبل المستخدم اقتراحًا، يمكنك عندئذٍ دمجها في طلب إنشاء الحملة بعد أن يكمل المستخدم عملية إنشاء الحملة