- Recurso: Campaign
- CampaignGoal
- CampaignGoalType
- PerformanceGoal
- PerformanceGoalType
- CampaignFlight
- CampaignBudget
- ExternalBudgetSource
- PrismaConfig
- PrismaType
- PrismaCpeCode
- Métodos
Recurso: Campaign
Una sola campaña
Representación JSON |
---|
{ "name": string, "advertiserId": string, "campaignId": string, "displayName": string, "entityStatus": enum ( |
Campos | |
---|---|
name |
Solo salida. El nombre del recurso de la campaña. |
advertiserId |
Solo salida. El ID único del anunciante al que pertenece la campaña |
campaignId |
Solo salida. El ID único de la campaña. Lo asigna el sistema. |
displayName |
Obligatorio. El nombre visible de la campaña. Debe estar codificado en UTF-8 con un tamaño máximo de 240 bytes. |
entityStatus |
Obligatorio. Controla si los pedidos de inserción de esta campaña pueden invertir sus presupuestos y ofertar en el inventario.
|
updateTime |
Solo salida. La marca de tiempo de la última actualización de la campaña. 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: |
campaignGoal |
Obligatorio. El objetivo de la campaña. |
campaignFlight |
Obligatorio. La inversión y duración previstas de la campaña |
frequencyCap |
Obligatorio. El parámetro de configuración de limitación de frecuencia de la campaña |
campaignBudgets[] |
Es la lista de presupuestos disponibles para esta campaña. Si no se establece este campo, la campaña utilizará un presupuesto ilimitado. |
CampaignGoal
Son parámetros de configuración que controlan el objetivo de una campaña.
Representación JSON |
---|
{ "campaignGoalType": enum ( |
Campos | |
---|---|
campaignGoalType |
Obligatorio. Es el tipo del objetivo de la campaña. |
performanceGoal |
Obligatorio. El objetivo de rendimiento de la campaña. Los valores aceptables para
|
CampaignGoalType
Tipos posibles de objetivos de campaña.
Enumeradores | |
---|---|
CAMPAIGN_GOAL_TYPE_UNSPECIFIED |
En esta versión, no se especificó el valor del objetivo o se desconoce. |
CAMPAIGN_GOAL_TYPE_APP_INSTALL |
Generar instalaciones de la aplicación o participación en ella |
CAMPAIGN_GOAL_TYPE_BRAND_AWARENESS |
Aumentar el reconocimiento de una marca o un producto |
CAMPAIGN_GOAL_TYPE_OFFLINE_ACTION |
Generar ventas tradicionales 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 ( |
Campos | |
---|---|
performanceGoalType |
Obligatorio. Es el tipo de objetivo de rendimiento. |
Campo de unión performance_goal_value . Obligatorio. Es el valor del objetivo de rendimiento correspondiente a un performance_goal_type determinado. performance_goal_value puede ser solo uno de los siguientes: |
|
performanceGoalAmountMicros |
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. |
performanceGoalPercentageMicros |
Representación decimal del porcentaje objetivo en micros. Se aplica cuando
Por ejemplo, 70,000 representa el 7% (decimal 0.07). |
performanceGoalString |
Una string de indicador clave de rendimiento (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 |
PerformanceGoalType
Tipos de objetivos de rendimiento posibles.
Enumeradores | |
---|---|
PERFORMANCE_GOAL_TYPE_UNSPECIFIED |
No se especificó el tipo de objetivo de rendimiento o se desconoce 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 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_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 impresiones (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 tasa de finalización de video (vistas de video completas por impresión). |
PERFORMANCE_GOAL_TYPE_OTHER |
El objetivo de rendimiento está establecido en Otros. |
CampaignFlight
Son parámetros de configuración que hacen un seguimiento de la inversión y la duración planificadas de una campaña.
Representación JSON |
---|
{
"plannedSpendAmountMicros": string,
"plannedDates": {
object ( |
Campos | |
---|---|
plannedSpendAmountMicros |
Es el importe que se espera que invierta la campaña por el importe de El importe está en micros. Debe ser mayor o igual que 0. Por ejemplo, 500000000 representa 500 unidades estándar de la moneda. |
plannedDates |
Obligatorio. Las fechas en las que se espera que se publique la campaña Se resuelven según la zona horaria del anunciante principal.
|
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 ( |
Campos | |
---|---|
budgetId |
El ID único del presupuesto de la campaña Lo asigna el sistema. No establecerla para presupuestos nuevos Debe incluirse cuando se actualizan o se agregan presupuestos a |
displayName |
Obligatorio. El nombre visible del presupuesto. Debe estar codificado en UTF-8 con un tamaño máximo de 240 bytes. |
budgetUnit |
Obligatorio. Inmutable. Especifica si el presupuesto se mide en moneda o impresiones. |
budgetAmountMicros |
Obligatorio. Es el importe total que puede presupuestar los segmentos de pedidos de inserción vinculados. El importe está en micros. Debe ser mayor que 0. Por ejemplo, 500000000 representa 500 unidades estándar de la moneda. |
dateRange |
Obligatorio. El período del presupuesto de la campaña. Es posible que los segmentos de presupuesto vinculados tengan un período diferente. Se resuelven según la zona horaria del anunciante principal.
|
externalBudgetSource |
Obligatorio. Es la fuente externa del presupuesto. |
externalBudgetId |
Inmutable. El ID que identifica este presupuesto para la fuente externa. Si se configura este campo y el nivel de detalles de la factura del perfil de facturación correspondiente se establece en "PO a nivel del presupuesto", todas las impresiones publicadas con este presupuesto incluirán este ID en la factura. Debe ser único en la campaña. |
invoiceGroupingId |
Inmutable. Es el ID que se utiliza para agrupar los presupuestos que se incluirán en la misma factura. Si se configura este campo y el nivel de factura del perfil de facturación correspondiente se establece en "ID de agrupación de facturas del presupuesto", todos los |
prismaConfig |
Metadatos adicionales que puede usar la herramienta Mediaocean Prisma. Obligatorio para los presupuestos de Mediaocean. Solo se aplica a |
ExternalBudgetSource
Fuente externa para un segmento del presupuesto de la campaña.
Enumeradores | |
---|---|
EXTERNAL_BUDGET_SOURCE_UNSPECIFIED |
El valor de la fuente del presupuesto externo no se especificó 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
Configuración específica de la herramienta Mediaocean Prisma.
Representación JSON |
---|
{ "prismaType": enum ( |
Campos | |
---|---|
prismaType |
Obligatorio. El tipo Prisma. |
prismaCpeCode |
Obligatorio. Códigos relevantes de clientes, productos y estimaciones de la herramienta Mediaocean Prisma. |
supplier |
Obligatorio. La entidad asignó este presupuesto (DSP, sitio, etc.). |
PrismaType
Tipos posibles para un presupuesto de Prisma.
Enumeradores | |
---|---|
PRISMA_TYPE_UNSPECIFIED |
En esta versión, no se especificó el tipo o se desconoce. |
PRISMA_TYPE_DISPLAY |
Tipo de visualización. |
PRISMA_TYPE_SEARCH |
Tipo de búsqueda. |
PRISMA_TYPE_VIDEO |
Tipo de video. |
PRISMA_TYPE_AUDIO |
Tipo de audio. |
PRISMA_TYPE_SOCIAL |
Tipo de red social. |
PRISMA_TYPE_FEE |
Tipo de tarifa. |
PrismaCpeCode
El centro de pagos de Google admite la búsqueda y el filtrado de los campos componentes de este código.
Representación JSON |
---|
{ "prismaClientCode": string, "prismaProductCode": string, "prismaEstimateCode": string } |
Campos | |
---|---|
prismaClientCode |
El código de cliente de Prisma |
prismaProductCode |
Es el código de producto de Prisma. |
prismaEstimateCode |
Código de estimación de Prisma. |
Métodos |
|
---|---|
|
Crea una campaña nueva. |
|
Elimina una campaña de forma permanente. |
|
Obtiene una campaña. |
|
Muestra una lista de las campañas de un anunciante. |
|
Muestra una lista de las opciones de segmentación asignadas de una campaña en todos los tipos de segmentación. |
|
Actualiza una campaña existente. |