يمكن أن تحسّن الاقتراحات حملاتك من خلال بضع طرق:
- تقديم ميزات جديدة وملائمة
- الاستفادة بشكل أكبر من ميزانيتك باستخدام عروض الأسعار والكلمات الرئيسية والإعلانات المحسّنة
- تحسين أداء حملاتك وكفاءتها بوجهٍ عام
لزيادة نتائج التحسين، يمكنك استخدام RecommendationService
لاسترداد الاقتراحات، ثم تطبيقها أو رفضها وفقًا لذلك. بدءًا من الإصدار 15 من Google Ads API، يمكنك أيضًا الاشتراك في ميزة التطبيق التلقائي
للاقتراحات باستخدام RecommendationSubscriptionService
.
نتيجة التحسين
نتيجة التحسين هي
تقدير لمدى جودة أداء حسابك على "إعلانات Google" وتوفّره
على مستويَي Customer
وCampaign
.
لا يتوفّر Customer.optimization_score_weight
إلا للحسابات غير الإدارية، ويُستخدَم لاحتساب نتيجة التحسين الإجمالية لحسابات متعددة. استرجع نتيجة التحسين
ووزن نتيجة التحسين للحسابات واضربهما معًا
(Customer.optimization_score * Customer.optimization_score_weight
) لاحتساب
نتيجة التحسين الإجمالية.
تتوفّر مقاييس مرتبطة بالتحسين لتقريرَي customer
وcampaign
:
- توفِّر
metrics.optimization_score_url
رابطًا لصفحة معيّنة في الحساب للاطّلاع على معلومات عن الاقتراحات ذات الصلة في واجهة مستخدم "إعلانات Google". - توضّح السمة
metrics.optimization_score_uplift
مقدار الزيادة في نتيجة التحسين في حال تطبيق جميع الاقتراحات ذات الصلة. إنه تقدير يستند إلى جميع الاقتراحات المتاحة ككل، وليس فقط مجموع درجات الزيادة لكل توصية.
لتجميع الاقتراحات المعروضة وترتيبها، يمكنك تقسيم كلا هذين المقياسَين حسب نوع الاقتراح باستخدام segments.recommendation_type
في طلب البحث.
أنواع الاقتراحات
أنواع الاقتراحات المتوافقة بالكامل
RecommendationType | الوصف |
---|---|
CAMPAIGN_BUDGET |
إصلاح الحملات التي تكون ميزانيتها أدنى من حدود الميزانية المطلوبة |
KEYWORD |
إضافة كلمات رئيسية جديدة |
TEXT_AD |
إضافة اقتراحات الإعلانات |
TARGET_CPA_OPT_IN |
عرض سعر باستخدام التكلفة المستهدفة للإجراء |
MAXIMIZE_CONVERSIONS_OPT_IN |
تقديم عروض أسعار باستخدام استراتيجية "تحقيق الحد الأقصى من الإحالات الناجحة" |
MAXIMIZE_CONVERSION_VALUE_OPT_IN |
تقديم عروض أسعار باستخدام استراتيجية "تحقيق الحد الأقصى من قيمة الإحالات الناجحة" |
ENHANCED_CPC_OPT_IN |
عرض الأسعار باستخدام تكلفة النقرة المحسّنة |
MAXIMIZE_CLICKS_OPT_IN |
تقديم عروض أسعار باستخدام استراتيجية "الحصول على الحد الأقصى من النقرات" |
OPTIMIZE_AD_ROTATION |
استخدام عمليات عرض الإعلانات بالتناوب المحسَّنة |
MOVE_UNUSED_BUDGET |
نقل البيانات غير المستخدَمة إلى الميزانيات المحدودة |
TARGET_ROAS_OPT_IN |
تقديم عروض أسعار باستخدام عائد الإنفاق الإعلاني المستهدف |
FORECASTING_CAMPAIGN_BUDGET |
أصلِح الحملات التي من المتوقّع أن تصبح أدنى من حدود الميزانية المطلوبة في المستقبل. |
RESPONSIVE_SEARCH_AD |
إضافة إعلان متجاوب جديد على شبكة البحث |
MARGINAL_ROI_CAMPAIGN_BUDGET |
تعديل ميزانية الحملة لزيادة عائد الاستثمار |
USE_BROAD_MATCH_KEYWORD |
استخدام المطابقة التقريبية للحملات المستندة إلى الإحالات الناجحة التي تتضمّن عروض أسعار مبرمَجة |
RESPONSIVE_SEARCH_AD_ASSET |
إضافة مواد عرض الإعلانات المتجاوبة على شبكة البحث إلى إعلان |
RESPONSIVE_SEARCH_AD_IMPROVE_AD_STRENGTH |
تحسين قوة الإعلان المتجاوب على شبكة البحث |
DISPLAY_EXPANSION_OPT_IN |
تعديل حملة لاستخدام ميزة "الانتشار على الشبكة الإعلانية" |
SEARCH_PARTNERS_OPT_IN |
توسيع مدى الوصول من خلال شركاء بحث Google |
CUSTOM_AUDIENCE_OPT_IN |
إنشاء جمهور مخصّص |
IMPROVE_DISCOVERY_AD_STRENGTH |
تحسين قوة الإعلانات في "الحملات لزيادة الطلب" |
UPGRADE_SMART_SHOPPING_CAMPAIGN_TO_PERFORMANCE_MAX |
ترقية "حملة Shopping ذكية" إلى "حملة أداء أفضل" |
UPGRADE_LOCAL_CAMPAIGN_TO_PERFORMANCE_MAX |
ترقية حملة محلية قديمة إلى "حملة أداء أفضل" |
SHOPPING_MIGRATE_REGULAR_SHOPPING_CAMPAIGN_OFFERS_TO_PERFORMANCE_MAX |
نقل العروض التي تستهدفها "حملات Shopping العادية" إلى "حملات الأداء الأفضل" الحالية |
MIGRATE_DYNAMIC_SEARCH_ADS_CAMPAIGN_TO_PERFORMANCE_MAX |
نقل "الإعلانات الديناميكية على شبكة البحث" إلى "حملات الأداء الأفضل" |
PERFORMANCE_MAX_OPT_IN |
إنشاء "حملات الأداء الأفضل" في حسابك |
IMPROVE_PERFORMANCE_MAX_AD_STRENGTH |
حسِّن قوة مجموعة مواد العرض الخاصة بـ "حملة الأداء الأفضل" إلى تقييم "ممتاز". |
PERFORMANCE_MAX_FINAL_URL_OPT_IN |
تفعيل ميزة توسيع عنوان URL النهائي في "حملات الأداء الأفضل" |
RAISE_TARGET_CPA_BID_TOO_LOW |
رفع التكلفة المستهدفة للإجراء عندما تكون منخفضة جدًا ويتوفر عدد قليل جدًا من الإحالات الناجحة أو لا يحدث أي إحالات ناجحة |
FORECASTING_SET_TARGET_ROAS |
يمكنك زيادة الميزانية مسبقًا قبل فعالية موسمية من المتوقّع أن تساهم في زيادة عدد الزيارات، وتغيير استراتيجية عروض الأسعار بدلاً من استراتيجية "تحقيق الحد الأقصى من قيمة الإحالات الناجحة" إلى "عائد الإنفاق الإعلاني المستهدَف". |
LEAD_FORM |
إضافة مواد عرض نماذج العملاء المحتملين إلى حملة |
CALLOUT_ASSET |
إضافة مواد عرض وسائل الشرح إلى مستوى الحملة أو العميل |
SITELINK_ASSET |
إضافة مواد عرض روابط أقسام الموقع إلى مستوى الحملة أو العميل |
CALL_ASSET |
إضافة مواد عرض المكالمات إلى مستوى الحملة أو العميل |
SHOPPING_ADD_AGE_GROUP |
أضِف سمة الفئة العمرية إلى العروض التي تم خفض ترتيبها بسبب عدم توفّر فئة عمرية. |
SHOPPING_ADD_COLOR |
إضافة لون إلى العروض التي تم خفض ترتيبها بسبب عدم توفّر سمة اللون |
SHOPPING_ADD_GENDER |
أضِف فئة جنس إلى العروض التي تم خفض ترتيبها بسبب عدم توفّر سمة الجنس. |
SHOPPING_ADD_GTIN |
إضافة رقم GTIN (الرقم التجاري العالمي للسلعة) إلى العروض التي تم خفض ترتيبها بسبب عدم توفّر رقم GTIN |
SHOPPING_ADD_MORE_IDENTIFIERS |
أضِف المزيد من المعرّفات إلى العروض التي تم خفض ترتيبها بسبب عدم توفّر معرّفات. |
SHOPPING_ADD_SIZE |
يمكنك إضافة المقاس إلى العروض التي تم خفض ترتيبها بسبب عدم توفّر مقاس. |
SHOPPING_ADD_PRODUCTS_TO_CAMPAIGN |
إضافة منتجات لحملة لعرضها |
SHOPPING_FIX_DISAPPROVED_PRODUCTS |
إصلاح المنتجات المرفوضة |
SHOPPING_TARGET_ALL_OFFERS |
أنشِئ حملة شاملة تستهدف جميع العروض. |
SHOPPING_FIX_SUSPENDED_MERCHANT_CENTER_ACCOUNT |
إصلاح المشاكل المتعلقة بتعليق حساب Merchant Center |
SHOPPING_FIX_MERCHANT_CENTER_ACCOUNT_SUSPENSION_WARNING |
إصلاح المشاكل التحذيرية بشأن تعليق حساب Merchant Center |
DYNAMIC_IMAGE_EXTENSION_OPT_IN |
تفعيل إضافات الصور الديناميكية على الحساب |
RAISE_TARGET_CPA |
رفع التكلفة المستهدفة للإجراء |
LOWER_TARGET_ROAS |
خفض عائد الإنفاق الإعلاني المستهدف |
FORECASTING_SET_TARGET_CPA |
يتم ضبط تكلفة مستهدَفة للإجراء للحملات التي لا تتضمّن حملة محدّدة، قبل عقد فعالية موسمية من المتوقّع أن تؤدي إلى زيادة عدد الزيارات. |
SET_TARGET_CPA |
إعداد تكلفة مستهدفة للإجراء للحملات التي لم يتم تحديد تكلفة محدّدة لها |
SET_TARGET_ROAS |
ضبط عائد إنفاق إعلاني مستهدف للحملات التي لم يتم تحديد عائد إنفاق إعلاني مستهدَف لها |
REFRESH_CUSTOMER_MATCH_LIST |
تعديل قائمة عملاء لم يتم تعديلها في آخر 90 يومًا |
IMPROVE_GOOGLE_TAG_COVERAGE |
نشر علامة Google على مزيد من الصفحات |
CALLOUT_EXTENSION (متوقّفة نهائيًا) |
تم إيقاف العمل به. يمكنك استخدام CALLOUT_ASSET بدلاً منه. |
SITELINK_EXTENSION (متوقّفة نهائيًا) |
تم إيقاف العمل به. يمكنك استخدام SITELINK_ASSET بدلاً منه. |
CALL_EXTENSION (متوقّفة نهائيًا) |
تم إيقاف العمل به. يمكنك استخدام CALL_ASSET بدلاً منه. |
KEYWORD_MATCH_TYPE (متوقّفة نهائيًا) |
تم إيقاف العمل به. يمكنك استخدام USE_BROAD_MATCH_KEYWORD بدلاً منه. |
مشاهدة الفيديو لمزيد من المعلومات
التعامل مع الأنواع غير المتوافقة
استرداد الاقتراحات
مثل معظم الكيانات الأخرى في 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
من أحد الحسابات، ويطبع بعض تفاصيلها:
Java
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)); } }
C#
// 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; }
PHP
$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()); }
Python
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) )
Ruby
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
Perl
# 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); });
اتّخاذ إجراء
يمكن تطبيق أو رفض أي اقتراح تم استرداده.
اعتمادًا على نوع الاقتراح، يمكن أن تتغيّر الاقتراحات
بشكل يومي أو عدة مرات في اليوم. في هذه الحالة، قد يصبح resource_name
لعنصر الاقتراح قديمًا بعد استرداد الاقتراح.
من الممارسات الجيدة اتخاذ إجراء بشأن التوصيات بعد فترة وجيزة من الاسترجاع.
تطبيق الاقتراحات
يمكنك تطبيق الاقتراحات النشطة أو المرفوضة باستخدام
طريقة
ApplyRecommendation
في
RecommendationService
.
يمكن أن تحتوي أنواع الاقتراحات على معلَمات إلزامية أو اختيارية. تتضمّن معظم الاقتراحات قيمًا مقترَحة يتم استخدامها تلقائيًا.
لا تتوفّر إمكانية إعداد الحسابات لتطبيق الاقتراحات تلقائيًا لجميع أنواع الاقتراحات. مع ذلك، يمكنك تنفيذ سلوك مشابه لأنواع الاقتراحات المتوافقة بالكامل مع Google Ads API.
راجِع مثال الرمز البرمجي DetectAndApplyRecommendations
لمعرفة المزيد من المعلومات.
استخدِم حقل اتحاد apply_parameters
في ApplyRecommendationOperation
لتطبيق اقتراحات بقيم معلَمات معيّنة. ولكل نوع اقتراح مناسب حقله الخاص.
إنّ أيّ نوع اقتراح غير مُدرَج في الحقل apply_parameters
لا يستخدم قيم المَعلمات هذه.
مثال الرمز البرمجي
يوضّح الرمز التالي كيفية إنشاء ApplyRecommendationOperation
وكيفية تجاوز القيم المقترَحة إذا أردت استبدالها بقيمك الخاصة.
Java
/** 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(); }
C#
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; }
PHP
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; }
Python
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
Ruby
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
Perl
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; }
يستدعي المثال التالي
ApplyRecommendation
،
ويرسل عمليات تطبيق الاقتراح التي تم إنشاؤها في الرمز
السابق.
Java
// 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()); }
C#
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); } }
PHP
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 ); } }
Python
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}'." )
Ruby
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
Perl
# 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}; }
مشاهدة الفيديوهات لمزيد من المعلومات
تطبيق المعلمات
مجمَّع
الأخطاء
الاختبارات
رفض الاقتراحات
يمكنك رفض الاقتراحات باستخدام
RecommendationService
. يشبه بنية الرمز البرمجي تطبيق الاقتراحات، ولكنك بدلاً من ذلك تستخدم
DismissRecommendationOperation
وRecommendationService.DismissRecommendation
.
مشاهدة الفيديوهات لمزيد من المعلومات
مجمَّع
الأخطاء
الاختبارات
تطبيق الاقتراحات تلقائيًا
بدءًا من الإصدار 15 من Google Ads API، يمكنك استخدام RecommendationSubscriptionService
لتطبيق الاقتراحات من نوع معيّن تلقائيًا.
للاشتراك في نوع اقتراح معيّن، أنشِئ عنصر RecommendationSubscription
، واضبط الحقل type
على أحد
أنواع الاقتراحات المتوافقة، واضبط حقل
status
على ENABLED
.
أنواع الاقتراحات المتوافقة مع الاشتراكات
ENHANCED_CPC_OPT_IN
KEYWORD
KEYWORD_MATCH_TYPE
LOWER_TARGET_ROAS
MAXIMIZE_CLICKS_OPT_IN
OPTIMIZE_AD_ROTATION
RAISE_TARGET_CPA
RESPONSIVE_SEARCH_AD
RESPONSIVE_SEARCH_AD_IMPROVE_AD_STRENGTH
SEARCH_PARTNERS_OPT_IN
SEARCH_PLUS_OPT_IN
SET_TARGET_CPA
SET_TARGET_ROAS
TARGET_CPA_OPT_IN
TARGET_ROAS_OPT_IN
USE_BROAD_MATCH_KEYWORD
استرداد الاشتراكات
للحصول على معلومات عن الاشتراكات في الاقتراحات لحساب معيّن، يمكنك طلب البحث في المورد 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
بعد جمع كل المعلومات
المرتبطة بأنواع الاقتراحات المطلوبة. للحصول على تفاصيل إضافية حول الحقول المطلوبة والاختيارية، بما في ذلك الحقول المدمجة، يمكنك الاطّلاع على المستندات المرجعية.
RecommendationType | حقول مطلوبة | حقول اختيارية |
---|---|---|
KEYWORD |
|
|
MAXIMIZE_CLICKS_OPT_IN |
|
|
MAXIMIZE_CONVERSIONS_OPT_IN |
|
|
MAXIMIZE_CONVERSION_VALUE_OPT_IN |
|
|
SET_TARGET_CPA |
|
|
SET_TARGET_ROAS |
|
|
SITELINK_ASSET
ملاحظة: سيحتوي العنصر SitelinkAssetRecommendation
المعروض على قوائم فارغة. إذا كان الردّ GenerateRecommendations
يتضمّن SitelinkAssetRecommendation ، يمكن
التعامل معه كإشارة لإضافة ما لا يقل عن مادة عرض واحدة لرابط أقسام الموقع إلى الحملة. |
|
|
TARGET_CPA_OPT_IN |
|
|
TARGET_ROAS_OPT_IN |
|
مثال على تدفق الاستخدام
لنفترض أنّ شركتك وكالة إعلانية توفِّر للمستخدمين
سير عمل إنشاء الحملة، وتريد تقديم اقتراحات للمستخدمين
خلال هذا المسار. يمكنك استخدام
GenerateRecommendationsRequest
لإنشاء اقتراحات عند الطلب، ودمجها
في واجهة المستخدم لإنشاء الحملة.
قد يبدو تدفق الاستخدام كما يلي:
ينتقل أحد المستخدِمين إلى تطبيقك لإنشاء "حملة أداء أفضل".
يقدم المستخدم بعض المعلومات الأولية كجزء من عملية إنشاء الحملة. على سبيل المثال، تقدِّم الشركة تفاصيل لإنشاء
SitelinkAsset
واحدة، واختَرتTARGET_SPEND
لتكون استراتيجية عروض الأسعار الذكية.لنفترض أنّك ترسل الرمز
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
: تم الضبط على رقم تعريف العميل الذي ينشئ الحملة.
يمكنك أخذ الاقتراحات في
GenerateRecommendationsResponse
، وهي في هذه الحالة،SitelinkAssetRecommendation
وMaximizeClicksOptInRecommendation
، واقتراحها على المستخدم من خلال عرضها على واجهة إنشاء حملتك. إذا قبل المستخدم اقتراحًا، يمكنك دمجه في طلب إنشاء الحملة بعد أن يكمل المستخدم عملية إنشاء الحملة.