- Recurso: InserciónOrder
- InsertionOrderType
- Kpi
- KpiType
- InsertionOrderBudget
- InsertionOrderAutomationType
- InsertionOrderBudgetSegment
- Métodos
Recurso: InserciónOrder
Un único pedido de inserción.
Representación JSON |
---|
{ "name": string, "advertiserId": string, "campaignId": string, "insertionOrderId": string, "displayName": string, "insertionOrderType": enum ( |
Campos | |
---|---|
name |
Solo salida. El nombre del recurso del pedido de inserción. |
advertiserId |
Solo salida. Es el ID único del anunciante al que pertenece el pedido de inserción. |
campaignId |
Obligatorio. Inmutable. El ID único de la campaña a la que pertenece el pedido de inserción. |
insertionOrderId |
Solo salida. El ID único del pedido de inserción. Lo asigna el sistema. |
displayName |
Obligatorio. El nombre visible del pedido de inserción. Debe estar codificado en UTF-8, con un tamaño máximo de 240 bytes. |
insertionOrderType |
Es el tipo de pedido de inserción. Si no se especifica este campo durante la creación, el valor predeterminado es |
entityStatus |
Obligatorio. Controla si el pedido de inserción puede invertir su presupuesto y ofertar en el inventario.
|
updateTime |
Solo salida. Es la marca de tiempo de la última actualización del pedido de inserción. Lo asigna el sistema. Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: |
partnerCosts[] |
Los costos del socio asociados con el pedido de inserción. Si está ausente o está vacío en el método |
pacing |
Obligatorio. Es el parámetro de configuración de velocidad de inversión del presupuesto del pedido de inserción. |
frequencyCap |
Obligatorio. La configuración de limitación de frecuencia del pedido de inserción. |
integrationDetails |
Son los detalles de integración adicionales del pedido de inserción. |
kpi |
Obligatorio. Es el indicador clave de rendimiento (KPI) del pedido de inserción. Esto se representa como el “Objetivo” en la interfaz de Display & Video 360. |
budget |
Obligatorio. La configuración de asignación de presupuesto del pedido de inserción. |
bidStrategy |
Es la estrategia de ofertas del pedido de inserción. De forma predeterminada, se configura |
reservationType |
Solo salida. Es el tipo de reserva del pedido de inserción. |
InsertionOrderType
Posibles tipos de un pedido de inserción
El tipo de pedido de inserción determina qué configuración y opciones se aplican, como el formato de los anuncios o las opciones de segmentación.
Enumeradores | |
---|---|
INSERTION_ORDER_TYPE_UNSPECIFIED |
El tipo de pedido de inserción no se especificó o se desconoce. |
RTB |
Ofertas en tiempo real |
OVER_THE_TOP |
Excepcional. |
KPI
Es la configuración que controla el indicador clave de rendimiento, o KPI, de un pedido de inserción.
Representación JSON |
---|
{ "kpiType": enum ( |
Campos | |
---|---|
kpiType |
Obligatorio. Es el tipo de KPI. |
kpiAlgorithmId |
Opcional. ID del algoritmo de ofertas personalizadas asociado con KPI_CUSTOM_ Identity_VALUE_OVER_COST Este campo se ignora si no se selecciona el KPI adecuado. |
Campo de unión kpi_value . Obligatorio. Es el valor del KPI. El campo relevante corresponde a kpi_type . kpi_value puede ser solo uno de los siguientes: |
|
kpiAmountMicros |
Es el importe objetivo, en micros de la moneda del anunciante. Se aplica cuando
Por ejemplo: 1500000 representa 1.5 unidades estándar de la moneda. |
kpiPercentageMicros |
La representación decimal del porcentaje del objetivo en micros. Se aplica cuando
Por ejemplo: 70,000 representa el 7% (decimal 0.07). |
kpiString |
Una cadena de KPI, que puede estar vacía. Debe estar codificado en UTF-8, con una longitud de no más de 100 caracteres. Se aplica cuando |
KpiType
Posibles tipos de indicadores clave de rendimiento (KPI).
Enumeradores | |
---|---|
KPI_TYPE_UNSPECIFIED |
No se especificó el tipo de KPI o se desconoce en esta versión. |
KPI_TYPE_CPM |
El KPI es el CPM (costo por cada mil vistas). |
KPI_TYPE_CPC |
El KPI es el CPC (costo por clic). |
KPI_TYPE_CPA |
El KPI es el CPA (costo por acción). |
KPI_TYPE_CTR |
El KPI es el porcentaje de CTR (tasa de clics). |
KPI_TYPE_VIEWABILITY |
El KPI es el porcentaje de visibilidad. |
KPI_TYPE_CPIAVC |
El KPI es CPIAVC (costo por impresión audible y visible al finalizar). |
KPI_TYPE_CPE |
El KPI es el CPE (costo por participación). |
KPI_TYPE_CPV |
El KPI se establece en CPV (costo por vista). |
KPI_TYPE_CLICK_CVR |
El KPI es el porcentaje del porcentaje de conversiones por clic (conversiones por clic). |
KPI_TYPE_IMPRESSION_CVR |
El KPI es el porcentaje del porcentaje de conversiones de impresiones (conversiones por impresión). |
KPI_TYPE_VCPM |
El KPI es el VCPM (costo por cada mil impresiones visibles). |
KPI_TYPE_VTR |
El KPI es el porcentaje de la tasa de vistas de YouTube (vistas por impresión en YouTube). |
KPI_TYPE_AUDIO_COMPLETION_RATE |
El KPI es el porcentaje de la tasa de finalización de audio (reproducciones de audio completas por impresión). |
KPI_TYPE_VIDEO_COMPLETION_RATE |
El KPI es el porcentaje de tasa de finalización de video (vistas de video completas por impresión). |
KPI_TYPE_CPCL |
El KPI se establece en CPCL (costo por reproducción de audio completa). |
KPI_TYPE_CPCV |
El KPI se establece en CPCV (costo por vista completa de video). |
KPI_TYPE_TOS10 |
El KPI se establece en una tasa de tiempo en pantalla de más de 10 segundos (porcentaje de impresiones medibles que no se pueden omitir y que estuvieron en la pantalla durante al menos 10 segundos). |
KPI_TYPE_MAXIMIZE_PACING |
El KPI está configurado para maximizar el impacto de la marca, a la vez que se prioriza la inversión de todo el presupuesto. |
KPI_TYPE_CUSTOM_IMPRESSION_VALUE_OVER_COST |
El KPI se establece en el valor de las impresiones personalizadas dividido por el costo. |
KPI_TYPE_OTHER |
El KPI es algún otro valor. |
InsertionOrderBudget
Configuración que controla cómo se asigna el presupuesto de los pedidos de inserción.
Representación JSON |
---|
{ "budgetUnit": enum ( |
Campos | |
---|---|
budgetUnit |
Obligatorio. Inmutable. La unidad de presupuesto especifica si el presupuesto se basa en la moneda o en las impresiones. |
automationType |
Es el tipo de automatización que se usa para administrar la oferta y el presupuesto del pedido de inserción. Si no se especifica este campo durante la creación, el valor predeterminado es |
budgetSegments[] |
Obligatorio. Es la lista de segmentos del presupuesto. Usa un segmento de presupuesto para especificar un presupuesto específico durante un período determinado en el que se esté ejecutando un pedido de inserción. |
InsertionOrderAutomationType
Opciones posibles para automatizar la oferta y el presupuesto de los pedidos de inserción.
Enumeradores | |
---|---|
INSERTION_ORDER_AUTOMATION_TYPE_UNSPECIFIED |
No se especificó la opción de automatización de pedidos de inserción o se desconoce en esta versión. |
INSERTION_ORDER_AUTOMATION_TYPE_BUDGET |
Asignación automática del presupuesto Permite que el sistema cambie automáticamente el presupuesto a las líneas de pedido propietarias para optimizar el rendimiento definido por kpi . No hay automatización en la configuración de ofertas. |
INSERTION_ORDER_AUTOMATION_TYPE_NONE |
No se pueden automatizar las ofertas ni los presupuestos a nivel del pedido de inserción. La oferta y el presupuesto se deben configurar manualmente a nivel de la línea de pedido. |
INSERTION_ORDER_AUTOMATION_TYPE_BID_BUDGET |
Permite que el sistema ajuste automáticamente las ofertas y transfiera el presupuesto a las líneas de pedido propietarias para optimizar el rendimiento definido por la kpi . |
InsertionOrderBudgetSegment
Son parámetros de configuración que controlan el presupuesto de un solo segmento del presupuesto.
Representación JSON |
---|
{
"budgetAmountMicros": string,
"description": string,
"dateRange": {
object ( |
Campos | |
---|---|
budgetAmountMicros |
Obligatorio. Es el importe del presupuesto que invertirá el pedido de inserción para el |
description |
La descripción del segmento del presupuesto Puede utilizarse para ingresar información de la orden de compra para cada segmento del presupuesto y hacer que se imprima en las facturas. Debe estar codificado en UTF-8. |
dateRange |
Obligatorio. La configuración de fecha de inicio y finalización del segmento del presupuesto Se resuelven en función de la zona horaria del anunciante principal.
|
campaignBudgetId |
El |
Métodos |
|
---|---|
|
Crea un pedido de inserción nuevo. |
|
Borra un pedido de inserción. |
|
Obtiene un pedido de inserción. |
|
Muestra una lista de los pedidos de inserción de un anunciante. |
|
Enumera las opciones de segmentación asignadas de un pedido de inserción en todos los tipos de segmentación. |
|
Actualiza un pedido de inserción existente. |