REST Resource: advertisers.campaigns

Recurso: Campaign

Una sola campaña

Representación JSON 
{
  "name": string,
  "advertiserId": string,
  "campaignId": string,
  "displayName": string,
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "campaignGoal": {
    object (CampaignGoal)
  },
  "campaignFlight": {
    object (CampaignFlight)
  },
  "frequencyCap": {
    object (FrequencyCap)
  },
  "campaignBudgets": [
    {
      object (CampaignBudget)
    }
  ]
}
Campos
name

string

Solo salida. Es el nombre del recurso de la campaña.
advertiserId

string (int64 format)

Solo salida. Es el ID único del anunciante al que pertenece la campaña.
campaignId

string (int64 format)

Solo salida. Es el ID único de la campaña. El sistema lo asigna.
displayName

string

Es obligatorio. Es el nombre visible de la campaña.

Debe estar codificado en UTF-8 con un tamaño máximo de 240 bytes.
entityStatus

enum (EntityStatus)

Es obligatorio. Controla si los pedidos de inserción de esta campaña pueden invertir sus presupuestos y ofertar por el inventario.

  • Los valores aceptados son ENTITY_STATUS_ACTIVE, ENTITY_STATUS_ARCHIVED y ENTITY_STATUS_PAUSED.
  • Para el método campaigns.create, no se permite ENTITY_STATUS_ARCHIVED.
updateTime

string (Timestamp format)

Solo salida. Es la marca de tiempo de la última actualización de la campaña. El sistema lo asigna.

Usa el RFC 3339, en el que el resultado generado siempre se normaliza según la zona horaria Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otras compensaciones que no sean "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
campaignGoal

object (CampaignGoal)

Es obligatorio. Es el objetivo de la campaña.
campaignFlight

object (CampaignFlight)

Es obligatorio. Es la inversión y la duración planificadas de la campaña.
frequencyCap

object (FrequencyCap)

Es obligatorio. Es el parámetro de configuración de la limitación de frecuencia de la campaña.
campaignBudgets[]

object (CampaignBudget)

Es la lista de presupuestos disponibles para esta campaña.

Si no se configura este campo, la campaña usará un presupuesto ilimitado.

CampaignGoal

Son los parámetros de configuración que controlan el objetivo de una campaña.

Representación JSON 
{
  "campaignGoalType": enum (CampaignGoalType),
  "performanceGoal": {
    object (PerformanceGoal)
  }
}
Campos
campaignGoalType

enum (CampaignGoalType)

Es obligatorio. Es el tipo de objetivo de la campaña.
performanceGoal

object (PerformanceGoal)

Es obligatorio. Es el objetivo de rendimiento de la campaña.

Los valores aceptables para performanceGoalType son los siguientes:

  • PERFORMANCE_GOAL_TYPE_CPM
  • PERFORMANCE_GOAL_TYPE_CPC
  • PERFORMANCE_GOAL_TYPE_CPA
  • PERFORMANCE_GOAL_TYPE_CPIAVC
  • PERFORMANCE_GOAL_TYPE_CTR
  • PERFORMANCE_GOAL_TYPE_VIEWABILITY
  • PERFORMANCE_GOAL_TYPE_OTHER

CampaignGoalType

Son los tipos posibles de objetivos de campaña.

Enumeraciones
CAMPAIGN_GOAL_TYPE_UNSPECIFIED En esta versión, no se especifica o se desconoce el valor del objetivo.
CAMPAIGN_GOAL_TYPE_APP_INSTALL Generar instalaciones de aplicaciones o participaciones en la aplicación
CAMPAIGN_GOAL_TYPE_BRAND_AWARENESS Aumentar el reconocimiento de una marca o un producto
CAMPAIGN_GOAL_TYPE_OFFLINE_ACTION Generar ventas sin conexión o en la tienda
CAMPAIGN_GOAL_TYPE_ONLINE_ACTION Generar acciones o visitas en línea

PerformanceGoal

Son los parámetros de configuración que controlan el objetivo de rendimiento de una campaña.

Representación JSON 
{
  "performanceGoalType": enum (PerformanceGoalType),

  // Union field performance_goal_value can be only one of the following:
  "performanceGoalAmountMicros": string,
  "performanceGoalPercentageMicros": string,
  "performanceGoalString": string
  // End of list of possible types for union field performance_goal_value.
}
Campos
performanceGoalType

enum (PerformanceGoalType)

Es obligatorio. Es el tipo de objetivo de rendimiento.
Campo de unión performance_goal_value. Es obligatorio. Es el valor del objetivo de rendimiento que corresponde a un performance_goal_type determinado. performance_goal_value puede ser solo uno de los siguientes:
performanceGoalAmountMicros

string (int64 format)

Es el importe objetivo, en micros de la moneda del anunciante.

Se aplica cuando performanceGoalType es uno de los siguientes:

  • PERFORMANCE_GOAL_TYPE_CPM
  • PERFORMANCE_GOAL_TYPE_CPC
  • PERFORMANCE_GOAL_TYPE_CPA
  • PERFORMANCE_GOAL_TYPE_CPIAVC
  • PERFORMANCE_GOAL_TYPE_VCPM

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

