입찰 시뮬레이션 가져오기

입찰가 시뮬레이션에는 시뮬레이션 데이터와 기간, 시뮬레이션 데이터 유형, 적용되는 캠페인, 광고 그룹, 광고 그룹 기준, 입찰 전략에 관한 정보가 포함됩니다. 시뮬레이션 데이터는 지정된 기간 동안 다양한 입찰가, 타겟, 예산으로 예측된 실적의 히스토그램을 제공하는 시뮬레이션 포인트 의 시퀀스입니다. 시뮬레이션 포인트에서 제공하는 정보는 시뮬레이션 데이터 유형에 따라 다릅니다.

핵심사항: 입찰가 시뮬레이션은 과거의 동일한 조건에서 다양한 입찰가로 광고가 게재되었을 때의 실적을 예측하므로 기간은 항상 과거입니다.

Google Ads 쿼리 언어 쿼리를 사용하여 해당 리소스 (입찰가 수준)에서 적절한 시뮬레이션 데이터 필드 (시뮬레이션 데이터 유형)를 선택하여 입찰가 시뮬레이션을 검색할 수 있습니다.

핵심사항: 각 입찰가 수준은 지원되는 특정 필드 값 조합과 연결되어 있습니다. 자세한 내용은 각 리소스 유형의 문서 를 참고하세요. 예: CampaignSimulation.

입찰가 수준 및 리소스	SimulationType	시뮬레이션 데이터 필드	시뮬레이션 포인트 유형
광고 그룹 ad_group_simulation	CPC_BID CPV_BID TARGET_CPA TARGET_ROAS	ad_group_simulation.cpc_bid_point_list.points ad_group_simulation.cpv_bid_point_list.points ad_group_simulation.target_cpa_point_list.points ad_group_simulation.target_roas_point_list.points	CpcBidSimulationPoint CpvBidSimulationPoint TargetCpaSimulationPoint TargetRoasSimulationPoint
광고 그룹 기준 ad_group_criterion_simulation	CPC_BID PERCENT_CPC_BID	ad_group_criterion_simulation.cpc_bid_point_list.points ad_group_criterion_simulation.percent_cpc_bid_point_list.points	CpcBidSimulationPoint PercentCpcBidSimulationPoint
입찰 전략 (포트폴리오) bidding_strategy_simulation	TARGET_CPA TARGET_ROAS	bidding_strategy_simulation.target_cpa_point_list.points bidding_strategy_simulation.target_roas_point_list.points	TargetCpaSimulationPoint TargetRoasSimulationPoint
캠페인 campaign_simulation	BUDGET CPC_BID TARGET_CPA TARGET_IMPRESSION_SHARE TARGET_ROAS	campaign_simulation.budget_point_list.points campaign_simulation.cpc_bid_point_list.points campaign_simulation.target_cpa_point_list.points campaign_simulation.target_impression_share_point_list.points campaign_simulation.target_roas_point_list.points	BudgetSimulationPoint CpcBidSimulationPoint TargetCpaSimulationPoint TargetImpressionShareSimulationPoint TargetRoasSimulationPoint

참고: CampaignSimulation에서 각 포인트에 채워지는 시뮬레이션된 측정항목은 광고 채널에 따라 다를 수 있습니다. 예를 들어 디맨드젠 (DEMAND_GEN) 캠페인은 TargetCpaSimulationPoint에 clicks 대신 interactions를 채우고 앱 (MULTI_CHANNEL) 캠페인은 TargetCpaSimulationPoint에 app_installs 및 in_app_actions를 채웁니다.

캠페인 시뮬레이션의 확장된 시뮬레이션 수정 방법

