সাজেশন আপনার ক্যাম্পেনকে কয়েকটি উপায়ে উন্নত করতে পারে:
- নতুন ও প্রাসঙ্গিক ফিচার নিয়ে আসা
- উন্নত বিড, কীওয়ার্ড ও বিজ্ঞাপনের মাধ্যমে আপনার বাজেট থেকে আরও বেশি সুবিধা পান
- আপনার ক্যাম্পেনের সামগ্রিক পারফর্ম্যান্স ও দক্ষতা বাড়ান
অপ্টিমাইজেশন স্কোর বাড়াতে, আপনি
RecommendationService ব্যবহার করে সাজেশন
পেতে পারেন এবং তারপর সেই অনুযায়ী সেগুলি প্রয়োগ বা বাতিল করতে পারেন। এছাড়াও, আপনি RecommendationSubscriptionService ব্যবহার করে
সাজেশন অটোমেটিক প্রয়োগ করতে
সাবস্ক্রাইব করতে পারেন।
অপ্টিমাইজেশন স্কোর
আপনার Google Ads অ্যাকাউন্ট পারফর্ম করার জন্য কতটা ভালভাবে সেট-আপ করা হয়েছে তা অপ্টিমাইজেশন স্কোর থেকে অনুমান করা যায় এবং এটি Customer ও Campaign লেভেলে উপলভ্য।
customer এবং campaign
রিপোর্টের জন্য অপ্টিমাইজেশন-সম্পর্কিত মেট্রিক উপলভ্য আছে:
metrics.optimization_score_urlঅ্যাকাউন্টে একটি ডিপ লিঙ্ক প্রদান করে যাতে Google Ads UI-তে সম্পর্কিত সাজেশন সম্পর্কে তথ্য দেখা যায়।metrics.optimization_score_upliftথেকে জানা যায় যে, সব সম্পর্কিত সাজেশন প্রয়োগ করা হলে অপ্টিমাইজেশন স্কোর কতটা বাড়বে। এটি সামগ্রিকভাবে উপলভ্য সব সাজেশনের উপর ভিত্তি করে করা একটি অনুমান, প্রতিটি সাজেশনের জন্য আপলিফ্ট স্কোরের যোগফল নয়।
ফেরত আসা সাজেশন গ্রুপ ও অর্ডার করতে, আপনার কোয়েরিতে segments.recommendation_type ব্যবহার করে সাজেশনের ধরন অনুযায়ী
আপনি এই দুটি মেট্রিকই
সেগমেন্ট করতে পারবেন।
সাজেশনের ধরন
নিম্নলিখিত সারণীতে সাজেশনের ধরনগুলি তালিকাভুক্ত করা হয়েছে যা Google Ads API-তে সাজেশন ফিরিয়ে আনা, প্রয়োগ করা এবং খারিজ করার জন্য কাজ করে। কোনও অ্যাকাউন্টে
Google Ads UI-তে এমন সাজেশন থাকলে যা API-তে কাজ করে না,
তাহলে আপনি metrics.optimization_score_url ব্যবহার করে
সরাসরি Google Ads UI-তে সাজেশনের পৃষ্ঠায় ব্যবহারকারীদের লিঙ্ক করতে পারেন, যাতে তারা
সেই সাজেশনগুলি পর্যালোচনা করতে এবং সেই অনুযায়ী কাজ করতে পারেন।
সম্পূর্ণভাবে কাজ করে এমন সাজেশনের ধরন
| RecommendationType | বিবরণ |
|---|---|
CAMPAIGN_BUDGET |
বাজেটের দ্বারা সীমাবদ্ধ ক্যাম্পেন সংক্রান্ত সমস্যার সমাধান করুন |
KEYWORD |
নতুন কীওয়ার্ড যোগ করা |
TEXT_AD |
বিজ্ঞাপন সংক্রান্ত সাজেশন যোগ করুন |
TARGET_CPA_OPT_IN |
টার্গেট CPA-এর সাথে বিড করুন |
MAXIMIZE_CONVERSIONS_OPT_IN |
কনভার্সন বাড়ানোর বিডিংয়ের মাধ্যমে বিড করা |
MAXIMIZE_CONVERSION_VALUE_OPT_IN |
কনভার্সন ভ্যালু বাড়ানোর বিডিং ব্যবহার করে বিড করা |
ENHANCED_CPC_OPT_IN |
এনহেন্সড CPC-র মাধ্যমে বিড করা |
MAXIMIZE_CLICKS_OPT_IN |
'ক্লিক সর্বাধিক করুন' বিডিং স্ট্র্যাটেজি ব্যবহার করে বিড করা |
OPTIMIZE_AD_ROTATION |
অপ্টিমাইজ করা বিজ্ঞাপন রোটেশন ব্যবহার করুন |
MOVE_UNUSED_BUDGET |
অব্যবহৃত বাজেট থেকে সীমিত বাজেটে সরান |
TARGET_ROAS_OPT_IN |
টার্গেট ROAS-এর মাধ্যমে বিড করুন |
FORECASTING_CAMPAIGN_BUDGET |
ভবিষ্যতে বাজেটের মাধ্যমে সীমাবদ্ধ হয়ে যেতে পারে এমন ক্যাম্পেন সংক্রান্ত সমস্যার সমাধান করুন |
RESPONSIVE_SEARCH_AD |
নতুন রেসপন্সিভ সার্চ বিজ্ঞাপন যোগ করুন |
MARGINAL_ROI_CAMPAIGN_BUDGET |
ROI বাড়াতে ক্যাম্পেনের বাজেট অ্যাডজাস্ট করুন |
USE_BROAD_MATCH_KEYWORD |
অটোমেটেড বিডিং সহ কনভার্সন-ভিত্তিক ক্যাম্পেনের জন্য ব্রড ম্যাচ ব্যবহার করুন |
RESPONSIVE_SEARCH_AD_ASSET |
কোনও বিজ্ঞাপনে রেসপন্সিভ সার্চ বিজ্ঞাপনের অ্যাসেট যোগ করা |
RESPONSIVE_SEARCH_AD_IMPROVE_AD_STRENGTH |
রেসপন্সিভ সার্চ বিজ্ঞাপনের ক্ষমতা উন্নত করা |
DISPLAY_EXPANSION_OPT_IN |
Display Expansion ব্যবহার করার জন্য ক্যাম্পেন আপডেট করুন |
SEARCH_PARTNERS_OPT_IN |
Google Search পার্টনারদের সাথে রিচ বাড়ান |
CUSTOM_AUDIENCE_OPT_IN |
কাস্টম অডিয়েন্স তৈরি করুন |
IMPROVE_DEMAND_GEN_AD_STRENGTH |
ডিমান্ড জেনারেশন ক্যাম্পেনে বিজ্ঞাপনের ক্ষমতা উন্নত করুন |
UPGRADE_SMART_SHOPPING_CAMPAIGN_TO_PERFORMANCE_MAX |
স্মার্ট শপিং ক্যাম্পেনকে পারফর্ম্যান্স ম্যাক্স ক্যাম্পেনে আপগ্রেড করা |
UPGRADE_LOCAL_CAMPAIGN_TO_PERFORMANCE_MAX |
পুরনো স্থানীয় ক্যাম্পেনকে পারফর্ম্যান্স ম্যাক্স ক্যাম্পেনে আপগ্রেড করা |
SHOPPING_MIGRATE_REGULAR_SHOPPING_CAMPAIGN_OFFERS_TO_PERFORMANCE_MAX
|
নিয়মিত শপিং ক্যাম্পেন দ্বারা টার্গেট করা অফারগুলি আগে থেকে থাকা পারফর্ম্যান্স ম্যাক্স ক্যাম্পেনে মাইগ্রেট করুন |
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 |
টার্গেট CPA খুব কম হলে এবং খুব কম বা কোনও কনভার্সন না হলে টার্গেট CPA বাড়ান |
FORECASTING_SET_TARGET_ROAS |
সিজনাল ইভেন্টের আগে বাজেট বাড়ান যার ফলে ট্রাফিক বাড়বে বলে পূর্বাভাস দেওয়া হয়েছে এবং বিডিং স্ট্র্যাটেজি পরিবর্তন করুন কনভার্সন ভ্যালু বাড়ানো থেকে টার্গেট ROAS-এ |
LEAD_FORM_ASSET |
ক্যাম্পেনে লিড ফর্ম অ্যাসেট যোগ করা |
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 |
টার্গেট CPA বাড়ান |
LOWER_TARGET_ROAS |
টার্গেট ROAS কমানো |
FORECASTING_SET_TARGET_CPA |
যেসব ক্যাম্পেনের জন্য কোনও টার্গেট CPA নির্দিষ্ট করা নেই, সেগুলির জন্য টার্গেট CPA সেট করুন, সিজনাল ইভেন্টের আগে ট্রাফিক বাড়বে বলে পূর্বাভাস দেওয়া হয়েছে |
SET_TARGET_CPA |
যেসব ক্যাম্পেনের জন্য টার্গেট CPA নির্দিষ্ট করা নেই সেগুলির জন্য টার্গেট CPA সেট করুন |
SET_TARGET_ROAS |
যেসব ক্যাম্পেনের জন্য টার্গেট ROAS নির্দিষ্ট করা নেই সেগুলির জন্য টার্গেট ROAS সেট করুন |
REFRESH_CUSTOMER_MATCH_LIST |
গত ৯০ দিনে আপডেট করা হয়নি এমন গ্রাহক তালিকা আপডেট করুন |
IMPROVE_GOOGLE_TAG_COVERAGE |
আরও পৃষ্ঠায় Google ট্যাগ ডিপ্লয় করুন |
CAMPAIGN_SPECIFIC_APP_GOAL |
ক্যাম্পেন-ভিত্তিক অ্যাপ কনভার্সন সম্পর্কিত লক্ষ্য যোগ করুন |
RAISE_TARGET_CPA_PERFORMANCE_BID_TOO_LOW |
সার্চ ক্যাম্পেনের জন্য টার্গেট CPA খুব কম হলে তা বাড়ান |
LOWER_TARGET_ROAS_PERFORMANCE_BID_TOO_LOW |
সার্চ ক্যাম্পেনের জন্য টার্গেট ROAS খুব কম হলে তা আরও কমানো |
RAISE_BUDGET_PERFORMANCE_TOO_LOW |
সার্চ ক্যাম্পেনের জন্য বাজেট খুব কম হলে তা বাড়ান। v26 থেকে
উপলভ্য।
সাজেশনের বিবরণ
Recommendation.raise_budget_performance_too_low_recommendation-এ ফেরত দেওয়া হয়
এবং
ApplyRecommendationOperation.raise_budget_performance_too_low ব্যবহার করে প্রয়োগ করা হয়। |
OPTIMIZE_FOR_NEW_CUSTOMERS |
নতুন
গ্রাহক অর্জন-এর জন্য ক্যাম্পেন অপ্টিমাইজ করতে নতুন গ্রাহকদের জন্য ইনক্রিমেন্টাল কনভার্সন ভ্যালু সেট করুন। v26.1 থেকে উপলভ্য।
সাজেশনের বিবরণ
Recommendation.optimize_for_new_customers_recommendation-এ ফেরত দেওয়া হয়
এবং
ApplyRecommendationOperation.optimize_for_new_customers ব্যবহার করে প্রয়োগ করা হয়। |
KEYWORD_MATCH_TYPE (বন্ধ করে দেওয়া হয়েছে) |
বন্ধ করা হয়েছে, এর পরিবর্তে USE_BROAD_MATCH_KEYWORD ব্যবহার করুন |
সাজেশন ফিরিয়ে আনা
Google Ads API-এর অন্যান্য এন্টিটির মতো, Recommendation
অবজেক্ট
GoogleAdsService.SearchStream
ব্যবহার করে Google Ads কোয়েরি ল্যাঙ্গুয়েজ কোয়েরির মাধ্যমে ফেচ করা হয়।
প্রতিটি ধরনের সাজেশনের জন্য, সাজেশন-নির্দিষ্ট ফিল্ডে বিবরণ প্রদান করা হয়। যেমন, CAMPAIGN_BUDGET সাজেশনের
বিবরণ campaign_budget_recommendation ফিল্ডে
আছে এবং CampaignBudgetRecommendation অবজেক্টে
র্যাপ করা আছে।
recommendation ইউনিয়ন ফিল্ডে
সুপারিশ-নির্দিষ্ট সব ফিল্ড খুঁজুন।
সাজেশনের প্রভাব
কিছু সাজেশনের ধরন সাজেশনের
impact ফিল্ড পূরণ করে।
RecommendationImpact
সাজেশন প্রয়োগ করার ফলে অ্যাকাউন্টের পারফর্ম্যান্সে কী প্রভাব পড়তে পারে তার একটি অনুমান থাকে। নিম্নলিখিত
সাজেস্ট করা মেট্রিক
impact.base_metrics এবং impact.potential_metrics ফিল্ডে উপলভ্য:
impressionsclickscost_microsconversionsall_conversionsvideo_views
impact ফিল্ডে ডেটা থাকলেও, অন্যান্য ফ্যাক্টরের মধ্যে, সাজেশন ও ক্যাম্পেনের ধরনের উপর নির্ভর করে
মেট্রিকের উপলভ্যতা পরিবর্তিত হয়। সাধারণত,
প্রতিটি ইমপ্যাক্ট মেট্রিক ব্যবহার করার আগে সেটি উপলভ্য আছে কিনা তা চেক করে নিন।
কোডের উদাহরণ
নিম্নলিখিত স্যাম্পেল কোডটি কোনও অ্যাকাউন্ট থেকে 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.V26.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: str = """ SELECT recommendation.campaign, recommendation.keyword_recommendation FROM recommendation WHERE recommendation.type = KEYWORD""" # Detects keyword recommendations that exist for the customer account. response: Iterable[GoogleAdsRow] = googleads_service.search( customer_id=customer_id, query=query ) operations: List[ApplyRecommendationOperation] = [] for row in response: 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); });
কার্ল
# Gets keyword recommendations. # # Variables: # API_VERSION, # CUSTOMER_ID, # MANAGER_CUSTOMER_ID, # OAUTH2_ACCESS_TOKEN: # See https://developers.google.com/google-ads/api/rest/auth#request_headers # for details. curl -f --request POST \ "https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/googleAds:search" \ --header "Content-Type: application/json" \ --header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \ --header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \ --data @- <<EOF { "query": " SELECT recommendation.campaign, recommendation.keyword_recommendation FROM recommendation WHERE recommendation.type = KEYWORD " } EOF
পদক্ষেপ নিন
ফিরিয়ে আনা যেকোনও সাজেশন প্রয়োগ বা বাতিল করা যেতে পারে।
সাজেশনের ধরনের উপর নির্ভর করে, সাজেশন দৈনিক ভিত্তিতে বা এমনকি দিনে একাধিকবার পরিবর্তন হতে পারে। এমন হলে, সাজেশন ফিরিয়ে আনার পরে
সাজেশন অবজেক্টের resource_name
পুরনো হয়ে যেতে পারে।
সাজেশন পাওয়ার পরেই সেটির উপর অ্যাকশন নেওয়া ভালো অভ্যাস।
সাজেশন প্রয়োগ করুন
আপনি
RecommendationService-এর
ApplyRecommendation পদ্ধতির মাধ্যমে অ্যাক্টিভ বা বাতিল করা সাজেশন প্রয়োগ করতে পারবেন।
সাজেশনের ধরনের বাধ্যতামূলক বা ঐচ্ছিক প্যারামিটার থাকতে পারে। বেশিরভাগ সাজেশন সাজেস্ট করা ভ্যালু সহ আসে যা ডিফল্ট হিসেবে ব্যবহার করা হয়।
সাজেশন অটোমেটিক প্রয়োগ করার জন্য অ্যাকাউন্ট সেট-আপ করার সুবিধা
সব ধরনের সাজেশনের ক্ষেত্রে কাজ করে না। তবে, Google Ads API-এর মাধ্যমে সম্পূর্ণভাবে কাজ করে এমন সাজেশন ধরনের জন্য আপনি একই ধরনের
আচরণ প্রয়োগ করতে পারবেন।
আরও জানতে DetectAndApplyRecommendations কোড
উদাহরণ দেখুন।
নির্দিষ্ট প্যারামিটার ভ্যালু সহ সাজেশন প্রয়োগ করতে
ApplyRecommendationOperation-এর apply_parameters ইউনিয়ন ফিল্ড ব্যবহার করুন। প্রতিটি উপযুক্ত সাজেশনের ধরনের নিজস্ব ফিল্ড আছে। 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: GoogleAdsClient, recommendation: str ) -> ApplyRecommendationOperation: """Creates a ApplyRecommendationOperation to apply the given recommendation. Args: client: an initialized GoogleAdsClient instance. 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: ApplyRecommendationOperation = 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::V26::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::V26::Resources::Ad->new({ # id => "INSERT_AD_ID_AS_INTEGER_HERE" # }); # my $text_ad_parameters = # Google::Ads::GoogleAds::V26::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::V26::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.V26.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: GoogleAdsClient, customer_id: str, operations: List[ApplyRecommendationOperation], ) -> None: """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: ApplyRecommendationResult = ( recommendation_service.apply_recommendation( customer_id=customer_id, operations=operations ) ) for result in response.results: print( "Applied a recommendation with resource name: " f"'{result.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}; }
কার্ল
# Applies a recommendation. # # Variables: # API_VERSION, # CUSTOMER_ID, # MANAGER_CUSTOMER_ID, # OAUTH2_ACCESS_TOKEN: # See https://developers.google.com/google-ads/api/rest/auth#request_headers # for details. # # RECOMMENDATION_RESOURCE_NAME: The resource name of the recommendation to # apply, from the previous request. curl -f --request POST \ "https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/recommendations:apply" \ --header "Content-Type: application/json" \ --header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \ --header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \ --data @- <<EOF { "operations": [ { "resourceName": "${RECOMMENDATION_RESOURCE_NAME}" } ] } EOF
সাজেশন খারিজ করুন
আপনি
RecommendationService-এর মাধ্যমে সাজেশন বাতিল করতে পারবেন। কোডের
গঠন সাজেশন প্রয়োগ করার মতোই, তবে এর পরিবর্তে আপনি
DismissRecommendationOperation এবং
RecommendationService.DismissRecommendation ব্যবহার করেন।
বাল্ক অপারেশন ও সমস্যা ম্যানেজ করা
ApplyRecommendation এবং DismissRecommendation, উভয়ই অনুরোধ পিছু সর্বাধিক ১০০টি
অপারেশন গ্রহণ করে। একটি অনুরোধে একাধিক অপারেশন পাঠানোর সময়,
নিম্নলিখিত আচরণগুলি মনে রাখবেন:
- সাজেশনের ধরন মিক্স করা: ডিফল্ট (
partial_failure = false) হিসেবে, একটি অনুরোধের সব অপারেশনকে একই সাজেশনের ধরন টার্গেট করতে হবে; অন্যথায়, APIRecommendationError.DIFFERENT_TYPES_NOT_SUPPORTEDরিটার্ন করে। একই অনুরোধে বিভিন্ন ধরনের সাজেশন প্রয়োগ বা খারিজ করতে, অনুরোধেpartial_failure-কেtrue-এ সেট করুন যাতে সঠিক অপারেশন স্বাধীনভাবে সফল হয়। - লাইফসাইকেল সংক্রান্ত সমস্যা: যেহেতু সাজেশন ডাইনামিকভাবে মূল্যায়ন করা হয়, তাই
সাজেশনের স্ট্যাটাস পুনরুদ্ধার ও অ্যাকশনের মধ্যে পরিবর্তন হতে পারে। কোনও সাজেশন
আগে থেকেই প্রয়োগ করা হয়ে থাকলে, আগে থেকেই বাতিল করা হয়ে থাকলে অথবা আর প্রযোজ্য
না হলে, API
RECOMMENDATION_ALREADY_APPLIED,RECOMMENDATION_ALREADY_DISMISSEDঅথবাRECOMMENDATION_INVALIDATEDRecommendationError-এ ফিরিয়ে দেয়।
সাজেশন অটোমেটিক প্রয়োগ করুন
আপনি RecommendationSubscriptionService ব্যবহার করে
নির্দিষ্ট ধরনের সাজেশন অটোমেটিক প্রয়োগ করতে পারবেন।
নির্দিষ্ট কোনও সাজেশনের ধরন সাবস্ক্রাইব করতে,
RecommendationSubscription অবজেক্ট তৈরি করুন,
type ফিল্ডটি কাজ করে এমন সাজেশনের
ধরন হিসেবে সেট করুন এবং
status ফিল্ডটি ENABLED হিসেবে সেট করুন।
সাবস্ক্রিপশন-সমর্থিত সাজেশনের ধরন
ENHANCED_CPC_OPT_INKEYWORDKEYWORD_MATCH_TYPELOWER_TARGET_ROASMAXIMIZE_CLICKS_OPT_INOPTIMIZE_AD_ROTATIONRAISE_TARGET_CPARESPONSIVE_SEARCH_ADRESPONSIVE_SEARCH_AD_IMPROVE_AD_STRENGTHSEARCH_PARTNERS_OPT_INSET_TARGET_CPASET_TARGET_ROASTARGET_CPA_OPT_INTARGET_ROAS_OPT_INUSE_BROAD_MATCH_KEYWORD
সাবস্ক্রিপশন ফিরিয়ে আনুন
কোনও অ্যাকাউন্টের সাজেশন সাবস্ক্রিপশন সম্পর্কে তথ্য পেতে,
recommendation_subscription রিসোর্স কোয়েরি করুন।
অটোমেটিক প্রয়োগ করা পরিবর্তন দেখতে,
change_event রিসোর্স কোয়েরি করুন,
change_event.client_type থেকে
GOOGLE_ADS_RECOMMENDATIONS_SUBSCRIPTION ফিল্টার করুন।
ক্যাম্পেন কনস্ট্রাকশনে সাজেশন
আপনি
RecommendationService.GenerateRecommendationsRequest ব্যবহার করে
ক্যাম্পেন কনস্ট্রাকশন চলাকালীন সাজেশন জেনারেট করতে পারবেন, সাজেশনের ধরন
অনুযায়ী।
GenerateRecommendations ইনপুট হিসেবে কাস্টমার আইডি, বিজ্ঞাপন চ্যানেলের ধরন
যা অবশ্যই SEARCH অথবা
PERFORMANCE_MAX হতে হবে, তৈরি করার জন্য সাজেস্ট করা ধরনের তালিকা
এবং নির্দিষ্ট ধরনের উপর নির্ভর করে বিভিন্ন ডেটা পয়েন্ট গ্রহণ করে। আপনার দেওয়া ডেটার ভিত্তিতে এটি
Recommendationটি অবজেক্টের তালিকা আউটপুট হিসেবে দেখায়। অনুরোধ করা
recommendation_types-এর জন্য সাজেশন তৈরি করার মতো পর্যাপ্ত ডেটা না থাকলে অথবা ক্যাম্পেনটি আগে থেকেই সাজেস্ট করা অবস্থায় থাকলে, ফলাফল সেটে সেই ধরনের সাজেশন থাকবে না।
অনুরোধ করা সাজেশনের ধরনের জন্য কোনও সাজেশন না পাওয়া গেলে, আপনার অ্যাপ্লিকেশন যাতে সেই পরিস্থিতি
ম্যানেজ করতে পারে তা নিশ্চিত করুন।
GenerateRecommendations-এ কাজ করে এমন সাজেশনের ধরন এবং সেই ধরনের সাজেশন পেতে আপনাকে যেসব ফিল্ড পূরণ করতে হবে, তা নিচের সারণীতে বর্ণনা করা হয়েছে। পেশাদার পদ্ধতি হিসেবে, অনুরোধ করা সাজেশনের ধরন সম্পর্কিত সব তথ্য সংগ্রহ করার
পরে
GenerateRecommendations অনুরোধ পাঠান। নেস্টেড ফিল্ড সহ প্রয়োজনীয় ও ঐচ্ছিক ফিল্ডের ব্যাপারে অতিরিক্ত বিবরণের জন্য
রেফারেন্স ডকুমেন্টেশন
দেখুন।
| RecommendationType | ফাঁকা রাখা যাবে না | ঐচ্ছিক ফিল্ড |
|---|---|---|
CAMPAIGN_BUDGET |
Search এবং পারফর্ম্যান্স ম্যাক্স ক্যাম্পেন, দুটির ক্ষেত্রেই নিম্নলিখিত ফিল্ডগুলি
প্রয়োজন:
|
|
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— এবং আপনার ক্যাম্পেন কনস্ট্রাকশন ইন্টারফেসে সেগুলি দেখানোর মাধ্যমে ব্যবহারকারীকে সাজেস্ট করতে পারেন। ব্যবহারকারী কোনও সাজেশন গ্রহণ করলে, ব্যবহারকারী ক্যাম্পেন কনস্ট্রাকশন ফ্লো সম্পূর্ণ করার পরে আপনি সেটি ক্যাম্পেন তৈরির অনুরোধে অন্তর্ভুক্ত করতে পারেন।