Google বিভিন্ন পণ্য এবং শ্রোতা অফার করে যা আপনি প্রচারাভিযান তৈরি করতে ব্যবহার করতে পারেন, যদিও আপনি কীভাবে একটি পরিকল্পনা তৈরি করতে জানেন না। এটিতে সাহায্য করার জন্য, ReachPlanService আবিষ্কারের পদ্ধতিগুলি প্রদান করে যা আপনি একটি বক্ররেখা তৈরি করতে ব্যবহার করতে পারেন৷
দর্শক টার্গেটিং
একটি মিডিয়া প্ল্যানের প্রথম উপাদান হল দর্শক টার্গেটিং, যার মধ্যে নিম্নলিখিত টার্গেট মানদণ্ড অন্তর্ভুক্ত থাকতে পারে:
- শ্রোতা
- রেফারেন্স
AudienceTargeting। - বয়স সীমা
-
ReachPlanAgeRangeenum উল্লেখ করুন। - লিঙ্গ
-
GenderInfoমানদণ্ড উল্লেখ করুন। - ডিভাইস
-
DeviceInfoমানদণ্ড উল্লেখ করুন। - অবস্থানসমূহ
- সমর্থিত অবস্থান আইডি খুঁজতে
ListPlannableLocationsপদ্ধতি ব্যবহার করুন। - নেটওয়ার্ক
- প্রযোজ্য নেটওয়ার্কগুলি খুঁজে পেতে
ListPlannableLocationsপদ্ধতি ব্যবহার করুন, যা পণ্য এবং অঞ্চল অনুসারে পরিবর্তিত হতে পারে।
আপনি সব
টার্গেটিং তথ্য ছাড়াও, একটি বক্ররেখা তৈরি করার জন্য আপনাকে অবশ্যই একটি পণ্য মিশ্রণ নির্দিষ্ট করতে হবে।
ReachPlanService এ ListPlannableProducts পদ্ধতি প্রদত্ত অবস্থান আইডির জন্য সর্বশেষ উপলব্ধ ফর্ম্যাটগুলি দেখায়, যা ProductMetadata এর plannable_product_code এবং plannable_product_name ক্ষেত্র দ্বারা প্রতিনিধিত্ব করে। মনে রাখবেন যে এই মানগুলি পর্যায়ক্রমে পরিবর্তিত হয়, তাই আপনার ব্যবহারকারীদের অফলাইনে উত্তর না দিয়ে লাইভ ফলাফল প্রদান করা ভাল।
এখানে কিছু লক্ষ্য মাপদণ্ডের জন্য পণ্য মিশ্রণ কিভাবে পেতে হয় তার একটি কোড উদাহরণ:
জাভা
private void showPlannableProducts(
ReachPlanServiceClient reachPlanServiceClient, String locationId) {
ListPlannableProductsRequest request =
ListPlannableProductsRequest.newBuilder().setPlannableLocationId(locationId).build();
ListPlannableProductsResponse response = reachPlanServiceClient.listPlannableProducts(request);
System.out.printf("Plannable Products for location %s:%n", locationId);
for (ProductMetadata product : response.getProductMetadataList()) {
System.out.printf("%s:%n", product.getPlannableProductCode());
System.out.println("Age Ranges:");
for (ReachPlanAgeRange ageRange : product.getPlannableTargeting().getAgeRangesList()) {
System.out.printf("\t- %s%n", ageRange);
}
System.out.println("Genders:");
for (GenderInfo gender : product.getPlannableTargeting().getGendersList()) {
System.out.printf("\t- %s%n", gender.getType());
}
System.out.println("Devices:");
for (DeviceInfo device : product.getPlannableTargeting().getDevicesList()) {
System.out.printf("\t- %s%n", device.getType());
}
}
}
সি#
public void ShowPlannableProducts(
ReachPlanServiceClient reachPlanService, string locationId)
{
ListPlannableProductsRequest request = new ListPlannableProductsRequest
{
PlannableLocationId = locationId
};
ListPlannableProductsResponse response = reachPlanService.ListPlannableProducts(
request);
Console.WriteLine($"Plannable Products for location {locationId}:");
foreach (ProductMetadata product in response.ProductMetadata)
{
Console.WriteLine($"{product.PlannableProductCode}:");
Console.WriteLine("Age Ranges:");
foreach (ReachPlanAgeRange ageRange in product.PlannableTargeting.AgeRanges)
{
Console.WriteLine($"\t- {ageRange}");
}
Console.WriteLine("Genders:");
foreach (GenderInfo gender in product.PlannableTargeting.Genders)
{
Console.WriteLine($"\t- {gender.Type}");
}
Console.WriteLine("Devices:");
foreach (DeviceInfo device in product.PlannableTargeting.Devices)
{
Console.WriteLine($"\t- {device.Type}");
}
}
}
পিএইচপি
private static function showPlannableProducts(GoogleAdsClient $googleAdsClient)
{
$response = $googleAdsClient->getReachPlanServiceClient()->listPlannableProducts(
ListPlannableProductsRequest::build(self::LOCATION_ID)
);
print 'Plannable Products for Location ID ' . self::LOCATION_ID . ':' . PHP_EOL;
foreach ($response->getProductMetadata() as $product) {
/** @var ProductMetadata $product */
print $product->getPlannableProductCode() . ':' . PHP_EOL;
print 'Age Ranges:' . PHP_EOL;
foreach ($product->getPlannableTargeting()->getAgeRanges() as $ageRange) {
/** @var ReachPlanAgeRange $ageRange */
printf("\t- %s%s", ReachPlanAgeRange::name($ageRange), PHP_EOL);
}
print 'Genders:' . PHP_EOL;
foreach ($product->getPlannableTargeting()->getGenders() as $gender) {
/** @var GenderInfo $gender */
printf("\t- %s%s", GenderType::name($gender->getType()), PHP_EOL);
}
print 'Devices:' . PHP_EOL;
foreach ($product->getPlannableTargeting()->getDevices() as $device) {
/** @var DeviceInfo $device */
printf("\t- %s%s", Device::name($device->getType()), PHP_EOL);
}
}
}
পাইথন
def show_plannable_products(client, location_id):
"""Lists plannable products for a given location.
Args:
client: an initialized GoogleAdsClient instance.
location_id: The location ID to plan for.
"""
reach_plan_service = client.get_service("ReachPlanService")
response = reach_plan_service.list_plannable_products(
plannable_location_id=location_id
)
print(f"Plannable Products for Location ID {location_id}")
for product_metadata in response.product_metadata:
print(
f"{product_metadata.plannable_product_code} : "
f"{product_metadata.plannable_product_name}"
)
print("Age Ranges:")
for age_range in product_metadata.plannable_targeting.age_ranges:
print(f"\t- {age_range.name}")
print("Genders:")
for gender in product_metadata.plannable_targeting.genders:
print(f"\t- {gender.type_.name}")
print("Devices:")
for device in product_metadata.plannable_targeting.devices:
print(f"\t- {device.type_.name}")
রুবি
def show_plannable_products(reach_plan_service)
response = reach_plan_service.list_plannable_products(
plannable_location_id: LOCATION_ID,
)
puts "Plannable Products for Location ID #{LOCATION_ID}:"
response.product_metadata.each do |product|
puts "#{product.plannable_product_code}:"
puts "Age Ranges:"
product.plannable_targeting.age_ranges.each do |age_range|
puts "\t- #{age_range}"
end
puts "Genders:"
product.plannable_targeting.genders.each do |gender|
puts "\t- #{gender.type}"
end
puts "Devices:"
product.plannable_targeting.devices.each do |device|
puts "\t- #{device.type}"
end
end
end
পার্ল
sub show_plannable_products {
my ($reach_plan_service, $location_id) = @_;
my $response = $reach_plan_service->list_plannable_products({
plannableLocationId => $location_id
});
printf "Plannable Products for location %d:\n", $location_id;
foreach my $product (@{$response->{productMetadata}}) {
printf "%s : '%s'\n", $product->{plannableProductCode},
$product->{plannableProductName};
print "Age Ranges:\n";
foreach my $age_range (@{$product->{plannableTargeting}{ageRanges}}) {
printf "\t- %s\n", $age_range;
}
print "Genders:\n";
foreach my $gender (@{$product->{plannableTargeting}{genders}}) {
printf "\t- %s\n", $gender->{type};
}
print "Devices:\n";
foreach my $device (@{$product->{plannableTargeting}{devices}}) {
printf "\t- %s\n", $device->{type};
}
}
}
একটি বক্ররেখা তৈরি করতে আপনি তারপর প্রতিটি পণ্যের জন্য একটি বাজেট বরাদ্দ করবেন:
জাভা
private void forecastManualMix(
ReachPlanServiceClient reachPlanServiceClient,
long customerId,
String locationId,
String currencyCode,
long budgetMicros) {
List<PlannedProduct> productMix = new ArrayList<>();
// Set up a ratio to split the budget between two products.
double trueviewAllocation = 0.15;
double bumperAllocation = 1 - trueviewAllocation;
// See listPlannableProducts on ReachPlanService to retrieve a list
// of valid PlannableProductCode's for a given location:
// https://developers.google.com/google-ads/api/reference/rpc/latest/ReachPlanService
productMix.add(
PlannedProduct.newBuilder()
.setPlannableProductCode("TRUEVIEW_IN_STREAM")
.setBudgetMicros((long) (budgetMicros * bumperAllocation))
.build());
productMix.add(
PlannedProduct.newBuilder()
.setPlannableProductCode("BUMPER")
.setBudgetMicros((long) (budgetMicros * bumperAllocation))
.build());
GenerateReachForecastRequest request =
buildReachRequest(customerId, productMix, locationId, currencyCode);
getReachCurve(reachPlanServiceClient, request);
}
সি#
public void ForecastMix(ReachPlanServiceClient reachPlanService, string customerId,
string locationId, string currencyCode, long budgetMicros)
{
List<PlannedProduct> productMix = new List<PlannedProduct>();
// Set up a ratio to split the budget between two products.
double trueviewAllocation = 0.15;
double bumperAllocation = 1 - trueviewAllocation;
// See listPlannableProducts on ReachPlanService to retrieve a list
// of valid PlannableProductCode's for a given location:
// https://developers.google.com/google-ads/api/reference/rpc/latest/ReachPlanService
productMix.Add(new PlannedProduct
{
PlannableProductCode = "TRUEVIEW_IN_STREAM",
BudgetMicros = Convert.ToInt64(budgetMicros * trueviewAllocation)
});
productMix.Add(new PlannedProduct
{
PlannableProductCode = "BUMPER",
BudgetMicros = Convert.ToInt64(budgetMicros * bumperAllocation)
});
GenerateReachForecastRequest request =
BuildReachRequest(customerId, productMix, locationId, currencyCode);
GetReachCurve(reachPlanService, request);
}
পিএইচপি
private static function forecastManualMix(GoogleAdsClient $googleAdsClient, int $customerId)
{
// Set up a ratio to split the budget between two products.
$trueviewAllocation = floatval(0.15);
$bumperAllocation = floatval(1 - $trueviewAllocation);
// See listPlannableProducts on ReachPlanService to retrieve a list
// of valid PlannableProductCode's for a given location:
// https://developers.google.com/google-ads/api/reference/rpc/latest/ReachPlanService
$productMix = [
new PlannedProduct([
'plannable_product_code' => 'TRUEVIEW_IN_STREAM',
'budget_micros' => self::BUDGET_MICROS * $trueviewAllocation
]),
new PlannedProduct([
'plannable_product_code' => 'BUMPER',
'budget_micros' => self::BUDGET_MICROS * $bumperAllocation
])
];
self::getReachCurve(
$googleAdsClient,
$customerId,
$productMix,
self::LOCATION_ID,
self::CURRENCY_CODE
);
}
পাইথন
def forecast_manual_mix(
client, customer_id, location_id, currency_code, budget
):
"""Pulls a forecast for product mix created manually.
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.
budget: Budget to allocate to the plan.
"""
product_mix = []
trueview_allocation = 0.15
bumper_allocation = 1 - trueview_allocation
product_splits = [
("TRUEVIEW_IN_STREAM", trueview_allocation),
("BUMPER", bumper_allocation),
]
for product, split in product_splits:
planned_product = client.get_type("PlannedProduct")
planned_product.plannable_product_code = product
planned_product.budget_micros = math.trunc(budget * ONE_MILLION * split)
product_mix.append(planned_product)
request_reach_curve(
client, customer_id, product_mix, location_id, currency_code
)
রুবি
def forecast_manual_mix(client, reach_plan_service, customer_id)
# Set up a ratio to split the budget between two products.
trueview_allocation = 0.15
bumper_allocation = 1 - trueview_allocation
# See listPlannableProducts on ReachPlanService to retrieve a list
# of valid PlannableProductCode's for a given location:
# https://developers.google.com/google-ads/api/reference/rpc/latest/ReachPlanService
product_mix = []
product_mix << client.resource.planned_product do |p|
p.plannable_product_code = 'TRUEVIEW_IN_STREAM'
p.budget_micros = BUDGET_MICROS * trueview_allocation
end
product_mix << client.resource.planned_product do |p|
p.plannable_product_code = 'BUMPER'
p.budget_micros = BUDGET_MICROS * bumper_allocation
end
get_reach_curve(
client,
reach_plan_service,
customer_id,
product_mix,
LOCATION_ID,
CURRENCY_CODE,
)
end
পার্ল
sub forecast_mix {
my (
$reach_plan_service, $customer_id, $location_id,
$currency_code, $budget_micros
) = @_;
my $product_mix = [];
# Set up a ratio to split the budget between two products.
my $trueview_allocation = 0.15;
my $bumper_allocation = 1 - $trueview_allocation;
# See list_plannable_products on ReachPlanService to retrieve a list of valid
# plannable product codes for a given location:
# https://developers.google.com/google-ads/api/reference/rpc/latest/ReachPlanService
push @$product_mix,
Google::Ads::GoogleAds::V16::Services::ReachPlanService::PlannedProduct->
new({
plannableProductCode => "TRUEVIEW_IN_STREAM",
budgetMicros => int($budget_micros * $trueview_allocation)});
push @$product_mix,
Google::Ads::GoogleAds::V16::Services::ReachPlanService::PlannedProduct->
new({
plannableProductCode => "BUMPER",
budgetMicros => int($budget_micros * $bumper_allocation)});
my $reach_request =
build_reach_request($customer_id, $product_mix, $location_id,
$currency_code);
pull_reach_curve($reach_plan_service, $reach_request);
}
আপনি যখন YouTube নির্বাচন লাইনআপের জন্য advanced_product_targeting সেট করতে পারেন তখনও এটি হয়।
পূর্বাভাস অনুরোধ ক্ষেত্র পৌঁছান
প্রতিটি GenerateReachForecastRequest এর জন্য আপনাকে customer_id , campaign_duration , এবং planned_products ক্ষেত্র সেট করতে হবে।
এছাড়াও আপনি নিম্নলিখিত ঐচ্ছিক ক্ষেত্র সেট করতে পারেন:
| মাঠ | বর্ণনা |
|---|---|
cookie_frequency_cap_setting | একটি নির্দিষ্ট সময়ের ব্যবধানে একই ব্যবহারকারীকে সর্বাধিক কতবার বিজ্ঞাপন দেখানো যেতে পারে। এই ক্যাপটিকে একদিন, এক সপ্তাহ বা এক মাস প্রতি সীমা হিসাবে সংজ্ঞায়িত করা যেতে পারে। |
currency_code | তিন-অক্ষরের ISO 4217 মুদ্রা কোড। |
customer_reach_group | গ্রাহকের নাম যার জন্য পরিকল্পনা করা হচ্ছে। এটি একটি ব্যবহারকারী-সংজ্ঞায়িত মান। targeting.audience_targeting সেট করা থাকলে প্রয়োজন। |
min_effective_frequency | রিপোর্ট করা পৌঁছানোর মেট্রিক্সের জন্য একজন ব্যক্তি বিজ্ঞাপনে ন্যূনতম কতবার উন্মুক্ত হয়েছেন। |
targeting | অবস্থান, বয়সের পরিসর, লিঙ্গ, ডিভাইস এবং নেটওয়ার্ক সহ পণ্যের মিশ্রণে নির্বাচিত সমস্ত পণ্যের জন্য লক্ষ্যমাত্রা প্রয়োগ করা হবে। |