각 시뮬레이션 리소스에는 시뮬레이션된 값이 적용되는 방식을 나타내는 SimulationModificationMethod 유형의 modification_method 필드 (UNIFORM, DEFAULT 또는 SCALING)가 포함됩니다. UNIFORM 및 DEFAULT 시뮬레이션은 각 시뮬레이션 포인트에 명시적 마이크로 금액 (예: cpc_bid_micros 또는 target_cpa_micros)을 채우지만 검색 캠페인의 캠페인 수준 시뮬레이션은 CPC_BID 및 TARGET_CPA 시뮬레이션 모두에 SCALING 수정 방법을 지원합니다.

• CampaignSimulation.type이 CPC_BID이고 modification_method이 SCALING인 경우 각 CpcBidSimulationPoint는 cpc_bid_micros 대신 cpc_bid_scaling_modifier 를 채워 캠페인의 모든 CPC 입찰가(광고 그룹 기본 CPC 입찰가 및 기준 수준 CPC 입찰가 모두)가 해당 수정자에 의해 조정되는 경우의 결과를 보여줍니다. 예를 들어 2.0의 조정 수정자는 캠페인의 모든 CPC 입찰가가 두 배로 늘어나는 경우의 결과를 보여줍니다.
• CampaignSimulation.type이 TARGET_CPA 이고 modification_method가 SCALING인 경우 각 TargetCpaSimulationPoint는 target_cpa_micros 대신 target_cpa_scaling_modifier를 채워 캠페인 타겟 CPA와 캠페인의 모든 광고 그룹 타겟 CPA가 해당 수정자에 의해 조정되는 경우의 결과를 보여줍니다.

자세한 내용은 입찰가, 예산, 타겟 시뮬레이터로 실적 추정을 참고하세요.

코드 예: 광고 그룹 기준 입찰가 시뮬레이션 검색

다음 예에서는 ad_group_id에서 ad_group_criterion_simulation을 필터링하여 지정된 광고 그룹의 기준에 사용할 수 있는 모든 CPC 입찰가(CPC_BID) 시뮬레이션을 검색하고 출력하는 방법을 보여줍니다.

자바

private void runExample(GoogleAdsClient googleAdsClient, long customerId, long adGroupId) {
  try (GoogleAdsServiceClient googleAdsServiceClient =
      googleAdsClient.getLatestVersion().createGoogleAdsServiceClient()) {
    // Creates a query that retrieves the ad group criterion CPC bid simulations.
    String query =
        String.format(
            "SELECT ad_group_criterion_simulation.ad_group_id, "
                + "ad_group_criterion_simulation.criterion_id, "
                + "ad_group_criterion_simulation.start_date, "
                + "ad_group_criterion_simulation.end_date, "
                + "ad_group_criterion_simulation.cpc_bid_point_list.points "
                + "FROM ad_group_criterion_simulation "
                + "WHERE ad_group_criterion_simulation.type = CPC_BID "
                + "AND ad_group_criterion_simulation.ad_group_id = %d",
            adGroupId);
    // Constructs the SearchGoogleAdsStreamRequest.
    SearchGoogleAdsStreamRequest request =
        SearchGoogleAdsStreamRequest.newBuilder()
            .setCustomerId(Long.toString(customerId))
            .setQuery(query)
            .build();

    // Issues the search stream request.
    ServerStream<SearchGoogleAdsStreamResponse> stream =
        googleAdsServiceClient.searchStreamCallable().call(request);

    // Iterates over all rows in all messages and prints the requested field values for
    // the ad group criterion CPC bid simulation in each row.
    for (SearchGoogleAdsStreamResponse response : stream) {
      for (GoogleAdsRow googleAdsRow : response.getResultsList()) {
        AdGroupCriterionSimulation simulation = googleAdsRow.getAdGroupCriterionSimulation();
        System.out.printf(
            "Found ad group criterion CPC bid simulation for ad group ID %d, "
                + "criterion ID %d, start date '%s', end date '%s', and points:%n",
            simulation.getAdGroupId(),
            simulation.getCriterionId(),
            simulation.getStartDate(),
            simulation.getEndDate());
        for (CpcBidSimulationPoint point : simulation.getCpcBidPointList().getPointsList()) {
          System.out.printf(
              "  bid: %d => clicks: %d, cost: %d, impressions: %d, "
                  + "biddable conversions: %.2f, biddable conversions value: %.2f%s",
              point.getCpcBidMicros(),
              point.getClicks(),
              point.getCostMicros(),
              point.getImpressions(),
              point.getBiddableConversions(),
              point.getBiddableConversions());
        }
      }
    }
  }
}
GetAdGroupCriterionCpcBidSimulations.java
      

