BiddingStrategy

Es la configuración que controla la estrategia de ofertas. La estrategia de ofertas determina el precio de la oferta.

Representación JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "fixedBid": {
    object (FixedBidStrategy)
  },
  "maximizeSpendAutoBid": {
    object (MaximizeSpendBidStrategy)
  },
  "performanceGoalAutoBid": {
    object (PerformanceGoalBidStrategy)
  },
  "youtubeAndPartnersBid": {
    object (YoutubeAndPartnersBiddingStrategy)
  },
  "demandGenBid": {
    object (DemandGenBiddingStrategy)
  }
  // End of mutually exclusive fields.
}
Campos
Obligatorio. La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta:
fixedBid

object (FixedBidStrategy)

Es una estrategia que utiliza un precio de oferta fijo.
maximizeSpendAutoBid

object (MaximizeSpendBidStrategy)

Es una estrategia que ajusta automáticamente la oferta para optimizarla en función de tu objetivo de rendimiento y, al mismo tiempo, invertir todo el presupuesto.

A nivel del pedido de inserción, el markupType de las líneas de pedido no se puede establecer en PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM.

Además, el valor de performanceGoalType asignado a una orden de inserción determina los posibles valores de lineItemType disponibles para las líneas de pedido de esa orden de inserción:

  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA, BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC y BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED solo permiten líneas de pedido de LINE_ITEM_TYPE_DISPLAY_DEFAULT o LINE_ITEM_TYPE_VIDEO_DEFAULT.
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA y BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN solo permiten líneas de pedido de LINE_ITEM_TYPE_VIDEO_DEFAULT.
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_REACH solo permite líneas de pedido de LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP.
performanceGoalAutoBid

object (PerformanceGoalBidStrategy)

Estrategia que ajusta automáticamente la oferta para alcanzar o superar un objetivo de rendimiento especificado. Solo se debe usar para una entidad de concepto de línea.
youtubeAndPartnersBid

object (YoutubeAndPartnersBiddingStrategy)

Es una estrategia de ofertas que usan los recursos de YouTube y los socios.

Solo se puede usar para una entidad de línea de pedido o grupo de anuncios de YouTube y socios.
demandGenBid

object (DemandGenBiddingStrategy)

Es una estrategia de ofertas que utilizan los recursos de las campañas de generación de demanda.

Solo se puede usar para una entidad de línea de pedido o grupo de anuncios de generación de demanda.
Fin de los campos mutuamente excluyentes.

FixedBidStrategy

Es una estrategia que utiliza un precio de oferta fijo.

Representación JSON 
{
  "bidAmountMicros": string
}
Campos
bidAmountMicros

string (int64 format)

Es el importe de la oferta fija, en micros de la moneda del anunciante. Para la entidad de pedido de inserción, bidAmountMicros debe establecerse como 0. Para la entidad de la línea de pedido, bidAmountMicros debe ser mayor o igual que la unidad facturable de la moneda determinada y menor o igual que el límite superior de 1000000000.

Por ejemplo, 1500000 representa 1.5 unidades estándar de la moneda.

MaximizeSpendBidStrategy

Es una estrategia que ajusta automáticamente la oferta para optimizar un objetivo de rendimiento específico y, al mismo tiempo, invertir todo el presupuesto.

Representación JSON 
{
  "performanceGoalType": enum (BiddingStrategyPerformanceGoalType),
  "maxAverageCpmBidAmountMicros": string,
  "raiseBidForDeals": boolean,
  "customBiddingAlgorithmId": string
}
Campos
performanceGoalType

enum (BiddingStrategyPerformanceGoalType)

Obligatorio. Es el tipo de objetivo de rendimiento que la estrategia de ofertas intenta minimizar mientras invierte todo el presupuesto. BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM no es compatible con esta estrategia.
maxAverageCpmBidAmountMicros

string (int64 format)

Es el CPM promedio máximo que se puede ofertar, expresado en unidades pequeñas de la moneda del anunciante. Debe ser mayor o igual que una unidad facturable de la moneda especificada.

Por ejemplo, 1500000 representa 1.5 unidades estándar de la moneda.
raiseBidForDeals

boolean

Indica si la estrategia tiene en cuenta los precios mínimos del acuerdo.
customBiddingAlgorithmId

string (int64 format)

Es el ID del algoritmo de ofertas personalizadas que utiliza esta estrategia. Solo es aplicable cuando performanceGoalType se establece como BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO.

Si se asigna un algoritmo de ofertas personalizadas que utiliza actividades de Floodlight no identificadas en floodlightActivityConfigs, se mostrará un error.

BiddingStrategyPerformanceGoalType

