Sau khi thu thập các chế độ cài đặt nhắm mục tiêu và kiểu kết hợp các loại quảng cáo cho kế hoạch truyền thông của mình, bạn có thể tạo đường cong về ngân sách so với phạm vi tiếp cận tiềm năng bằng phương thức GenerateReachForecast trong ReachPlanService. Hãy xem bảng thuật ngữ và hướng dẫn về kế hoạch truyền thông để biết thông tin chi tiết về các trường yêu cầu.
Lưu đường cong
Bạn chỉ có thể lưu từng đường cong để mang lại sự thuận tiện cho người dùng. Chúng tôi nghiêm cấm việc lưu đường cong vào bộ nhớ đệm trong khối lượng lớn. Nếu bạn cần tạo đường cong lớn, trước tiên hãy kiểm tra với đại diện của Google.
Các thay đổi đối với YouTube Chọn lọc
YouTube Chọn lọc trong Dịch vụ kế hoạch tiếp cận hiện hỗ trợ tính năng nhắm mục tiêu ở cấp nhóm kênh nổi tiếng (so với Loạt mạng trước đây) cho tất cả những vị trí đủ điều kiện của YouTube Kids đối với chế độ đặt giá Đặt trước nhanh. Với tính năng Đặt trước nhanh, có 2 lỗi mới có thể xảy ra trong phiên bản v15 trở lên khi yêu cầu thông tin dự đoán cho YouTubeS:
Thay vào đó, các phiên bản cũ sẽ gửi lỗi `UNKNOWN.
Ví dụ về mã
Đường cong này bao gồm số lượt hiển thị và phạm vi tiếp cận người dùng ở dạng số tuyệt đối, cũng như quy mô đa dạng tương ứng với dân số theo dữ liệu điều tra dân số và quy mô đối tượng trên YouTube cho thông tin nhân khẩu học và quốc gia được yêu cầu.
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("]\"");
}
}
1.199
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, customer_id, product_mix, location_id, currency_code
):
"""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 = 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.
for gender_type in [
client.enums.GenderTypeEnum.FEMALE,
client.enums.GenderTypeEnum.MALE,
]:
gender = client.get_type("GenderInfo")
gender.type_ = gender_type
request.targeting.genders.append(gender)
# Add device targeting to the request.
for device_type in [
client.enums.DeviceEnum.DESKTOP,
client.enums.DeviceEnum.MOBILE,
client.enums.DeviceEnum.TABLET,
]:
device = client.get_type("DeviceInfo")
device.type_ = device_type
request.targeting.devices.append(device)
reach_plan_service = client.get_service("ReachPlanService")
response = reach_plan_service.generate_reach_forecast(request=request)
print(
"Currency, Cost, On-Target Reach, On-Target Imprs, Total Reach,"
" Total Imprs, Products"
)
for point in response.reach_curve.reach_forecasts:
product_splits = []
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";
}
}