C#

public void Run(GoogleAdsClient client, long customerId, long adGroupId)
{
    // Get the GoogleAdsService.
    GoogleAdsServiceClient googleAdsService =
        client.GetService(Services.V26.GoogleAdsService);

    try
    {
        // Creates a query that retrieves the ad group criterion CPC bid simulations.
        string query = $@"
            SELECT
                ad_group_criterion_simulation.ad_group_id,
                ad_group_criterion_simulation.criterion_id,
                ad_group_criterion_simulation.start_date,
                ad_group_criterion_simulation.end_date,
                ad_group_criterion_simulation.cpc_bid_point_list.points
            FROM
                ad_group_criterion_simulation
            WHERE
                ad_group_criterion_simulation.type = CPC_BID AND
                ad_group_criterion_simulation.ad_group_id = {adGroupId}";

        // Issue a search stream request.
        googleAdsService.SearchStream(customerId.ToString(), query,
            delegate (SearchGoogleAdsStreamResponse response)
            {
                // Iterates over all rows in all messages and prints the requested field
                // values for the ad group criterion CPC bid simulation in each row.
                foreach (GoogleAdsRow googleAdsRow in response.Results)
                {
                    AdGroupCriterionSimulation simulation =
                        googleAdsRow.AdGroupCriterionSimulation;

                    Console.WriteLine("Found ad group criterion CPC bid simulation for " +
                        $"ad group ID {simulation.AdGroupId}, " +
                        $"criterion ID {simulation.CriterionId}, " +
                        $"start date {simulation.StartDate}, " +
                        $"end date {simulation.EndDate}");

                    foreach (CpcBidSimulationPoint point in
                        simulation.CpcBidPointList.Points)
                    {
                        Console.WriteLine($"\tbid: {point.CpcBidMicros} => " +
                            $"clicks: {point.Clicks}, " +
                            $"cost: {point.CostMicros}, " +
                            $"impressions: {point.Impressions}, " +
                            $"biddable conversions: {point.BiddableConversions}, " +
                            "biddable conversions value: " +
                            $"{point.BiddableConversionsValue}");
                    }

                    Console.WriteLine();
                }
            }
        );
    }
GetAdGroupCriterionCpcBidSimulations.cs
      

PHP

public static function runExample(
    GoogleAdsClient $googleAdsClient,
    int $customerId,
    int $adGroupId
) {
    $googleAdsServiceClient = $googleAdsClient->getGoogleAdsServiceClient();

    // Creates a query that retrieves the ad group criterion CPC bid simulations.
    $query = sprintf(
        'SELECT ad_group_criterion_simulation.ad_group_id, ' .
        'ad_group_criterion_simulation.criterion_id, ' .
        'ad_group_criterion_simulation.start_date, ' .
        'ad_group_criterion_simulation.end_date, ' .
        'ad_group_criterion_simulation.cpc_bid_point_list.points ' .
        'FROM ad_group_criterion_simulation ' .
        'WHERE ad_group_criterion_simulation.type = CPC_BID ' .
        'AND ad_group_criterion_simulation.ad_group_id = %d',
        $adGroupId
    );

    // Issues a search stream request.
    /** @var GoogleAdsServerStreamDecorator $stream */
    $stream = $googleAdsServiceClient->searchStream(
        SearchGoogleAdsStreamRequest::build($customerId, $query)
    );

    // Iterates over all rows in all messages and prints the requested field values for
    // the ad group criterion CPC bid simulation in each row.
    foreach ($stream->iterateAllElements() as $googleAdsRow) {
        /** @var GoogleAdsRow $googleAdsRow */
        $simulation = $googleAdsRow->getAdGroupCriterionSimulation();
        printf(
            'Found ad group criterion CPC bid simulation for ad group ID %d, ' .
            'criterion ID %d, start date "%s", end date "%s", and points:%s',
            $simulation->getAdGroupId(),
            $simulation->getCriterionId(),
            $simulation->getStartDate(),
            $simulation->getEndDate(),
            PHP_EOL
        );
        foreach ($simulation->getCpcBidPointList()->getPoints() as $point) {
            /** @var CpcBidSimulationPoint $point */
            printf(
                '  bid: %d => clicks: %d, cost: %d, impressions: %d, ' .
                'biddable conversions: %.2f, biddable conversions value: %.2f%s',
                $point->getCpcBidMicros(),
                $point->getClicks(),
                $point->getCostMicros(),
                $point->getImpressions(),
                $point->getBiddableConversions(),
                $point->getBiddableConversionsValue(),
                PHP_EOL
            );
        }

        print PHP_EOL;
    }
}
GetAdGroupCriterionCpcBidSimulations.php
      

Python

def main(client: GoogleAdsClient, customer_id: str, ad_group_id: str):
    googleads_service: GoogleAdsServiceClient = client.get_service(
        "GoogleAdsService"
    )

    query = f"""
        SELECT
          ad_group_criterion_simulation.ad_group_id,
          ad_group_criterion_simulation.criterion_id,
          ad_group_criterion_simulation.start_date,
          ad_group_criterion_simulation.end_date,
          ad_group_criterion_simulation.cpc_bid_point_list.points
        FROM ad_group_criterion_simulation
        WHERE
          ad_group_criterion_simulation.type = CPC_BID
          AND ad_group_criterion_simulation.ad_group_id = {ad_group_id}"""

    # Issues a search request using streaming.
    stream: Iterable[SearchGoogleAdsStreamResponse] = (
        googleads_service.search_stream(customer_id=customer_id, query=query)
    )

    # Iterates over all rows in all messages and prints the requested field
    # values for the ad group criterion CPC bid simulation in each row.
    batch: SearchGoogleAdsStreamResponse
    for batch in stream:
        row: GoogleAdsRow
        for row in batch.results:
            simulation: AdGroupCriterionSimulation = (
                row.ad_group_criterion_simulation
            )

            print(
                "found ad group criterion CPC bid simulation for "
                f"ad group ID {simulation.ad_group_id}, "
                f"criterion ID {simulation.criterion_id}, "
                f"start date {simulation.start_date}, "
                f"end date {simulation.end_date}"
            )

            point: CpcBidSimulationPoint
            for point in simulation.cpc_bid_point_list.points:
                print(
                    f"\tbid: {point.cpc_bid_micros} => "
                    f"clicks: {point.clicks}",
                    f"cost: {point.cost_micros}, "
                    f"impressions: {point.impressions},"
                    "biddable conversions: "
                    f"{point.biddable_conversions},"
                    f"biddable conversions value: "
                    f"{point.biddable_conversions_value}",
                )

            print()
get_ad_group_criterion_cpc_bid_simulations.py
      

Ruby

def get_ad_group_criterion_cpc_bid_simulations(customer_id, ad_group_id)
  # GoogleAdsClient will read a config file from
  # ENV['HOME']/google_ads_config.rb when called without parameters
  client = Google::Ads::GoogleAds::GoogleAdsClient.new

  query = <<~QUERY
    SELECT ad_group_criterion_simulation.ad_group_id,
           ad_group_criterion_simulation.criterion_id,
           ad_group_criterion_simulation.start_date,
           ad_group_criterion_simulation.end_date,
           ad_group_criterion_simulation.cpc_bid_point_list.points
    FROM ad_group_criterion_simulation
    WHERE ad_group_criterion_simulation.type = CPC_BID 
    AND ad_group_criterion_simulation.ad_group_id = #{ad_group_id}
  QUERY

  responses = client.service.google_ads.search_stream(
    customer_id: customer_id,
    query: query,
  )

  responses.each do |response|
    response.results.each do |row|
      simulation = row.ad_group_criterion_simulation

      puts "Found ad group criterion CPC bid simulation for " \
      "ad group ID #{simulation.ad_group_id}, " \
      "criterion ID #{simulation.criterion_id}, " \
      "start date '#{simulation.start_date}', " \
      "end date '#{simulation.end_date}', and points:"

      simulation.cpc_bid_point_list.points.each do |point|
        puts "  bid: #{point.cpc_bid_micros} => " \
        "clicks: #{point.clicks}, " \
        "cost: #{point.cost_micros}, " \
        "impressions: #{point.impressions}, " \
        "biddable conversions: #{point.biddable_conversions.round(2)}, " \
        "biddable conversions value: #{point.biddable_conversions_value.round(2)}"
      end
    end
  end
end
get_ad_group_criterion_cpc_bid_simulations.rb
      

Perl

sub get_ad_group_criterion_cpc_bid_simulations {
  my ($api_client, $customer_id, $ad_group_id) = @_;

  # Create a query that retrieves the ad group criterion CPC bid simulations.
  my $search_query =
    "SELECT ad_group_criterion_simulation.ad_group_id, " .
    "ad_group_criterion_simulation.criterion_id, " .
    "ad_group_criterion_simulation.start_date, " .
    "ad_group_criterion_simulation.end_date, " .
    "ad_group_criterion_simulation.cpc_bid_point_list.points " .
    "FROM ad_group_criterion_simulation " .
    "WHERE ad_group_criterion_simulation.type = CPC_BID " .
    "AND ad_group_criterion_simulation.ad_group_id = $ad_group_id";

  my $search_stream_request =
    Google::Ads::GoogleAds::V26::Services::GoogleAdsService::SearchGoogleAdsStreamRequest
    ->new({
      customerId => $customer_id,
      query      => $search_query
    });

  # 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 => $search_stream_request
    });

  # Issue a search stream request, iterate over all rows in all messages and
  # print the requested field values for the ad group criterion CPC bid
  # simulation in each row.
  $search_stream_handler->process_contents(
    sub {
      my $google_ads_row = shift;
      my $simulation     = $google_ads_row->{adGroupCriterionSimulation};

      printf
        "Found ad group criterion CPC bid simulation for ad group ID %d, " .
        "criterion ID %d, start date '%s', end date '%s', and points:\n",
        $simulation->{adGroupId}, $simulation->{criterionId},
        $simulation->{startDate}, $simulation->{endDate};

      foreach my $point (@{$simulation->{cpcBidPointList}{points}}) {
        printf "  bid: %d => clicks: %d, cost: %d, impressions: %d, " .
          "biddable conversions: %.2f, biddable conversions value: %.2f\n",
          $point->{cpcBidMicros},
          $point->{clicks},
          $point->{costMicros},
          $point->{impressions},
          $point->{biddableConversions},
          $point->{biddableConversionsValue};
      }
    });

  return 1;
}
get_ad_group_criterion_cpc_bid_simulations.pl
      

curl

참고: 이 단계의 직접 REST 코드 샘플은 여기에 제공되지 않지만 수동 REST 요청을 사용하여 이 작업을 수행할 수 있습니다.

Google Ads API REST 인터페이스 문서 및 메서드별 참조 페이지를 참고하세요. 프로토 정의를 기반으로 JSON 페이로드를 구성해야 합니다.

주요 리소스:

• REST 사용
• REST 인터페이스 구조
• JSON 필드 매핑
• 특정 서비스 및 메서드에 관한 REST API 참조를 확인하세요.