string (int64 format)

Es la representación decimal del porcentaje objetivo en micros.

Se aplica cuando performanceGoalType es uno de los siguientes:

  • PERFORMANCE_GOAL_TYPE_CTR
  • PERFORMANCE_GOAL_TYPE_VIEWABILITY
  • PERFORMANCE_GOAL_TYPE_CLICK_CVR
  • PERFORMANCE_GOAL_TYPE_IMPRESSION_CVR
  • PERFORMANCE_GOAL_TYPE_VTR
  • PERFORMANCE_GOAL_TYPE_AUDIO_COMPLETION_RATE
  • PERFORMANCE_GOAL_TYPE_VIDEO_COMPLETION_RATE

Por ejemplo, 70000 representa el 7% (0.07 en decimales).
performanceGoalString

string

Es una cadena del indicador clave de rendimiento (KPI) que puede estar vacía. Debe estar codificado en UTF-8 y tener una longitud de no más de 100 caracteres.

Se aplica cuando performanceGoalType se establece como PERFORMANCE_GOAL_TYPE_OTHER.

PerformanceGoalType

Son los tipos posibles de objetivos de rendimiento.

Enumeraciones
PERFORMANCE_GOAL_TYPE_UNSPECIFIED El tipo de objetivo de rendimiento no se especificó o es desconocido en esta versión.
PERFORMANCE_GOAL_TYPE_CPM El objetivo de rendimiento se establece en CPM (costo por mil).
PERFORMANCE_GOAL_TYPE_CPC El objetivo de rendimiento se establece en CPC (costo por clic).
PERFORMANCE_GOAL_TYPE_CPA El objetivo de rendimiento se establece en CPA (costo por acción).
PERFORMANCE_GOAL_TYPE_CTR El objetivo de rendimiento se establece en el porcentaje de la CTR (tasa de clics).
PERFORMANCE_GOAL_TYPE_VIEWABILITY El objetivo de rendimiento se establece en el porcentaje de visibilidad.
PERFORMANCE_GOAL_TYPE_CPIAVC El objetivo de rendimiento se establece como CPIAVC (costo por impresión audible y visible al finalizar).
PERFORMANCE_GOAL_TYPE_CPE El objetivo de rendimiento se establece en CPE (costo por participación).
PERFORMANCE_GOAL_TYPE_CPV El objetivo de rendimiento se establece en CPV (costo por vista).
PERFORMANCE_GOAL_TYPE_CLICK_CVR El objetivo de rendimiento se establece en el porcentaje del porcentaje de conversiones por clic (conversiones por clic).
PERFORMANCE_GOAL_TYPE_IMPRESSION_CVR El objetivo de rendimiento se establece en el porcentaje del porcentaje de conversiones de impresión (conversiones por impresión).
PERFORMANCE_GOAL_TYPE_VCPM El objetivo de rendimiento se establece en vCPM (costo por cada mil impresiones visibles).
PERFORMANCE_GOAL_TYPE_VTR El objetivo de rendimiento se establece en el porcentaje de la tasa de vistas de YouTube (vistas de YouTube por impresión).
PERFORMANCE_GOAL_TYPE_AUDIO_COMPLETION_RATE El objetivo de rendimiento se establece en el porcentaje de la tasa de finalización de audio (reproducciones de audio completas por impresión).
PERFORMANCE_GOAL_TYPE_VIDEO_COMPLETION_RATE El objetivo de rendimiento se establece en el porcentaje de la tasa de finalización de video (vistas de video completas por impresión).
PERFORMANCE_GOAL_TYPE_OTHER El objetivo de rendimiento está establecido en Otro.

CampaignFlight

Es la configuración que hace un seguimiento de la inversión y la duración planificadas de una campaña.

Representación JSON 
{
  "plannedSpendAmountMicros": string,
  "plannedDates": {
    object (DateRange)
  }
}
Campos
plannedSpendAmountMicros

string (int64 format)

Es el importe que se espera que invierta la campaña para su plannedDates determinado. Esto no limitará la publicación, pero se usará para hacer un seguimiento de la inversión en la IU de DV360.

El importe está en micros. Debe ser mayor o igual que 0. Por ejemplo, 500000000 representa 500 unidades estándar de la moneda.
plannedDates

object (DateRange)

Es obligatorio. Son las fechas en las que se espera que se publique la campaña. Se resuelven en relación con la zona horaria del anunciante principal.

  • Las fechas especificadas aquí no afectarán la publicación. Se usan para generar alertas y advertencias. Por ejemplo, si la fecha de publicación de cualquier orden de inserción secundaria está fuera del rango de estas fechas, la interfaz de usuario mostrará una advertencia.
  • startDate es obligatorio y debe ser la fecha actual o una posterior.
  • endDate es opcional. Si se especifica, debe ser startDate o una versión posterior.
  • Cualquier fecha especificada debe ser anterior al año 2037.

CampaignBudget

Son los parámetros de configuración que controlan cómo se asigna el presupuesto de la campaña.

