REST Resource: advertisers

Recurso: Advertiser

Es un anunciante único 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,
  "billingConfig": {
    object (AdvertiserBillingConfig)
  },
  "containsEuPoliticalAds": enum (EuPoliticalAdvertisingStatus),
  "defaultBusinessName": string,
  "defaultLogoAssetId": string
}
Campos
name

string

Solo salida. Es el nombre del recurso del anunciante.
advertiserId

string (int64 format)

Solo salida. Es el ID único del anunciante. Asignado por 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 establece en ENTITY_STATUS_SCHEDULED_FOR_DELETION, el anunciante se borrará 30 días después de la primera vez que se programó su eliminación.
updateTime

string (Timestamp format)

Solo salida. Es la marca de tiempo de la última actualización del anunciante. Asignado por el sistema.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. 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".
generalConfig

object (AdvertiserGeneralConfig)

Obligatorio. Es la configuración general del anunciante.
adServerConfig

object (AdvertiserAdServerConfig)

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

object (AdvertiserCreativeConfig)

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

object (AdvertiserDataAccessConfig)

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

object (IntegrationDetails)

Son los detalles de integración del anunciante. Por el momento, solo se aplica integrationCode al anunciante. No se admiten otros campos de IntegrationDetails y se ignorarán si se proporcionan.
servingConfig

object (AdvertiserTargetingConfig)

Es la configuración de segmentación relacionada con la publicación de anuncios del anunciante.
prismaEnabled

boolean

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

En nombre de mi empresa, autorizo a Mediaocean (Prisma) a enviar planes de presupuesto segmentados a Google, y autorizo a Google a enviar los informes y las facturas correspondientes de DV360 a Mediaocean con el propósito de planificar el presupuesto, facturar y conciliar los datos de este anunciante.
billingConfig

object (AdvertiserBillingConfig)

Obligatorio. Es la configuración relacionada con la facturación del anunciante.
containsEuPoliticalAds

enum (EuPoliticalAdvertisingStatus)

Opcional. Indica si este anunciante contiene líneas de pedido que publican anuncios políticos de la Unión Europea.

Si este campo se establece en DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING, ocurrirá lo siguiente:

  • A menos que se indique lo contrario, las líneas de pedido nuevas que se creen para este anunciante se asignarán a DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING.
  • Las líneas de pedido existentes de este anunciante que no tengan un valor establecido se actualizarán a DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING en un plazo de un día.
defaultBusinessName

string

Opcional. Es el nombre de la empresa predeterminado del anunciante.

Este es el valor que utilizan los anuncios de YouTube y de generación de demanda de este anunciante si no se proporciona un nombre de la empresa.
defaultLogoAssetId

string (int64 format)

Opcional. Es el ID del activo de la imagen del logotipo predeterminado del anunciante.

Este es el ID del activo que usarán los anuncios de YouTube y de generación de demanda de este anunciante si no se proporciona un recurso de logotipo.

Debes usar advertisers.adAssets.upload para subir este recurso con la API.

AdvertiserGeneralConfig

Es 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 la 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 estándar de la base de datos TZ de la zona horaria del anunciante. Por ejemplo, America/New_York.

Consulta más información en 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 de CM360 asociada. En el caso de los anunciantes que solo usan plataformas de terceros, la zona horaria es la misma que la del socio superior.
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 : esloti
  • 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 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "thirdPartyOnlyConfig": {
    object (ThirdPartyOnlyConfig)
  },
  "cmHybridConfig": {
    object (CmHybridConfig)
  }
  // End of mutually exclusive fields.
}
Campos
Obligatorio. La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta:
thirdPartyOnlyConfig

object (ThirdPartyOnlyConfig)

Es la configuración para los anunciantes que solo 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.
Fin de los campos mutuamente excluyentes.

ThirdPartyOnlyConfig

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

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

boolean

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

CmHybridConfig

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

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