Son los tipos posibles de objetivo de rendimiento para la estrategia de ofertas.

Enums
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_UNSPECIFIED El valor del tipo no se especificó o es desconocido en esta versión.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA Es el costo por acción.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC Es el costo por clic.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM Es el CPM visibles.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO Es el algoritmo de ofertas personalizadas.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA Vistas completas con sonido
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN Vistas de tiempo en pantalla de más de 10 segundos
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED Son las impresiones visibles.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_REACH Maximizar el alcance

PerformanceGoalBidStrategy

Estrategia que ajusta automáticamente la oferta para alcanzar o superar un objetivo de rendimiento especificado.

Representación JSON 
{
  "performanceGoalType": enum (BiddingStrategyPerformanceGoalType),
  "performanceGoalAmountMicros": string,
  "maxAverageCpmBidAmountMicros": string,
  "customBiddingAlgorithmId": string
}
Campos
performanceGoalType

enum (BiddingStrategyPerformanceGoalType)

Obligatorio. Es el tipo de objetivo de rendimiento que la estrategia de ofertas intentará alcanzar o superar.

Para el uso a nivel de la línea de pedido, el valor debe ser uno de los siguientes:

  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO.
performanceGoalAmountMicros

string (int64 format)

Obligatorio. Es el objetivo de rendimiento que la estrategia de ofertas intentará alcanzar o superar, expresado en unidades de la moneda del anunciante o en unidades del valor del ROAS (retorno de la inversión publicitaria), que también se basa en la moneda del anunciante. Debe ser mayor o igual que una unidad facturable de la moneda determinada y menor o igual que los límites superiores. Cada performanceGoalType tiene su límite superior:

  • cuando performanceGoalType es BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA, el límite superior es de USD 10,000.00.
  • cuando performanceGoalType es BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC, el límite superior es de USD 1,000.00.
  • cuando performanceGoalType es BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM, el límite superior es de USD 1,000.00.
  • Cuando performanceGoalType es BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO, el límite superior es 1,000.00 y el límite inferior es 0.01.

Ejemplo: Si se configura como BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM, el precio de la oferta se basará en la probabilidad de que cada impresión disponible sea visible. Por ejemplo, si el objetivo de CPM visibles es de USD 2 y la probabilidad de que una impresión sea visible es del 40%, el precio de la oferta será de USD 0.80 de CPM (el 40% de USD 2).

Por ejemplo, 1500000 representa 1.5 unidades estándar de la moneda o el valor del ROAS.
maxAverageCpmBidAmountMicros

string (int64 format)

Es el CPM promedio máximo que se puede ofertar, expresado en unidades pequeñas de la moneda del anunciante. Debe ser mayor o igual que una unidad facturable de la moneda especificada. No se aplica cuando performanceGoalType se configura como BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM.

Por ejemplo, 1500000 representa 1.5 unidades estándar de la moneda.
customBiddingAlgorithmId

string (int64 format)

Es el ID del algoritmo de ofertas personalizadas que utiliza esta estrategia. Solo es aplicable cuando performanceGoalType se establece como BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO.

Si se asigna un algoritmo de ofertas personalizadas que utiliza actividades de Floodlight no identificadas en floodlightActivityConfigs, se mostrará un error.

YoutubeAndPartnersBiddingStrategy

Son los parámetros de configuración que controlan la estrategia de ofertas para los recursos de YouTube y los socios.

Representación JSON 
{
  "type": enum (YoutubeAndPartnersBiddingStrategyType),
  "value": string,
  "adGroupEffectiveTargetCpaValue": string,
  "adGroupEffectiveTargetCpaSource": enum (BiddingSource)
}
Campos
type

enum (YoutubeAndPartnersBiddingStrategyType)

Es el tipo de estrategia de ofertas.
value

string (int64 format)

Es el valor que utiliza la estrategia de ofertas.

Cuando la estrategia de ofertas se asigna a nivel de la línea de pedido, este campo solo se aplica a los siguientes tipos de estrategias:

  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPA
  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_ROAS

Cuando la estrategia de ofertas se asigna a nivel del grupo de anuncios, este campo solo se aplica a los siguientes tipos de estrategias:

  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MANUAL_CPM
  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MANUAL_CPV
  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPA
  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM
  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_RESERVE_CPM
  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_ROAS

Si no se usa una estrategia aplicable, el valor de este campo será 0.
adGroupEffectiveTargetCpaValue

string (int64 format)

Solo salida. Es el CPA objetivo efectivo del grupo de anuncios, expresado en micro unidades de la moneda del anunciante.
adGroupEffectiveTargetCpaSource

enum (BiddingSource)

