REST Resource: advertisers

Recurso: Anunciante

Un solo anunciante en Display & Video 360 (DV360).

Representación JSON
{
  "name": string,
  "advertiserId": string,
  "partnerId": string,
  "displayName": string,
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "generalConfig": {
    object (AdvertiserGeneralConfig)
  },
  "adServerConfig": {
    object (AdvertiserAdServerConfig)
  },
  "creativeConfig": {
    object (AdvertiserCreativeConfig)
  },
  "dataAccessConfig": {
    object (AdvertiserDataAccessConfig)
  },
  "integrationDetails": {
    object (IntegrationDetails)
  },
  "servingConfig": {
    object (AdvertiserTargetingConfig)
  },
  "prismaEnabled": boolean
}
Campos
name

string

Solo salida. Es el nombre del recurso del anunciante.

advertiserId

string (int64 format)

Solo salida. Es el ID único del anunciante. Lo asigna el sistema.

partnerId

string (int64 format)

Obligatorio. Inmutable. Es el ID único del socio al que pertenece el anunciante.

displayName

string

Obligatorio. Es el nombre visible del anunciante.

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

entityStatus

enum (EntityStatus)

Obligatorio. Controla si los pedidos de inserción y las líneas de pedido del anunciante pueden invertir sus presupuestos y ofertar por el inventario.

  • Los valores aceptados son ENTITY_STATUS_ACTIVE, ENTITY_STATUS_PAUSED y ENTITY_STATUS_SCHEDULED_FOR_DELETION.
  • Si se configura como ENTITY_STATUS_SCHEDULED_FOR_DELETION, el anunciante se borrará 30 días después de la fecha en que se programó la eliminación por primera vez.
updateTime

string (Timestamp format)

Solo salida. La marca de tiempo de la última actualización del anunciante. 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: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

generalConfig

object (AdvertiserGeneralConfig)

Obligatorio. Configuración general del anunciante

adServerConfig

object (AdvertiserAdServerConfig)

Obligatorio. Inmutable. Es la configuración del anunciante relacionada con el servidor de anuncios.

creativeConfig

object (AdvertiserCreativeConfig)

Obligatorio. Es la configuración relacionada con las creatividades del anunciante.

dataAccessConfig

object (AdvertiserDataAccessConfig)

Son parámetros de configuración que controlan cómo se puede acceder a los datos del anunciante.

integrationDetails

object (IntegrationDetails)

Detalles de la integración del anunciante Actualmente, solo se aplica integrationCode al anunciante. No se admiten otros campos de IntegrationDetails y, si se proporcionan, se ignorarán.

servingConfig

object (AdvertiserTargetingConfig)

Son los parámetros de configuración de segmentación relacionados con la publicación de anuncios del anunciante.

prismaEnabled

boolean

Indica si está habilitada la integración con Mediaocean (Prisma). Si habilitas esta opción, aceptas lo siguiente:

En nombre de mi empresa, autorizo a Mediaocean (Prisma) a enviar planes de segmentos presupuestarios a Google y a enviar los informes y las facturas correspondientes de DV360 a Mediaocean con fines de planificación, facturación y conciliación de presupuesto para este anunciante.

AdvertiserGeneralConfig

La configuración general de un anunciante

Representación JSON
{
  "domainUrl": string,
  "timeZone": string,
  "currencyCode": string
}
Campos
domainUrl

string

Obligatorio. Es la URL del dominio del sitio web principal del anunciante. El sistema enviará esta información a los publicadores que requieran una URL del sitio web para asociar una campaña con un anunciante.

Proporciona una URL sin ruta de acceso ni cadena de consulta que comience con http: o https:. Por ejemplo, http://www.example.com

timeZone

string

Solo salida. Es el nombre de la base de datos de TZ estándar de la zona horaria del anunciante. Por ejemplo, America/New_York.

Más información: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones

En el caso de los anunciantes híbridos de CM360, la zona horaria es la misma que la de la cuenta asociada de CM360. En el caso de los anunciantes externos, la zona horaria es la misma que la del socio principal.

