Google sử dụng công nghệ AI để dịch nội dung sang ngôn ngữ bạn ưu tiên. Bản dịch bằng AI có thể có lỗi.

Chỉ định kế hoạch truyền thông

Google cung cấp nhiều sản phẩm và đối tượng mà bạn có thể sử dụng để tạo chiến dịch, mặc dù có thể bạn không biết cách lập kế hoạch. Để hỗ trợ việc này, ReachPlanService cung cấp các phương thức khám phá mà bạn có thể dùng để tạo đường cong.

Nhắm mục tiêu theo đối tượng

Thành phần đầu tiên của kế hoạch truyền thông là tiêu chí nhắm mục tiêu theo đối tượng. Tiêu chí này có thể bao gồm các tiêu chí nhắm mục tiêu sau:

Đối tượng: Nhắm đến đối tượng chung sở thích, đối tượng đang cân nhắc mua hàng và đối tượng trong danh sách người dùng bằng cách sử dụng targeting.audience_targeting (AudienceTargeting). Truy vấn các tiêu chí được hỗ trợ bằng cách sử dụng ReachPlanService.ListPlannableUserInterests và ReachPlanService.ListPlannableUserLists.
Phạm vi độ tuổi: Chỉ định nhóm tuổi mục tiêu bằng cách sử dụng enum ReachPlanAgeRange.
Giới tính: Nhắm đến giới tính cụ thể bằng tiêu chí GenderInfo.
Thiết bị: Nhắm đến các thiết bị cụ thể bằng tiêu chí DeviceInfo.
Vị trí: Tìm mã vị trí được hỗ trợ bằng cách sử dụng ListPlannableLocations.
Mạng truyền hình: Xem các mạng truyền hình được hỗ trợ cho một vị trí và sản phẩm. Các mạng này có thể khác nhau tuỳ theo sản phẩm và khu vực. Bạn có thể xem bằng cách sử dụng ListPlannableProducts.
Tình trạng con cái: Nhắm đến tình trạng con cái cụ thể bằng tiêu chí ParentalStatusInfo (có trong v25 trở lên).
Nhóm YouTube Chọn lọc: Nhắm đến các nhóm nội dung cụ thể bằng cách sử dụng YouTubeSelectSettings trong kế hoạch tăng cường phạm vi tiếp cận để tiếp cận đối tượng tương tác với nội dung được tuyển chọn trên YouTube.

Kiểu kết hợp các loại quảng cáo

Ngoài thông tin nhắm mục tiêu, bạn phải chỉ định một kiểu kết hợp các loại quảng cáo để tạo đường cong.

Phương thức ListPlannableProducts trên ReachPlanService cho biết các định dạng mới nhất hiện có cho một mã vị trí nhất định. Các trường này được biểu thị bằng các trường sau trong ProductMetadata:

plannable_product_code
plannable_product_name
plannable_product_description (có trong v24 trở lên)
plannable_product_core_attributes (có trong v24 trở lên): Một tập hợp các thuộc tính (ProductCoreAttributes) dùng để mô tả các chức năng của sản phẩm, bao gồm:
plannable_targeting: Các chế độ cài đặt tiêu chí nhắm mục tiêu được phép cho sản phẩm, chẳng hạn như độ tuổi, giới tính, thiết bị, mạng và (trong v25 trở lên) tình trạng làm cha mẹ.

Xin lưu ý rằng các giá trị này sẽ thay đổi định kỳ, vì vậy, tốt nhất là bạn nên cung cấp cho người dùng kết quả trực tiếp thay vì duy trì các phản hồi ngoại tuyến.

Sau đây là ví dụ về mã cho biết cách nhận kiểu kết hợp các loại quảng cáo cho một số tiêu chí mục tiêu:

Java

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());
    }
  }
}ForecastReach.java

C#

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}");
        }
    }
}ForecastReach.cs

PHP

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);
        }
    }
}ForecastReach.php

Python

def show_plannable_products(client: GoogleAdsClient, location_id: str):
    """Lists plannable products for a given location.

    Args:
        client: an initialized GoogleAdsClient instance.
        location_id: The location ID to plan for.
    """
    reach_plan_service: ReachPlanServiceClient = client.get_service(
        "ReachPlanService"
    )
    response: ListPlannableProductsResponse = (
        reach_plan_service.list_plannable_products(
            plannable_location_id=location_id
        )
    )
    print(f"Plannable Products for Location ID {location_id}")

    product_metadata: ProductMetadata
    for product_metadata in response.product_metadata:
        print(
            f"{product_metadata.plannable_product_code} : "
            f"{product_metadata.plannable_product_name}"
        )

        print("Age Ranges:")
        age_range: ReachPlanAgeRangeEnum
        for age_range in product_metadata.plannable_targeting.age_ranges:
            print(f"\t- {age_range.name}")

        print("Genders:")
        gender: GenderInfo
        for gender in product_metadata.plannable_targeting.genders:
            print(f"\t- {gender.type_.name}")

        print("Devices:")
        device: DeviceInfo
        for device in product_metadata.plannable_targeting.devices:
            print(f"\t- {device.type_.name}")forecast_reach.py

