Recupera simulaciones de ofertas

Una simulación de ofertas contiene datos de simulación e información sobre el período, el tipo de datos de simulación y la campaña, el grupo de anuncios, el criterio del grupo de anuncios o la estrategia de ofertas a la que se aplica. Los datos de simulación son una secuencia de puntos de simulación que proporciona un histograma del rendimiento previsto con diferentes ofertas, objetivos o presupuestos durante el período determinado. La información que proporciona un punto de simulación depende del tipo de datos de simulación.

Punto clave: El período siempre es en el pasado, ya que las simulaciones de ofertas predicen cómo se habrían comportado tus anuncios en esos momentos y en las mismas condiciones, pero con diferentes ofertas.

Puedes recuperar cualquier simulación de ofertas con una consulta del lenguaje de consultas de Google Ads seleccionando el campo de datos de simulación adecuado (tipo de datos de simulación) del recurso correspondiente (nivel de oferta).

Punto clave: Cada nivel de oferta está asociado con un conjunto específico de combinaciones admitidas de valores de campo. Consulta la documentación de cada tipo de recurso para obtener más detalles, como CampaignSimulation.

Nivel de oferta y recurso	SimulationType	Campo de datos de simulación	Tipo de punto de simulación
Grupo de anuncios 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
Criterio del grupo de anuncios 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
Estrategia de ofertas (cartera) 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
Campaña 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

Nota: En CampaignSimulation, las métricas simuladas que se propagan en cada punto pueden variar según el canal de publicidad. Por ejemplo, las campañas de generación de demanda (DEMAND_GEN) propagan interactions en lugar de clicks en TargetCpaSimulationPoint, y las campañas de aplicaciones (MULTI_CHANNEL) propagan app_installs y in_app_actions en TargetCpaSimulationPoint.

Método de modificación de simulación escalada en simulaciones de campañas

Cada recurso de simulación incluye un campo modification_method de tipo SimulationModificationMethod que indica cómo se aplican los valores simulados (UNIFORM, DEFAULT o SCALING). Si bien las simulaciones UNIFORM y DEFAULT propagan importes explícitos de microvalores en cada punto de simulación (como cpc_bid_micros o target_cpa_micros), las simulaciones a nivel de la campaña para las campañas de búsqueda también admiten un SCALING método de modificación para las simulaciones CPC_BID y TARGET_CPA:

• Cuando CampaignSimulation.type es CPC_BID y modification_method es SCALING, cada CpcBidSimulationPoint propaga cpc_bid_scaling_modifier (en lugar de cpc_bid_micros) para mostrar qué sucede si todas las ofertas de CPC de la campaña (tanto las ofertas de CPC predeterminadas del grupo de anuncios como las ofertas de CPC a nivel del criterio) se ajustan según ese modificador. Por ejemplo, un modificador de ajuste de 2.0 muestra qué sucede si se duplican todas las ofertas de CPC de la campaña.
• Cuando CampaignSimulation.type es TARGET_CPA y modification_method es SCALING, cada TargetCpaSimulationPoint propaga target_cpa_scaling_modifier (en lugar de target_cpa_micros) para mostrar qué sucede si el CPA objetivo de la campaña y todos los CPA objetivo de los grupos de anuncios de la campaña se ajustan según ese modificador.

Para obtener más información, consulta Estima tus resultados con simuladores de oferta, presupuesto y objetivo.

Ejemplo de código: Recupera simulaciones de ofertas de criterios del grupo de anuncios

En el siguiente ejemplo, se muestra cómo recuperar e imprimir todas las simulaciones de ofertas de CPC (CPC_BID) disponibles para los criterios de un grupo de anuncios determinado filtrando ad_group_criterion_simulation en ad_group_id.

Java

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

Nota: Si bien aquí no se proporciona una muestra de código REST directa para este paso, puedes lograrlo con una solicitud REST manual.

Consulta la documentación de la interfaz REST de la API de Google Ads y las páginas de referencia específicas del método. Deberás crear la carga útil JSON según las definiciones de proto.

Recursos clave:

• Uso de REST
• Estructura de la interfaz REST
• Asignaciones de campos JSON
• Consulta la referencia de la API de REST para obtener información sobre el servicio y el método específicos.