currencyCode

string

Obligatorio. Inmutable. Es la moneda del anunciante en formato ISO 4217.

Los códigos aceptados y las monedas que representan son los siguientes:

Código de moneda : Nombre de la moneda

  • ARS : Peso argentino
  • AUD : Dólar australiano
  • BRL : Real brasileño
  • CAD : Dólar canadiense
  • CHF : franco suizo
  • CLP : Peso chileno
  • CNY : Yuan chino
  • COP : Peso colombiano
  • CZK : Corona checa
  • DKK : Corona danesa
  • EGP : Libra egipcia
  • EUR : euro
  • GBP : Libra esterlina
  • HKD : Dólar de Hong Kong
  • HUF : florín húngaro
  • IDR : Rupia indonesia
  • ILS : Séquel israelí
  • INR : rupia india
  • JPY : yen japonés
  • KRW : won surcoreano
  • MXN : Pesos mexicanos
  • MYR : ringgit malayo
  • NGN : naira nigeriano
  • NOK : Corona noruega
  • NZD : Dólar neozelandés
  • PEN : nuevo sol peruano
  • PLN : Zloty
  • RON : Nuevo leu rumano
  • RUB : Rublo ruso
  • SEK : Corona sueca
  • TRY : Lira turca
  • TWD : Nuevo dólar taiwanés
  • USD : Dólar estadounidense
  • ZAR : rand sudafricano

AdvertiserAdServerConfig

Es la configuración relacionada con el servidor de anuncios de un anunciante.

Representación JSON
{

  // Union field ad_server_config_scheme can be only one of the following:
  "thirdPartyOnlyConfig": {
    object (ThirdPartyOnlyConfig)
  },
  "cmHybridConfig": {
    object (CmHybridConfig)
  }
  // End of list of possible types for union field ad_server_config_scheme.
}
Campos
Campo de unión ad_server_config_scheme. Obligatorio. Las direcciones (ad_server_config_scheme) solo pueden ser una de las siguientes opciones:
thirdPartyOnlyConfig

object (ThirdPartyOnlyConfig)

Es la configuración únicamente para los anunciantes que usan servidores de anuncios de terceros.

cmHybridConfig

object (CmHybridConfig)

Es la configuración para los anunciantes que usan Campaign Manager 360 (CM360) y servidores de anuncios de terceros.

ThirdPartyOnlyConfig

Es la configuración solo para anunciantes que usan servidores de anuncios de terceros.

Representación JSON
{
  "pixelOrderIdReportingEnabled": boolean
}
Campos
pixelOrderIdReportingEnabled

boolean

Indica si los informes de ID de pedido para píxeles están habilitados o no. Este valor no se puede cambiar una vez que se establece en true.

CmHybridConfig

Configuración para anunciantes que usan Campaign Manager 360 (CM360) y servidores de anuncios de terceros.

Representación JSON
{
  "cmAccountId": string,
  "cmFloodlightConfigId": string,
  "cmSyncableSiteIds": [
    string
  ],
  "dv360ToCmDataSharingEnabled": boolean,
  "dv360ToCmCostReportingEnabled": boolean,
  "cmFloodlightLinkingAuthorized": boolean
}
Campos
cmAccountId

string (int64 format)

Obligatorio. Inmutable. Es el ID de la cuenta de la configuración de Floodlight de CM360 vinculada al anunciante de DV360.

cmFloodlightConfigId

string (int64 format)

Obligatorio. Inmutable. ID de la configuración de Floodlight de CM360 vinculada al anunciante de DV360.

cmSyncableSiteIds[]

string (int64 format)

Es una lista de sitios de CM360 cuyas posiciones se sincronizarán con DV360 como creatividades.

Si está ausente o vacío en el método advertisers.create, el sistema creará automáticamente un sitio de CM360.

Si se quitan sitios de esta lista, es posible que también se borren las creatividades de DV360 sincronizadas desde CM360. Se debe especificar al menos un sitio.