string (int64 format)

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

string (int64 format)

Obligatorio. Inmutable. Es el ID de la configuración de Floodlight de CM360 vinculada con el anunciante de DV360.
cmAdvertiserIds[]

string (int64 format)

Solo salida. Es el conjunto de IDs de anunciantes de CM360 que comparten la configuración de Floodlight de CM360.
cmSyncableSiteIds[]

string (int64 format)

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

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

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

boolean

Indica si se deben incluir o no los datos de DV360 en los informes de transferencia de datos de CM360.
dv360ToCmCostReportingEnabled

boolean

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

boolean

Obligatorio. Inmutable. Si configuras este campo como true, tú, en nombre de tu empresa, autorizas el uso compartido de la información de la configuración de Floodlight determinada con este anunciante de Display & Video 360.

AdvertiserCreativeConfig

Es la configuración relacionada con las creatividades de un anunciante.

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

string (int64 format)

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

boolean

Indica si se debe inhabilitar la función Acerca de este anuncio de Google, que agrega insignias de anuncios (para identificar el contenido como un anuncio) y la información de transparencia (en la interacción con Acerca de este anuncio) a tus anuncios para la publicidad en línea basada en el comportamiento (OBA) y los requisitos regulatorios. Acerca del anuncio les brinda a los usuarios un mayor control sobre los anuncios que ven y te ayuda a explicarles por qué ven tu anuncio. Obtén más información.

Si decides establecer este campo en true, ten en cuenta que los anuncios que se publiquen a través de Display & Video 360 deben cumplir con lo siguiente:

  • Cumplir con la Publicidad en línea basada en el comportamiento (OBA), según tu contrato con Google Marketing Platform
  • En el Espacio Económico Europeo (EEE), incluye información de transparencia y un mecanismo para que los usuarios denuncien contenido ilegal en los anuncios. Si usas una solución alternativa de insignias de anuncios, transparencia y denuncias, debes asegurarte de que incluya la información de transparencia requerida y el mecanismo de marcación de contenido ilegal, y de notificar a Google sobre cualquier denuncia de contenido ilegal a través del formulario correspondiente.
dynamicCreativeEnabled

boolean

Indica si el anunciante está habilitado para las creatividades dinámicas.
videoCreativeDataSharingAuthorized

boolean

Si configuras este campo como true, autorizas a Google, en nombre de tu empresa, a usar las creatividades de video asociadas con este anunciante de Display & Video 360 para proporcionar informes y funciones relacionados con las campañas de televisión del anunciante.

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

AdvertiserDataAccessConfig

Son los 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)

Es la configuración de los archivos de datos estructurados (SDF) del anunciante.

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

AdvertiserSdfConfig

Es la configuración de los archivos de datos estructurados (SDF) de un anunciante.

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

boolean

Indica si este anunciante anula 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 del socio, establece este campo en true y proporciona la nueva configuración en sdfConfig.
sdfConfig

object (SdfConfig)

Es la configuración de SDF del anunciante.

AdvertiserTargetingConfig

Es la configuración de segmentación relacionada con la publicación de anuncios de un anunciante.

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

boolean

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

AdvertiserBillingConfig

Es la configuración relacionada con la facturación de un anunciante.

Representación JSON 
{
  "billingProfileId": string
}
Campos
billingProfileId

string (int64 format)

Obligatorio. Es el ID de un perfil de facturación asignado al anunciante.

Métodos

audit

 Audita un anunciante.

create

 Crea un anunciante nuevo.

delete

 Borra un anunciante.

editAssignedTargetingOptions

 Edita las opciones de segmentación de un solo anunciante.

get

 Obtiene un anunciante.

list

 Muestra una lista de los anunciantes a los que puede acceder el usuario actual.

listAssignedTargetingOptions

 Enumera las opciones de segmentación asignadas de un anunciante en todos los tipos de segmentación.

patch

 Actualiza un anunciante existente.