Representación JSON 
{
  "budgetId": string,
  "displayName": string,
  "budgetUnit": enum (BudgetUnit),
  "budgetAmountMicros": string,
  "dateRange": {
    object (DateRange)
  },
  "externalBudgetSource": enum (ExternalBudgetSource),
  "externalBudgetId": string,
  "invoiceGroupingId": string,
  "prismaConfig": {
    object (PrismaConfig)
  }
}
Campos
budgetId

string (int64 format)

Es el ID único del presupuesto de la campaña. El sistema lo asigna. No se establece para los presupuestos nuevos.

Se debe incluir cuando se actualizan o agregan presupuestos a campaignBudgets. De lo contrario, se generará y asignará un ID nuevo.
displayName

string

Es obligatorio. Es el nombre visible del presupuesto.

Debe estar codificado en UTF-8 con un tamaño máximo de 240 bytes.
budgetUnit

enum (BudgetUnit)

Es obligatorio. Inmutable. Especifica si el presupuesto se mide en moneda o en impresiones.
budgetAmountMicros

string (int64 format)

Es obligatorio. Es el importe total que pueden presupuestar los segmentos del pedido de inserción vinculado.

El importe está en micros. Debe ser mayor que 0. Por ejemplo, 500000000 representa 500 unidades estándar de la moneda.
dateRange

object (DateRange)

Es obligatorio. Es el período del presupuesto de la campaña. Los segmentos de presupuesto vinculados pueden tener un período diferente. Se resuelven en relación con la zona horaria del anunciante principal.

Tanto startDate como endDate deben ser anteriores al año 2037.
externalBudgetSource

enum (ExternalBudgetSource)

Es obligatorio. Es la fuente externa del presupuesto.
externalBudgetId

string

Inmutable. Es el ID que identifica este presupuesto para la fuente externa.

Si se configura este campo y el nivel de detalle de la factura del perfil de facturación correspondiente se establece en "Orden de compra a nivel del presupuesto", todas las impresiones publicadas en relación con este presupuesto incluirán este ID en la factura.

Debe ser único en la campaña.
invoiceGroupingId

string

Inmutable. Es el ID que se usa para agrupar los presupuestos que se incluirán en la misma factura.

Si se establece este campo y el nivel de la factura del perfil de facturación correspondiente se establece en "ID de agrupación de facturas de presupuesto", todos los externalBudgetId que compartan el mismo invoiceGroupingId se agruparán en la misma factura.
prismaConfig

object (PrismaConfig)

Son metadatos adicionales para usar con la herramienta Prisma de Mediaocean.

Es obligatorio para los presupuestos de Mediaocean.

Solo se aplica a los anunciantes de prismaEnabled.

ExternalBudgetSource

Es la fuente externa de un segmento del presupuesto de la campaña.

Enumeraciones
EXTERNAL_BUDGET_SOURCE_UNSPECIFIED El valor de la fuente de presupuesto externa no se especifica o se desconoce en esta versión.
EXTERNAL_BUDGET_SOURCE_NONE El presupuesto no tiene una fuente externa.
EXTERNAL_BUDGET_SOURCE_MEDIA_OCEAN La fuente del presupuesto es Mediaocean.

PrismaConfig

Es la configuración específica de la herramienta Prisma de Mediaocean.

Representación JSON 
{
  "prismaType": enum (PrismaType),
  "prismaCpeCode": {
    object (PrismaCpeCode)
  },
  "supplier": string
}
Campos
prismaType

enum (PrismaType)

Es obligatorio. Es el tipo de Prisma.
prismaCpeCode

object (PrismaCpeCode)

Es obligatorio. Son los códigos de cliente, producto y estimación pertinentes de la herramienta Prisma de Mediaocean.
supplier

string

Es obligatorio. Es la entidad que asignó este presupuesto (DSP, sitio, etc.).

PrismaType

Son los tipos posibles para un presupuesto de Prisma.

Enumeraciones
PRISMA_TYPE_UNSPECIFIED El tipo no se especifica o es desconocido en esta versión.
PRISMA_TYPE_DISPLAY Es el tipo de pantalla.
PRISMA_TYPE_VIDEO Tipo de video.
PRISMA_TYPE_AUDIO Tipo de audio.
PRISMA_TYPE_SOCIAL Tipo de red social.
PRISMA_TYPE_FEE Tipo de comisión.

PrismaCpeCode

El Centro de pagos de Google admite la búsqueda y el filtrado en los campos de componentes de este código.

Representación JSON 
{
  "prismaClientCode": string,
  "prismaProductCode": string,
  "prismaEstimateCode": string
}
Campos
prismaClientCode

string

Es el código de cliente de Prisma.
prismaProductCode

string

Es el código de producto de Prisma.
prismaEstimateCode

string

Es el código de estimación de Prisma.

Métodos

create

 Crea una campaña nueva.

delete

 Borra una campaña de forma permanente.

get

 Obtiene una campaña.

list

 Enumera las campañas de un anunciante.

listAssignedTargetingOptions

 Enumera las opciones de segmentación asignadas de una campaña en todos los tipos de segmentación.

patch

 Actualiza una campaña existente.