- Recurso: InserciónOrder
- InsertionOrderType
- InsertionOrderBudget
- InsertionOrderAutomationType
- InsertionOrderBudgetSegment
- BillableOutcome
- 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. Es 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 será |
entityStatus |
Obligatorio. Controla si el pedido de inserción puede invertir su presupuesto y oferta en el inventario.
|
updateTime |
Solo salida. 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 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 vacío en el método |
pacing |
Obligatorio. Es la 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. |
performanceGoal |
Obligatorio. Corresponde al objetivo de rendimiento del pedido de inserción. |
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. |
billableOutcome |
Inmutable. Es el resultado facturable del pedido de inserción. Las compras basadas en resultados dejaron de estar disponibles. |
InsertionOrderType
Tipos de pedidos de inserción posibles.
El tipo de Pedido de inserción determina qué configuración y opciones son aplicables, como el formato de los anuncios o las opciones de segmentación.
Enumeradores | |
---|---|
INSERTION_ORDER_TYPE_UNSPECIFIED |
Se desconoce el tipo de pedido de inserción o no se especificó. |
RTB |
Ofertas en tiempo real |
OVER_THE_TOP |
Excepcional. |
InsertionOrderBudget
La configuración que controla cómo se asigna el presupuesto del pedido de inserción.
Representación JSON |
---|
{ "budgetUnit": enum ( |
Campos | |
---|---|
budgetUnit |
Obligatorio. Inmutable. La unidad de presupuesto especifica si el presupuesto se basa en una moneda o en 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 será |
budgetSegments[] |
Obligatorio. Es la lista de segmentos del presupuesto. Usa un segmento de presupuesto para especificar un presupuesto durante un período determinado en el que se esté ejecutando un pedido de inserción. |
InsertionOrderAutomationType
Las opciones posibles para automatizar la oferta y el presupuesto de los pedidos de inserción
Enumeradores | |
---|---|
INSERTION_ORDER_AUTOMATION_TYPE_UNSPECIFIED |
La opción de automatización del pedido de inserción no se especificó 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 performanceGoal . No hay automatización en la configuración de ofertas. |
INSERTION_ORDER_AUTOMATION_TYPE_NONE |
No se pueden automatizar las ofertas ni el presupuesto 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 cambie el presupuesto a las líneas de pedido propietarias para optimizar el rendimiento definido por la performanceGoal . |
InsertionOrderBudgetSegment
La configuración que controla el presupuesto de un solo segmento.
Representación JSON |
---|
{
"budgetAmountMicros": string,
"description": string,
"dateRange": {
object ( |
Campos | |
---|---|
budgetAmountMicros |
Obligatorio. Es el importe del presupuesto que el pedido de inserción invertirá para el |
description |
La descripción del segmento del presupuesto. Se puede utilizar para ingresar la información de la orden de compra de cada segmento del presupuesto y hacer que se imprima esa información 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 según la zona horaria del anunciante principal.
|
campaignBudgetId |
El |
BillableOutcome
Posibles resultados facturables para un pedido de inserción.
Enumeradores | |
---|---|
BILLABLE_OUTCOME_UNSPECIFIED |
Resultado facturable no especificado. |
BILLABLE_OUTCOME_PAY_PER_IMPRESSION |
Pago por impresiones. |
BILLABLE_OUTCOME_PAY_PER_CLICK |
Pago por clic. |
BILLABLE_OUTCOME_PAY_PER_VIEWABLE_IMPRESSION |
Pago por vista activa. |
Métodos |
|
---|---|
|
Se muestran las opciones de segmentación asignadas de un pedido de inserción en todos los tipos de segmentación. |
|
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. |
|
Actualiza un pedido de inserción existente. |