Solo salida. Es la fuente del valor del CPA objetivo efectivo del grupo de anuncios.

YoutubeAndPartnersBiddingStrategyType

Son los tipos posibles de estrategia de ofertas para los recursos de YouTube y socios.

Enums
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_UNSPECIFIED El tipo no se especificó o es desconocido.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MANUAL_CPV Es una estrategia de ofertas que paga un importe configurable por cada vista de video.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MANUAL_CPM Es una estrategia de ofertas que paga un importe configurable por impresión.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPA Es una estrategia de ofertas que optimiza automáticamente las conversiones por dólar.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM Es una estrategia de ofertas que paga un importe configurable por impresión.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_RESERVE_CPM Es una estrategia de ofertas para las líneas de pedido de Reserva instantánea de YouTube que paga un importe fijo por impresión.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_LIFT Es una estrategia de ofertas automáticas que establece ofertas para lograr la máxima efectividad.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSIONS Es una estrategia de ofertas que maximiza automáticamente la cantidad de conversiones dado un presupuesto diario.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPV Es una estrategia de ofertas que optimiza automáticamente el costo por vista de video.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_ROAS Es una estrategia de ofertas que maximiza automáticamente los ingresos y, al mismo tiempo, calcula el promedio de un retorno de la inversión publicitaria objetivo (ROAS).
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSION_VALUE Es una estrategia de ofertas que establece automáticamente las ofertas para maximizar los ingresos sin exceder tu presupuesto.

BiddingSource

Es la fuente del valor de la oferta.

Enums
BIDDING_SOURCE_UNSPECIFIED No se especificó la fuente de licitación o es desconocida.
BIDDING_SOURCE_LINE_ITEM El valor de la oferta se hereda de la línea de pedido.
BIDDING_SOURCE_AD_GROUP El valor de la oferta se define en el grupo de anuncios.

DemandGenBiddingStrategy

Es la configuración que controla la estrategia de ofertas para los recursos de las campañas de generación de demanda.

Representación JSON 
{
  "type": enum (DemandGenBiddingStrategyType),
  "value": string,
  "effectiveBiddingValue": string,
  "effectiveBiddingValueSource": enum (BiddingSource)
}
Campos
type

enum (DemandGenBiddingStrategyType)

Opcional. Es el tipo de estrategia de ofertas.

Solo se puede establecer cuando se asigna a una línea de pedido. Los grupos de anuncios heredarán este valor de su línea de pedido.
value

string (int64 format)

Opcional. Es el valor que utiliza la estrategia de ofertas. Se puede establecer cuando se asigna a líneas de pedido o grupos de anuncios. Este campo solo se aplica a los siguientes tipos de estrategias:

  • DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPA
  • DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPC
  • DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_ROAS

El valor de este campo se expresa en micro unidades de la moneda del anunciante o en valor del ROAS. Por ejemplo, 1000000 representa 1.0 unidades estándar de la moneda o el 100% del valor del ROAS. Si no se usa una estrategia aplicable, el valor de este campo será 0.
effectiveBiddingValue

string (int64 format)

Solo salida. Es el valor que utiliza de manera eficaz la estrategia de ofertas. Este campo será igual que value si se configura. Si no se establece value y la estrategia se asigna a un grupo de anuncios, este campo se heredará de la estrategia de ofertas de la línea de pedido.

Si type no es DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPA ni DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_ROAS, este campo será 0.
effectiveBiddingValueSource

enum (BiddingSource)

Solo salida. Es la fuente del valor de la oferta efectiva.

DemandGenBiddingStrategyType

Son los tipos posibles de estrategia de ofertas para los recursos de las campañas de generación de demanda.

Enums
DEMAND_GEN_BIDDING_STRATEGY_TYPE_UNSPECIFIED El tipo no se especificó o es desconocido.
DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPA Es una estrategia de ofertas que optimiza automáticamente las conversiones por dólar.
DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_ROAS Es una estrategia de ofertas que maximiza automáticamente los ingresos y, al mismo tiempo, calcula el promedio de un retorno de la inversión publicitaria objetivo (ROAS).
DEMAND_GEN_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSIONS Estrategia de ofertas que maximiza automáticamente la cantidad de conversiones
DEMAND_GEN_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSION_VALUE Es una estrategia de ofertas que maximiza automáticamente los ingresos mientras inviertes tu presupuesto.
DEMAND_GEN_BIDDING_STRATEGY_TYPE_MAXIMIZE_CLICKS Es una estrategia de ofertas que maximiza automáticamente los clics dentro de un presupuesto determinado.
DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPC Es una estrategia de ofertas que optimiza automáticamente el costo por clic.