আপনার মিডিয়া প্ল্যানের জন্য টার্গেটিং সেটিংস এবং প্রোডাক্ট মিক্স সংগ্রহ করার পরে,
ReachPlanService-এ
GenerateReachForecast পদ্ধতি ব্যবহার করে সম্ভাব্য রিচের বিপরীতে বাজেটের কার্ভ তৈরি করতে পারবেন। অনুরোধের ফিল্ড সম্পর্কে বিস্তারিত জানতে
শব্দকোষ এবং মিডিয়া প্ল্যান
গাইড দেখুন।
পূর্বাভাস মেট্রিক
GenerateReachForecast-এর উত্তরে Forecast মেসেজের মধ্যে বিভিন্ন মেট্রিক অন্তর্ভুক্ত থাকে, যা আপনার পরিকল্পিত ক্যাম্পেনের সম্ভাব্য পারফর্ম্যান্স সম্পর্কে ইনসাইট প্রদান করে। এইসব মেট্রিক্সের মধ্যে রয়েছে:
- রিচ (কো-ভিউ সহ অন-টার্গেট ও মোট)
- ইম্প্রেশন (অন-টার্গেট এবং মোট, কো-ভিউ এবং ভিউয়েবল সহ)
- কার্যকরী ফ্রিকোয়েন্সি ব্রেকডাউন (কতজন অনন্য ব্যবহারকারীর কাছে অন্তত একটি নির্দিষ্ট সংখ্যক বার পৌঁছানো হয়েছে; যেমন, ১+, ২+ বা ৩+ ইম্প্রেশন)
- ব্যবহারকারীর অ্যাকশন (TrueView ভিউ, কনভার্সন ও ক্লিক)
ডিমান্ড জেনারেশনের জন্য পূর্বাভাসের রিচ
DEMAND_GENটি প্ল্যান করা যায় এমন প্রোডাক্টের জন্য কার্ভ তৈরি করার সময়, আপনাকে প্রতিটি প্রোডাক্টের জন্য প্রত্যাশিত কনভার্সন রেটও
অন্তর্ভুক্ত করতে হবে।
প্ল্যান করা যায় এমন কাজ করে এমন প্রোডাক্টের জন্য কনভার্সন রেট সাজেশন পেতে,
GenerateConversionRates পদ্ধতি ব্যবহার করুন। এই পদ্ধতি
আপনার অ্যাকাউন্টের পারফর্ম্যান্সের ইতিহাস অথবা সব বিজ্ঞাপনদাতার পারফর্ম্যান্সের উপর ভিত্তি করে
কনভার্সন রেট সংক্রান্ত সাজেশন দেখায়।
DEMAND_GEN প্রোডাক্টের জন্য, GenerateConversionRates একই প্রোডাক্টের জন্য একাধিক
সাজেশন দেখাতে পারে। কিছু সাজেশনে surface_targeting
ফিল্ড পূরণ করা থাকে, যা ইঙ্গিত করে যে সাজেশনটি শুধুমাত্র সেই নির্দিষ্ট সারফেসের কম্বিনেশনের (যেমন, YouTube Shorts) ক্ষেত্রে প্রযোজ্য। surface_targeting
পপুলেট করা না হলে, সাজেশনটি হল সেই প্রোডাক্টের জন্য ডিমান্ড জেনারেশন ক্যাম্পেনের
গড়। সারফেস টার্গেটিং সহ ডিমান্ড জেনারেশন ক্যাম্পেনের জন্য পূর্বাভাস জেনারেট করার সময়, সবচেয়ে নির্দিষ্ট কনভার্সন রেট সাজেশন
ব্যবহার করুন।
কনভার্সন রেট ছাড়াও, ডিমান্ড জেনারেশন ব্যবহারকারীরা
GenerateReachForecast ব্যবহার করে clicks প্রজেক্ট করতে পারেন, যা বিশেষ করে
ক্লিকের জন্য অপ্টিমাইজ করা ক্যাম্পেনের ক্ষেত্রে প্রাসঙ্গিক, যেমন সর্বাধিক ক্লিক বিডিং সহ ডিমান্ড জেনারেশন।
YouTube Select-এর জন্য পূর্বাভাসের রিচ।
ReachPlanService-এ YouTube Select (YTS) Instant Reserve মূল্যে সব উপযুক্ত YTS লোকেশনের জন্য
লাইনআপ-লেভেল টার্গেটিংয়ে কাজ করে। উপলভ্য লাইন-আপ শনাক্ত করতে
ReachPlanService.ListPlannableProducts-এ
youtube_select_lineup_targeting ফিল্ড ব্যবহার করুন (youtube_select_lineup_targeting ফিল্ডটি
youtube_select_lineups ফিল্ডের পরিবর্তে ব্যবহার করা হয়, যা v23-এ বাতিল করা হয়েছে এবং
v24-এ সরিয়ে দেওয়া হয়েছে)।
Instant Reserve-এর ক্ষেত্রে, YTS-এর জন্য পূর্বাভাস পাওয়ার অনুরোধ করার সময় নিম্নলিখিত সমস্যাগুলি হতে পারে:
কার্ভ সেভ করুন
আপনার ব্যবহারকারীদের সুবিধা প্রদান করার জন্য আপনি শুধুমাত্র স্বতন্ত্র কার্ভ সেভ করতে পারবেন। কার্ভের ডেটা ক্যাশে করা কঠোরভাবে নিষিদ্ধ। আপনাকে যদি একসাথে অনেক কার্ভ তৈরি করতে হয়, তাহলে প্রথমে আপনার Google অ্যাকাউন্ট প্রতিনিধির সাথে যোগাযোগ করুন।
সমস্যা ম্যানেজ করা
ReachPlanService-এ করা অনুরোধ অবশ্যই প্রাথমিক API
কাঠামো অনুসরণ করতে হবে এবং যাচাইকরণে ব্যর্থ হলে সাধারণ
ত্রুটি দেখাতে পারে।
সাধারণ সমস্যার পাশাপাশি, ReachPlanService-এর মাধ্যমে ReachPlanError-এ তালিকাভুক্ত রিচ প্ল্যানিংয়ের সাথে সম্পর্কিত সমস্যাও
ফেরত পাঠানো হতে পারে।
কোডের উদাহরণ
কার্ভে ইম্প্রেশন ও ব্যবহারকারীর কাছে পৌঁছানোর সংখ্যা এবং অনুরোধ করা ডেমোগ্রাফি ও দেশের জন্য জনগণনার ভিত্তিতে জনসংখ্যা ও YouTube দর্শকের সাইজ অনুযায়ী ইউনিভার্স সাইজ অন্তর্ভুক্ত থাকে।
Java
private void getReachCurve( ReachPlanServiceClient reachPlanServiceClient, GenerateReachForecastRequest request) { GenerateReachForecastResponse response = reachPlanServiceClient.generateReachForecast(request); System.out.println("Reach curve output:"); System.out.println( "Currency, Cost Micros, On-Target Reach, On-Target Imprs, Total Reach, Total Imprs," + " Products"); for (ReachForecast point : response.getReachCurve().getReachForecastsList()) { System.out.printf( "%s, \"", Joiner.on(", ") .join( request.getCurrencyCode(), String.valueOf(point.getCostMicros()), String.valueOf(point.getForecast().getOnTargetReach()), String.valueOf(point.getForecast().getOnTargetImpressions()), String.valueOf(point.getForecast().getTotalReach()), String.valueOf(point.getForecast().getTotalImpressions()))); for (PlannedProductReachForecast product : point.getPlannedProductReachForecastsList()) { System.out.printf("[Product: %s, ", product.getPlannableProductCode()); System.out.printf("Budget Micros: %s]", product.getCostMicros()); } System.out.printf("\"%n"); } }
C#
public void GetReachCurve(ReachPlanServiceClient reachPlanService, GenerateReachForecastRequest request) { GenerateReachForecastResponse response = reachPlanService.GenerateReachForecast( request); Console.WriteLine("Reach curve output:"); Console.WriteLine( "Currency, Cost Micros, On-Target Reach, On-Target Impressions, Total Reach," + " Total Impressions, Products"); foreach (ReachForecast point in response.ReachCurve.ReachForecasts) { Console.Write($"{request.CurrencyCode}, "); Console.Write($"{point.CostMicros}, "); Console.Write($"{point.Forecast.OnTargetReach}, "); Console.Write($"{point.Forecast.OnTargetImpressions}, "); Console.Write($"{point.Forecast.TotalReach}, "); Console.Write($"{point.Forecast.TotalImpressions}, "); Console.Write("\"["); foreach (PlannedProductReachForecast productReachForecast in point.PlannedProductReachForecasts) { Console.Write($"(Product: {productReachForecast.PlannableProductCode}, "); Console.Write($"Budget Micros: {productReachForecast.CostMicros}), "); } Console.WriteLine("]\""); } }
PHP
private static function getReachCurve( GoogleAdsClient $googleAdsClient, int $customerId, array $productMix, string $locationId, string $currencyCode ) { // Valid durations are between 1 and 90 days. $duration = new CampaignDuration(['duration_in_days' => 28]); $targeting = new Targeting([ 'plannable_location_id' => $locationId, 'age_range' => ReachPlanAgeRange::AGE_RANGE_18_65_UP, 'genders' => [ new GenderInfo(['type' => GenderType::FEMALE]), new GenderInfo(['type' => GenderType::MALE]) ], 'devices' => [ new DeviceInfo(['type' => Device::DESKTOP]), new DeviceInfo(['type' => Device::MOBILE]), new DeviceInfo(['type' => Device::TABLET]) ] ]); // See the docs for defaults and valid ranges: // https://developers.google.com/google-ads/api/reference/rpc/latest/GenerateReachForecastRequest $response = $googleAdsClient->getReachPlanServiceClient()->generateReachForecast( GenerateReachForecastRequest::build($customerId, $duration, $productMix) ->setCurrencyCode($currencyCode) ->setTargeting($targeting) ); printf( "Reach curve output:%sCurrency, Cost Micros, On-Target Reach, On-Target Imprs," . " Total Reach, Total Imprs, Products%s", PHP_EOL, PHP_EOL ); foreach ($response->getReachCurve()->getReachForecasts() as $point) { $products = ''; /** @var ReachForecast $point */ foreach ($point->getPlannedProductReachForecasts() as $plannedProductReachForecast) { /** @var PlannedProductReachForecast $plannedProductReachForecast */ $products .= sprintf( '(Product: %s, Budget Micros: %s)', $plannedProductReachForecast->getPlannableProductCode(), $plannedProductReachForecast->getCostMicros() ); } printf( "%s, %d, %d, %d, %d, %d, %s%s", $currencyCode, $point->getCostMicros(), $point->getForecast()->getOnTargetReach(), $point->getForecast()->getOnTargetImpressions(), $point->getForecast()->getTotalReach(), $point->getForecast()->getTotalImpressions(), $products, PHP_EOL ); } }
Python
def request_reach_curve( client: GoogleAdsClient, customer_id: str, product_mix: list[PlannedProduct], location_id: str, currency_code: str, ): """Creates a sample request for a given product mix. Args: client: an initialized GoogleAdsClient instance. customer_id: The customer ID for the reach forecast. product_mix: The product mix for the reach forecast. location_id: The location ID to plan for. currency_code: Three-character ISO 4217 currency code. """ # See the docs for defaults and valid ranges: # https://developers.google.com/google-ads/api/reference/rpc/latest/GenerateReachForecastRequest request: GenerateReachForecastRequest = client.get_type( "GenerateReachForecastRequest" ) request.customer_id = customer_id # Valid durations are between 1 and 90 days. request.campaign_duration.duration_in_days = 28 request.currency_code = currency_code request.cookie_frequency_cap = 0 request.min_effective_frequency = 1 request.planned_products = product_mix request.targeting.plannable_location_id = location_id request.targeting.age_range = ( client.enums.ReachPlanAgeRangeEnum.AGE_RANGE_18_65_UP ) # Add gender targeting to the request. gender_type: GenderTypeEnum for gender_type in [ client.enums.GenderTypeEnum.FEMALE, client.enums.GenderTypeEnum.MALE, ]: gender: GenderInfo = client.get_type("GenderInfo") gender.type_ = gender_type request.targeting.genders.append(gender) # Add device targeting to the request. device_type: DeviceEnum for device_type in [ client.enums.DeviceEnum.DESKTOP, client.enums.DeviceEnum.MOBILE, client.enums.DeviceEnum.TABLET, ]: device: DeviceInfo = client.get_type("DeviceInfo") device.type_ = device_type request.targeting.devices.append(device) reach_plan_service: ReachPlanServiceClient = client.get_service( "ReachPlanService" ) response: GenerateReachForecastResponse = ( reach_plan_service.generate_reach_forecast(request=request) ) print( "Currency, Cost, On-Target Reach, On-Target Imprs, Total Reach," " Total Imprs, Products" ) point: ReachForecast for point in response.reach_curve.reach_forecasts: product_splits = [] p: PlannedProductReachForecast for p in point.planned_product_reach_forecasts: product_splits.append( {p.plannable_product_code: p.cost_micros / ONE_MILLION} ) print( [ currency_code, point.cost_micros / ONE_MILLION, point.forecast.on_target_reach, point.forecast.on_target_impressions, point.forecast.total_reach, point.forecast.total_impressions, product_splits, ] )
Ruby
def get_reach_curve( client, reach_plan_service, customer_id, product_mix, location_id, currency_code) duration = client.resource.campaign_duration do |d| # Valid durations are between 1 and 90 days. d.duration_in_days = 28 end targeting = client.resource.targeting do |t| t.plannable_location_id = location_id t.age_range = :AGE_RANGE_18_65_UP t.genders << client.resource.gender_info do |gender| gender.type = :FEMALE end t.genders << client.resource.gender_info do |gender| gender.type = :MALE end t.devices << client.resource.device_info do |device| device.type = :DESKTOP end t.devices << client.resource.device_info do |device| device.type = :MOBILE end t.devices << client.resource.device_info do |device| device.type = :TABLET end end # See the docs for defaults and valid ranges: # https://developers.google.com/google-ads/api/reference/rpc/latest/GenerateReachForecastRequest response = reach_plan_service.generate_reach_forecast( customer_id: customer_id, campaign_duration: duration, planned_products: product_mix, currency_code: currency_code, targeting: targeting, ) puts "Reach curve output:" puts "Currency, Cost Micros, On-Target Reach, On-Target Imprs, " \ "Total Reach, Total Imprs, Products" response.reach_curve.reach_forecasts.each do |point| products = "" point.planned_product_reach_forecasts.each do |product| products += "(Product: #{product.plannable_product_code}, "\ "Cost Micros: #{product.cost_micros})" end puts "#{currency_code}, #{point.cost_micros}, " \ "#{point.forecast.on_target_reach}, " \ "#{point.forecast.on_target_impressions}, " \ "#{point.forecast.total_reach}, " \ "#{point.forecast.total_impressions}, " \ "#{products}" end end
Perl
sub pull_reach_curve { my ($reach_plan_service, $reach_request) = @_; my $response = $reach_plan_service->generate_reach_forecast($reach_request); print "Reach curve output:\n"; print "Currency,\tCost Micros,\tOn-Target Reach,\tOn-Target Imprs,\t" . "Total Reach,\tTotal Imprs,\tProducts\n"; foreach my $point (@{$response->{reachCurve}{reachForecasts}}) { printf "%s,\t%d,\t%d,\t%d,\t%d,\t%d,\t'[", $reach_request->{currencyCode}, $point->{costMicros}, $point->{forecast}{onTargetReach}, $point->{forecast}{onTargetImpressions}, $point->{forecast}{totalReach}, $point->{forecast}{totalImpressions}; foreach my $productReachForecast (@{$point->{plannedProductReachForecasts}}) { printf "(Product: %s, Budget Micros: %d), ", $productReachForecast->{plannableProductCode}, $productReachForecast->{costMicros}; } print "]'\n"; } }
কার্ল
Google সমস্যা ট্র্যাকার
সহায়তা সংক্রান্ত প্রশ্ন জিজ্ঞাসা করতে, বাগ রিপোর্ট করতে বা ফিচার রিকোয়েস্ট জমা দিতে Google Issue Tracker ব্যবহার করুন। Google আপনার অনুরোধ ট্র্যাক করে, অগ্রাধিকার দেয় এবং আপডেট পোস্ট করে সরাসরি Issue Tracker-এ। আরও তথ্যের জন্য, Google Issue Tracker-এ সমস্যা তৈরি করুন দেখুন।
নিম্নলিখিত Issue Tracker টেমপ্লেটগুলির মধ্যে একটি ব্যবহার করে সমস্যা তৈরি করুন:
- সহায়তা সংক্রান্ত সাধারণ প্রশ্ন জিজ্ঞাসা করা বা ডকুমেন্টেশন সংক্রান্ত মতামত জমা দেওয়া
- টেকনিক্যাল সমস্যা সম্পর্কে অভিযোগ জানান
- API ফিচার সংক্রান্ত অনুরোধ জমা দিন
টেমপ্লেটের সব ফিল্ডে বিস্তারিত তথ্য লিখুন যাতে Google আপনার অনুরোধ পুনরায় তৈরি করতে ও অগ্রাধিকার দিতে পারে। Google অসম্পূর্ণ রিপোর্ট বন্ধ করে দিতে পারে এবং বাদ পড়ে যাওয়া বিবরণ সহ নতুন সমস্যা জমা দিতে বলতে পারে।