dv360ToCmDataSharingEnabled

boolean

Incluir o no datos de DV360 en los informes de transferencia de datos de CM360

dv360ToCmCostReportingEnabled

boolean

Indica si se debe informar o no el costo de DV360 a CM360.

cmFloodlightLinkingAuthorized

boolean

Obligatorio. Inmutable. Si estableces este campo en true, autorizas, en nombre de tu empresa, que se comparta la información de la configuración de Floodlight especificada con este anunciante de Display & Video 360.

AdvertiserCreativeConfig

La configuración de un anunciante relacionada con las creatividades.

Representación JSON
{
  "iasClientId": string,
  "obaComplianceDisabled": boolean,
  "dynamicCreativeEnabled": boolean,
  "videoCreativeDataSharingAuthorized": boolean
}
Campos
iasClientId

string (int64 format)

Un ID para configurar la supervisión de campañas que proporciona Integral Ad Service (IAS). El sistema de DV360 agregará una etiqueta "Campaign Monitor" de IAS que contiene este ID a la etiqueta de la creatividad.

obaComplianceDisabled

boolean

Indica si se debe usar o no el cumplimiento de la Publicidad en Línea Basada en Intereses de DV360 (OBA).

Advertencia: Si cambias la configuración de OBA, es posible que algunos intercambios de anuncios restablezcan el estado de auditoría de tus creatividades, por lo que no se puedan publicar hasta que se vuelvan a aprobar.

dynamicCreativeEnabled

boolean

Indica si el anunciante está habilitado para usar creatividades dinámicas o no.

videoCreativeDataSharingAuthorized

boolean

Si estableces este campo en true, autorizas, en nombre de tu empresa, a Google a usar creatividades de video asociadas con este anunciante de Display & Video 360 para proporcionar informes y funciones relacionadas con sus campañas televisivas.

Solo se aplica cuando el anunciante tiene una configuración de servidor de anuncios CM360 hybrid.

AdvertiserDataAccessConfig

Son parámetros de configuración que controlan cómo se puede acceder a los datos relacionados con el anunciante.

Representación JSON
{
  "sdfConfig": {
    object (AdvertiserSdfConfig)
  }
}
Campos
sdfConfig

object (AdvertiserSdfConfig)

Configuración de archivos de datos estructurados (SDF) del anunciante

Si no se especifica, se usa la configuración de SDF del socio superior.

AdvertiserSdfConfig

Configuración de archivos de datos estructurados (SDF) de un anunciante

Representación JSON
{
  "overridePartnerSdfConfig": boolean,
  "sdfConfig": {
    object (SdfConfig)
  }
}
Campos
overridePartnerSdfConfig

boolean

Indica si este anunciante anula o no la configuración de SDF de su socio superior.

De forma predeterminada, un anunciante hereda la configuración de SDF del socio superior. Para anular la configuración de socio, establece este campo en true y proporciona la nueva configuración en sdfConfig.

sdfConfig

object (SdfConfig)

La configuración de SDF del anunciante.

AdvertiserTargetingConfig

Son los parámetros de configuración de segmentación relacionados con la publicación de anuncios de un anunciante.

Representación JSON
{
  "exemptTvFromViewabilityTargeting": boolean
}
Campos
exemptTvFromViewabilityTargeting

boolean

Indica si los dispositivos de TV conectados están exentos de la segmentación por visibilidad para todas las líneas de pedido de video del anunciante.

Métodos

audit

Audita a un anunciante.

bulkEditAdvertiserAssignedTargetingOptions

Edita de forma masiva las opciones de segmentación de un único anunciante.

bulkListAdvertiserAssignedTargetingOptions

Muestra una lista de las opciones de segmentación asignadas de un anunciante en todos los tipos de segmentación.

create

Crea un anunciante nuevo.

delete

Borra un anunciante.

get

Obtiene un anunciante.

list

Se muestran los anunciantes a los que puede acceder el usuario actual.

patch

Actualiza un anunciante existente.