Ruby

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
endforecast_reach.rb

Perl

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};
    }
  }
}forecast_reach.pl

curl

Để tạo đường cong, bạn sẽ chỉ định ngân sách cho từng sản phẩm:

Java

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);
}ForecastReach.java

C#

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);
}ForecastReach.cs

PHP

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
    );
}ForecastReach.php

Python

def forecast_manual_mix(
    client: GoogleAdsClient,
    customer_id: str,
    location_id: str,
    currency_code: str,
    budget: int,
):
    """Pulls a forecast for product mix created manually.

    Args:
        client: an initialized GoogleAdsClient instance.
        customer_id: The customer ID 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: list[PlannedProduct] = []
    trueview_allocation = 0.15
    bumper_allocation = 1 - trueview_allocation
    product_splits = [
        ("TRUEVIEW_IN_STREAM", trueview_allocation),
        ("BUMPER", bumper_allocation),
    ]
    product: str
    split: float
    for product, split in product_splits:
        planned_product: PlannedProduct = 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
    )forecast_reach.py

Ruby

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,
  )
endforecast_reach.rb

Perl

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::V25::Services::ReachPlanService::PlannedProduct->
    new({
      plannableProductCode => "TRUEVIEW_IN_STREAM",
      budgetMicros         => int($budget_micros * $trueview_allocation)});
  push @$product_mix,
    Google::Ads::GoogleAds::V25::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);
}forecast_reach.pl

curl

Đây cũng là thời điểm bạn có thể thiết lập advanced_product_targeting cho các Nhóm YouTube Chọn lọc.

Các trường yêu cầu dự báo phạm vi tiếp cận

Bạn phải đặt các trường customer_id, campaign_duration và planned_products cho mỗi GenerateReachForecastRequest.

Bạn cũng có thể đặt các trường có điều kiện hoặc không bắt buộc sau đây:

Trường	Yêu cầu	Mô tả
`cookie_frequency_cap_setting`	Không bắt buộc	Số lần tối đa một quảng cáo có thể xuất hiện cho cùng một người dùng trong một khoảng thời gian cụ thể. Bạn có thể xác định hạn mức này là giới hạn cho mỗi ngày, mỗi tuần hoặc mỗi tháng. Thay thế `cookie_frequency_cap` (không dùng nữa trong `v24` và bị xoá trong `v25`).
`currency_code`	Không bắt buộc	Mã đơn vị tiền tệ gồm 3 ký tự theo tiêu chuẩn ISO 4217.
`customer_reach_group`	Bắt buộc trong một số điều kiện	Tên của khách hàng đang được lập kế hoạch. Đây là giá trị do người dùng xác định. Bắt buộc nếu bạn đặt `targeting.audience_targeting`.
`effective_frequency_limit`	Không bắt buộc	Chỉ định tần suất hiệu quả tối thiểu cao nhất (`1` – `10`) cho `Forecast.effective_frequency_breakdowns`, loại trừ lẫn nhau với `min_effective_frequency`.
`forecast_metric_options`	Không bắt buộc	Các lựa chọn khác về chỉ số (`ForecastMetricOptions`), chẳng hạn như `include_coview`.
`min_effective_frequency`	Không bắt buộc	Số lần tối thiểu mà một người đã xem quảng cáo để các chỉ số phạm vi tiếp cận được báo cáo.
`targeting`	Không bắt buộc	Tiêu chí nhắm mục tiêu sẽ được áp dụng cho tất cả sản phẩm được chọn trong kiểu kết hợp các loại quảng cáo, bao gồm cả vị trí (`plannable_location_ids`, thay thế cho `plannable_location_id` trong `v25`), độ tuổi, giới tính, thiết bị, mạng và (trong `v25` trở lên) tình trạng làm cha mẹ.

Bước tiếp theo

Tìm hiểu cách tạo đường cong phạm vi tiếp cận.

Xác thực

Tiếp

Tạo đường cong

Chỉ định kế hoạch truyền thông Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Nhắm mục tiêu theo đối tượng

Kiểu kết hợp các loại quảng cáo

Java

C#

PHP

Python

Ruby

Perl

curl

Java

C#

PHP

Python

Ruby

Perl

curl

Các trường yêu cầu dự báo phạm vi tiếp cận

Bước tiếp theo

Chỉ định kế hoạch truyền thông