SearchAds360Row

Es una fila devuelta de la consulta.

Representación JSON
{
  "adGroup": {
    object (AdGroup)
  },
  "adGroupAd": {
    object (AdGroupAd)
  },
  "adGroupAdEffectiveLabel": {
    object (AdGroupAdEffectiveLabel)
  },
  "adGroupAdLabel": {
    object (AdGroupAdLabel)
  },
  "adGroupAsset": {
    object (AdGroupAsset)
  },
  "adGroupAssetSet": {
    object (AdGroupAssetSet)
  },
  "adGroupAudienceView": {
    object (AdGroupAudienceView)
  },
  "adGroupBidModifier": {
    object (AdGroupBidModifier)
  },
  "adGroupCriterion": {
    object (AdGroupCriterion)
  },
  "adGroupCriterionEffectiveLabel": {
    object (AdGroupCriterionEffectiveLabel)
  },
  "adGroupCriterionLabel": {
    object (AdGroupCriterionLabel)
  },
  "adGroupEffectiveLabel": {
    object (AdGroupEffectiveLabel)
  },
  "adGroupLabel": {
    object (AdGroupLabel)
  },
  "ageRangeView": {
    object (AgeRangeView)
  },
  "asset": {
    object (Asset)
  },
  "assetGroupAsset": {
    object (AssetGroupAsset)
  },
  "assetGroupSignal": {
    object (AssetGroupSignal)
  },
  "assetGroupListingGroupFilter": {
    object (AssetGroupListingGroupFilter)
  },
  "assetGroupTopCombinationView": {
    object (AssetGroupTopCombinationView)
  },
  "assetGroup": {
    object (AssetGroup)
  },
  "assetSetAsset": {
    object (AssetSetAsset)
  },
  "assetSet": {
    object (AssetSet)
  },
  "biddingStrategy": {
    object (BiddingStrategy)
  },
  "campaignBudget": {
    object (CampaignBudget)
  },
  "campaign": {
    object (Campaign)
  },
  "campaignAsset": {
    object (CampaignAsset)
  },
  "campaignAssetSet": {
    object (CampaignAssetSet)
  },
  "campaignAudienceView": {
    object (CampaignAudienceView)
  },
  "campaignCriterion": {
    object (CampaignCriterion)
  },
  "campaignEffectiveLabel": {
    object (CampaignEffectiveLabel)
  },
  "campaignLabel": {
    object (CampaignLabel)
  },
  "cartDataSalesView": {
    object (CartDataSalesView)
  },
  "audience": {
    object (Audience)
  },
  "conversionAction": {
    object (ConversionAction)
  },
  "conversionCustomVariable": {
    object (ConversionCustomVariable)
  },
  "customer": {
    object (Customer)
  },
  "customerAsset": {
    object (CustomerAsset)
  },
  "customerAssetSet": {
    object (CustomerAssetSet)
  },
  "accessibleBiddingStrategy": {
    object (AccessibleBiddingStrategy)
  },
  "customerManagerLink": {
    object (CustomerManagerLink)
  },
  "customerClient": {
    object (CustomerClient)
  },
  "dynamicSearchAdsSearchTermView": {
    object (DynamicSearchAdsSearchTermView)
  },
  "genderView": {
    object (GenderView)
  },
  "geoTargetConstant": {
    object (GeoTargetConstant)
  },
  "keywordView": {
    object (KeywordView)
  },
  "label": {
    object (Label)
  },
  "languageConstant": {
    object (LanguageConstant)
  },
  "locationView": {
    object (LocationView)
  },
  "productBiddingCategoryConstant": {
    object (ProductBiddingCategoryConstant)
  },
  "productGroupView": {
    object (ProductGroupView)
  },
  "shoppingPerformanceView": {
    object (ShoppingPerformanceView)
  },
  "userList": {
    object (UserList)
  },
  "userLocationView": {
    object (UserLocationView)
  },
  "webpageView": {
    object (WebpageView)
  },
  "visit": {
    object (Visit)
  },
  "conversion": {
    object (Conversion)
  },
  "metrics": {
    object (Metrics)
  },
  "segments": {
    object (Segments)
  },
  "customColumns": [
    {
      object (Value)
    }
  ]
}
Campos
adGroup

object (AdGroup)

Es el grupo de anuncios al que se hace referencia en la búsqueda.

adGroupAd

object (AdGroupAd)

Es el anuncio al que se hace referencia en la búsqueda.

adGroupAdEffectiveLabel

object (AdGroupAdEffectiveLabel)

Es la etiqueta efectiva del anuncio del grupo de anuncios a la que se hace referencia en la búsqueda.

adGroupAdLabel

object (AdGroupAdLabel)

Es la etiqueta del anuncio del grupo de anuncios a la que se hace referencia en la búsqueda.

adGroupAsset

object (AdGroupAsset)

Es el recurso del grupo de anuncios al que se hace referencia en la consulta.

adGroupAssetSet

object (AdGroupAssetSet)

Es el conjunto de recursos del grupo de anuncios al que se hace referencia en la búsqueda.

adGroupAudienceView

object (AdGroupAudienceView)

Es la vista del público del grupo de anuncios a la que se hace referencia en la consulta.

adGroupBidModifier

object (AdGroupBidModifier)

Es el modificador de ofertas al que se hace referencia en la consulta.

adGroupCriterion

object (AdGroupCriterion)

Es el criterio al que se hace referencia en la búsqueda.

adGroupCriterionEffectiveLabel

object (AdGroupCriterionEffectiveLabel)

Es la etiqueta efectiva del criterio del grupo de anuncios a la que se hace referencia en la consulta.

adGroupCriterionLabel

object (AdGroupCriterionLabel)

Es la etiqueta del criterio del grupo de anuncios a la que se hace referencia en la búsqueda.

adGroupEffectiveLabel

object (AdGroupEffectiveLabel)

Es la etiqueta efectiva del grupo de anuncios a la que se hace referencia en la consulta.

adGroupLabel

object (AdGroupLabel)

Es la etiqueta del grupo de anuncios a la que se hace referencia en la búsqueda.

ageRangeView

object (AgeRangeView)

Es la vista del rango de edad a la que se hace referencia en la consulta.

asset

object (Asset)

Es el activo al que se hace referencia en la búsqueda.

assetGroupAsset

object (AssetGroupAsset)

Es el recurso del grupo de recursos al que se hace referencia en la búsqueda.

assetGroupSignal

object (AssetGroupSignal)

Es el indicador del grupo de recursos al que se hace referencia en la búsqueda.

assetGroupListingGroupFilter

object (AssetGroupListingGroupFilter)

Es el filtro de grupo de fichas y elementos del grupo de recursos al que se hace referencia en la consulta.

assetGroupTopCombinationView

object (AssetGroupTopCombinationView)

Es la vista de la combinación principal del grupo de recursos a la que se hace referencia en la búsqueda.

assetGroup

object (AssetGroup)

Es el grupo de recursos al que se hace referencia en la búsqueda.

assetSetAsset

object (AssetSetAsset)

Es el recurso del conjunto de recursos al que se hace referencia en la búsqueda.

assetSet

object (AssetSet)

Es el conjunto de recursos al que se hace referencia en la búsqueda.

biddingStrategy

object (BiddingStrategy)

Es la estrategia de ofertas a la que se hace referencia en la búsqueda.

campaignBudget

object (CampaignBudget)

Es el presupuesto de la campaña al que se hace referencia en la búsqueda.

campaign

object (Campaign)

Es la campaña a la que se hace referencia en la búsqueda.

campaignAsset

object (CampaignAsset)

Es el recurso de la campaña al que se hace referencia en la búsqueda.

campaignAssetSet

object (CampaignAssetSet)

Es el conjunto de recursos de la campaña al que se hace referencia en la búsqueda.

campaignAudienceView

object (CampaignAudienceView)

Es la vista del público de la campaña a la que se hace referencia en la consulta.

campaignCriterion

object (CampaignCriterion)

Es el criterio de campaña al que se hace referencia en la búsqueda.

campaignEffectiveLabel

object (CampaignEffectiveLabel)

Es la etiqueta efectiva de la campaña a la que se hace referencia en la consulta.

campaignLabel

object (CampaignLabel)

Es la etiqueta de la campaña a la que se hace referencia en la búsqueda.

cartDataSalesView

object (CartDataSalesView)

Es la vista de ventas de datos del carrito a la que se hace referencia en la consulta.

audience

object (Audience)

Es el público al que se hace referencia en la búsqueda.

conversionAction

object (ConversionAction)

Es la acción de conversión a la que se hace referencia en la búsqueda.

conversionCustomVariable

object (ConversionCustomVariable)

Es la variable personalizada de conversión a la que se hace referencia en la consulta.

customer

object (Customer)

Es el cliente al que se hace referencia en la búsqueda.

customerAsset

object (CustomerAsset)

Es el recurso del cliente al que se hace referencia en la búsqueda.

customerAssetSet

object (CustomerAssetSet)

Es el conjunto de recursos del cliente al que se hace referencia en la búsqueda.

accessibleBiddingStrategy

object (AccessibleBiddingStrategy)

Es la estrategia de ofertas accesible a la que se hace referencia en la búsqueda.

customerClient

object (CustomerClient)

Es el CustomerClient al que se hace referencia en la consulta.

dynamicSearchAdsSearchTermView

object (DynamicSearchAdsSearchTermView)

Es la vista de términos de búsqueda de los anuncios dinámicos de búsqueda a la que se hace referencia en la consulta.

genderView

object (GenderView)

Es la vista de género a la que se hace referencia en la consulta.

geoTargetConstant

object (GeoTargetConstant)

Es la constante de segmentación geográfica a la que se hace referencia en la búsqueda.

keywordView

object (KeywordView)

Es la vista de palabras clave a la que se hace referencia en la búsqueda.

label

object (Label)

Es la etiqueta a la que se hace referencia en la búsqueda.

languageConstant

object (LanguageConstant)

Es la constante de idioma a la que se hace referencia en la búsqueda.

locationView

object (LocationView)

Es la vista de ubicación a la que se hace referencia en la búsqueda.

productBiddingCategoryConstant

object (ProductBiddingCategoryConstant)

Es la categoría de ofertas del producto a la que se hace referencia en la búsqueda.

productGroupView

object (ProductGroupView)

Es la vista del grupo de productos a la que se hace referencia en la búsqueda.

shoppingPerformanceView

object (ShoppingPerformanceView)

Es la vista del rendimiento de Shopping a la que se hace referencia en la consulta.

userList

object (UserList)

Es la lista de usuarios a la que se hace referencia en la consulta.

userLocationView

object (UserLocationView)

Es la vista de la ubicación del usuario a la que se hace referencia en la consulta.

webpageView

object (WebpageView)

Es la vista de la página web a la que se hace referencia en la búsqueda.

visit

object (Visit)

Es la visita a nivel del evento a la que se hace referencia en la búsqueda.

conversion

object (Conversion)

Es la conversión a nivel del evento a la que se hace referencia en la consulta.

metrics

object (Metrics)

Son las métricas.

segments

object (Segments)

Son los segmentos.

customColumns[]

object (Value)

Son las columnas personalizadas.

Grupo de anuncios

Es un grupo de anuncios.

Representación JSON
{
  "resourceName": string,
  "status": enum (AdGroupStatus),
  "type": enum (AdGroupType),
  "adRotationMode": enum (AdGroupAdRotationMode),
  "creationTime": string,
  "targetingSetting": {
    object (TargetingSetting)
  },
  "labels": [
    string
  ],
  "effectiveLabels": [
    string
  ],
  "engineId": string,
  "startDate": string,
  "endDate": string,
  "languageCode": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "cpcBidMicros": string,
  "engineStatus": enum (AdGroupEngineStatus),
  "finalUrlSuffix": string
}
Campos
resourceName

string

Es el nombre del recurso del grupo de anuncios. Los nombres de recursos de los grupos de anuncios tienen el siguiente formato:

customers/{customerId}/adGroups/{adGroupId}

status

enum (AdGroupStatus)

El estado del grupo de anuncios.

type

enum (AdGroupType)

Es el tipo del grupo de anuncios.

adRotationMode

enum (AdGroupAdRotationMode)

Es el modo de rotación de anuncios del grupo de anuncios.

creationTime

string

Es la marca de tiempo de la creación de este adGroup. La marca de tiempo se encuentra en la zona horaria del cliente y en el formato “dd-MM-aaaa HH:mm:ss”.

targetingSetting

object (TargetingSetting)

Es el parámetro de configuración para las funciones relacionadas con la segmentación.

labels[]

string

Los nombres de recursos de las etiquetas adjuntas a este grupo de anuncios.

effectiveLabels[]

string

Son los nombres de recursos de las etiquetas efectivas adjuntas a este grupo de anuncios. Una etiqueta efectiva es una etiqueta heredada o asignada directamente a este grupo de anuncios.

engineId

string

ID del grupo de anuncios en la cuenta de motor externo. Este campo es solo para una cuenta que no es de Google Ads, por ejemplo, Yahoo Japan, Microsoft, Baidu, etc. Para la entidad de Google Ads, usa "adGroup.id".

startDate

string

La fecha en la que este grupo de anuncios comienza a publicar anuncios. De forma predeterminada, el grupo de anuncios comienza ahora o en la fecha de inicio del grupo de anuncios, lo que ocurra después. Si se configura este campo, el grupo de anuncios comenzará al principio de la fecha especificada en la zona horaria del cliente. Este campo solo está disponible para cuentas de puerta de enlace de Microsoft Advertising y Facebook.

Formato: AAAA-MM-DD Ejemplo: 2019-03-14

endDate

string

Fecha en la que el grupo de anuncios termina de publicar anuncios. De forma predeterminada, el grupo de anuncios termina en la fecha de finalización del grupo. Si se configura este campo, el grupo de anuncios terminará al final de la fecha especificada en la zona horaria del cliente. Este campo solo está disponible para cuentas de puerta de enlace de Microsoft Advertising y Facebook.

Formato: AAAA-MM-DD Ejemplo: 2019-03-14

languageCode

string

El idioma de los anuncios y las palabras clave de un grupo de anuncios. Este campo solo está disponible para cuentas de Microsoft Advertising. Más detalles: https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage

lastModifiedTime

string

La fecha y hora de la última modificación de este grupo de anuncios. La fecha y hora se encuentran en la zona horaria del cliente y en el formato “dd-MM-aaaa HH:mm:ss.ssssss”.

id

string (int64 format)

El ID del grupo de anuncios.

name

string

El nombre del grupo de anuncios.

Este campo es obligatorio y no debe estar vacío cuando se crean grupos de anuncios nuevos.

Debe contener menos de 255 caracteres de ancho completo UTF-8.

No debe contener caracteres nulos (punto de código 0x0), de salto de línea NL (punto de código 0xA) ni de retorno de carro (punto de código 0xD).

trackingUrlTemplate

string

La plantilla de URL para crear una URL de seguimiento.

cpcBidMicros

string (int64 format)

La oferta de CPC (costo por clic) máxima. Este campo se usa cuando la estrategia de ofertas efectiva del grupo de anuncios es CPC manual. Este campo no se aplica y se ignorará si la campaña del grupo de anuncios utiliza una estrategia de ofertas de cartera.

engineStatus

enum (AdGroupEngineStatus)

El estado del motor para el grupo de anuncios.

finalUrlSuffix

string

Es la plantilla de URL para agregar parámetros a la URL final.

AdGroupStatus

Son los posibles estados de un grupo de anuncios.

Enums
UNSPECIFIED No se especificó el estado.
UNKNOWN

El valor recibido no se conoce en esta versión.

Este es un valor de solo respuesta.

ENABLED El grupo de anuncios está habilitado.
PAUSED El grupo de anuncios está detenido.
REMOVED Se quitó el grupo de anuncios.

AdGroupType

Es una enumeración que incluye los posibles tipos de un grupo de anuncios.

Enums
UNSPECIFIED No se especificó el tipo.
UNKNOWN

El valor recibido no se conoce en esta versión.

Este es un valor de solo respuesta.

SEARCH_STANDARD Es el tipo de grupo de anuncios predeterminado para las campañas de Búsqueda.
DISPLAY_STANDARD Es el tipo de grupo de anuncios predeterminado para las campañas de Display.
SHOPPING_PRODUCT_ADS Es el tipo de grupo de anuncios para las campañas de Shopping que publican anuncios de productos estándares.
HOTEL_ADS Es el tipo de grupo de anuncios predeterminado para las campañas de hoteles.
SHOPPING_SMART_ADS Es el tipo de grupos de anuncios en las campañas de Shopping inteligentes.
VIDEO_BUMPER Anuncios de video in-stream cortos que no se pueden omitir
VIDEO_TRUE_VIEW_IN_STREAM Anuncios de video TrueView in-stream (que se pueden omitir)
VIDEO_TRUE_VIEW_IN_DISPLAY Anuncios de video TrueView en display
VIDEO_NON_SKIPPABLE_IN_STREAM Anuncios de video in-stream que no se pueden omitir
VIDEO_OUTSTREAM Anuncios de video outstream
SEARCH_DYNAMIC_ADS Es el tipo de grupo de anuncios para los grupos de anuncios de las campañas de anuncios dinámicos de búsqueda.
SHOPPING_COMPARISON_LISTING_ADS Es el tipo de grupos de anuncios en las campañas de anuncios de comparación de Shopping.
PROMOTED_HOTEL_ADS Es el tipo de grupo de anuncios para los grupos de anuncios de hoteles promocionados.
VIDEO_RESPONSIVE Son los grupos de anuncios de video responsivos.
VIDEO_EFFICIENT_REACH Son los grupos de anuncios de alcance eficiente de video.
SMART_CAMPAIGN_ADS Es el tipo de grupo de anuncios para las campañas inteligentes.
TRAVEL_ADS Es el tipo de grupo de anuncios para las campañas de viajes.

AdGroupAdRotationMode

Son los modos de rotación de anuncios posibles de un grupo de anuncios.

Enums
UNSPECIFIED No se especificó el modo de rotación de anuncios.
UNKNOWN

El valor recibido no se conoce en esta versión.

Este es un valor de solo respuesta.

OPTIMIZE Optimiza los anuncios del grupo de anuncios en función de los clics o las conversiones.
ROTATE_FOREVER Rotar de manera uniforme indefinidamente.

AdGroupEngineStatus

Es el estado del motor del grupo de anuncios.

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
AD_GROUP_ELIGIBLE

Obsoleta. No lo utilices.

AD_GROUP_EXPIRED No se publican anuncios para este grupo de anuncios porque ya pasó la fecha de finalización del grupo de anuncios.
AD_GROUP_REMOVED Se borró el grupo de anuncios.
AD_GROUP_DRAFT No se publican anuncios para este grupo de anuncios porque el grupo de anuncios asociado aún está en borrador.
AD_GROUP_PAUSED Se detuvo el grupo de anuncios.
AD_GROUP_SERVING El grupo de anuncios está activo y actualmente publica anuncios.
AD_GROUP_SUBMITTED El grupo de anuncios se envió (estado heredado de Microsoft Bing Ads).
CAMPAIGN_PAUSED No se publican anuncios para este grupo de anuncios porque la campaña está detenida.
ACCOUNT_PAUSED No se publican anuncios para este grupo de anuncios porque se detuvo la cuenta.

TargetingSetting

Es la configuración de las funciones relacionadas con la segmentación, a nivel de la campaña y del grupo de anuncios. Para obtener más detalles sobre la configuración de la segmentación, visita https://support.google.com/google-ads/answer/7365594

Representación JSON
{
  "targetRestrictions": [
    {
      object (TargetRestriction)
    }
  ]
}
Campos
targetRestrictions[]

object (TargetRestriction)

La configuración de dimensión por segmentación para restringir el alcance de tu campaña o grupo de anuncios.

TargetRestriction

Es la lista de configuración de la segmentación por dimensión de segmentación.

Representación JSON
{
  "targetingDimension": enum (TargetingDimension),
  "bidOnly": boolean
}
Campos
targetingDimension

enum (TargetingDimension)

Es la dimensión de segmentación a la que se aplica esta configuración.

bidOnly

boolean

Indica si se deben restringir los anuncios para que se muestren solo según los criterios que seleccionaste para esta targetingDimension o si se deben segmentar todos los valores para esta targetingDimension y mostrar anuncios según tu segmentación en otras targetingDimensions. Un valor de true significa que estos criterios solo aplicarán modificadores de ofertas y no afectarán la segmentación. Un valor de false significa que estos criterios restringirán la segmentación y aplicarán modificadores de ofertas.

TargetingDimension

Es un enum que describe las posibles dimensiones de segmentación.

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
KEYWORD Son los criterios de palabras clave, por ejemplo, "crucero a Marte". Se puede usar KEYWORD como dimensión de oferta personalizada. Las palabras clave siempre son una dimensión de segmentación, por lo que no se pueden establecer como una dimensión de destino "ALL" con TargetRestriction.
AUDIENCE Criterios de público, que incluyen la lista de usuarios, el interés del usuario, la afinidad personalizada y el público en el mercado personalizado
TOPIC Son criterios de temas para segmentar categorías de contenido, por ejemplo, "category::Animals>Pets". Se usan para la segmentación de Display y video.
GENDER Son los criterios para segmentar por género.
AGE_RANGE Son los criterios para segmentar por rangos etarios.
PLACEMENT Criterios de posición, que incluyen sitios web como "www.floresparavender.com", así como aplicaciones para dispositivos móviles, categorías de aplicaciones para dispositivos móviles, videos de YouTube y canales de YouTube
PARENTAL_STATUS Son los criterios para la segmentación por estado parental.
INCOME_RANGE Son los criterios para la segmentación por intervalo de ingresos.

AdGroupAd

Es un anuncio del grupo de anuncios.

Representación JSON
{
  "resourceName": string,
  "status": enum (AdGroupAdStatus),
  "ad": {
    object (Ad)
  },
  "creationTime": string,
  "labels": [
    string
  ],
  "effectiveLabels": [
    string
  ],
  "engineId": string,
  "engineStatus": enum (AdGroupAdEngineStatus),
  "lastModifiedTime": string
}
Campos
resourceName

string

Es el nombre del recurso del anuncio. Los nombres de recursos de los anuncios de grupo de anuncios tienen el siguiente formato:

customers/{customerId}/adGroupAds/{adGroupId}~{adId}

status

enum (AdGroupAdStatus)

El estado del anuncio.

ad

object (Ad)

Es el anuncio.

creationTime

string

Es la marca de tiempo de la creación de este objeto AdGroupAd. La fecha y hora se encuentran en la zona horaria del cliente y en el formato “dd-MM-aaaa HH:mm:ss.ssssss”.

labels[]

string

Los nombres de recursos de las etiquetas adjuntas a este anuncio de grupo de anuncios.

effectiveLabels[]

string

Son los nombres de recursos de las etiquetas eficaces adjuntas a este anuncio. Una etiqueta efectiva es una etiqueta heredada o asignada directamente a este anuncio.

engineId

string

ID del anuncio en la cuenta de motor externa. Este campo solo se usa para la cuenta de Search Ads 360; por ejemplo, Yahoo Japan, Microsoft, Baidu, etc. En el caso de una entidad que no sea de Search Ads 360, usa "adGroupAd.ad.id".

engineStatus

enum (AdGroupAdEngineStatus)

Estado adicional del anuncio en la cuenta de motor externa. Los estados posibles (según el tipo de cuenta externa) incluyen activo, apto, revisión pendiente, etcétera.

lastModifiedTime

string

La fecha y hora de la última modificación de este anuncio del grupo de anuncios. La fecha y hora se encuentran en la zona horaria del cliente y en el formato “dd-MM-aaaa HH:mm:ss.ssssss”.

AdGroupAdStatus

Son los estados posibles de un AdGroupAd.

Enums
UNSPECIFIED No se especificó ningún valor.
UNKNOWN

El valor recibido no se conoce en esta versión.

Este es un valor de solo respuesta.

ENABLED El anuncio del grupo de anuncios está habilitado.
PAUSED El anuncio del grupo de anuncios está detenido.
REMOVED Se quita el anuncio del grupo de anuncios.

FinalAppUrl

Es una URL para vincular directamente a una app para el sistema operativo determinado.

Representación JSON
{
  "osType": enum (AppUrlOperatingSystemType),
  "url": string
}
Campos
osType

enum (AppUrlOperatingSystemType)

Es el sistema operativo al que se segmenta esta URL. Obligatorio.

url

string

Es la URL del vínculo directo a la aplicación. Los vínculos directos especifican una ubicación en una app que corresponde al contenido que deseas mostrar y deben tener el formato {scheme}://{host_path}. El esquema identifica qué app se debe abrir. En el caso de tu app, puedes usar un esquema personalizado que comience con el nombre de la app. El host y la ruta de acceso especifican la ubicación única en la app donde se encuentra tu contenido. Ejemplo: "exampleapp://productid_1234". Obligatorio.

AppUrlOperatingSystemType

Sistema operativo

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
IOS Es el sistema operativo iOS de Apple.
ANDROID Es el sistema operativo Android.

AdType

Son los tipos posibles de un anuncio.

Enums
UNSPECIFIED No se especificó ningún valor.
UNKNOWN

El valor recibido no se conoce en esta versión.

Este es un valor de solo respuesta.

TEXT_AD El anuncio es un anuncio de texto.
EXPANDED_TEXT_AD El anuncio es un anuncio de texto expandido. Los anuncios de texto expandidos dejaron de estar disponibles.
CALL_ONLY_AD El anuncio es un anuncio solo de llamada.
EXPANDED_DYNAMIC_SEARCH_AD El anuncio es un anuncio dinámico de búsqueda expandido.
HOTEL_AD El anuncio es un anuncio de hotel.
SHOPPING_SMART_AD El anuncio es un anuncio de Shopping inteligente.
SHOPPING_PRODUCT_AD El anuncio es un anuncio de Shopping estándar.
VIDEO_AD El anuncio es un anuncio de video.
GMAIL_AD Este anuncio es un anuncio de Gmail.
IMAGE_AD Este anuncio es un anuncio con imagen.
RESPONSIVE_SEARCH_AD El anuncio es un anuncio de búsqueda responsivo.
LEGACY_RESPONSIVE_DISPLAY_AD El anuncio es un anuncio de display responsivo heredado.
APP_AD El anuncio es un anuncio de aplicación.
LEGACY_APP_INSTALL_AD El anuncio es un anuncio heredado de instalación de aplicación.
RESPONSIVE_DISPLAY_AD El anuncio es un anuncio de display responsivo.
LOCAL_AD El anuncio es un anuncio local.
HTML5_UPLOAD_AD El anuncio es un anuncio gráfico subido con el tipo de producto HTML5_UPLOAD_AD.
DYNAMIC_HTML5_AD El anuncio es un anuncio gráfico subido con uno de los tipos de producto DYNAMIC_HTML5_*.
APP_ENGAGEMENT_AD El anuncio es un anuncio de participación en la aplicación.
SHOPPING_COMPARISON_LISTING_AD El anuncio es un anuncio de comparación de Shopping.
VIDEO_BUMPER_AD Anuncio bumper de video.
VIDEO_NON_SKIPPABLE_IN_STREAM_AD Anuncio de video in-stream que no se puede omitir.
VIDEO_OUTSTREAM_AD Es un anuncio out-stream de video.
VIDEO_TRUEVIEW_DISCOVERY_AD Anuncio de video TrueView en display.
VIDEO_TRUEVIEW_IN_STREAM_AD Anuncio TrueView in-stream.
VIDEO_RESPONSIVE_AD Es un anuncio de video responsivo.
SMART_CAMPAIGN_AD Anuncio de campaña inteligente.
APP_PRE_REGISTRATION_AD Anuncio de registro previo universal de aplicaciones.
TRAVEL_AD Anuncio de viajes.
MULTIMEDIA_AD Es un anuncio multimedia.

SyntheticContentInfo

Es un contenedor para las certificaciones de contenido sintético de diferentes fuentes, como los sistemas de Google y los anunciantes.

Representación JSON
{
  "advertiserAttestation": {
    object (SyntheticContentAttestation)
  },
  "systemAttestation": {
    object (SyntheticContentAttestation)
  }
}
Campos
advertiserAttestation

object (SyntheticContentAttestation)

Es la entrada que proporciona el anunciante.

systemAttestation

object (SyntheticContentAttestation)

Es información sobre el contenido sintético generado por los sistemas de Google.

SyntheticContentAttestation

Representa una certificación sobre el contenido sintético de una sola fuente.

Representación JSON
{
  "status": enum (SyntheticContentAttestationStatus),
  "source": enum (SyntheticContentSource)
}
Campos
status

enum (SyntheticContentAttestationStatus)

Indica si esta fuente considera que el contenido es sintético.

source

enum (SyntheticContentSource)

Es la fuente de la certificación de contenido sintético.

SyntheticContentAttestationStatus

Es el estado de certificación del contenido sintético.

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para los valores que se devuelven. Representa un valor desconocido en esta versión.
NOT_SYNTHETIC Se certifica que el contenido no es sintético.
IS_SYNTHETIC El contenido se certifica como sintético.

SyntheticContentSource

Es la fuente de la designación de contenido sintético.

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para los valores que se devuelven. Representa un valor desconocido en esta versión.
ADVERTISER_ATTESTED Es la certificación proporcionada por el anunciante.
GOOGLE_GENERATED_ADVERTISER_REVIEWED Contenido generado por Google con la revisión o los comentarios del anunciante
GOOGLE_GENERATED_FULLY_AUTOMATED Contenido generado automáticamente por Google sin revisión del anunciante

SearchAds360TextAdInfo

Es un anuncio de texto de Search Ads 360.

Representación JSON
{
  "headline": string,
  "description1": string,
  "description2": string,
  "displayUrl": string,
  "displayMobileUrl": string,
  "adTrackingId": string
}
Campos
headline

string

Es el título del anuncio.

description1

string

La primera línea de la descripción del anuncio.

description2

string

La segunda línea de la descripción del anuncio.

displayUrl

string

Es la URL visible del anuncio.

displayMobileUrl

string

Es la URL visible para dispositivos móviles del anuncio.

adTrackingId

string (int64 format)

Es el ID de seguimiento del anuncio.

SearchAds360ExpandedTextAdInfo

Es un anuncio de texto expandido de Search Ads 360. Los anuncios de texto expandidos dejaron de estar disponibles. En su lugar, usa SearchAds360ResponsiveSearchAd.

Representación JSON
{
  "headline": string,
  "headline2": string,
  "headline3": string,
  "description1": string,
  "description2": string,
  "path1": string,
  "path2": string,
  "adTrackingId": string
}
Campos
headline

string

Es el título del anuncio.

headline2

string

El segundo título del anuncio.

headline3

string

El tercer título del anuncio.

description1

string

La primera línea de la descripción del anuncio.

description2

string

La segunda línea de la descripción del anuncio.

path1

string

Es el texto que se agrega a la URL visible generada automáticamente con un delimitador.

path2

string

Texto anexado a path1 con un delimitador.

adTrackingId

string (int64 format)

Es el ID de seguimiento del anuncio.

SearchAds360ResponsiveSearchAdInfo

Es un anuncio de búsqueda responsivo de Search Ads 360.

Representación JSON
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "path1": string,
  "path2": string,
  "adTrackingId": string
}
Campos
headlines[]

object (AdTextAsset)

Es una lista de recursos de texto para los títulos. Cuando se publique el anuncio, se seleccionarán los títulos de esta lista.

descriptions[]

object (AdTextAsset)

Es una lista de recursos de texto para las descripciones. Cuando se publique el anuncio, se seleccionarán las descripciones de esta lista.

path1

string

Es el texto que se agrega a la URL visible generada automáticamente con un delimitador.

path2

string

Texto anexado a path1 con un delimitador.

adTrackingId

string (int64 format)

Es el ID de seguimiento del anuncio.

AdTextAsset

Es un recurso de texto que se usa dentro de un anuncio.

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

string

Texto del recurso.

SearchAds360ProductAdInfo

Este tipo no tiene campos.

Es un anuncio de producto de Search Ads 360.

SearchAds360ExpandedDynamicSearchAdInfo

Es un anuncio dinámico de búsqueda expandido.

Representación JSON
{
  "description1": string,
  "description2": string,
  "adTrackingId": string
}
Campos
description1

string

La primera línea de la descripción del anuncio.

description2

string

La segunda línea de la descripción del anuncio.

adTrackingId

string (int64 format)

Es el ID de seguimiento del anuncio.

AdGroupAdEngineStatus

Enumera los estados del motor de AdGroupAd.

Enums
UNSPECIFIED No se especificó ningún valor.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
AD_GROUP_AD_ELIGIBLE

Obsoleta. No lo utilices.

AD_GROUP_AD_INAPPROPRIATE_FOR_CAMPAIGN Baidu: No se aprobó la creatividad.
AD_GROUP_AD_MOBILE_URL_UNDER_REVIEW Baidu: URL para dispositivos móviles en proceso de revisión.
AD_GROUP_AD_PARTIALLY_INVALID Baidu: La creatividad no es válida en dispositivos móviles, pero sí en computadoras.
AD_GROUP_AD_TO_BE_ACTIVATED Baidu: La creatividad está lista para activarse.
AD_GROUP_AD_NOT_REVIEWED Baidu: No se revisó la creatividad.
AD_GROUP_AD_ON_HOLD

Obsoleta. No lo utilices. Usado anteriormente por Gemini

AD_GROUP_AD_PAUSED Se detuvo la creatividad.
AD_GROUP_AD_REMOVED Se quitó la creatividad.
AD_GROUP_AD_PENDING_REVIEW La creatividad está pendiente de revisión.
AD_GROUP_AD_UNDER_REVIEW La creatividad está en proceso de revisión.
AD_GROUP_AD_APPROVED Se aprobó la creatividad.
AD_GROUP_AD_DISAPPROVED Se rechazó la creatividad.
AD_GROUP_AD_SERVING Se está publicando la creatividad.
AD_GROUP_AD_ACCOUNT_PAUSED La creatividad se pausó porque la cuenta está pausada.
AD_GROUP_AD_CAMPAIGN_PAUSED La creatividad se detuvo porque la campaña está detenida.
AD_GROUP_AD_AD_GROUP_PAUSED Se detuvo la creatividad porque se detuvo el grupo de anuncios.

AdGroupAdEffectiveLabel

Es una relación entre un anuncio del grupo de anuncios y una etiqueta efectiva. Una etiqueta eficaz es una etiqueta heredada o asignada directamente a este anuncio de grupo de anuncios.

Representación JSON
{
  "resourceName": string,
  "adGroupAd": string,
  "label": string,
  "ownerCustomerId": string
}
Campos
resourceName

string

Es el nombre del recurso de la etiqueta efectiva del anuncio del grupo de anuncios. Los nombres de recursos de las etiquetas efectivas de los anuncios de grupo de anuncios tienen el siguiente formato: customers/{ownerCustomerId}/adGroupAdEffectiveLabels/{adGroupId}~{adId}~{label_id}

adGroupAd

string

Es el anuncio del grupo de anuncios al que se adjunta la etiqueta efectiva.

label

string

Es la etiqueta efectiva asignada al anuncio del grupo de anuncios.

ownerCustomerId

string (int64 format)

Es el ID del cliente propietario de la etiqueta efectiva.

AdGroupAdLabel

Es una relación entre un anuncio del grupo de anuncios y una etiqueta.

Representación JSON
{
  "resourceName": string,
  "adGroupAd": string,
  "label": string,
  "ownerCustomerId": string
}
Campos
resourceName

string

Es el nombre del recurso de la etiqueta del anuncio del grupo de anuncios. Los nombres de recursos de las etiquetas de anuncios del grupo de anuncios tienen el siguiente formato: customers/{ownerCustomerId}/adGroupAdLabels/{adGroupId}~{adId}~{label_id}

adGroupAd

string

Es el anuncio del grupo de anuncios al que se adjunta la etiqueta.

label

string

Es la etiqueta asignada al anuncio del grupo de anuncios.

ownerCustomerId

string (int64 format)

Es el ID del cliente propietario de la etiqueta.

AdGroupAsset

Es un vínculo entre un grupo de anuncios y un recurso.

Representación JSON
{
  "resourceName": string,
  "adGroup": string,
  "asset": string,
  "status": enum (AssetLinkStatus)
}
Campos
resourceName

string

Es el nombre del recurso del recurso del grupo de anuncios. Los nombres de los recursos de AdGroupAsset tienen el siguiente formato:

customers/{customerId}/adGroupAssets/{adGroupId}~{assetId}~{fieldType}

adGroup

string

Obligatorio. El grupo de anuncios al que está vinculado el recurso.

asset

string

Obligatorio. El recurso que está vinculado al grupo de anuncios.

status

enum (AssetLinkStatus)

Es el estado de la asociación del recurso del grupo de anuncios.

AssetLinkStatus

Es una enumeración que describe los estados de una vinculación de recursos.

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
ENABLED El vínculo del recurso está habilitado.
REMOVED Se quitó la vinculación del recurso.
PAUSED La vinculación de recursos está detenida.

AdGroupAssetSet

AdGroupAssetSet es la vinculación entre un grupo de anuncios y un conjunto de recursos. La creación de un AdGroupAssetSet vincula un conjunto de recursos con un grupo de anuncios.

Representación JSON
{
  "resourceName": string,
  "adGroup": string,
  "assetSet": string,
  "status": enum (AssetSetLinkStatus)
}
Campos
resourceName

string

Es el nombre del recurso del conjunto de recursos del grupo de anuncios. Los nombres de recursos de los conjuntos de recursos del grupo de anuncios tienen el siguiente formato:

customers/{customerId}/adGroupAssetSets/{adGroupId}~{asset_set_id}

adGroup

string

Es el grupo de anuncios al que está vinculado este conjunto de recursos.

assetSet

string

Es el conjunto de recursos que está vinculado al grupo de anuncios.

status

enum (AssetSetLinkStatus)

Es el estado del conjunto de recursos del grupo de anuncios. Solo lectura.

AssetSetLinkStatus

Son los posibles estados de la vinculación entre el conjunto de recursos y su contenedor.

Enums
UNSPECIFIED No se especificó el estado.
UNKNOWN El valor recibido no se conoce en esta versión. Este es un valor de solo respuesta.
ENABLED Se habilita la vinculación entre el conjunto de recursos y su contenedor.
REMOVED Se quita la vinculación entre el conjunto de recursos y su contenedor.

AdGroupAudienceView

Es una vista del público del grupo de anuncios. Incluye datos de rendimiento de los intereses y las listas de remarketing para los anuncios de la Red de Display y la Red de YouTube, y las listas de remarketing para anuncios de búsqueda (RLSA), agregados a nivel del público.

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

string

Es el nombre del recurso de la vista de público del grupo de anuncios. Los nombres de los recursos de la vista del público del grupo de anuncios tienen el siguiente formato:

customers/{customerId}/adGroupAudienceViews/{adGroupId}~{criterionId}

AdGroupBidModifier

Representa un modificador de ofertas del grupo de anuncios.

Representación JSON
{
  "resourceName": string,
  "bidModifier": number,

  // Union field criterion can be only one of the following:
  "device": {
    object (DeviceInfo)
  }
  // End of list of possible types for union field criterion.
}
Campos
resourceName

string

Es el nombre del recurso del modificador de ofertas del grupo de anuncios. Los nombres de recursos de los modificadores de ofertas del grupo de anuncios tienen el siguiente formato:

customers/{customerId}/adGroupBidModifiers/{adGroupId}~{criterionId}

bidModifier

number

El modificador para la oferta cuando el criterio coincida. El modificador debe estar en el rango de 0.1 a 10.0. Usa 0 para inhabilitar un tipo de dispositivo.

Campo de unión criterion. Es el criterio de este modificador de ofertas del grupo de anuncios.

Se requiere en las operaciones de creación a partir de la versión 5. criterion puede ser una de las siguientes opciones:

device

object (DeviceInfo)

Es un criterio del dispositivo.

DeviceInfo

Es un criterio del dispositivo.

Representación JSON
{
  "type": enum (Device)
}
Campos
type

enum (Device)

Tipo del dispositivo.

Dispositivo

Enumera los dispositivos de Google Ads disponibles para la segmentación.

Enums
UNSPECIFIED No se especifica.
UNKNOWN El valor es desconocido en esta versión.
MOBILE Dispositivos móviles con navegadores completos
TABLET Tablets con navegadores completos
DESKTOP Computadoras
CONNECTED_TV Smart TVs y consolas de juegos
OTHER Otros tipos de dispositivos

AdGroupCriterion

Es un criterio del grupo de anuncios. El informe adGroupCriterion solo devuelve los criterios que se agregaron de forma explícita al grupo de anuncios.

Representación JSON
{
  "resourceName": string,
  "creationTime": string,
  "status": enum (AdGroupCriterionStatus),
  "qualityInfo": {
    object (QualityInfo)
  },
  "type": enum (CriterionType),
  "labels": [
    string
  ],
  "effectiveLabels": [
    string
  ],
  "positionEstimates": {
    object (PositionEstimates)
  },
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "engineId": string,
  "lastModifiedTime": string,
  "criterionId": string,
  "adGroup": string,
  "negative": boolean,
  "bidModifier": number,
  "cpcBidMicros": string,
  "effectiveCpcBidMicros": string,
  "engineStatus": enum (AdGroupCriterionEngineStatus),
  "finalUrlSuffix": string,
  "trackingUrlTemplate": string,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "listingGroup": {
    object (ListingGroupInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "location": {
    object (LocationInfo)
  }
  // End of list of possible types for union field criterion.
}
Campos
resourceName

string

Es el nombre del recurso del criterio del grupo de anuncios. Los nombres de recursos de los criterios del grupo de anuncios tienen el siguiente formato:

customers/{customerId}/adGroupCriteria/{adGroupId}~{criterionId}

creationTime

string

La marca de tiempo de la creación del criterio del grupo de anuncios. La marca de tiempo se encuentra en la zona horaria del cliente y en el formato “dd-MM-aaaa HH:mm:ss”.

status

enum (AdGroupCriterionStatus)

El estado del criterio.

Este es el estado de la entidad de criterio del grupo de anuncios, configurada por el cliente. Nota: Es posible que los informes de la IU incorporen información adicional que afecte si un criterio es apto para ejecutarse. En algunos casos, un criterio que se quita en la API aún puede mostrarse como habilitado en la IU. Por ejemplo, las campañas predeterminadas se mostrarán a los usuarios de todos los rangos de edad, a menos que se excluyan. La IU mostrará cada rango de edad como "habilitado", ya que son aptos para ver los anuncios, pero AdGroupCriterion.status mostrará “quitado”, ya que no se agregó ningún criterio positivo.

qualityInfo

object (QualityInfo)

Es información sobre la calidad del criterio.

type

enum (CriterionType)

El tipo del criterio.

labels[]

string

Los nombres de recursos de las etiquetas adjuntas a este criterio de grupo de anuncios.

effectiveLabels[]

string

Son los nombres de recursos de las etiquetas vigentes adjuntas a este criterio de grupo de anuncios. Una etiqueta eficaz es una etiqueta heredada o asignada directamente a este criterio de grupo de anuncios.

positionEstimates

object (PositionEstimates)

Son las estimaciones de las ofertas de criterios en varias posiciones.

finalUrls[]

string

La lista de posibles URLs finales después de todos los redireccionamientos entre dominios del anuncio.

finalMobileUrls[]

string

Es la lista de posibles URLs finales para dispositivos móviles después de todos los redireccionamientos entre dominios.

urlCustomParameters[]

object (CustomParameter)

Es la lista de asignaciones que se usan para sustituir las etiquetas de parámetros personalizados en un objeto trackingUrlTemplate, finalUrls o mobile_final_urls.

engineId

string

ID del criterio del grupo de anuncios en la cuenta de motor externo. Este campo es solo para una cuenta que no es de Google Ads, por ejemplo, Yahoo Japan, Microsoft, Baidu, etc. Para la entidad de Google Ads, usa "adGroupCriterion.criterion_id".

lastModifiedTime

string

La fecha y hora de la última modificación del criterio de este grupo de anuncios. La fecha y hora se encuentran en la zona horaria del cliente y en el formato “dd-MM-aaaa HH:mm:ss.ssssss”.

criterionId

string (int64 format)

El ID del criterio.

adGroup

string

Es el grupo de anuncios al que pertenece el criterio.

negative

boolean

Indica si se debe segmentar (false) o excluir (true) el criterio.

Este campo es inmutable. Para cambiar un criterio de positivo a negativo, quítalo y vuelve a agregarlo.

bidModifier

number

El modificador para la oferta cuando el criterio coincida. El modificador debe estar en el rango de 0.1 a 10.0. La mayoría de los tipos de criterios de segmentación admiten modificadores.

cpcBidMicros

string (int64 format)

La oferta de CPC (costo por clic).

effectiveCpcBidMicros

string (int64 format)

La oferta de CPC (costo por clic) efectiva.

engineStatus

enum (AdGroupCriterionEngineStatus)

El estado del motor para el criterio del grupo de anuncios.

finalUrlSuffix

string

Plantilla de URL para agregar parámetros a la URL final.

trackingUrlTemplate

string

La plantilla de URL para crear una URL de seguimiento.

Campo de unión criterion. Es el criterio del grupo de anuncios.

Se debe establecer exactamente uno. criterion puede ser una de las siguientes opciones:

keyword

object (KeywordInfo)

Es la palabra clave.

listingGroup

object (ListingGroupInfo)

Es el grupo de fichas.

ageRange

object (AgeRangeInfo)

Es el rango de edad.

gender

object (GenderInfo)

Es el género.

userList

object (UserListInfo)

Es la lista de usuarios.

webpage

object (WebpageInfo)

Página web

location

object (LocationInfo)

Ubicación.

AdGroupCriterionStatus

Son los estados posibles de un AdGroupCriterion.

Enums
UNSPECIFIED No se especificó ningún valor.
UNKNOWN

El valor recibido no se conoce en esta versión.

Este es un valor de solo respuesta.

ENABLED El criterio del grupo de anuncios está habilitado.
PAUSED El criterio del grupo de anuncios está detenido.
REMOVED Se quita el criterio del grupo de anuncios.

QualityInfo

Es un contenedor de información sobre la calidad del criterio del grupo de anuncios.

Representación JSON
{
  "qualityScore": integer
}
Campos
qualityScore

integer

El nivel de calidad.

Este campo no se puede propagar si Google no tiene suficiente información para determinar un valor.

CriterionType

Es una enumeración que describe los posibles tipos de criterios.

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
KEYWORD Palabra clave, por ejemplo, "crucero a Marte".
PLACEMENT Es la posición, también conocida como sitio web, por ejemplo, "www.floresparavender.com".
MOBILE_APP_CATEGORY Son las categorías de aplicaciones para dispositivos móviles a las que se segmenta la campaña.
MOBILE_APPLICATION Son las aplicaciones para dispositivos móviles a las que se segmenta la campaña.
DEVICE Son los dispositivos para segmentar.
LOCATION Son las ubicaciones para segmentar los anuncios.
LISTING_GROUP Es la lista de grupos para segmentar.
AD_SCHEDULE Programación de anuncios
AGE_RANGE Es el rango de edad.
GENDER Es el género.
INCOME_RANGE Rango de ingresos.
PARENTAL_STATUS Es el estado parental.
YOUTUBE_VIDEO Video de YouTube
YOUTUBE_CHANNEL Canal de YouTube
USER_LIST Es la lista de usuarios.
PROXIMITY Proximidad
TOPIC Una segmentación por tema en la Red de Display (por ejemplo, "Mascotas y animales").
LISTING_SCOPE Es el alcance de la ficha para la segmentación.
LANGUAGE Language.
IP_BLOCK Es IpBlock.
CONTENT_LABEL Es la etiqueta de contenido para la exclusión de categorías.
CARRIER Es el operador.
USER_INTEREST Es una categoría en la que el usuario está interesado.
WEBPAGE Es un criterio de página web para los anuncios dinámicos de búsqueda.
OPERATING_SYSTEM_VERSION Es la versión del sistema operativo.
APP_PAYMENT_MODEL Modelo de pago de la app.
MOBILE_DEVICE Dispositivo móvil.
CUSTOM_AFFINITY Afinidad personalizada
CUSTOM_INTENT Intención personalizada.
LOCATION_GROUP Es el grupo por ubicación.
CUSTOM_AUDIENCE Público personalizado
COMBINED_AUDIENCE Público combinado
KEYWORD_THEME Tema de palabras clave de la campaña inteligente
AUDIENCE Público
LOCAL_SERVICE_ID Es el ID del servicio de los Anuncios de Servicios Locales.
BRAND Marca
BRAND_LIST Lista de marcas
LIFE_EVENT Acontecimiento personal

PositionEstimates

Son las estimaciones de las ofertas de criterios en varias posiciones.

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

string (int64 format)

Es la estimación de la oferta de CPC requerida para que el anuncio se muestre en la parte superior de la primera página de los resultados de la búsqueda.

AdGroupCriterionEngineStatus

Enumera los estados del motor de AdGroupCriterion.

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
AD_GROUP_CRITERION_ELIGIBLE

Obsoleta. No lo utilices.

AD_GROUP_CRITERION_INAPPROPRIATE_FOR_CAMPAIGN Baidu: La oferta o la calidad son demasiado bajas para mostrar anuncios.
AD_GROUP_CRITERION_LOW_SEARCH_VOLUME Baidu: Se detuvo por Baidu debido a un volumen de búsquedas bajo.
AD_GROUP_CRITERION_MOBILE_URL_UNDER_REVIEW Baidu: URL para dispositivos móviles en proceso de revisión.
AD_GROUP_CRITERION_PARTIALLY_INVALID Baidu: La página de destino para un dispositivo no es válida, mientras que la página de destino para el otro dispositivo sí lo es.
AD_GROUP_CRITERION_TO_BE_ACTIVATED Baidu: La administración de cuentas de Baidu creó y detuvo la palabra clave, y ahora está lista para que la actives.
AD_GROUP_CRITERION_UNDER_REVIEW Baidu: Está en proceso de revisión por parte de Baidu. Gemini: El criterio está en proceso de revisión.
AD_GROUP_CRITERION_NOT_REVIEWED Baidu: Es el criterio que se revisará.
AD_GROUP_CRITERION_ON_HOLD

Obsoleta. No lo utilices. Usado anteriormente por Gemini

AD_GROUP_CRITERION_PENDING_REVIEW Y!J : Criterio pendiente de revisión
AD_GROUP_CRITERION_PAUSED Se detuvo el criterio.
AD_GROUP_CRITERION_REMOVED Se quitó el criterio.
AD_GROUP_CRITERION_APPROVED Se aprobó el criterio.
AD_GROUP_CRITERION_DISAPPROVED Se rechazó el criterio.
AD_GROUP_CRITERION_SERVING El criterio está activo y se publica.
AD_GROUP_CRITERION_ACCOUNT_PAUSED El criterio se detuvo porque la cuenta está detenida.

CustomParameter

Es una asignación que pueden usar las etiquetas de parámetros personalizados en un objeto trackingUrlTemplate, finalUrls o mobile_final_urls.

Representación JSON
{
  "key": string,
  "value": string
}
Campos
key

string

Es la clave que coincide con el nombre de la etiqueta del parámetro.

value

string

Es el valor que se sustituirá.

KeywordInfo

Es un criterio de palabra clave.

Representación JSON
{
  "matchType": enum (KeywordMatchType),
  "text": string
}
Campos
matchType

enum (KeywordMatchType)

El tipo de concordancia de la palabra clave.

text

string

El texto de la palabra clave (como máximo, 80 caracteres y 10 palabras).

KeywordMatchType

Son los posibles tipos de concordancia de palabras clave.

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
EXACT Es una coincidencia exacta.
PHRASE Concordancia de frase.
BROAD Concordancia amplia.

ListingGroupInfo

Es un criterio del grupo de fichas.

Representación JSON
{
  "type": enum (ListingGroupType)
}
Campos
type

enum (ListingGroupType)

Tipo del grupo de fichas.

ListingGroupType

Es el tipo del grupo de fichas.

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
SUBDIVISION Subdivisión de productos según alguna dimensión de la ficha. Estos nodos no se usan para la publicación de anuncios segmentados en las entradas de la ficha, sino que sirven únicamente para definir la estructura del árbol.
UNIT Es la unidad del grupo de fichas que define una oferta.

AgeRangeInfo

Es un criterio de rango de edad.

Representación JSON
{
  "type": enum (AgeRangeType)
}
Campos
type

enum (AgeRangeType)

Tipo de rango de edad.

AgeRangeType

Es el tipo de rangos etarios demográficos (por ejemplo, entre 18 y 24 años).

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
AGE_RANGE_18_24 Tener entre 18 y 24 años
AGE_RANGE_25_34 Entre 25 y 34 años
AGE_RANGE_35_44 Entre 35 y 44 años
AGE_RANGE_45_54 Entre 45 y 54 años
AGE_RANGE_55_64 Entre 55 y 64 años
AGE_RANGE_65_UP 65 años y más
AGE_RANGE_UNDETERMINED Es un rango de edad indeterminado.

GenderInfo

Es un criterio de género.

Representación JSON
{
  "type": enum (GenderType)
}
Campos
type

enum (GenderType)

El tipo de género.

GenderType

Es el tipo de género demográfico (por ejemplo, femenino).

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
MALE Hombre.
FEMALE Mujer.
UNDETERMINED Género indeterminado.

UserListInfo

Es un criterio de lista de usuarios. Representa una lista de usuarios que el anunciante define para la segmentación.

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

string

El nombre del recurso de la lista de usuarios.

WebpageInfo

Representa un criterio para segmentar las páginas web del sitio web de un anunciante.

Representación JSON
{
  "conditions": [
    {
      object (WebpageConditionInfo)
    }
  ],
  "coveragePercentage": number,
  "criterionName": string
}
Campos
conditions[]

object (WebpageConditionInfo)

Condiciones o expresiones lógicas para la segmentación de páginas web. La lista de condiciones de segmentación de páginas web se crea cuando se evalúa la segmentación. Una lista de condiciones vacía indica que todas las páginas del sitio web de la campaña se segmentan.

Este campo es obligatorio para las operaciones de creación y está prohibido en las operaciones de actualización.

coveragePercentage

number

Porcentaje de cobertura de los criterios del sitio web. Es el porcentaje calculado de cobertura del sitio web en función de la segmentación del sitio web, la segmentación negativa del sitio web y las palabras clave negativas del grupo de anuncios y la campaña. Por ejemplo, cuando la cobertura se muestra como 1, indica que tiene una cobertura del 100%. Este campo es de solo lectura.

criterionName

string

Es el nombre del criterio que define este parámetro. El valor del nombre se usará para identificar, ordenar y filtrar criterios con este tipo de parámetros.

Este campo es obligatorio para las operaciones de creación y está prohibido en las operaciones de actualización.

WebpageConditionInfo

Es una expresión lógica para segmentar páginas web del sitio web de un anunciante.

Representación JSON
{
  "operand": enum (WebpageConditionOperand),
  "operator": enum (WebpageConditionOperator),
  "argument": string
}
Campos
operand

enum (WebpageConditionOperand)

Es el operando de la condición de segmentación de páginas web.

operator

enum (WebpageConditionOperator)

Es el operador de la condición de segmentación de páginas web.

argument

string

Es el argumento de la condición de segmentación de páginas web.

WebpageConditionOperand

Es el operando de la condición de la página web en el criterio de página web.

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
URL Es un operando que denota una condición de segmentación por URL de página web.
CATEGORY Es un operando que denota una condición de segmentación por categoría de página web.
PAGE_TITLE Es un operando que denota una condición de segmentación por título de página web.
PAGE_CONTENT Es un operando que denota una condición de segmentación por contenido de la página web.
CUSTOM_LABEL Es un operando que denota una condición de segmentación por etiqueta personalizada de página web.

WebpageConditionOperator

Es el operador de condición de la página web en el criterio de página web.

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
EQUALS El argumento de la condición web es igual a la condición web comparada.
CONTAINS El argumento de condición web forma parte de la condición web comparada.

LocationInfo

Es un criterio de ubicación.

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

string

El nombre del recurso constante de la segmentación geográfica.

AdGroupCriterionEffectiveLabel

Es una relación entre un criterio del grupo de anuncios y una etiqueta efectiva. Una etiqueta eficaz es una etiqueta heredada o asignada directamente a este criterio de grupo de anuncios.

Representación JSON
{
  "resourceName": string,
  "adGroupCriterion": string,
  "label": string,
  "ownerCustomerId": string
}
Campos
resourceName

string

Es el nombre del recurso de la etiqueta efectiva del criterio del grupo de anuncios. Los nombres de recursos de las etiquetas efectivas del criterio del grupo de anuncios tienen el siguiente formato: customers/{ownerCustomerId}/adGroupCriterionEffectiveLabels/{adGroupId}~{criterionId}~{label_id}

adGroupCriterion

string

Es el criterio del grupo de anuncios al que se adjunta la etiqueta efectiva.

label

string

Es la etiqueta efectiva asignada al criterio del grupo de anuncios.

ownerCustomerId

string (int64 format)

Es el ID del cliente propietario de la etiqueta efectiva.

AdGroupCriterionLabel

Es una relación entre un criterio del grupo de anuncios y una etiqueta.

Representación JSON
{
  "resourceName": string,
  "adGroupCriterion": string,
  "label": string,
  "ownerCustomerId": string
}
Campos
resourceName

string

Es el nombre del recurso de la etiqueta del criterio del grupo de anuncios. Los nombres de recursos de las etiquetas de criterios del grupo de anuncios tienen el siguiente formato: customers/{ownerCustomerId}/adGroupCriterionLabels/{adGroupId}~{criterionId}~{label_id}

adGroupCriterion

string

Es el criterio del grupo de anuncios al que se adjunta la etiqueta.

label

string

Es la etiqueta asignada al criterio del grupo de anuncios.

ownerCustomerId

string (int64 format)

Es el ID del cliente propietario de la etiqueta.

AdGroupEffectiveLabel

Es una relación entre un grupo de anuncios y una etiqueta efectiva. Una etiqueta efectiva es una etiqueta heredada o asignada directamente a este grupo de anuncios.

Representación JSON
{
  "resourceName": string,
  "adGroup": string,
  "label": string,
  "ownerCustomerId": string
}
Campos
resourceName

string

Es el nombre del recurso de la etiqueta efectiva del grupo de anuncios. Los nombres de recursos de las etiquetas efectivas del grupo de anuncios tienen el siguiente formato: customers/{ownerCustomerId}/adGroupEffectiveLabels/{adGroupId}~{label_id}

adGroup

string

Es el grupo de anuncios al que se adjunta la etiqueta efectiva.

label

string

Es la etiqueta efectiva asignada al grupo de anuncios.

ownerCustomerId

string (int64 format)

Es el ID del cliente propietario de la etiqueta efectiva.

AdGroupLabel

Es una relación entre un grupo de anuncios y una etiqueta.

Representación JSON
{
  "resourceName": string,
  "adGroup": string,
  "label": string,
  "ownerCustomerId": string
}
Campos
resourceName

string

Es el nombre del recurso de la etiqueta del grupo de anuncios. Los nombres de recursos de las etiquetas del grupo de anuncios tienen el siguiente formato: customers/{ownerCustomerId}/adGroupLabels/{adGroupId}~{label_id}

adGroup

string

Es el grupo de anuncios al que se adjunta la etiqueta.

label

string

Es la etiqueta asignada al grupo de anuncios.

ownerCustomerId

string (int64 format)

Es el ID del cliente propietario de la etiqueta.

AgeRangeView

Es una vista de rango de edad.

Representa la vista de las métricas de rendimiento de un cliente (como las impresiones y los clics) agregadas por rango de edad. Todas las estadísticas se agregan a nivel del grupo de anuncios.

Nota: Si bien puedes segmentar las métricas por rango de edad con ageRangeView o por género con genderView, la API de Search Ads 360 no admite la segmentación de métricas por rango de edad y género de forma simultánea en una sola consulta. El análisis del rendimiento en ambas dimensiones combinadas no se admite en la API de Search Ads 360.

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

string

Es el nombre del recurso de la vista del rango de edad. Los nombres de los recursos de la vista de rango etario tienen el siguiente formato:

customers/{customerId}/ageRangeViews/{adGroupId}~{criterionId}

Recurso

Un recurso es una parte de un anuncio que se puede compartir en varios anuncios. Puede ser una imagen (ImageAsset), un video (YoutubeVideoAsset), etcétera. Los recursos son inmutables y no se pueden quitar. Para que un recurso deje de publicarse, quítalo de la entidad que lo usa.

Representación JSON
{
  "resourceName": string,
  "type": enum (AssetType),
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "status": enum (AssetStatus),
  "creationTime": string,
  "lastModifiedTime": string,
  "syntheticContentInfo": {
    object (SyntheticContentInfo)
  },
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,
  "engineStatus": enum (AssetEngineStatus),

  // Union field asset_data can be only one of the following:
  "youtubeVideoAsset": {
    object (YoutubeVideoAsset)
  },
  "imageAsset": {
    object (ImageAsset)
  },
  "textAsset": {
    object (TextAsset)
  },
  "calloutAsset": {
    object (UnifiedCalloutAsset)
  },
  "sitelinkAsset": {
    object (UnifiedSitelinkAsset)
  },
  "pageFeedAsset": {
    object (UnifiedPageFeedAsset)
  },
  "mobileAppAsset": {
    object (MobileAppAsset)
  },
  "callAsset": {
    object (UnifiedCallAsset)
  },
  "callToActionAsset": {
    object (CallToActionAsset)
  },
  "locationAsset": {
    object (UnifiedLocationAsset)
  }
  // End of list of possible types for union field asset_data.
}
Campos
resourceName

string

Es el nombre del recurso del activo. Los nombres de recursos de los activos tienen el siguiente formato:

customers/{customerId}/assets/{assetId}

type

enum (AssetType)

Es el tipo de recurso.

finalUrls[]

string

Una lista de las posibles URLs finales después de todos los redireccionamientos entre dominios.

finalMobileUrls[]

string

Es una lista de las posibles URLs finales para dispositivos móviles después de todos los redireccionamientos entre dominios.

urlCustomParameters[]

object (CustomParameter)

Es una lista de asignaciones que se utilizarán para sustituir las etiquetas de parámetros personalizados de URL en trackingUrlTemplate, finalUrls o finalMobileUrls.

status

enum (AssetStatus)

El estado del recurso.

creationTime

string

La marca de tiempo de la creación de este recurso. La marca de tiempo se encuentra en la zona horaria del cliente y en el formato “dd-MM-aaaa HH:mm:ss”.

lastModifiedTime

string

La fecha y hora de la última modificación de este recurso. La fecha y hora se encuentran en la zona horaria del cliente y en el formato “dd-MM-aaaa HH:mm:ss.ssssss”.

syntheticContentInfo

object (SyntheticContentInfo)

Es la información del contenido sintético del activo. Solo los recursos con tipos específicos son aptos para las actualizaciones con el campo syntheticContentInfo.

Valores AssetType permitidos: * IMAGE * MEDIA_BUNDLE * YOUTUBE_VIDEO

id

string (int64 format)

El ID del activo.

name

string

Nombre opcional del activo.

trackingUrlTemplate

string

Plantilla de URL para crear una URL de seguimiento.

finalUrlSuffix

string

Es la plantilla de URL para agregar parámetros a las URLs de página de destino que se publican con el seguimiento paralelo.

engineStatus

enum (AssetEngineStatus)

Es el estado del motor de un recurso.

Campo de unión asset_data. Es el tipo específico del activo. asset_data puede ser solo uno de los parámetros siguientes:
youtubeVideoAsset

object (YoutubeVideoAsset)

Es un recurso de video de YouTube.

imageAsset

object (ImageAsset)

Es un recurso de imagen.

textAsset

object (TextAsset)

Es un recurso de texto.

calloutAsset

object (UnifiedCalloutAsset)

Es un recurso de texto destacado unificado.

pageFeedAsset

object (UnifiedPageFeedAsset)

Es un recurso de feed de páginas unificado.

mobileAppAsset

object (MobileAppAsset)

Es un recurso de aplicación para dispositivos móviles.

callAsset

object (UnifiedCallAsset)

Es un recurso de llamada unificado.

callToActionAsset

object (CallToActionAsset)

Es un recurso de llamado a la acción.

locationAsset

object (UnifiedLocationAsset)

Es un recurso de ubicación unificado.

AssetType

Es una enumeración que describe los posibles tipos de recursos.

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
YOUTUBE_VIDEO Es un recurso de video de YouTube.
MEDIA_BUNDLE Es el recurso del paquete de medios.
IMAGE Es un recurso de imagen.
TEXT Es un recurso de texto.
LEAD_FORM Es el recurso de formulario de clientes potenciales.
BOOK_ON_GOOGLE Es un activo de Reservar en Google.
PROMOTION Es el recurso de promoción.
CALLOUT Es el recurso de texto destacado.
STRUCTURED_SNIPPET Es un recurso de fragmento estructurado.
PAGE_FEED Es un recurso del feed de páginas.
DYNAMIC_EDUCATION Es un recurso dinámico de educación.
MOBILE_APP Es un recurso de aplicación para dispositivos móviles.
HOTEL_CALLOUT Es un recurso de texto destacado de hoteles.
CALL Es un recurso de llamada.
PRICE Es el recurso de precios.
CALL_TO_ACTION Es un recurso de llamado a la acción.
DYNAMIC_REAL_ESTATE Es un recurso dinámico de bienes raíces.
DYNAMIC_CUSTOM Es un recurso personalizado dinámico.
DYNAMIC_HOTELS_AND_RENTALS Es un recurso de anuncio dinámico de hoteles y alquileres.
DYNAMIC_FLIGHTS Es el recurso de anuncios dinámicos de vuelos.
DYNAMIC_TRAVEL Es un recurso de viajes dinámico.
DYNAMIC_LOCAL Es un recurso local dinámico.
DYNAMIC_JOBS Es un recurso de anuncios dinámicos de empleos.
LOCATION Es un recurso de ubicación.
HOTEL_PROPERTY Es un recurso de propiedad de hotel.

AssetStatus

Son los estados posibles de un activo.

Enums
UNSPECIFIED No se especificó el estado.
UNKNOWN El valor recibido no se conoce en esta versión. Este es un valor de solo respuesta.
ENABLED El activo está habilitado.
REMOVED Se quita el recurso.
ARCHIVED El activo está archivado.
PENDING_SYSTEM_GENERATED El recurso se generó automáticamente y está pendiente de la revisión del usuario.

AssetEngineStatus

Es una enumeración que describe los posibles estados del motor de activos.

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
SERVING El activo está activo.
SERVING_LIMITED El recurso está activo y limitado.
DISAPPROVED Se rechazó el recurso (no apto).
DISABLED El activo está inactivo (pendiente).
REMOVED Se quitó el recurso.

YoutubeVideoAsset

Es un activo de YouTube.

Representación JSON
{
  "youtubeVideoTitle": string,
  "youtubeVideoId": string
}
Campos
youtubeVideoTitle

string

Es el título del video de YouTube.

youtubeVideoId

string

Es el ID del video de YouTube. Es el valor de cadena de 11 caracteres que se usa en la URL del video de YouTube.

ImageAsset

Es un recurso de imagen.

Representación JSON
{
  "mimeType": enum (MimeType),
  "fullSize": {
    object (ImageDimension)
  },
  "fileSize": string
}
Campos
mimeType

enum (MimeType)

Es el tipo de MIME del recurso de imagen.

fullSize

object (ImageDimension)

Son los metadatos de esta imagen en su tamaño original.

fileSize

string (int64 format)

Tamaño del archivo del recurso de imagen en bytes.

MimeType

Tipo de MIME

Enums
UNSPECIFIED No se especificó el tipo MIME.
UNKNOWN

El valor recibido no se conoce en esta versión.

Este es un valor de solo respuesta.

IMAGE_JPEG Tipo de MIME de image/jpeg.
IMAGE_GIF Tipo de MIME de la imagen o el GIF.
IMAGE_PNG Tipo de MIME de image/png.
FLASH Tipo de MIME de application/x-shockwave-flash.
TEXT_HTML Es el tipo de MIME de text/html.
PDF Es el tipo de MIME de application/pdf.
MSWORD Tipo de MIME de application/msword.
MSEXCEL Es el tipo de MIME de application/vnd.ms-excel.
RTF Es el tipo de MIME de application/rtf.
AUDIO_WAV Tipo de MIME de audio/wav.
AUDIO_MP3 Tipo de MIME de audio/mp3.
HTML5_AD_ZIP Tipo de MIME de application/x-html5-ad-zip.

ImageDimension

Son los metadatos de una imagen con un tamaño determinado, ya sea original o redimensionada.

Representación JSON
{
  "heightPixels": string,
  "widthPixels": string,
  "url": string
}
Campos
heightPixels

string (int64 format)

Altura de la imagen.

widthPixels

string (int64 format)

Ancho de la imagen

url

string

Es una URL que devuelve la imagen con esta altura y ancho.

TextAsset

Es un recurso de texto.

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

string

Es el contenido de texto del recurso de texto.

UnifiedCalloutAsset

Es un recurso de texto destacado unificado.

Representación JSON
{
  "calloutText": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "useSearcherTimeZone": boolean
}
Campos
calloutText

string

Es el texto destacado. La longitud de esta cadena debe ser entre 1 y 25, inclusive.

startDate

string

Fecha de inicio en la que este recurso es efectivo y puede comenzar a publicarse, en formato aaaa-MM-dd.

endDate

string

Es la última fecha en la que este recurso es efectivo y aún se publica, en formato aaaa-MM-dd.

adScheduleTargets[]

object (AdScheduleInfo)

Es una lista de programas no superpuestos que especifican todos los intervalos de tiempo durante los que se puede publicar el activo. Puede haber un máximo de 6 programaciones por día y 42 en total.

useSearcherTimeZone

boolean

Indica si se debe mostrar el recurso en la zona horaria del usuario de la búsqueda. Se aplica a Microsoft Ads.

AdScheduleInfo

Representa un criterio de AdSchedule.

AdSchedule se especifica como el día de la semana y un intervalo de tiempo dentro del cual se mostrarán los anuncios.

No se pueden agregar más de seis AdSchedules para el mismo día.

Representación JSON
{
  "startMinute": enum (MinuteOfHour),
  "endMinute": enum (MinuteOfHour),
  "dayOfWeek": enum (DayOfWeek),
  "startHour": integer,
  "endHour": integer
}
Campos
startMinute

enum (MinuteOfHour)

Minutos después de la hora de inicio en la que comienza esta programación.

Este campo es obligatorio para las operaciones de creación y está prohibido en las operaciones de actualización.

endMinute

enum (MinuteOfHour)

Minutos después de la hora de finalización en la que termina este programa. La programación no incluye el minuto final.

Este campo es obligatorio para las operaciones de creación y está prohibido en las operaciones de actualización.

dayOfWeek

enum (DayOfWeek)

Día de la semana al que se aplica el programa.

Este campo es obligatorio para las operaciones de creación y está prohibido en las operaciones de actualización.

startHour

integer

Hora de inicio en formato de 24 horas. Este campo debe estar entre 0 y 23, inclusive.

Este campo es obligatorio para las operaciones de creación y está prohibido en las operaciones de actualización.

endHour

integer

Hora de finalización en formato de 24 horas. El número 24 significa el final del día. Este campo debe estar comprendido entre 0 y 24, ambos incluidos.

Este campo es obligatorio para las operaciones de creación y está prohibido en las operaciones de actualización.

MinuteOfHour

Enumera los cuartos de hora. Por ejemplo, "QUINCE".

Enums
UNSPECIFIED No se especifica.
UNKNOWN El valor es desconocido en esta versión.
ZERO Cero minutos después de la hora.
FIFTEEN Quince minutos después de la hora.
THIRTY Treinta minutos después de la hora.
FORTY_FIVE Cuarenta y cinco minutos después de la hora.

DayOfWeek

Enumera los días de la semana, por ejemplo, “lunes”.

Enums
UNSPECIFIED No se especifica.
UNKNOWN El valor es desconocido en esta versión.
MONDAY Lunes
TUESDAY Martes
WEDNESDAY miércoles
THURSDAY Jueves
FRIDAY Viernes.
SATURDAY Sábado
SUNDAY Domingo

UnifiedSitelinkAsset

Es un recurso de vínculo a sitio unificado.

Representación JSON
{
  "linkText": string,
  "description1": string,
  "description2": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "trackingId": string,
  "useSearcherTimeZone": boolean,
  "mobilePreferred": boolean
}
Campos
description1

string

Primera línea de la descripción del vínculo a sitio. Si se establece, la longitud debe estar entre 1 y 35, inclusive, y también se debe establecer description2.

description2

string

Es la segunda línea de la descripción del vínculo a sitio. Si se establece, la longitud debe estar entre 1 y 35, inclusive, y también se debe establecer description1.

startDate

string

Fecha de inicio en la que este recurso es efectivo y puede comenzar a publicarse, en formato aaaa-MM-dd.

endDate

string

Es la última fecha en la que este recurso es efectivo y aún se publica, en formato aaaa-MM-dd.

adScheduleTargets[]

object (AdScheduleInfo)

Es una lista de programas no superpuestos que especifican todos los intervalos de tiempo durante los que se puede publicar el activo. Puede haber un máximo de 6 programaciones por día y 42 en total.

trackingId

string (int64 format)

Es el ID que se usa para hacer un seguimiento de los clics en el recurso de vínculo a sitio. Esto es Yahoo! Es un campo exclusivo para Japón.

useSearcherTimeZone

boolean

Indica si se debe mostrar el recurso de vínculo a sitio en la zona horaria del usuario de la búsqueda. Se aplica a Microsoft Ads.

mobilePreferred

boolean

Indica si la preferencia es que el recurso de vínculo a sitio se muestre en dispositivos móviles. Se aplica a Microsoft Ads.

UnifiedPageFeedAsset

Es un recurso de feed de páginas unificado.

Representación JSON
{
  "pageUrl": string,
  "labels": [
    string
  ]
}
Campos
pageUrl

string

Es la página web a la que los anunciantes desean segmentar sus anuncios.

labels[]

string

Son las etiquetas que se usan para agrupar las URLs de la página.

MobileAppAsset

Es un recurso que representa una aplicación para dispositivos móviles.

Representación JSON
{
  "appId": string,
  "appStore": enum (MobileAppVendor)
}
Campos
appId

string

Obligatorio. Es una cadena que identifica de forma única una aplicación para dispositivos móviles. Solo debe contener el ID nativo de la plataforma, como "com.android.ebay" para Android o "12345689" para iOS.

appStore

enum (MobileAppVendor)

Obligatorio. Es la tienda de aplicaciones que distribuye esta app específica.

MobileAppVendor

Tipo de proveedor de la app para dispositivos móviles

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
APPLE_APP_STORE Es el proveedor de la app para dispositivos móviles de la App Store de Apple.
GOOGLE_APP_STORE Es el proveedor de la app para dispositivos móviles de la tienda de aplicaciones de Google.

UnifiedCallAsset

Es un recurso de llamada unificado.

Representación JSON
{
  "countryCode": string,
  "phoneNumber": string,
  "callConversionReportingState": enum (CallConversionReportingState),
  "callConversionAction": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "callOnly": boolean,
  "callTrackingEnabled": boolean,
  "useSearcherTimeZone": boolean,
  "startDate": string,
  "endDate": string
}
Campos
countryCode

string

Código de país de dos letras del número de teléfono. Ejemplos: “US”, “us”.

phoneNumber

string

Es el número de teléfono sin procesar del anunciante. Ejemplos: "1234567890", "(123)456-7890"

callConversionReportingState

enum (CallConversionReportingState)

Indica si este CallAsset debe usar su propia configuración de conversiones de llamada, seguir la configuración a nivel de la cuenta o inhabilitar las conversiones de llamada.

callConversionAction

string

Es la acción de conversión a la que se atribuirá una conversión de llamada. Si no se establece, se usa la acción de conversión predeterminada. Este campo solo tiene efecto si callConversionReportingState se establece en USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION.

adScheduleTargets[]

object (AdScheduleInfo)

Es una lista de programas no superpuestos que especifican todos los intervalos de tiempo durante los que se puede publicar el activo. Puede haber un máximo de 6 programaciones por día y 42 en total.

callOnly

boolean

Indica si la llamada solo muestra el número de teléfono sin un vínculo al sitio web. Se aplica a Microsoft Ads.

callTrackingEnabled

boolean

Indica si la llamada debe habilitarse en el seguimiento de llamadas. Se aplica a Microsoft Ads.

useSearcherTimeZone

boolean

Indica si se debe mostrar la extensión de llamada en la zona horaria del usuario de la búsqueda. Se aplica a Microsoft Ads.

startDate

string

Fecha de inicio en la que este recurso es efectivo y puede comenzar a publicarse, en formato aaaa-MM-dd.

endDate

string

Es la última fecha en la que este recurso es efectivo y aún se publica, en formato aaaa-MM-dd.

CallConversionReportingState

Son los tipos de datos posibles para el estado de una acción de conversión de llamada.

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
DISABLED La acción de conversión de llamada está inhabilitada.
USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION La acción de conversión de llamada utilizará el tipo de conversión de llamada establecido a nivel de la cuenta.
USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION La acción de conversión de llamada utilizará el tipo de conversión de llamada establecido a nivel del recurso (anuncios solo de llamada o extensiones de llamada).

CallToActionAsset

Es un recurso de llamado a la acción.

Representación JSON
{
  "callToAction": enum (CallToActionType)
}
Campos
callToAction

enum (CallToActionType)

Llamado a la acción.

CallToActionType

Es una enumeración que describe los posibles tipos de llamados a la acción.

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
LEARN_MORE El tipo de llamado a la acción es Más información.
GET_QUOTE El tipo de llamado a la acción es obtener una cotización.
APPLY_NOW El tipo de llamado a la acción es postularse ahora.
SIGN_UP El tipo de llamado a la acción es registrarse.
CONTACT_US El tipo de llamado a la acción es "Contáctanos".
SUBSCRIBE El tipo de llamado a la acción es suscribirse.
DOWNLOAD El tipo de llamado a la acción es de descarga.
BOOK_NOW El tipo de llamado a la acción es reservar ahora.
SHOP_NOW El tipo de llamado a la acción es comprar ahora.
BUY_NOW El tipo de llamado a la acción es comprar ahora.
DONATE_NOW El tipo de llamado a la acción es Donar ahora.
ORDER_NOW El tipo de llamado a la acción es "Pedir ahora".
PLAY_NOW El tipo de llamado a la acción es Jugar ahora.
SEE_MORE El tipo de llamado a la acción es Ver más.
START_NOW El tipo de llamado a la acción es comenzar ahora.
VISIT_SITE El tipo de llamado a la acción es visitar el sitio.
WATCH_NOW El tipo de llamado a la acción es mirar ahora.

UnifiedLocationAsset

Es un recurso de ubicación unificado.

Representación JSON
{
  "placeId": string,
  "businessProfileLocations": [
    {
      object (BusinessProfileLocation)
    }
  ],
  "locationOwnershipType": enum (LocationOwnershipType)
}
Campos
placeId

string

Los IDs de lugar identifican de forma exclusiva un sitio en la base de datos de Google Places y en Google Maps. Este campo es único para un ID de cliente y un tipo de activo determinados. Consulta https://developers.google.com/places/web-service/place-id para obtener más información sobre el ID de lugar.

businessProfileLocations[]

object (BusinessProfileLocation)

Es la lista de ubicaciones de la empresa para el cliente. Este valor solo se devolverá si el recurso de ubicación se sincroniza desde la cuenta del Perfil de Negocio. Es posible tener varias fichas del Perfil de Negocio en la misma cuenta que apuntan al mismo ID de lugar.

locationOwnershipType

enum (LocationOwnershipType)

Es el tipo de propiedad de la ubicación. Si el tipo es BUSINESS_OWNER, se publicará como una extensión de ubicación. Si el tipo es AFFILIATE, se publicará como ubicación afiliada.

BusinessProfileLocation

Son los datos de ubicación del Perfil de Negocio sincronizados desde la cuenta del Perfil de Negocio vinculada.

Representación JSON
{
  "labels": [
    string
  ],
  "storeCode": string,
  "listingId": string
}
Campos
labels[]

string

Es la etiqueta especificada por el anunciante para la ubicación en la cuenta del Perfil de Negocio. Esta información se sincroniza desde la cuenta del Perfil de Negocio.

storeCode

string

Es el código de tienda del Perfil de Negocio de esta ubicación. Esta información se sincroniza desde la cuenta del Perfil de Negocio.

listingId

string (int64 format)

Es el ID de la ficha de esta ubicación del Perfil de Negocio. Esta información se sincroniza desde la cuenta del Perfil de Negocio vinculado.

LocationOwnershipType

Son los tipos posibles de propiedad de una ubicación.

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
BUSINESS_OWNER Es el propietario de la empresa de la ubicación(extensión de ubicación heredada, LE).
AFFILIATE Ubicación afiliada(extensión de ubicación de terceros, ALE).

AssetGroupAsset

AssetGroupAsset es la vinculación entre un recurso y un grupo de recursos. Agregar un AssetGroupAsset vincula un recurso con un grupo de recursos.

Representación JSON
{
  "resourceName": string,
  "assetGroup": string,
  "asset": string,
  "fieldType": enum (AssetFieldType),
  "status": enum (AssetLinkStatus)
}
Campos
resourceName

string

Es el nombre del recurso del recurso del grupo de recursos. El nombre del recurso del recurso del grupo de recursos tiene el siguiente formato:

customers/{customerId}/assetGroupAssets/{asset_group_id}~{assetId}~{fieldType}

assetGroup

string

Es el grupo de recursos al que se vincula este recurso del grupo de recursos.

asset

string

Es el recurso al que se vincula este recurso del grupo de recursos.

fieldType

enum (AssetFieldType)

Es la descripción de la posición del recurso dentro del grupo de recursos. Por ejemplo: HEADLINE, YOUTUBE_VIDEO, etcétera

status

enum (AssetLinkStatus)

Es el estado de la vinculación entre un recurso y un grupo de recursos.

AssetFieldType

Es una enumeración que describe las posibles posiciones de un recurso.

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
HEADLINE El recurso está vinculado para usarse como título.
DESCRIPTION El recurso está vinculado para usarse como descripción.
MANDATORY_AD_TEXT El recurso está vinculado para usarse como texto del anuncio obligatorio.
MARKETING_IMAGE El recurso está vinculado para usarse como imagen de marketing.
MEDIA_BUNDLE El recurso está vinculado para usarse como paquete de medios.
YOUTUBE_VIDEO El activo está vinculado para usarse como video de YouTube.
BOOK_ON_GOOGLE El recurso está vinculado para indicar que una campaña de hoteles está habilitada para "Reservar en Google".
LEAD_FORM El recurso está vinculado para usarse como extensión de formulario de clientes potenciales.
PROMOTION El recurso está vinculado para usarse como extensión de promoción.
CALLOUT El recurso está vinculado para usarse como extensión de texto destacado.
STRUCTURED_SNIPPET El recurso está vinculado para usarse como extensión de fragmento estructurado.
MOBILE_APP El recurso está vinculado para usarse como extensión de aplicación para dispositivos móviles.
HOTEL_CALLOUT El recurso está vinculado para usarse como extensión de texto destacado de hoteles.
CALL El recurso está vinculado para usarse como extensión de llamada.
PRICE El recurso está vinculado para usarse como extensión de precio.
LONG_HEADLINE El recurso está vinculado para usarse como un título largo.
BUSINESS_NAME El recurso está vinculado para usarse como nombre de la empresa.
SQUARE_MARKETING_IMAGE El recurso está vinculado para usarse como imagen de marketing cuadrada.
PORTRAIT_MARKETING_IMAGE El recurso está vinculado para usarse como imagen de marketing vertical.
VIDEO El activo está vinculado para usarse como un logotipo que no es de YouTube.
CALL_TO_ACTION_SELECTION El recurso está vinculado para que se pueda seleccionar un llamado a la acción.
AD_IMAGE El recurso está vinculado para seleccionar una imagen del anuncio.
HOTEL_PROPERTY El recurso está vinculado para usarse como propiedad de hotel en una campaña de máximo rendimiento para objetivos de viaje.
LONG_DESCRIPTION El recurso está vinculado para usarse como descripción larga.
CALL_TO_ACTION El recurso está vinculado para usarse como llamado a la acción.

AssetGroupSignal

AssetGroupSignal representa un indicador en un grupo de recursos. La existencia de un indicador le indica a la campaña de máximo rendimiento quiénes son los usuarios que tienen más probabilidades de generar una conversión. Las campañas de máximo rendimiento utilizan el indicador para encontrar usuarios nuevos con una intención similar o superior y así conseguir conversiones en las redes de Búsqueda, Display, video y mucho más.

Representación JSON
{
  "resourceName": string,
  "assetGroup": string,

  // Union field signal can be only one of the following:
  "audience": {
    object (AudienceInfo)
  }
  // End of list of possible types for union field signal.
}
Campos
resourceName

string

Es el nombre del recurso del indicador del grupo de recursos. El nombre del recurso del indicador del grupo de recursos tiene el siguiente formato:

customers/{customerId}/assetGroupSignals/{asset_group_id}~{signal_id}

assetGroup

string

Es el grupo de recursos al que pertenece este indicador del grupo de recursos.

Campo de unión signal. Es el indicador del grupo de recursos. signal puede ser solo uno de los parámetros siguientes:
audience

object (AudienceInfo)

Es el indicador de público que utilizará la campaña de máximo rendimiento.

AudienceInfo

Es un criterio de público.

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

string

Es el nombre del recurso Audience.

AssetGroupListingGroupFilter

AssetGroupListingGroupFilter representa un nodo de árbol de filtro de grupo de fichas en un grupo de recursos.

Representación JSON
{
  "resourceName": string,
  "assetGroup": string,
  "id": string,
  "type": enum (ListingGroupFilterType),
  "vertical": enum (ListingGroupFilterVertical),
  "caseValue": {
    object (ListingGroupFilterDimension)
  },
  "parentListingGroupFilter": string,
  "path": {
    object (ListingGroupFilterDimensionPath)
  }
}
Campos
resourceName

string

Es el nombre del recurso del filtro del grupo de fichas del grupo de recursos. El nombre del recurso del filtro de grupo de fichas y elementos del grupo de recursos tiene el siguiente formato:

customers/{customerId}/assetGroupListingGroupFilters/{asset_group_id}~{listing_group_filter_id}

assetGroup

string

Es el grupo de recursos del que forma parte este filtro de grupo de fichas y elementos del grupo de recursos.

id

string (int64 format)

Es el ID de ListingGroupFilter.

type

enum (ListingGroupFilterType)

Es el tipo de un nodo de filtro de grupo de fichas.

vertical

enum (ListingGroupFilterVertical)

Vertical que representa el árbol de nodos actual. Todos los nodos del mismo árbol deben pertenecer a la misma vertical.

caseValue

object (ListingGroupFilterDimension)

Es el valor de la dimensión con el que este grupo de fichas segmenta su grupo superior. No se define para el grupo raíz.

parentListingGroupFilter

string

Es el nombre del recurso de la subdivisión del grupo de fichas principal. Es nulo para el nodo del filtro del grupo de fichas raíz.

path

object (ListingGroupFilterDimensionPath)

Es la ruta de acceso de las dimensiones que definen este filtro del grupo de fichas.

ListingGroupFilterType

Es el tipo de filtro del grupo de fichas.

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
SUBDIVISION Subdivisión de productos según algunas dimensiones de la ficha.
UNIT_INCLUDED Es un nodo hoja del filtro del grupo de fichas incluido.
UNIT_EXCLUDED Es un nodo hoja del filtro de grupo de fichas excluido.

ListingGroupFilterVertical

Es el tipo de vertical del filtro del grupo de fichas.

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
SHOPPING Representa la vertical de compras. La vertical solo se permite en las campañas de máximo rendimiento de venta minorista.

ListingGroupFilterDimension

Son las dimensiones de la ficha para el filtro de grupo de fichas del grupo de recursos.

Representación JSON
{

  // Union field dimension can be only one of the following:
  "productBiddingCategory": {
    object (ProductBiddingCategory)
  },
  "productBrand": {
    object (ProductBrand)
  },
  "productChannel": {
    object (ProductChannel)
  },
  "productCondition": {
    object (ProductCondition)
  },
  "productCustomAttribute": {
    object (ProductCustomAttribute)
  },
  "productItemId": {
    object (ProductItemId)
  },
  "productType": {
    object (ProductType)
  }
  // End of list of possible types for union field dimension.
}
Campos
Campo de unión dimension. Siempre está presente la dimensión de uno de los siguientes tipos. dimension puede ser solo uno de los parámetros siguientes:
productBiddingCategory

object (ProductBiddingCategory)

Es la categoría de oferta de un producto.

productBrand

object (ProductBrand)

Es la marca de una oferta de producto.

productChannel

object (ProductChannel)

Es la localidad de una oferta de producto.

productCondition

object (ProductCondition)

Es el estado de una oferta de producto.

productCustomAttribute

object (ProductCustomAttribute)

Es el atributo personalizado de una oferta de producto.

productItemId

object (ProductItemId)

Es el ID de artículo de una oferta de producto.

productType

object (ProductType)

Es el tipo de oferta de un producto.

ProductBiddingCategory

Es un elemento de una categoría de oferta en un nivel determinado. Las categorías de nivel superior se encuentran en el nivel 1, sus secundarias en el nivel 2, y así sucesivamente. Actualmente, admitimos hasta 5 niveles. El usuario debe especificar un tipo de dimensión que indique el nivel de la categoría. Todos los casos de la misma subdivisión deben tener el mismo tipo de dimensión (nivel de categoría).

Representación JSON
{
  "level": enum (ListingGroupFilterBiddingCategoryLevel),
  "id": string
}
Campos
level

enum (ListingGroupFilterBiddingCategoryLevel)

Indica el nivel de la categoría en la taxonomía.

id

string (int64 format)

Es el ID de la categoría de ofertas del producto.

Este ID es equivalente al ID de google_product_category, como se describe en este artículo: https://support.google.com/merchants/answer/6324436

ListingGroupFilterBiddingCategoryLevel

Es el nivel de la categoría de oferta del filtro del grupo de fichas.

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
LEVEL1 Nivel 1.
LEVEL2 Nivel 2.
LEVEL3 Nivel 3.
LEVEL4 Nivel 4.
LEVEL5 Nivel 5

ProductBrand

Es la marca del producto.

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

string

Es el valor de cadena de la marca del producto.

ProductChannel

Es la localidad de una oferta de producto.

Representación JSON
{
  "channel": enum (ListingGroupFilterProductChannel)
}
Campos
channel

enum (ListingGroupFilterProductChannel)

Es el valor de la localidad.

ListingGroupFilterProductChannel

Es una enumeración que describe la localidad de una oferta de producto.

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
ONLINE El artículo se vende en línea.
LOCAL El artículo se vende en tiendas locales.

ProductCondition

Es el estado de una oferta de producto.

Representación JSON
{
  "condition": enum (ListingGroupFilterProductCondition)
}
Campos
condition

enum (ListingGroupFilterProductCondition)

Es el valor de la condición.

ListingGroupFilterProductCondition

Es una enumeración que describe la condición de una oferta de producto.

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
NEW El estado del producto es nuevo.
REFURBISHED El estado del producto es reacondicionado.
USED El estado del producto es usado.

ProductCustomAttribute

Es el atributo personalizado de una oferta de producto.

Representación JSON
{
  "index": enum (ListingGroupFilterCustomAttributeIndex),
  "value": string
}
Campos
index

enum (ListingGroupFilterCustomAttributeIndex)

Indica el índice del atributo personalizado.

value

string

Es el valor de cadena del atributo personalizado del producto.

ListingGroupFilterCustomAttributeIndex

Es el índice de los atributos del cliente.

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
INDEX0 Es el primer atributo personalizado del filtro de grupo de fichas.
INDEX1 Es el segundo atributo personalizado del filtro de grupo de fichas.
INDEX2 Es el tercer atributo personalizado del filtro de grupo de fichas.
INDEX3 Es el cuarto atributo personalizado del filtro de grupo de fichas.
INDEX4 Es el quinto atributo personalizado del filtro de grupo de fichas.

ProductItemId

Es el ID de artículo de una oferta de producto.

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

string

Es el valor del ID.

ProductType

Es el tipo de oferta de un producto.

Representación JSON
{
  "level": enum (ListingGroupFilterProductTypeLevel),
  "value": string
}
Campos
level

enum (ListingGroupFilterProductTypeLevel)

Es el nivel del tipo.

value

string

Es el valor del tipo.

ListingGroupFilterProductTypeLevel

Es una enumeración que describe el nivel del tipo de oferta de producto.

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
LEVEL1 Nivel 1.
LEVEL2 Nivel 2.
LEVEL3 Nivel 3.
LEVEL4 Nivel 4.
LEVEL5 Nivel 5

ListingGroupFilterDimensionPath

Es la ruta que define las dimensiones que definen un filtro de grupo de fichas.

Representación JSON
{
  "dimensions": [
    {
      object (ListingGroupFilterDimension)
    }
  ]
}
Campos
dimensions[]

object (ListingGroupFilterDimension)

Es la ruta de acceso completa de las dimensiones a través de la jerarquía de filtros del grupo de fichas (sin incluir el nodo raíz) hasta este filtro del grupo de fichas.

AssetGroupTopCombinationView

Es una vista del uso de las principales combinaciones de recursos del grupo de recursos.

Representación JSON
{
  "resourceName": string,
  "assetGroupTopCombinations": [
    {
      object (AssetGroupAssetCombinationData)
    }
  ]
}
Campos
resourceName

string

Es el nombre del recurso de la vista de la combinación principal del grupo de recursos. Los nombres de los recursos de la vista de combinaciones principales del grupo de recursos tienen el siguiente formato: "customers/{customerId}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}".

assetGroupTopCombinations[]

object (AssetGroupAssetCombinationData)

Son las principales combinaciones de recursos que se publicaron juntas.

AssetGroupAssetCombinationData

Datos de combinación de recursos del grupo de recursos

Representación JSON
{
  "assetCombinationServedAssets": [
    {
      object (AssetUsage)
    }
  ]
}
Campos
assetCombinationServedAssets[]

object (AssetUsage)

Son los recursos que se publicaron.

AssetUsage

Contiene la información de uso del activo.

Representación JSON
{
  "asset": string,
  "servedAssetFieldType": enum (ServedAssetFieldType)
}
Campos
asset

string

Es el nombre del recurso del activo.

servedAssetFieldType

enum (ServedAssetFieldType)

Es el tipo de campo publicado del recurso.

ServedAssetFieldType

Son los tipos de campos de recursos posibles.

Enums
UNSPECIFIED No se especificó ningún valor.
UNKNOWN

El valor recibido no se conoce en esta versión.

Este es un valor de solo respuesta.

HEADLINE_1 El recurso se usa en el título 1.
HEADLINE_2 El recurso se usa en el título 2.
HEADLINE_3 El recurso se usa en el título 3.
DESCRIPTION_1 El recurso se usa en la descripción 1.
DESCRIPTION_2 El activo se usa en la descripción 2.
HEADLINE El recurso se usó en un título. Úsalo solo si hay un solo título en el anuncio. De lo contrario, usa las enumeraciones HEADLINE_1, HEADLINE_2 o HEADLINE_3.
HEADLINE_IN_PORTRAIT El recurso se usó como título en la imagen vertical.
LONG_HEADLINE El recurso se usó en un título largo (se usa en MultiAssetResponsiveAd).
DESCRIPTION El activo se usó en una descripción. Úsalo solo si hay una sola descripción en el anuncio. De lo contrario, usa las enumeraciones DESCRIPTION_1 o DESCRIPTION_@.
DESCRIPTION_IN_PORTRAIT El recurso se usó como descripción en la imagen vertical.
BUSINESS_NAME_IN_PORTRAIT El recurso se usó como nombre de la empresa en la imagen vertical.
BUSINESS_NAME El activo se usó como nombre de la empresa.
MARKETING_IMAGE El recurso se usó como imagen de marketing.
MARKETING_IMAGE_IN_PORTRAIT El recurso se usó como imagen de marketing en una imagen vertical.
SQUARE_MARKETING_IMAGE El recurso se usó como imagen de marketing cuadrada.
PORTRAIT_MARKETING_IMAGE El recurso se usó como imagen de marketing vertical.
CALL_TO_ACTION El recurso se usó como llamado a la acción.
YOU_TUBE_VIDEO El activo se usó como un video de YouTube.
CALL Este recurso se usa como una llamada.
MOBILE_APP Este recurso se usa como una app para dispositivos móviles.
CALLOUT Este recurso se usa como texto destacado.
STRUCTURED_SNIPPET Este recurso se usa como fragmento estructurado.
PRICE Este activo se usa como precio.
PROMOTION Este recurso se usa como promoción.
AD_IMAGE Este recurso se usa como imagen.
LEAD_FORM El recurso se usa como formulario de clientes potenciales.
DESCRIPTION_PREFIX El activo se usa como prefijo de la descripción.

AssetGroup

Es un grupo de recursos. AssetGroupAsset se usa para vincular un recurso al grupo de recursos. AssetGroupSignal se usa para asociar un indicador a un grupo de recursos.

Representación JSON
{
  "resourceName": string,
  "id": string,
  "campaign": string,
  "name": string,
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "status": enum (AssetGroupStatus),
  "path1": string,
  "path2": string,
  "adStrength": enum (AdStrength)
}
Campos
resourceName

string

Es el nombre del recurso del grupo de recursos. Los nombres de los recursos de los grupos de recursos tienen el siguiente formato:

customers/{customerId}/assetGroups/{asset_group_id}

id

string (int64 format)

Es el ID del grupo de recursos.

campaign

string

Es la campaña con la que está asociado este grupo de recursos. Es el recurso que está vinculado al grupo de recursos.

name

string

Obligatorio. Es el nombre del grupo de recursos. Obligatorio. Debe tener una longitud mínima de 1 y una longitud máxima de 128. Debe ser único en una campaña.

finalUrls[]

string

Es una lista de URLs finales después de todos los redireccionamientos entre dominios. En las campañas de máximo rendimiento, de forma predeterminada, las URLs son aptas para la expansión, a menos que se inhabilite la opción.

finalMobileUrls[]

string

Es una lista de URLs finales para dispositivos móviles después de todos los redireccionamientos entre dominios. En las campañas de máximo rendimiento, de forma predeterminada, las URLs son aptas para la expansión, a menos que se inhabilite la opción.

status

enum (AssetGroupStatus)

Es el estado del grupo de recursos.

path1

string

Es la primera parte del texto que puede aparecer anexada a la URL que se muestra en el anuncio.

path2

string

Es la segunda parte del texto que puede aparecer anexada a la URL que se muestra en el anuncio. Este campo solo se puede configurar cuando se establece path1.

adStrength

enum (AdStrength)

Calidad general del anuncio de este grupo de recursos.

AssetGroupStatus

Son los estados posibles de un grupo de recursos.

Enums
UNSPECIFIED No se especificó el estado.
UNKNOWN El valor recibido no se conoce en esta versión.
ENABLED El grupo de recursos está habilitado.
PAUSED El grupo de recursos está detenido.
REMOVED Se quita el grupo de recursos.

AdStrength

Es un enum que enumera las posibles calidades del anuncio.

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
PENDING Actualmente, la calidad del anuncio está pendiente.
NO_ADS No se pudo generar ningún anuncio.
POOR Mala resistencia
AVERAGE Fuerza promedio.
GOOD Buena resistencia.
EXCELLENT Excelente resistencia

AssetSetAsset

AssetSetAsset es la vinculación entre un recurso y un conjunto de recursos. Agregar un AssetSetAsset vincula un recurso con un conjunto de recursos.

Representación JSON
{
  "resourceName": string,
  "assetSet": string,
  "asset": string,
  "status": enum (AssetSetAssetStatus)
}
Campos
resourceName

string

Es el nombre del recurso del recurso del conjunto de recursos. Los nombres de recursos de los recursos del conjunto de recursos tienen el siguiente formato:

customers/{customerId}/assetSetAssets/{asset_set_id}~{assetId}

assetSet

string

El conjunto de recursos al que está vinculado este recurso del conjunto de recursos.

asset

string

El recurso al que está vinculado este recurso del conjunto de recursos.

status

enum (AssetSetAssetStatus)

Es el estado del recurso del conjunto de recursos. Solo lectura.

AssetSetAssetStatus

Son los posibles estados de un recurso del conjunto de recursos.

Enums
UNSPECIFIED No se especificó el estado.
UNKNOWN El valor recibido no se conoce en esta versión. Este es un valor de solo respuesta.
ENABLED El recurso del conjunto de recursos está habilitado.
REMOVED Se quita la vinculación del recurso del conjunto de recursos.

AssetSet

Es un conjunto de recursos que representa una colección de recursos. Usa AssetSetAsset para vincular un recurso al conjunto de recursos.

Representación JSON
{
  "id": string,
  "resourceName": string
}
Campos
id

string (int64 format)

Es el ID del conjunto de recursos.

resourceName

string

Es el nombre del recurso del conjunto de recursos. Los nombres de los recursos de los conjuntos de recursos tienen el siguiente formato:

customers/{customerId}/assetSets/{asset_set_id}

BiddingStrategy

Es una estrategia de ofertas.

Representación JSON
{
  "resourceName": string,
  "status": enum (BiddingStrategyStatus),
  "type": enum (BiddingStrategyType),
  "currencyCode": string,
  "id": string,
  "name": string,
  "effectiveCurrencyCode": string,
  "campaignCount": string,
  "nonRemovedCampaignCount": string,

  // Union field scheme can be only one of the following:
  "enhancedCpc": {
    object (EnhancedCpc)
  },
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetOutrankShare": {
    object (TargetOutrankShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  }
  // End of list of possible types for union field scheme.
}
Campos
resourceName

string

Es el nombre del recurso de la estrategia de ofertas. Los nombres de los recursos de la estrategia de ofertas tienen el siguiente formato:

customers/{customerId}/biddingStrategies/{biddingStrategyId}

status

enum (BiddingStrategyStatus)

El estado de la estrategia de ofertas.

Este campo es de solo lectura.

type

enum (BiddingStrategyType)

Es el tipo de estrategia de ofertas. Crea una estrategia de ofertas estableciendo el esquema de ofertas.

Este campo es de solo lectura.

currencyCode

string

Es la moneda que usa la estrategia de ofertas (código de tres letras ISO 4217).

En el caso de las estrategias de ofertas en las cuentas de cliente de administrador, esta moneda se puede establecer durante la creación y, de forma predeterminada, se establece la moneda de la cuenta de cliente de administrador. En el caso de los clientes de publicación, este campo no se puede establecer. Todas las estrategias de un cliente de publicación utilizan implícitamente la moneda del cliente de publicación. En todos los casos, el campo effectiveCurrencyCode devuelve la moneda que utiliza la estrategia.

id

string (int64 format)

El ID de la estrategia de ofertas.

name

string

El nombre de la estrategia de ofertas. Todas las estrategias de ofertas dentro de una cuenta deben tener un nombre distinto.

La longitud de esta cadena debe ser de entre 1 y 255, inclusive, en bytes UTF-8 (cortada).

effectiveCurrencyCode

string

Es la moneda que usa la estrategia de ofertas (código de tres letras ISO 4217).

En el caso de las estrategias de ofertas de las cuentas de administrador de clientes, esta es la moneda que establece el anunciante cuando crea la estrategia. Para la atención al cliente, este es el currencyCode del cliente.

Las métricas de la estrategia de ofertas se registran en esta moneda.

Este campo es de solo lectura.

campaignCount

string (int64 format)

Es la cantidad de campañas asociadas a esta estrategia de ofertas.

Este campo es de solo lectura.

nonRemovedCampaignCount

string (int64 format)

Es la cantidad de campañas no quitadas asociadas a esta estrategia de ofertas.

Este campo es de solo lectura.

Campo de unión scheme. Es el esquema de ofertas.

Solo se puede establecer uno. scheme puede ser una de las siguientes opciones:

enhancedCpc

object (EnhancedCpc)

Es una estrategia de ofertas que aumenta las ofertas para los clics que parecen tener más probabilidades de generar una conversión y las disminuye para los clics que parecen tener menos probabilidades de hacerlo.

maximizeConversionValue

object (MaximizeConversionValue)

Es una estrategia de ofertas automáticas que te ayuda a obtener el mayor valor de conversión posible para tus campañas sin exceder tu presupuesto.

maximizeConversions

object (MaximizeConversions)

Es una estrategia de ofertas automáticas que te ayuda a obtener la mayor cantidad posible de conversiones para tus campañas sin exceder tu presupuesto.

targetCpa

object (TargetCpa)

Es una estrategia de ofertas que establece ofertas para ayudarte a obtener la mayor cantidad posible de conversiones con el costo por adquisición (CPA) objetivo que estableciste.

targetImpressionShare

object (TargetImpressionShare)

Es una estrategia de ofertas que se optimiza automáticamente en función de un porcentaje elegido de impresiones.

targetOutrankShare

object (TargetOutrankShare)

Es una estrategia de ofertas que establece ofertas según la fracción objetivo de las subastas en las que el anunciante debería superar a un competidor específico. Este campo ya no está disponible. Si se crea una estrategia de ofertas nueva con este campo o se adjuntan estrategias de ofertas con este campo a una campaña, se producirá un error. Se permiten las mutaciones a estrategias que ya tienen este esquema completado.

targetRoas

object (TargetRoas)

Es una estrategia de ofertas que te ayuda a maximizar los ingresos y, al mismo tiempo, aumentar el promedio de un retorno de la inversión publicitaria objetivo (ROAS) específico.

targetSpend

object (TargetSpend)

Es una estrategia de ofertas que establece tus ofertas para ayudarte a obtener la mayor cantidad posible de clics sin exceder tu presupuesto.

BiddingStrategyStatus

Son los estados posibles de un objeto BiddingStrategy.

Enums
UNSPECIFIED No se especificó ningún valor.
UNKNOWN

El valor recibido no se conoce en esta versión.

Este es un valor de solo respuesta.

ENABLED La estrategia de ofertas está habilitada.
REMOVED Se quitará la estrategia de ofertas.

BiddingStrategyType

Es una enumeración que describe los posibles tipos de estrategias de ofertas.

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
COMMISSION La estrategia de ofertas automáticas Comisión, en la que el anunciante paga un porcentaje determinado del valor de conversión.
ENHANCED_CPC El CPC avanzado es una estrategia de ofertas que aumenta las ofertas para los clics que parecen tener más probabilidades de generar una conversión y las disminuye para los clics que parecen tener menos probabilidades de hacerlo.
INVALID Solo se usa para el valor que se devuelve. Indica que una campaña no tiene una estrategia de ofertas. Esto impide que se publique la campaña. Por ejemplo, una campaña puede estar vinculada a una estrategia de ofertas de administrador y, posteriormente, la cuenta de publicación se desvincula de la cuenta de administrador. En este caso, la campaña se desvinculará automáticamente de la estrategia de ofertas del administrador, que ahora es inaccesible, y cambiará al tipo de estrategia de ofertas INVALID.
MANUAL_CPA Estrategia de ofertas manual que permite al anunciante establecer la oferta por acción especificada por el anunciante.
MANUAL_CPC Ofertas manuales basadas en clics en las que el usuario paga por clic.
MANUAL_CPM Es un tipo de oferta manual basada en impresiones en la que el usuario paga por cada mil impresiones.
MANUAL_CPV Es una estrategia de ofertas que paga un importe configurable por cada vista de video.
MAXIMIZE_CONVERSIONS Es una estrategia de ofertas que maximiza automáticamente la cantidad de conversiones dado un presupuesto diario.
MAXIMIZE_CONVERSION_VALUE Es una estrategia de ofertas automáticas que establece ofertas automáticamente para maximizar los ingresos sin exceder tu presupuesto.
PAGE_ONE_PROMOTED Es el esquema de ofertas de Promocionados en la primera página, que establece ofertas de CPC máx. para segmentar las impresiones en la primera página o en las posiciones promocionadas de la primera página en google.com. Este valor de enumeración está en desuso.
PERCENT_CPC El CPC porcentual es una estrategia de ofertas en la que las ofertas son una fracción del precio publicitado de algún bien o servicio.
TARGET_CPA El CPA objetivo es una estrategia de ofertas automáticas que establece ofertas para ayudarte a obtener la mayor cantidad posible de conversiones con el costo por adquisición (CPA) objetivo que estableciste.
TARGET_CPM El CPM objetivo es una estrategia de ofertas automáticas que establece ofertas para ayudarte a obtener la mayor cantidad posible de impresiones con el costo objetivo por mil impresiones (CPM) que estableciste.
TARGET_IMPRESSION_SHARE Es una estrategia de ofertas automáticas que establece ofertas para que un determinado porcentaje de los anuncios de búsqueda se muestren en la parte superior de la primera página (o en otra ubicación objetivo).
TARGET_OUTRANK_SHARE El Porcentaje de ranking superior objetivo es una estrategia de ofertas automáticas que establece ofertas según la fracción objetivo de las subastas en las que el anunciante debe superar a un competidor específico. Este valor de enumeración dejó de estar disponible.
TARGET_ROAS El ROAS objetivo es una estrategia de ofertas automática que te ayuda a maximizar los ingresos y, al mismo tiempo, obtener un promedio de un retorno de la inversión publicitaria (ROAS) objetivo específico.
TARGET_SPEND La inversión objetivo es una estrategia de ofertas automáticas que establece tus ofertas para ayudarte a obtener la mayor cantidad posible de clics sin exceder tu presupuesto.

EnhancedCpc

Este tipo no tiene campos.

Es una estrategia de ofertas automáticas que aumenta las ofertas para los clics que parecen tener más probabilidades de generar una conversión y las disminuye para los clics que parecen tener menos probabilidades.

Esta estrategia de ofertas dejó de estar disponible y ya no se puede crear. Usa ManualCpc con enhancedCpcEnabled establecido en verdadero para obtener una funcionalidad equivalente.

MaximizeConversionValue

Es una estrategia de ofertas automáticas que te ayuda a obtener el mayor valor de conversión posible para tus campañas sin exceder tu presupuesto.

Representación JSON
{
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string,
  "targetRoas": number
}
Campos
cpcBidCeilingMicros

string (int64 format)

El límite de oferta máximo que se puede establecer con la estrategia de ofertas. El límite se aplica a todas las palabras clave administradas por la estrategia. Solo se puede modificar para las estrategias de ofertas de cartera.

cpcBidFloorMicros

string (int64 format)

Es el límite de oferta mínimo que puede establecer la estrategia de ofertas. El límite se aplica a todas las palabras clave administradas por la estrategia. Solo se puede modificar para las estrategias de ofertas de cartera.

targetRoas

number

Es la opción de retorno de la inversión publicitaria (ROAS) objetivo. Si se establece, la estrategia de ofertas maximizará los ingresos y, al mismo tiempo, aumentará el promedio del retorno de la inversión publicitaria objetivo. Si el ROAS objetivo es alto, es posible que la estrategia de ofertas no pueda invertir todo el presupuesto. Si no se establece el ROAS objetivo, la estrategia de ofertas intentará alcanzar el ROAS más alto posible para el presupuesto.

MaximizeConversions

Es una estrategia de ofertas automáticas que te ayuda a obtener la mayor cantidad posible de conversiones para tus campañas sin exceder tu presupuesto.

Representación JSON
{
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string,
  "targetCpaMicros": string
}
Campos
cpcBidCeilingMicros

string (int64 format)

El límite de oferta máximo que se puede establecer con la estrategia de ofertas. El límite se aplica a todas las palabras clave administradas por la estrategia. Solo se puede modificar para las estrategias de ofertas de cartera.

cpcBidFloorMicros

string (int64 format)

Es el límite de oferta mínimo que puede establecer la estrategia de ofertas. El límite se aplica a todas las palabras clave administradas por la estrategia. Solo se puede modificar para las estrategias de ofertas de cartera.

targetCpaMicros

string (int64 format)

Es la opción de costo por acción (CPA) objetivo. Es el importe promedio que deseas invertir por acción de conversión, especificado en unidades pequeñas de la moneda de la estrategia de ofertas. Si se configura, la estrategia de ofertas obtendrá la mayor cantidad posible de conversiones con el costo por acción objetivo o uno inferior. Si no se establece el CPA objetivo, la estrategia de ofertas intentará alcanzar el CPA más bajo posible dado el presupuesto.

TargetCpa

Es una estrategia de ofertas automáticas que establece ofertas para ayudarte a obtener la mayor cantidad posible de conversiones con el costo por adquisición (CPA) objetivo que estableciste.

Representación JSON
{
  "targetCpaMicros": string,
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string
}
Campos
targetCpaMicros

string (int64 format)

Objetivo de CPA promedio. Este objetivo debe ser mayor o igual que la unidad facturable mínima según la moneda de la cuenta.

cpcBidCeilingMicros

string (int64 format)

El límite de oferta máximo que se puede establecer con la estrategia de ofertas. El límite se aplica a todas las palabras clave administradas por la estrategia. Esto solo se debe establecer para las estrategias de ofertas de cartera.

cpcBidFloorMicros

string (int64 format)

Es el límite de oferta mínimo que puede establecer la estrategia de ofertas. El límite se aplica a todas las palabras clave administradas por la estrategia. Esto solo se debe establecer para las estrategias de ofertas de cartera.

TargetImpressionShare

Es una estrategia de ofertas automáticas que establece ofertas para que un determinado porcentaje de los anuncios de búsqueda se muestren en la parte superior de la primera página (o en otra ubicación objetivo).

Representación JSON
{
  "location": enum (TargetImpressionShareLocation),
  "locationFractionMicros": string,
  "cpcBidCeilingMicros": string
}
Campos
location

enum (TargetImpressionShareLocation)

Es la ubicación objetivo en la página de resultados de búsqueda.

locationFractionMicros

string (int64 format)

Es la fracción elegida de anuncios que se mostrarán en la ubicación objetivo, expresada en micro unidades. Por ejemplo, el 1% equivale a 10,000.

cpcBidCeilingMicros

string (int64 format)

La oferta de CPC más alta que el sistema de ofertas automáticas puede especificar. Este es un campo obligatorio que ingresa el anunciante que establece el límite máximo y se especifica en micros locales.

TargetImpressionShareLocation

Es un enum que describe los objetivos posibles.

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
ANYWHERE_ON_PAGE Cualquier ubicación en la página web
TOP_OF_PAGE Es el cuadro superior de anuncios.
ABSOLUTE_TOP_OF_PAGE Es el espacio superior del cuadro superior de anuncios.

TargetOutrankShare

Es una estrategia de ofertas automáticas que establece ofertas en función de la fracción objetivo de las subastas en las que el anunciante debería superar a un competidor específico. Esta estrategia dejó de estar disponible.

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

string (Int64Value format)

El límite de oferta máximo que se puede establecer con la estrategia de ofertas. El límite se aplica a todas las palabras clave administradas por la estrategia.

TargetRoas

Es una estrategia de ofertas automáticas que te ayuda a maximizar los ingresos y, al mismo tiempo, obtener un promedio de un retorno de la inversión publicitaria objetivo (ROAS) específico.

Representación JSON
{
  "targetRoas": number,
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string
}
Campos
targetRoas

number

Obligatorio. Los ingresos elegidos (según los datos de conversiones) por unidad de inversión. El valor debe estar entre 0.01 y 1000.0, inclusive.

cpcBidCeilingMicros

string (int64 format)

El límite de oferta máximo que se puede establecer con la estrategia de ofertas. El límite se aplica a todas las palabras clave administradas por la estrategia. Esto solo se debe establecer para las estrategias de ofertas de cartera.

cpcBidFloorMicros

string (int64 format)

Es el límite de oferta mínimo que puede establecer la estrategia de ofertas. El límite se aplica a todas las palabras clave administradas por la estrategia. Esto solo se debe establecer para las estrategias de ofertas de cartera.

TargetSpend

Es una estrategia de ofertas automáticas que establece tus ofertas para ayudarte a obtener la mayor cantidad posible de clics sin exceder tu presupuesto.

Representación JSON
{
  "targetSpendMicros": string,
  "cpcBidCeilingMicros": string
}
Campos
targetSpendMicros
(deprecated)

string (int64 format)

Obsoleto: Es el objetivo de inversión en el que se maximizan los clics. Un ofertante de TargetSpend intentará gastar la menor cantidad de este valor o el importe de inversión de regulación natural. Si no se especifica, el presupuesto se utiliza como el objetivo de inversión. Este campo está obsoleto y ya no se debe usar. Consulta https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html para obtener más detalles.

cpcBidCeilingMicros

string (int64 format)

El límite de oferta máximo que se puede establecer con la estrategia de ofertas. El límite se aplica a todas las palabras clave administradas por la estrategia.

CampaignBudget

Un presupuesto de campaña

Representación JSON
{
  "resourceName": string,
  "deliveryMethod": enum (BudgetDeliveryMethod),
  "period": enum (BudgetPeriod),
  "amountMicros": string
}
Campos
resourceName

string

Es el nombre del recurso del presupuesto de la campaña. Los nombres de recursos de los presupuestos de la campaña tienen el siguiente formato:

customers/{customerId}/campaignBudgets/{campaign_budget_id}

deliveryMethod

enum (BudgetDeliveryMethod)

El método de publicación que determina el ritmo al que se invierte el presupuesto de la campaña.

El valor predeterminado es STANDARD si no se especifica en una operación de creación.

period

enum (BudgetPeriod)

Período en el que se debe invertir el presupuesto. El valor predeterminado es DAILY si no se especifica.

amountMicros

string (int64 format)

Es el importe promedio diario que invertirá la campaña. Este campo se usa cuando el campo period de CampaignBudget se establece en DAILY, que es el valor predeterminado.

El importe se especifica en micros en la moneda local de la cuenta. Un millón de micros equivale a una unidad de moneda. La inversión mensual efectiva está limitada a 30.4 veces este importe diario.

Este campo es mutuamente excluyente con "totalAmountMicros". Solo se debe establecer uno de los campos "amountMicros" o "totalAmountMicros".

BudgetDeliveryMethod

Son los posibles métodos de publicación de un presupuesto.

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
STANDARD El servidor de presupuesto limitará la publicación de manera uniforme durante todo el período.
ACCELERATED El servidor de presupuestos no limitará la publicación, y los anuncios se publicarán lo más rápido posible.

BudgetPeriod

Es el período posible de un presupuesto.

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
DAILY Presupuesto diario.
FIXED_DAILY Presupuesto diario fijo.
CUSTOM_PERIOD El presupuesto personalizado se puede usar con total_amount para especificar el límite del presupuesto para todo el ciclo de vida.

Campaña

Es una campaña.

Representación JSON
{
  "resourceName": string,
  "status": enum (CampaignStatus),
  "servingStatus": enum (CampaignServingStatus),
  "biddingStrategySystemStatus": enum (BiddingStrategySystemStatus),
  "adServingOptimizationStatus": enum (AdServingOptimizationStatus),
  "advertisingChannelType": enum (AdvertisingChannelType),
  "advertisingChannelSubType": enum (AdvertisingChannelSubType),
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "realTimeBiddingSetting": {
    object (RealTimeBiddingSetting)
  },
  "networkSettings": {
    object (NetworkSettings)
  },
  "dynamicSearchAdsSetting": {
    object (DynamicSearchAdsSetting)
  },
  "shoppingSetting": {
    object (ShoppingSetting)
  },
  "geoTargetTypeSetting": {
    object (GeoTargetTypeSetting)
  },
  "effectiveLabels": [
    string
  ],
  "labels": [
    string
  ],
  "biddingStrategyType": enum (BiddingStrategyType),
  "accessibleBiddingStrategy": string,
  "frequencyCaps": [
    {
      object (FrequencyCapEntry)
    }
  ],
  "selectiveOptimization": {
    object (SelectiveOptimization)
  },
  "optimizationGoalSetting": {
    object (OptimizationGoalSetting)
  },
  "trackingSetting": {
    object (TrackingSetting)
  },
  "engineId": string,
  "excludedParentAssetFieldTypes": [
    enum (AssetFieldType)
  ],
  "createTime": string,
  "creationTime": string,
  "lastModifiedTime": string,
  "feedTypes": [
    enum (AssetSetType)
  ],
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "campaignBudget": string,
  "startDate": string,
  "endDate": string,
  "finalUrlSuffix": string,
  "urlExpansionOptOut": boolean,

  // Union field campaign_bidding_strategy can be only one of the following:
  "biddingStrategy": string,
  "manualCpa": {
    object (ManualCpa)
  },
  "manualCpc": {
    object (ManualCpc)
  },
  "manualCpm": {
    object (ManualCpm)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  },
  "percentCpc": {
    object (PercentCpc)
  },
  "targetCpm": {
    object (TargetCpm)
  }
  // End of list of possible types for union field campaign_bidding_strategy.
}
Campos
resourceName

string

Es el nombre del recurso de la campaña. Los nombres de recursos de las campañas tienen el siguiente formato:

customers/{customerId}/campaigns/{campaignId}

status

enum (CampaignStatus)

El estado de la campaña.

Cuando se agrega una campaña nueva, el estado predeterminado es ENABLED.

servingStatus

enum (CampaignServingStatus)

Es el estado de publicación de anuncios de la campaña.

biddingStrategySystemStatus

enum (BiddingStrategySystemStatus)

Es el estado del sistema de la estrategia de ofertas de la campaña.

adServingOptimizationStatus

enum (AdServingOptimizationStatus)

Es el estado de optimización de la publicación de anuncios de la campaña.

advertisingChannelType

enum (AdvertisingChannelType)

Es el objetivo principal de publicación para los anuncios dentro de la campaña. Las opciones de segmentación se pueden definir mejor en networkSettings.

Este campo es obligatorio y no debe estar vacío cuando se crean campañas nuevas.

Se puede configurar solo cuando se crean campañas. Una vez creada la campaña, no se puede modificar el campo.

advertisingChannelSubType

enum (AdvertisingChannelSubType)

Es un perfeccionamiento opcional de advertisingChannelType. Debe ser un subtipo válido del tipo de canal superior.

Se puede configurar solo cuando se crean campañas. Una vez creada la campaña, no se puede modificar el campo.

urlCustomParameters[]

object (CustomParameter)

Es la lista de asignaciones que se usan para sustituir las etiquetas de parámetros personalizados en un objeto trackingUrlTemplate, finalUrls o mobile_final_urls.

realTimeBiddingSetting

object (RealTimeBiddingSetting)

Configuración de la licitación en tiempo real, una función que solo está disponible para las campañas segmentadas para la red de Ad Exchange.

networkSettings

object (NetworkSettings)

Es la configuración de red de la campaña.

dynamicSearchAdsSetting

object (DynamicSearchAdsSetting)

Es el parámetro de configuración para controlar los anuncios dinámicos de búsqueda (DSA).

shoppingSetting

object (ShoppingSetting)

Es el parámetro de configuración que controla las campañas de Shopping.

geoTargetTypeSetting

object (GeoTargetTypeSetting)

Es el parámetro de configuración de la segmentación geográfica de los anuncios.

effectiveLabels[]

string

Son los nombres de recursos de las etiquetas vigentes adjuntas a esta campaña. Una etiqueta efectiva es una etiqueta heredada o asignada directamente a esta campaña.

labels[]

string

Los nombres de recursos de las etiquetas adjuntas a esta campaña.

biddingStrategyType

enum (BiddingStrategyType)

El tipo de estrategia de ofertas.

La estrategia de ofertas se puede crear estableciendo el esquema de ofertas para crear una estrategia de ofertas estándar o el campo biddingStrategy para crear una estrategia de ofertas de cartera.

Este campo es de solo lectura.

accessibleBiddingStrategy

string

Es el nombre del recurso de AccessibleBiddingStrategy, una vista de solo lectura de los atributos sin restricciones de la estrategia de ofertas de cartera adjunta identificada por "biddingStrategy". Estará vacío si la campaña no utiliza una estrategia de cartera. Los atributos de estrategia sin restricciones están disponibles para todos los clientes con los que se comparte la estrategia y se leen desde el recurso AccessibleBiddingStrategy. En cambio, los atributos restringidos solo están disponibles para el cliente propietario de la estrategia y sus administradores. Los atributos restringidos solo se pueden leer desde el recurso BiddingStrategy.

frequencyCaps[]

object (FrequencyCapEntry)

Es una lista que limita la frecuencia con la que cada usuario verá los anuncios de esta campaña.

selectiveOptimization

object (SelectiveOptimization)

Es el parámetro de configuración de optimización selectiva para esta campaña, que incluye un conjunto de acciones de conversión para optimizar esta campaña. Esta función solo se aplica a las campañas de aplicaciones que utilizan MULTI_CHANNEL como AdvertisingChannelType y APP_CAMPAIGN o APP_CAMPAIGN_FOR_ENGAGEMENT como AdvertisingChannelSubType.

optimizationGoalSetting

object (OptimizationGoalSetting)

Es la configuración del objetivo de optimización para esta campaña, que incluye un conjunto de tipos de objetivos de optimización.

trackingSetting

object (TrackingSetting)

Es la configuración a nivel de la campaña para la información de seguimiento.

engineId

string

ID de la campaña en la cuenta de motor externa. Este campo es solo para una cuenta que no es de Google Ads, por ejemplo, Yahoo Japan, Microsoft, Baidu, etc. Para la entidad de Google Ads, usa "campaign.id".

excludedParentAssetFieldTypes[]

enum (AssetFieldType)

Son los tipos de campos de recursos que se deben excluir de esta campaña. Esta campaña no heredará los vínculos de recursos con estos tipos de campos del nivel superior.

createTime

string

La marca de tiempo de la creación de esta campaña. La marca de tiempo se encuentra en la zona horaria del cliente y en el formato “aaaa-MM-dd HH:mm:ss”. createTime dejará de estar disponible en la versión 1. En su lugar, usa creationTime.

creationTime

string

La marca de tiempo de la creación de esta campaña. La marca de tiempo se encuentra en la zona horaria del cliente y en el formato “dd-MM-aaaa HH:mm:ss”.

lastModifiedTime

string

La fecha y hora de la última modificación de esta campaña. La fecha y hora se encuentran en la zona horaria del cliente y en el formato “dd-MM-aaaa HH:mm:ss.ssssss”.

feedTypes[]

enum (AssetSetType)

Son los tipos de feeds que se adjuntan directamente a esta campaña.

id

string (int64 format)

El ID de la campaña.

name

string

El nombre de la campaña.

Este campo es obligatorio y no debe estar vacío cuando se crean campañas nuevas.

No debe contener caracteres nulos (punto de código 0x0), de salto de línea NL (punto de código 0xA) ni de retorno de carro (punto de código 0xD).

trackingUrlTemplate

string

La plantilla de URL para crear una URL de seguimiento.

campaignBudget

string

Es el nombre del recurso del presupuesto de la campaña.

startDate

string

La fecha en que comenzó la campaña en la zona horaria del cliente en formato AAAA-MM-DD.

endDate

string

El último día de la campaña en la zona horaria del cliente en formato AAAA-MM-DD. Cuando se crea, la configuración predeterminada es 2037-12-30, lo que significa que la campaña se publicará de forma indefinida. Para configurar una campaña existente para que se publique de forma indefinida, configura este campo en 2037-12-30.

finalUrlSuffix

string

Sufijo que se usa para agregar parámetros de consulta a las páginas de destino que se publican con el seguimiento paralelo.

urlExpansionOptOut

boolean

Representa la inhabilitación de la expansión de URL a URLs más segmentadas. Si se inhabilita (verdadero), solo se segmentan las URLs finales del grupo de recursos o las URLs especificadas en los feeds de datos de la empresa o de Google Merchant Center del anunciante. Si se habilita (falso), se segmentará todo el dominio. Este campo solo se puede establecer para las campañas de máximo rendimiento, en las que el valor predeterminado es falso.

Campo de unión campaign_bidding_strategy. Es la estrategia de ofertas de la campaña.

Debe ser de cartera (creada a través del servicio BiddingStrategy) o estándar, es decir, incorporada en la campaña. campaign_bidding_strategy puede ser una de las siguientes opciones:

biddingStrategy

string

Es el nombre del recurso de la estrategia de ofertas de cartera que utiliza la campaña.

manualCpa

object (ManualCpa)

Es la estrategia de ofertas de CPA manual estándar. Estrategia de ofertas manual que permite al anunciante establecer la oferta por acción especificada por el anunciante. Solo se admite para las campañas de Servicios locales.

manualCpc

object (ManualCpc)

Es la estrategia de ofertas estándar de CPC manual. Es una estrategia de ofertas manual basada en clics en la que el usuario paga por clic.

manualCpm

object (ManualCpm)

Es la estrategia de ofertas de CPM manual estándar. Es la estrategia de ofertas manuales basadas en impresiones en la que el usuario paga por cada mil impresiones.

maximizeConversions

object (MaximizeConversions)

Estrategia de ofertas estándar de Maximizar conversiones que maximiza automáticamente la cantidad de conversiones sin exceder tu presupuesto.

maximizeConversionValue

object (MaximizeConversionValue)

Estrategia de ofertas estándar Maximizar valor de conversión que establece ofertas automáticamente para maximizar los ingresos sin exceder tu presupuesto.

targetCpa

object (TargetCpa)

Es una estrategia de ofertas CPA objetivo estándar que establece las ofertas automáticamente para ayudarte a obtener la mayor cantidad posible de conversiones con el costo por adquisición (CPA) objetivo que estableciste.

targetImpressionShare

object (TargetImpressionShare)

Estrategia de ofertas Porcentaje de impresiones objetivo. Es una estrategia de ofertas automáticas que establece ofertas para alcanzar un porcentaje de impresiones elegido.

targetRoas

object (TargetRoas)

Estrategia de ofertas ROAS objetivo estándar que maximiza automáticamente los ingresos y, al mismo tiempo, calcula el promedio de un retorno de la inversión publicitaria (ROAS) objetivo específico.

targetSpend

object (TargetSpend)

Es una estrategia de ofertas estándar de inversión objetivo que establece automáticamente tus ofertas para ayudarte a obtener la mayor cantidad posible de clics sin exceder tu presupuesto.

percentCpc

object (PercentCpc)

Estrategia de ofertas de CPC porcentual estándar en la que las ofertas son una fracción del precio publicitado de algún bien o servicio.

targetCpm

object (TargetCpm)

Es una estrategia de ofertas que optimiza automáticamente el costo por mil impresiones.

CampaignStatus

Son los estados posibles de una campaña.

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
ENABLED La campaña está activa y puede mostrar anuncios.
PAUSED El usuario detuvo la campaña.
REMOVED Se quitó la campaña.

CampaignServingStatus

Son los posibles estados de publicación de una campaña.

Enums
UNSPECIFIED No se especificó ningún valor.
UNKNOWN

El valor recibido no se conoce en esta versión.

Este es un valor de solo respuesta.

SERVING Se está publicando.
NONE Ninguno
ENDED Finalizó.
PENDING Pendiente.
SUSPENDED Suspendido.

BiddingStrategySystemStatus

Son los posibles estados del sistema de una estrategia de ofertas.

Enums
UNSPECIFIED Indica que se produjo un error inesperado, por ejemplo, no se encontró ningún tipo de estrategia de ofertas o no se encontró información de estado.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
ENABLED La estrategia de oferta está activa y AdWords no encuentra problemas específicos con la estrategia.
LEARNING_NEW La estrategia de ofertas está en aprendizaje porque se creó o reactivó recientemente.
LEARNING_SETTING_CHANGE La estrategia de ofertas está en aprendizaje debido a un cambio reciente en la configuración.
LEARNING_BUDGET_CHANGE La estrategia de ofertas está en aprendizaje debido a un cambio reciente en el presupuesto.
LEARNING_COMPOSITION_CHANGE La estrategia de ofertas está en aprendizaje debido a un cambio reciente en la cantidad de campañas, grupos de anuncios o palabras clave asociados a ella.
LEARNING_CONVERSION_TYPE_CHANGE La estrategia de ofertas depende de los informes de conversiones y de los tipos de conversiones que el cliente modificó recientemente y que eran relevantes para la estrategia de ofertas.
LEARNING_CONVERSION_SETTING_CHANGE La estrategia de ofertas depende de los informes de conversiones, y el cliente cambió recientemente su configuración de conversiones.
LIMITED_BY_CPC_BID_CEILING La estrategia de ofertas está limitada por su límite superior de la oferta.
LIMITED_BY_CPC_BID_FLOOR La estrategia de ofertas está limitada por su precio mínimo.
LIMITED_BY_DATA La estrategia de ofertas está limitada porque no hubo suficiente tráfico de conversiones en las últimas semanas.
LIMITED_BY_BUDGET Una fracción significativa de las palabras clave de esta estrategia de ofertas están limitadas por el presupuesto.
LIMITED_BY_LOW_PRIORITY_SPEND La estrategia de ofertas no puede alcanzar su inversión objetivo porque se redujo su prioridad de inversión.
LIMITED_BY_LOW_QUALITY Una fracción significativa de las palabras clave de esta estrategia de ofertas tienen un Nivel de calidad bajo.
LIMITED_BY_INVENTORY La estrategia de ofertas no puede invertir por completo su presupuesto debido a la segmentación limitada.
MISCONFIGURED_ZERO_ELIGIBILITY Falta el seguimiento de conversiones (no hay pings presentes) o las listas de remarketing para las campañas de SSC.
MISCONFIGURED_CONVERSION_TYPES La estrategia de ofertas depende del registro de conversiones, y el cliente no tiene los tipos de conversiones que se podrían registrar en relación con esta estrategia.
MISCONFIGURED_CONVERSION_SETTINGS La estrategia de ofertas depende del registro de conversiones, y los parámetros de configuración de conversiones del cliente están configurados de forma incorrecta.
MISCONFIGURED_SHARED_BUDGET Hay campañas fuera de la estrategia de ofertas que comparten presupuestos con campañas incluidas en la estrategia.
MISCONFIGURED_STRATEGY_TYPE La campaña tiene un tipo de estrategia no válido y no se publica.
PAUSED La estrategia de ofertas no está activa. No hay campañas, grupos de anuncios ni palabras clave activos asociados a la estrategia de ofertas. O bien no hay presupuestos activos conectados a la estrategia de ofertas.
UNAVAILABLE Actualmente, esta estrategia de ofertas no admite informes de estado.
MULTIPLE_LEARNING Hubo varios estados del sistema LEARNING_* para esta estrategia de ofertas durante el período en cuestión.
MULTIPLE_LIMITED Hubo varios estados del sistema LIMITED_* para esta estrategia de ofertas durante el período en cuestión.
MULTIPLE_MISCONFIGURED Hubo varios estados del sistema MISCONFIGURED_* para esta estrategia de ofertas durante el período en cuestión.
MULTIPLE Hubo varios estados del sistema para esta estrategia de ofertas durante el período en cuestión.

AdServingOptimizationStatus

Es una enumeración que describe los posibles estados de publicación.

Enums
UNSPECIFIED No se especificó ningún valor.
UNKNOWN

El valor recibido no se conoce en esta versión.

Este es un valor de solo respuesta.

OPTIMIZE La publicación de anuncios se optimiza en función de la CTR de la campaña.
CONVERSION_OPTIMIZE La publicación de anuncios se optimiza en función de la métrica CTR * Conversiones de la campaña. Si la campaña no utiliza la estrategia de ofertas del Optimizador de conversiones, se establecerá de forma predeterminada en OPTIMIZED.
ROTATE Los anuncios rotan de manera uniforme durante 90 días y, luego, se optimizan para obtener más clics.
ROTATE_INDEFINITELY Mostrar anuncios de menor rendimiento de manera más uniforme con los anuncios de mayor rendimiento y no realizar optimizaciones
UNAVAILABLE El estado de optimización de la publicación de anuncios no está disponible.

AdvertisingChannelType

Es una enumeración que describe los distintos tipos de canales de publicidad.

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
SEARCH Red de búsqueda. Incluye campañas combinadas de Display y campañas de Búsqueda y Display.
DISPLAY Solo en la Red de Display de Google.
SHOPPING Las campañas de Shopping se publican en la propiedad de Shopping y en los resultados de la búsqueda de google.com.
HOTEL Campañas de Anuncios de hoteles
VIDEO Campañas de video
MULTI_CHANNEL Campañas de aplicaciones y campañas de participación en la aplicación que se publican en varios canales
LOCAL Campañas de anuncios locales
SMART Campañas inteligentes
PERFORMANCE_MAX Campañas de máximo rendimiento
LOCAL_SERVICES Campañas de servicios locales
DISCOVERY Son campañas discovery.
TRAVEL Campañas de viajes
SOCIAL Campañas de redes sociales

AdvertisingChannelSubType

Es una enumeración que describe los diferentes subtipos de canales.

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa como valor de devolución. Representa un valor desconocido en esta versión.
SEARCH_MOBILE_APP Son las campañas en aplicaciones para dispositivos móviles de la Búsqueda.
DISPLAY_MOBILE_APP Campañas en aplicaciones para dispositivos móviles de Display
SEARCH_EXPRESS Son campañas de AdWords Express para la Búsqueda.
DISPLAY_EXPRESS Campañas de AdWords Express para Display
SHOPPING_SMART_ADS Campañas de Shopping inteligentes
DISPLAY_GMAIL_AD Campañas de anuncios de Gmail
DISPLAY_SMART_CAMPAIGN Campañas inteligentes de la Red de Display. No se pueden crear campañas nuevas de este subtipo.
VIDEO_OUTSTREAM Campañas de video outstream
VIDEO_ACTION Campañas de video TrueView for Action.
VIDEO_NON_SKIPPABLE Campañas de video con anuncios de video que no se pueden omitir
APP_CAMPAIGN Campaña de aplicaciones que te permite promocionar fácilmente tu aplicación para Android o iOS en las propiedades más importantes de Google, incluidas la Búsqueda, Play, YouTube y la Red de Display de Google.
APP_CAMPAIGN_FOR_ENGAGEMENT Campaña de aplicaciones de participación, enfocada en generar una nueva participación en la aplicación en varias de las propiedades más importantes de Google, incluidas la Búsqueda, YouTube y la Red de Display de Google.
LOCAL_CAMPAIGN Son campañas especializadas para la publicidad local.
SHOPPING_COMPARISON_LISTING_ADS Campañas de comparadores de Shopping
SMART_CAMPAIGN Campañas inteligentes estándares
VIDEO_SEQUENCE Campañas de video con anuncios de video secuenciales
APP_CAMPAIGN_FOR_PRE_REGISTRATION Campaña de aplicaciones para el registro previo, especializada en la publicidad del registro previo de aplicaciones para dispositivos móviles, que segmenta sus anuncios para múltiples canales publicitarios en Google Play, YouTube y la Red de Display.
VIDEO_REACH_TARGET_FREQUENCY Campaña de alcance de video con la estrategia de ofertas de frecuencia objetivo.
TRAVEL_ACTIVITIES Campañas de actividades de viajes
SOCIAL_FACEBOOK_TRACKING_ONLY Campañas de redes sociales solo con seguimiento de Facebook.

RealTimeBiddingSetting

Configuración de la licitación en tiempo real, una función que solo está disponible para las campañas segmentadas para la red de Ad Exchange.

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

boolean

Indica si la campaña está habilitada para la licitación en tiempo real.

NetworkSettings

Es la configuración de red de la campaña.

Representación JSON
{
  "targetGoogleSearch": boolean,
  "targetSearchNetwork": boolean,
  "targetContentNetwork": boolean,
  "targetPartnerSearchNetwork": boolean
}
Campos
targetSearchNetwork

boolean

Indica si los anuncios se publicarán en sitios de la red de socios de búsqueda de Google (se requiere que targetGoogleSearch también sea true).

targetContentNetwork

boolean

Indica si los anuncios se publicarán en posiciones especificadas en la Red de Display de Google. Las posiciones se especifican con el criterio de posición.

targetPartnerSearchNetwork

boolean

Indica si los anuncios se publicarán en la red de socios. Esta función solo está disponible para algunas cuentas de socios seleccionadas. A menos que se te haya indicado que uses este campo, es probable que no se aplique a tu cuenta. Este parámetro no controla si los anuncios se publicarán en la red de socios de búsqueda de Google. En su lugar, usa targetSearchNetwork.

DynamicSearchAdsSetting

Es el parámetro de configuración para controlar los anuncios dinámicos de búsqueda (DSA).

Representación JSON
{
  "domainName": string,
  "languageCode": string,
  "useSuppliedUrlsOnly": boolean
}
Campos
domainName

string

Obligatorio. Nombre de dominio de Internet que representa este parámetro de configuración, por ejemplo, "google.com" o "www.google.com".

languageCode

string

Obligatorio. Es el código de idioma que especifica el idioma del dominio, por ejemplo, "en".

useSuppliedUrlsOnly

boolean

Indica si la campaña usa exclusivamente URLs proporcionadas por el anunciante.

ShoppingSetting

Es el parámetro de configuración para las campañas de Shopping. Define el universo de productos que se pueden publicitar en la campaña y cómo esta campaña interactúa con otras campañas de Shopping.

Representación JSON
{
  "feedLabel": string,
  "useVehicleInventory": boolean,
  "merchantId": string,
  "salesCountry": string,
  "campaignPriority": integer,
  "enableLocal": boolean
}
Campos
feedLabel

string

Es la etiqueta de feed de los productos que se incluirán en la campaña. Las etiquetas de feed válidas pueden contener un máximo de 20 caracteres, incluidas letras mayúsculas, números, guiones y guiones bajos. Si antes usabas el campo salesCountry obsoleto en el formato de código de país de dos letras (XX), debes usar el campo feedLabel en su lugar. Para obtener más información, consulta el artículo de asistencia sobre las etiquetas de feeds.

useVehicleInventory

boolean

Indica si se segmentará el inventario de fichas de vehículos.

merchantId

string (int64 format)

ID de la cuenta de Merchant Center. Este campo es obligatorio para las operaciones de creación. Este campo es inmutable para las campañas de Shopping.

salesCountry

string

Es el país de venta de los productos que se incluirán en la campaña.

campaignPriority

integer

Es la prioridad de la campaña. Las campañas con prioridades numéricamente más altas tienen prioridad sobre las que tienen prioridades más bajas. Este campo es obligatorio para las campañas de Shopping y debe tener valores entre 0 y 2, inclusive. Este campo es opcional para las campañas de Shopping inteligentes, pero debe ser igual a 3 si se configura.

enableLocal

boolean

Indica si se deben incluir los productos locales.

GeoTargetTypeSetting

Representa una colección de parámetros de configuración relacionados con la segmentación geográfica de los anuncios.

Representación JSON
{
  "positiveGeoTargetType": enum (PositiveGeoTargetType),
  "negativeGeoTargetType": enum (NegativeGeoTargetType)
}
Campos
positiveGeoTargetType

enum (PositiveGeoTargetType)

Es el parámetro de configuración que se usa para la segmentación geográfica positiva en esta campaña en particular.

negativeGeoTargetType

enum (NegativeGeoTargetType)

Es el parámetro de configuración que se usa para la segmentación geográfica negativa en esta campaña en particular.

PositiveGeoTargetType

Son los tipos de segmentación geográfica positiva posibles.

Enums
UNSPECIFIED No se especifica.
UNKNOWN El valor es desconocido en esta versión.
PRESENCE_OR_INTEREST Especifica que se activa un anuncio si el usuario se encuentra en las ubicaciones segmentadas del anunciante o muestra interés en ellas.
SEARCH_INTEREST Especifica que se activa un anuncio si el usuario busca las ubicaciones segmentadas del anunciante. Solo se puede usar con las campañas de Búsqueda y de Shopping estándares.
PRESENCE Especifica que se activa un anuncio si el usuario se encuentra en las ubicaciones segmentadas del anunciante o si suele estar allí.

NegativeGeoTargetType

Son los tipos de segmentación geográfica negativa posibles.

Enums
UNSPECIFIED No se especifica.
UNKNOWN El valor es desconocido en esta versión.
PRESENCE_OR_INTEREST Especifica que se excluye a un usuario de ver el anuncio si se encuentra en las ubicaciones excluidas del anunciante o muestra interés en ellas.
PRESENCE Especifica que se excluye a un usuario de ver el anuncio si se encuentra en las ubicaciones excluidas del anunciante.

FrequencyCapEntry

Este tipo no tiene campos.

Es una regla que especifica la cantidad máxima de veces que se puede mostrar un anuncio (o un conjunto de anuncios) a un usuario durante un período determinado.

SelectiveOptimization

Es el parámetro de configuración de optimización selectiva para esta campaña, que incluye un conjunto de acciones de conversión para optimizar esta campaña. Esta función solo se aplica a las campañas de aplicaciones que utilizan MULTI_CHANNEL como AdvertisingChannelType y APP_CAMPAIGN o APP_CAMPAIGN_FOR_ENGAGEMENT como AdvertisingChannelSubType.

Representación JSON
{
  "conversionActions": [
    string
  ]
}
Campos
conversionActions[]

string

Es el conjunto seleccionado de nombres de recursos para las acciones de conversión que se utilizan para optimizar esta campaña.

OptimizationGoalSetting

Es la configuración del objetivo de optimización para esta campaña, que incluye un conjunto de tipos de objetivos de optimización.

Representación JSON
{
  "optimizationGoalTypes": [
    enum (OptimizationGoalType)
  ]
}
Campos
optimizationGoalTypes[]

enum (OptimizationGoalType)

Es la lista de tipos de objetivos de optimización.

OptimizationGoalType

Tipo de objetivo de optimización

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa como valor de devolución. Representa un valor desconocido en esta versión.
CALL_CLICKS Optimiza la campaña para obtener clics en llamadas. Las conversiones por clic en llamada son las veces que los usuarios seleccionaron "Llamar" para comunicarse con una tienda después de ver un anuncio.
DRIVING_DIRECTIONS Optimiza la ruta en auto. Las conversiones de indicaciones para llegar en automóvil son las veces que los usuarios seleccionaron "Cómo llegar" para navegar a una tienda después de ver un anuncio.
APP_PRE_REGISTRATION Optimiza la campaña para el registro previo. Las conversiones por registro previo son la cantidad de registros previos para recibir una notificación cuando se lance la app.

TrackingSetting

Es la configuración a nivel de la campaña para la información de seguimiento.

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

string

Es la URL que se usa para el seguimiento dinámico.

AssetSetType

Son los tipos posibles de un conjunto de recursos.

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
PAGE_FEED Es el conjunto de recursos de la página.
DYNAMIC_EDUCATION Es un conjunto de recursos de educación dinámicos.
MERCHANT_CENTER_FEED Es el conjunto de recursos de Google Merchant Center.
DYNAMIC_REAL_ESTATE Es un conjunto de recursos dinámicos de bienes raíces.
DYNAMIC_CUSTOM Es un conjunto de recursos personalizados dinámicos.
DYNAMIC_HOTELS_AND_RENTALS Es el conjunto de recursos de anuncios dinámicos de hoteles y alquileres.
DYNAMIC_FLIGHTS Es el conjunto de recursos de anuncios dinámicos de vuelos.
DYNAMIC_TRAVEL Es un conjunto de recursos de viajes dinámicos.
DYNAMIC_LOCAL Es un conjunto de recursos locales dinámicos.
DYNAMIC_JOBS Es el conjunto de recursos de anuncios dinámicos de empleos.
LOCATION_SYNC Es el conjunto de recursos a nivel de la sincronización de la ubicación.
BUSINESS_PROFILE_DYNAMIC_LOCATION_GROUP Es un conjunto de recursos del grupo de ubicaciones del Perfil de Negocio.
CHAIN_DYNAMIC_LOCATION_GROUP Es un conjunto de recursos de grupo de ubicaciones de cadena que se puede usar tanto para las ubicaciones propias como para las ubicaciones afiliadas.
STATIC_LOCATION_GROUP Es un conjunto de recursos de grupo por ubicación estático que se puede usar tanto para las ubicaciones propias como para las ubicaciones afiliadas.
HOTEL_PROPERTY Es el conjunto de recursos de propiedad de hotel que se usa para vincular un feed de propiedad de hotel a las campañas de máximo rendimiento para objetivos de viaje.
TRAVEL_FEED Es el tipo de conjunto de recursos del feed de viajes. Puede representar un feed de hoteles o un feed de actividades (cosas que hacer).

ManualCpa

Este tipo no tiene campos.

Estrategia de ofertas manual que permite al anunciante establecer la oferta por acción especificada por el anunciante.

ManualCpc

Es una estrategia de ofertas manual basada en clics en la que el usuario paga por clic.

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

boolean

Indica si se deben mejorar las ofertas en función de los datos del Optimizador de conversiones.

ManualCpm

Este tipo no tiene campos.

Es la estrategia de ofertas manuales basadas en impresiones en la que el usuario paga por cada mil impresiones.

PercentCpc

Estrategia de ofertas en la que las ofertas son una fracción del precio publicitado de algún bien o servicio.

Representación JSON
{
  "cpcBidCeilingMicros": string,
  "enhancedCpcEnabled": boolean
}
Campos
cpcBidCeilingMicros

string (int64 format)

El límite de oferta máximo que se puede establecer con la estrategia de ofertas. Este es un campo opcional que ingresa el anunciante y se especifica en micros locales. Nota: Un valor cero se interpreta de la misma manera que si bid_ceiling no estuviera definido.

enhancedCpcEnabled

boolean

Ajusta la oferta para cada subasta hacia arriba o hacia abajo, según la probabilidad de generar una conversión. Las ofertas individuales pueden superar cpcBidCeilingMicros, pero el importe de la oferta promedio de una campaña no debe hacerlo.

TargetCpm

Este tipo no tiene campos.

El CPM objetivo (costo por cada mil impresiones) es una estrategia de ofertas automáticas que establece ofertas para optimizar el rendimiento en función del CPM objetivo que establezcas.

CampaignAsset

Es un vínculo entre una campaña y un recurso.

Representación JSON
{
  "resourceName": string,
  "status": enum (AssetLinkStatus),
  "campaign": string,
  "asset": string
}
Campos
resourceName

string

Es el nombre del recurso del recurso de la campaña. Los nombres de los recursos CampaignAsset tienen el siguiente formato:

customers/{customerId}/campaignAssets/{campaignId}~{assetId}~{fieldType}

status

enum (AssetLinkStatus)

Es el estado del recurso de la campaña.

campaign

string

La campaña a la que está vinculado el recurso.

asset

string

El recurso que está vinculado a la campaña.

CampaignAssetSet

CampaignAssetSet es la vinculación entre una campaña y un conjunto de recursos. Si agregas un CampaignAssetSet, se vincula un conjunto de recursos con una campaña.

Representación JSON
{
  "resourceName": string,
  "campaign": string,
  "assetSet": string,
  "status": enum (AssetSetLinkStatus)
}
Campos
resourceName

string

Es el nombre del recurso del conjunto de recursos de la campaña. Los nombres de recursos de los recursos del conjunto de recursos tienen el siguiente formato:

customers/{customerId}/campaignAssetSets/{campaignId}~{asset_set_id}

campaign

string

Campaña a la que está vinculado este conjunto de recursos.

assetSet

string

Es el conjunto de recursos que está vinculado a la campaña.

status

enum (AssetSetLinkStatus)

Es el estado del recurso del conjunto de recursos de la campaña. Solo lectura.

CampaignAudienceView

Es una vista del público de la campaña. Incluye datos de rendimiento de los intereses y las listas de remarketing para los anuncios de la Red de Display y la Red de YouTube, y las listas de remarketing para anuncios de búsqueda (RLSA), agregados por campaña y criterio de público. En esta vista, solo se incluyen los públicos adjuntos a nivel de la campaña.

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

string

Es el nombre del recurso de la vista del público de la campaña. Los nombres de los recursos de la vista de público de la campaña tienen el siguiente formato:

customers/{customerId}/campaignAudienceViews/{campaignId}~{criterionId}

CampaignCriterion

Es un criterio de campaña.

Representación JSON
{
  "resourceName": string,
  "displayName": string,
  "type": enum (CriterionType),
  "status": enum (CampaignCriterionStatus),
  "lastModifiedTime": string,
  "criterionId": string,
  "bidModifier": number,
  "negative": boolean,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "location": {
    object (LocationInfo)
  },
  "device": {
    object (DeviceInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "language": {
    object (LanguageInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "locationGroup": {
    object (LocationGroupInfo)
  }
  // End of list of possible types for union field criterion.
}
Campos
resourceName

string

Es el nombre del recurso del criterio de campaña. Los nombres de recursos de los criterios de la campaña tienen el siguiente formato:

customers/{customerId}/campaignCriteria/{campaignId}~{criterionId}

displayName

string

Es el nombre visible del criterio.

Este campo se ignora para las mutaciones.

type

enum (CriterionType)

El tipo del criterio.

status

enum (CampaignCriterionStatus)

El estado del criterio.

lastModifiedTime

string

La fecha y hora de la última modificación de este criterio de campaña. La fecha y hora se encuentran en la zona horaria del cliente y en el formato “dd-MM-aaaa HH:mm:ss.ssssss”.

criterionId

string (int64 format)

El ID del criterio.

Este campo se ignora durante la modificación.

bidModifier

number

Es el modificador de las ofertas cuando el criterio coincide. El modificador debe estar en el rango de 0.1 a 10.0. La mayoría de los tipos de criterios de segmentación admiten modificadores. Usa 0 para inhabilitar un tipo de dispositivo.

negative

boolean

Indica si se debe segmentar (false) o excluir (true) el criterio.

Campo de unión criterion. Es el criterio de la campaña.

Se debe establecer exactamente uno. criterion puede ser una de las siguientes opciones:

keyword

object (KeywordInfo)

Es la palabra clave.

location

object (LocationInfo)

Ubicación.

device

object (DeviceInfo)

Dispositivo.

ageRange

object (AgeRangeInfo)

Es el rango de edad.

gender

object (GenderInfo)

Es el género.

userList

object (UserListInfo)

Es la lista de usuarios.

language

object (LanguageInfo)

Language.

webpage

object (WebpageInfo)

Página web.

locationGroup

object (LocationGroupInfo)

Grupo por ubicación

CampaignCriterionStatus

Son los estados posibles de un CampaignCriterion.

Enums
UNSPECIFIED No se especificó ningún valor.
UNKNOWN

El valor recibido no se conoce en esta versión.

Este es un valor de solo respuesta.

ENABLED El criterio de campaña está habilitado.
PAUSED El criterio de la campaña está detenido.
REMOVED Se quita el criterio de la campaña.

LanguageInfo

Es un criterio de idioma.

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

string

Es el nombre del recurso de la constante de idioma.

LocationGroupInfo

Es un radio alrededor de una lista de ubicaciones especificadas a través de un feed.

Representación JSON
{
  "geoTargetConstants": [
    string
  ],
  "radiusUnits": enum (LocationGroupRadiusUnits),
  "feedItemSets": [
    string
  ],
  "radius": string
}
Campos
geoTargetConstants[]

string

Son las constantes de segmentación geográfica que restringen el alcance del área geográfica dentro del feed. Actualmente, solo se permite una constante de segmentación geográfica.

radiusUnits

enum (LocationGroupRadiusUnits)

Unidad del radio. Las millas y los metros se admiten para las constantes de segmentación geográfica. Se admiten los milímetros y los metros para los conjuntos de elementos del feed. Este campo es obligatorio y se debe establecer en las operaciones de creación.

feedItemSets[]

string

Son los FeedItemSets cuyos FeedItems se segmentan. Si se especifican varios IDs, se segmentarán todos los elementos que aparezcan en al menos un conjunto. Este campo no se puede usar con geoTargetConstants. Este campo es opcional y solo se puede configurar en las operaciones de CREATE.

radius

string (int64 format)

Es la distancia en unidades que especifica el radio alrededor de las ubicaciones segmentadas. Este campo es obligatorio y se debe establecer en las operaciones de creación.

LocationGroupRadiusUnits

Unidad de distancia del radio en el grupo de ubicaciones (por ejemplo, MILLAS)

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
METERS Metros
MILES Millas
MILLI_MILES Mili millas

CampaignEffectiveLabel

Representa una relación entre una campaña y una etiqueta efectiva. Una etiqueta efectiva es una etiqueta heredada o asignada directamente a esta campaña.

Representación JSON
{
  "resourceName": string,
  "campaign": string,
  "label": string,
  "ownerCustomerId": string
}
Campos
resourceName

string

Nombre del recurso. Los nombres de los recursos CampaignEffectivelabel tienen el siguiente formato: customers/{ownerCustomerId}/campaignEffectiveLabels/{campaignId}~{label_id}

campaign

string

Campaña a la que se adjunta la etiqueta efectiva.

label

string

Es la etiqueta efectiva asignada a la campaña.

ownerCustomerId

string (int64 format)

Es el ID del cliente propietario de la etiqueta efectiva.

CampaignLabel

Representa una relación entre una campaña y una etiqueta.

Representación JSON
{
  "resourceName": string,
  "campaign": string,
  "label": string,
  "ownerCustomerId": string
}
Campos
resourceName

string

Nombre del recurso. Los nombres de recursos de las etiquetas de la campaña tienen el siguiente formato: customers/{ownerCustomerId}/campaignLabels/{campaignId}~{label_id}

campaign

string

Campaña a la que se adjunta la etiqueta.

label

string

Es la etiqueta asignada a la campaña.

ownerCustomerId

string (int64 format)

Es el ID del cliente propietario de la etiqueta.

CartDataSalesView

Vista de ventas de los datos del carrito

Proporciona información sobre los productos que se compraron si se implementan las conversiones con datos del carrito. Las métricas de rendimiento, como los ingresos, las ganancias brutas, las métricas de clientes potenciales o de ventas cruzadas, etc., y los atributos de Merchant Center, como la marca, la categoría, etc., están disponibles para los productos definidos en un feed de inventario y que se venden como resultado de los anuncios de Google. En el caso de las compras atribuidas a clics en anuncios de Shopping, se pueden ver juntas las dimensiones de los productos en los que se hizo clic y los productos vendidos.

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

string

Es el nombre del recurso de la vista de datos de ventas del carrito. Los nombres de los recursos de la vista de ventas de datos del carrito tienen el siguiente formato: customers/{customerId}/cartDataSalesView

Público

Los públicos son una opción de segmentación eficaz que te permite mezclar diferentes atributos de segmentos, como afinidades y datos demográficos detallados, para crear públicos que representen secciones de tus segmentos objetivo.

Representación JSON
{
  "resourceName": string,
  "id": string,
  "name": string,
  "description": string
}
Campos
resourceName

string

Es el nombre del recurso del público. Los nombres de los públicos tienen el siguiente formato:

customers/{customerId}/audiences/{audience_id}

id

string (int64 format)

Es el ID del público.

name

string

Obligatorio. Es el nombre del público. Debe ser único para todos los públicos. Debe tener una longitud mínima de 1 y una longitud máxima de 255.

description

string

Es la descripción de este público.

ConversionAction

Es una acción de conversión.

Representación JSON
{
  "resourceName": string,
  "creationTime": string,
  "status": enum (ConversionActionStatus),
  "type": enum (ConversionActionType),
  "category": enum (ConversionActionCategory),
  "valueSettings": {
    object (ValueSettings)
  },
  "attributionModelSettings": {
    object (AttributionModelSettings)
  },
  "floodlightSettings": {
    object (FloodlightSettings)
  },
  "id": string,
  "name": string,
  "primaryForGoal": boolean,
  "ownerCustomer": string,
  "includeInClientAccountConversionsMetric": boolean,
  "includeInConversionsMetric": boolean,
  "clickThroughLookbackWindowDays": string,
  "appId": string
}
Campos
resourceName

string

Es el nombre del recurso de la acción de conversión. Los nombres de recursos de las acciones de conversión tienen el siguiente formato:

customers/{customerId}/conversionActions/{conversionActionId}

creationTime

string

Marca de tiempo de la creación de la actividad de Floodlight, con formato ISO 8601.

status

enum (ConversionActionStatus)

Es el estado de esta acción de conversión para la acumulación de eventos de conversión.

type

enum (ConversionActionType)

El tipo de esta acción de conversión.

category

enum (ConversionActionCategory)

Es la categoría de las conversiones registradas para esta acción de conversión.

valueSettings

object (ValueSettings)

Es la configuración relacionada con el valor de los eventos de conversión asociados a esta acción de conversión.

attributionModelSettings

object (AttributionModelSettings)

Es la configuración relacionada con el modelo de atribución de esta acción de conversión.

floodlightSettings

object (FloodlightSettings)

Es la configuración de Floodlight para los tipos de conversiones de Floodlight.

id

string (int64 format)

Es el ID de la acción de conversión.

name

string

Es el nombre de la acción de conversión.

Este campo es obligatorio y no debe estar vacío cuando se crean acciones de conversión nuevas.

primaryForGoal

boolean

Si el bit primaryForGoal de una acción de conversión es falso, la acción de conversión no apta para ofertas para todas las campañas, independientemente de su objetivo de conversión del cliente o de su objetivo de conversión de la campaña. Sin embargo, los objetivos de conversión personalizados no respetan primaryForGoal, por lo que, si una campaña tiene configurado un objetivo de conversión personalizado con una acción de conversión primaryForGoal = false, esa acción de conversión seguirá siendo apta para ofertas. De forma predeterminada, primaryForGoal será verdadero si no se configura. En la versión 9, primaryForGoal solo se puede establecer como falso después de la creación a través de una operación de "actualización", ya que no se declara como opcional.

ownerCustomer

string

Es el nombre del recurso del cliente propietario de la acción de conversión o nulo si se trata de una acción de conversión definida por el sistema.

includeInClientAccountConversionsMetric

boolean

Indica si esta acción de conversión se debe incluir en la métrica "clientAccountConversions".

includeInConversionsMetric

boolean

Indica si esta acción de conversión se debe incluir en la métrica "conversiones".

clickThroughLookbackWindowDays

string (int64 format)

Es la cantidad máxima de días que pueden transcurrir entre una interacción (por ejemplo, un clic) y un evento de conversión.

appId

string

Es el ID de la aplicación para una acción de conversión asociada a la aplicación.

ConversionActionStatus

Son los estados posibles de una acción de conversión.

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
ENABLED Se registrarán las conversiones.
REMOVED No se registrarán las conversiones.
HIDDEN No se registrarán las conversiones y la acción de conversión no aparecerá en la IU.

ConversionActionType

Son los tipos posibles de una acción de conversión.

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
AD_CALL Son las conversiones que se producen cuando un usuario hace clic en la extensión de llamada de un anuncio.
CLICK_TO_CALL Son las conversiones que se producen cuando un usuario en un dispositivo móvil hace clic en un número de teléfono.
GOOGLE_PLAY_DOWNLOAD Son las conversiones que se producen cuando un usuario descarga una aplicación para dispositivos móviles desde Google Play Store.
GOOGLE_PLAY_IN_APP_PURCHASE Son las conversiones que se producen cuando un usuario realiza una compra en una aplicación a través de la facturación de Android.
UPLOAD_CALLS Son las conversiones de llamadas que el anunciante realiza un seguimiento y sube.
UPLOAD_CLICKS Son las conversiones de las que el anunciante hace un seguimiento y que se suben con clics atribuidos.
WEBPAGE Son las conversiones que se producen en una página web.
WEBSITE_CALL Son las conversiones que se producen cuando un usuario llama a un número de teléfono generado de forma dinámica desde el sitio web de un anunciante.
STORE_SALES_DIRECT_UPLOAD Conversión de Ventas en la tienda basada en cargas de datos del comercio de origen o de terceros Solo los clientes incluidos en la lista de entidades permitidas pueden usar los tipos de carga directa de ventas en la tienda.
STORE_SALES Conversión de ventas en la tienda basada en cargas de datos de comercios de origen o de terceros, o bien en compras en la tienda con tarjetas de redes de pago Solo los clientes incluidos en la lista de entidades permitidas pueden usar los tipos de ventas en la tienda. Solo lectura.
FIREBASE_ANDROID_FIRST_OPEN Son las conversiones de primer acceso a la aplicación para Android que se registran a través de Firebase.
FIREBASE_ANDROID_IN_APP_PURCHASE Son las conversiones por compras directas desde la app para Android a las que se realiza un seguimiento a través de Firebase.
FIREBASE_ANDROID_CUSTOM Son las conversiones personalizadas de aplicaciones para Android de las que se realiza un seguimiento a través de Firebase.
FIREBASE_IOS_FIRST_OPEN Son las conversiones de primer acceso a la app para iOS de las que se realiza un seguimiento a través de Firebase.
FIREBASE_IOS_IN_APP_PURCHASE Se hace un seguimiento de las conversiones por compras directas desde la app para iOS a través de Firebase.
FIREBASE_IOS_CUSTOM Son las conversiones personalizadas de aplicaciones para iOS de las que se realiza un seguimiento a través de Firebase.
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN Conversiones de primer acceso a la app para Android registradas a través de estadísticas de aplicaciones de terceros.
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE Se hace un seguimiento de las conversiones por compras integradas en la app para Android a través de estadísticas de aplicaciones de terceros.
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM Son las conversiones personalizadas de apps para Android de las que se realiza un seguimiento a través de estadísticas de aplicaciones de terceros.
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN Se hace un seguimiento de las conversiones de primer acceso a la app para iOS a través de las estadísticas de aplicaciones de terceros.
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE Se hace un seguimiento de las conversiones por compras directas desde la app para iOS a través de estadísticas de aplicaciones de terceros.
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM Son las conversiones personalizadas de aplicaciones para iOS de las que se realiza un seguimiento a través de estadísticas de aplicaciones de terceros.
ANDROID_APP_PRE_REGISTRATION Son las conversiones que se producen cuando un usuario se registra previamente para descargar una app para dispositivos móviles desde Google Play Store. Solo lectura.
ANDROID_INSTALLS_ALL_OTHER_APPS Son las conversiones que hacen un seguimiento de todas las descargas de Google Play que no se registran con un tipo específico de aplicación. Solo lectura.
FLOODLIGHT_ACTION Actividad de Floodlight que registra la cantidad de veces que los usuarios visitaron una página web específica después de ver uno de los anuncios de un anunciante o hacer clic en él. Solo lectura.
FLOODLIGHT_TRANSACTION Actividad de Floodlight que hace un seguimiento de la cantidad de ventas realizadas o de artículos comprados. También puedes registrar el valor total de cada venta. Solo lectura.
GOOGLE_HOSTED Son las conversiones que hacen un seguimiento de las acciones locales de los productos y servicios de Google después de interactuar con un anuncio. Solo lectura.
LEAD_FORM_SUBMIT Se registran las conversiones cuando un usuario envía un formulario de clientes potenciales. Solo lectura.
SALESFORCE

Obsoleto: La integración de Salesforce finalizó el 31 de mayo de 2025. Consulta las preguntas frecuentes sobre la actualización de la integración heredada de Salesforce para las conversiones.

SEARCH_ADS_360 Son las conversiones importadas de los datos de Floodlight de Search Ads 360. Solo lectura.
SMART_CAMPAIGN_AD_CLICKS_TO_CALL Son las conversiones por llamada que se producen en los anuncios de las campañas inteligentes sin configuración del seguimiento de llamadas, a través de los criterios personalizados de las campañas inteligentes. Solo lectura.
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL El usuario hace clic en un elemento de llamada en Google Maps. Solo para campañas inteligentes. Solo lectura.
SMART_CAMPAIGN_MAP_DIRECTIONS El usuario solicita instrucciones sobre cómo llegar a la ubicación de una empresa en Google Maps. Solo para campañas inteligentes. Solo lectura.
SMART_CAMPAIGN_TRACKED_CALLS Son las conversiones de llamadas que se producen en los anuncios de las campañas inteligentes con la configuración del seguimiento de llamadas, utilizando los criterios personalizados de las campañas inteligentes. Solo lectura.
STORE_VISITS Son las conversiones que se producen cuando un usuario visita una tienda minorista de un anunciante. Solo lectura.
WEBPAGE_CODELESS Son las conversiones creadas a partir de eventos del sitio web (como envíos de formularios o cargas de páginas) que no utilizan fragmentos de eventos codificados de forma individual. Solo lectura.
UNIVERSAL_ANALYTICS_GOAL Son las conversiones que provienen de los objetivos vinculados de Universal Analytics.
UNIVERSAL_ANALYTICS_TRANSACTION Son las conversiones que provienen de transacciones de Universal Analytics vinculadas.
GOOGLE_ANALYTICS_4_CUSTOM Son las conversiones que provienen de las conversiones de eventos personalizados de Google Analytics 4 vinculados.
GOOGLE_ANALYTICS_4_PURCHASE Son las conversiones que provienen de las conversiones por compra de Google Analytics 4 vinculadas.

ConversionActionCategory

Es la categoría de conversiones asociadas a un objeto ConversionAction.

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
DEFAULT Es la categoría predeterminada.
PAGE_VIEW El usuario visita una página.
PURCHASE Evento de compra, venta o "pedido realizado".
SIGNUP Acción del usuario de registro.
LEAD Es una acción que genera clientes potenciales.
DOWNLOAD Acción de descarga de software (como para una app).
ADD_TO_CART Es la acción de agregar artículos a un carrito de compras o una bolsa en el sitio de un anunciante.
BEGIN_CHECKOUT Cuando alguien ingresa al proceso de confirmación de compra en el sitio de un anunciante
SUBSCRIBE_PAID Es el inicio de una suscripción pagada a un producto o servicio.
PHONE_CALL_LEAD Es una llamada para indicar interés en la oferta de un anunciante.
IMPORTED_LEAD Es una conversión de cliente potencial que se importó desde una fuente externa a Google Ads.
SUBMIT_LEAD_FORM Envío de un formulario en el sitio de un anunciante que indica interés comercial.
BOOK_APPOINTMENT Es la reserva de una cita con la empresa de un anunciante.
REQUEST_QUOTE Es una solicitud de cotización o estimación de precios.
GET_DIRECTIONS Búsqueda de la ubicación de la empresa de un anunciante con intención de visitarla
OUTBOUND_CLICK Es un clic en el sitio de un socio del anunciante.
CONTACT Una llamada, un SMS, un correo electrónico, un chat o cualquier otro tipo de contacto con un anunciante
ENGAGEMENT Un evento de interacción en el sitio web, como un tiempo prolongado en el sitio o un objetivo inteligente de Google Analytics (GA). Se diseñó para usarse en las importaciones de objetivos de GA, Firebase y GA Gold.
STORE_VISIT Visita a la ubicación de una tienda física
STORE_SALE Es una venta que se produce en una tienda física.
QUALIFIED_LEAD Es una conversión de cliente potencial que se importó de una fuente externa a Google Ads y que el anunciante (equipo de marketing o ventas) calificó aún más. En el recorrido del lead hasta la venta, los anunciantes obtienen clientes potenciales y, luego, se comunican con el consumidor para tomar medidas. Si el consumidor está interesado y es posible que termine comprando su producto, el anunciante marca esos clientes potenciales como "clientes potenciales calificados".
CONVERTED_LEAD Es una conversión de cliente potencial que se importó de una fuente externa a Google Ads y que completó una etapa elegida, según la define el anunciante de generación de clientes potenciales.

ValueSettings

Es la configuración relacionada con el valor de los eventos de conversión asociados a esta acción de conversión.

Representación JSON
{
  "defaultValue": number,
  "defaultCurrencyCode": string,
  "alwaysUseDefaultValue": boolean
}
Campos
defaultValue

number

Es el valor que se usará cuando los eventos de conversión de esta acción de conversión se envíen con un valor no válido, no permitido o faltante, o cuando esta acción de conversión esté configurada para usar siempre el valor predeterminado.

defaultCurrencyCode

string

Es el código de moneda que se usará cuando los eventos de conversión de esta acción de conversión se envíen con un código de moneda no válido o faltante, o cuando esta acción de conversión esté configurada para usar siempre el valor predeterminado.

alwaysUseDefaultValue

boolean

Controla si se usan el valor predeterminado y el código de moneda predeterminado en lugar del valor y el código de moneda especificados en los eventos de conversión para esta acción de conversión.

AttributionModelSettings

Es la configuración relacionada con el modelo de atribución de esta acción de conversión.

Representación JSON
{
  "attributionModel": enum (AttributionModel),
  "dataDrivenModelStatus": enum (DataDrivenModelStatus)
}
Campos
attributionModel

enum (AttributionModel)

Es el tipo de modelo de atribución de esta acción de conversión.

dataDrivenModelStatus

enum (DataDrivenModelStatus)

Es el estado del modelo de atribución basada en datos para la acción de conversión.

AttributionModel

Es el modelo de atribución que describe cómo distribuir el crédito de una conversión específica entre muchas interacciones previas posibles.

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
EXTERNAL Utiliza la atribución externa.
GOOGLE_ADS_LAST_CLICK Atribuye todo el crédito de una conversión a su último clic.
GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK Atribuye todo el crédito de una conversión a su primer clic con la atribución de la Búsqueda de Google.
GOOGLE_SEARCH_ATTRIBUTION_LINEAR Atribuye el crédito de una conversión de forma equitativa a todos sus clics con la atribución de la Búsqueda de Google.
GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY Atribuye exponencialmente más crédito por una conversión a sus clics más recientes con la atribución de la Búsqueda de Google (la semivida es de 1 semana).
GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED Atribuye el 40% del crédito de una conversión a su primer y último clic. El 20% restante se distribuye de manera uniforme entre todos los demás clics. Esto usa la atribución de la Búsqueda de Google.
GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN Es un modelo flexible que utiliza el aprendizaje automático para determinar la distribución adecuada del crédito entre los clics con la atribución de la Búsqueda de Google.

DataDrivenModelStatus

Enumera los estados del modelo basado en datos.

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
AVAILABLE El modelo basado en datos está disponible.
STALE El modelo basado en datos está desactualizado. No se actualizó en los últimos 7 días. Se sigue usando, pero vencerá si no se actualiza en 30 días.
EXPIRED El modelo basado en datos venció. No se actualizó en los últimos 30 días y no se puede usar. Por lo general, esto se debe a que no se registró la cantidad requerida de eventos en un período reciente de 30 días.
NEVER_GENERATED Nunca se generó el modelo basado en datos. Por lo general, esto se debe a que nunca hubo la cantidad requerida de eventos en ningún período de 30 días.

FloodlightSettings

Es la configuración relacionada con una acción de conversión de Floodlight.

Representación JSON
{
  "activityGroupTag": string,
  "activityTag": string,
  "activityId": string
}
Campos
activityGroupTag

string

Es la cadena que se usa para identificar un grupo de actividades de Floodlight cuando se informan las conversiones.

activityTag

string

Cadena que se usa para identificar una actividad de Floodlight cuando se informan las conversiones.

activityId

string (int64 format)

ID de la actividad de Floodlight en DoubleClick Campaign Manager (DCM).

ConversionCustomVariable

Es una variable personalizada de conversión. Consulta "Información sobre las métricas y dimensiones personalizadas de Floodlight en la nueva experiencia de Search Ads 360" en https://support.google.com/sa360/answer/13567857

Representación JSON
{
  "resourceName": string,
  "id": string,
  "name": string,
  "tag": string,
  "status": enum (ConversionCustomVariableStatus),
  "ownerCustomer": string,
  "family": enum (ConversionCustomVariableFamily),
  "cardinality": enum (ConversionCustomVariableCardinality),
  "floodlightConversionCustomVariableInfo": {
    object (FloodlightConversionCustomVariableInfo)
  },
  "customColumnIds": [
    string
  ]
}
Campos
resourceName

string

Es el nombre del recurso de la variable personalizada de conversión. Los nombres de los recursos de las variables personalizadas de conversión tienen el siguiente formato:

customers/{customerId}/conversionCustomVariables/{conversion_custom_variable_id}

id

string (int64 format)

Es el ID de la variable personalizada de conversión.

name

string

Obligatorio. Es el nombre de la variable personalizada de conversión. El nombre debe ser único. La longitud máxima del nombre es de 100 caracteres. No debe haber espacios adicionales antes ni después.

tag

string

Obligatorio. Es la etiqueta de la variable personalizada de conversión. La etiqueta debe ser única y constar de un carácter "u" seguido directamente de un número menor o igual a 100. Por ejemplo, “u4”.

status

enum (ConversionCustomVariableStatus)

Es el estado de la variable personalizada de conversión para la acumulación de eventos de conversión.

ownerCustomer

string

Es el nombre del recurso del cliente propietario de la variable personalizada de conversión.

family

enum (ConversionCustomVariableFamily)

Es la familia de la variable personalizada de conversión.

cardinality

enum (ConversionCustomVariableCardinality)

Es la cardinalidad de la variable personalizada de conversión.

floodlightConversionCustomVariableInfo

object (FloodlightConversionCustomVariableInfo)

Son los campos de las variables personalizadas de conversión de Floodlight de Search Ads 360.

customColumnIds[]

string (int64 format)

Son los IDs de las columnas personalizadas que utilizan esta variable personalizada de conversión.

ConversionCustomVariableStatus

Son los estados posibles de una variable personalizada de conversión.

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
ACTIVATION_NEEDED

La variable personalizada de conversión está pendiente de activación y no acumulará estadísticas hasta que se establezca en HABILITADA.

Este estado no se puede usar en las solicitudes CREATE y UPDATE.

ENABLED La variable personalizada de conversión está habilitada y acumulará estadísticas.
PAUSED La variable personalizada de conversión está detenida y no acumulará estadísticas hasta que se vuelva a establecer en ENABLED.

ConversionCustomVariableFamily

Es la familia de una variable personalizada de conversión.

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
STANDARD Es la variable personalizada de conversión estándar. Los clientes deben activar la tarjeta antes de usarla.
FLOODLIGHT Es la variable personalizada de conversión que se importó de una variable personalizada de Floodlight.

ConversionCustomVariableCardinality

Es la cardinalidad de una variable personalizada de conversión.

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
BELOW_ALL_LIMITS La variable personalizada de conversión tiene una cardinalidad inferior a todos los límites. La variable se puede usar para la segmentación, y las estadísticas se pueden acumular para los valores nuevos si la variable está habilitada.
EXCEEDS_SEGMENTATION_LIMIT_BUT_NOT_STATS_LIMIT La variable personalizada de conversión tiene una cardinalidad que supera el límite de segmentación, pero no el límite de estadísticas. La segmentación se inhabilitará, pero se pueden acumular estadísticas para los valores nuevos si la variable está habilitada.
APPROACHES_STATS_LIMIT La variable personalizada de conversión excedió los límites de segmentación y se acerca a los límites de estadísticas (más del 90%). La segmentación se inhabilitará, pero se pueden acumular estadísticas para los valores nuevos si la variable está habilitada.
EXCEEDS_STATS_LIMIT La variable personalizada de conversión superó los límites de segmentación y los límites de estadísticas. Se inhabilitará la segmentación, y las estadísticas de las variables habilitadas solo se podrán acumular si los valores existentes no aumentan aún más la cardinalidad de la variable.

FloodlightConversionCustomVariableInfo

Es información sobre las variables personalizadas de conversión de Floodlight de Search Ads 360.

Representación JSON
{
  "floodlightVariableType": enum (FloodlightVariableType),
  "floodlightVariableDataType": enum (FloodlightVariableDataType)
}
Campos
floodlightVariableType

enum (FloodlightVariableType)

Es el tipo de variable de Floodlight definida en Search Ads 360.

floodlightVariableDataType

enum (FloodlightVariableDataType)

Es el tipo de datos de la variable de Floodlight definida en Search Ads 360.

FloodlightVariableType

Es el tipo de variable de Floodlight, tal como se define en Search Ads 360. Consulta https://support.google.com/searchads/answer/4397154?hl=en para obtener más información.

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
DIMENSION Es el tipo de variable de Floodlight de dimensión.
METRIC Es el tipo de variable de Floodlight de la métrica.
UNSET No se configuró el tipo de variable de Floodlight.

FloodlightVariableDataType

Es el tipo de datos de la variable de Floodlight, tal como se define en Search Ads 360. Consulta https://support.google.com/searchads/answer/4397154?hl=en para obtener más información.

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
NUMBER Representa una variable de Floodlight de tipo "Número". Esta variable se puede asignar a variables de Floodlight de tipo DIMENSION o METRIC.
STRING Representa una variable de Floodlight de tipo "cadena". Esta variable se puede asignar a variables de Floodlight de tipo DIMENSION.

Cliente

Un cliente.

Representación JSON
{
  "resourceName": string,
  "conversionTrackingSetting": {
    object (ConversionTrackingSetting)
  },
  "accountType": enum (AccountType),
  "doubleClickCampaignManagerSetting": {
    object (DoubleClickCampaignManagerSetting)
  },
  "accountStatus": enum (AccountStatus),
  "lastModifiedTime": string,
  "engineId": string,
  "status": enum (CustomerStatus),
  "creationTime": string,
  "managerId": string,
  "managerDescriptiveName": string,
  "subManagerId": string,
  "subManagerDescriptiveName": string,
  "associateManagerId": string,
  "associateManagerDescriptiveName": string,
  "accountLevel": enum (AccountLevelType),
  "id": string,
  "descriptiveName": string,
  "currencyCode": string,
  "timeZone": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,
  "autoTaggingEnabled": boolean,
  "manager": boolean
}
Campos
resourceName

string

Es el nombre del recurso del cliente. Los nombres de recursos del cliente tienen el siguiente formato:

customers/{customerId}

conversionTrackingSetting

object (ConversionTrackingSetting)

Es el parámetro de configuración del seguimiento de conversiones de un cliente.

accountType

enum (AccountType)

Tipo de cuenta de motor, por ejemplo, Google Ads, Microsoft Advertising, Yahoo Japan, Baidu, Facebook, Engine seguimiento de motor, etcétera.

doubleClickCampaignManagerSetting

object (DoubleClickCampaignManagerSetting)

Es el parámetro de configuración de DoubleClick Campaign Manager (DCM) para un cliente administrador.

accountStatus

enum (AccountStatus)

Estado de la cuenta (por ejemplo, Habilitada, Detenida, Quitada, etcétera)

lastModifiedTime

string

La fecha y hora en la que se modificó este cliente por última vez. La fecha y hora se encuentran en la zona horaria del cliente y en el formato “dd-MM-aaaa HH:mm:ss.ssssss”.

engineId

string

ID de la cuenta de la cuenta de motor externa.

status

enum (CustomerStatus)

El estado del cliente.

creationTime

string

La marca de tiempo de la creación de este cliente. La marca de tiempo se encuentra en la zona horaria del cliente y en el formato “dd-MM-aaaa HH:mm:ss”.

managerId

string (int64 format)

Es el ID de cliente del administrador. Un valor de 0 indica que el cliente no tiene un administrador de SA360.

managerDescriptiveName

string

Es el nombre descriptivo de la cuenta de administrador.

subManagerId

string (int64 format)

Es el ID de cliente del subadministrador. Un valor de 0 indica que el cliente no tiene un administrador secundario de SA360.

subManagerDescriptiveName

string

Es el nombre descriptivo del subadministrador.

associateManagerId

string (int64 format)

Es el ID de cliente del administrador asociado. Un valor de 0 indica que el cliente no tiene una cuenta de administrador asociada de SA360.

associateManagerDescriptiveName

string

Es el nombre descriptivo de la cuenta de administrador asociada.

accountLevel

enum (AccountLevelType)

Es el nivel de la cuenta del cliente: Administrador, Subadministrador, Administrador asociado o Cuenta de servicio.

id

string (int64 format)

El ID del cliente.

descriptiveName

string

Nombre descriptivo no único y opcional del cliente.

currencyCode

string

La moneda en la que opera la cuenta. Se admite un subconjunto de códigos de moneda del estándar ISO 4217.

timeZone

string

El ID de la zona horaria local del cliente.

trackingUrlTemplate

string

Es la plantilla de URL para crear una URL de seguimiento a partir de parámetros.

finalUrlSuffix

string

Es la plantilla de URL para agregar parámetros a la URL final.

autoTaggingEnabled

boolean

Indica si el etiquetado automático está habilitado para el cliente.

manager

boolean

Indica si el cliente es un administrador.

ConversionTrackingSetting

Es una colección de parámetros de configuración a nivel del cliente relacionados con el seguimiento de conversiones de Search Ads 360.

Representación JSON
{
  "acceptedCustomerDataTerms": boolean,
  "conversionTrackingStatus": enum (ConversionTrackingStatus),
  "enhancedConversionsForLeadsEnabled": boolean,
  "googleAdsConversionCustomer": string,
  "conversionTrackingId": string,
  "googleAdsCrossAccountConversionTrackingId": string,
  "crossAccountConversionTrackingId": string
}
Campos
acceptedCustomerDataTerms

boolean

Indica si el cliente aceptó las condiciones sobre los datos del cliente. Si se utiliza el seguimiento de conversiones de múltiples cuentas, este valor se hereda de la cuenta de administrador. Este campo es de solo lectura. Para obtener más información, consulta https://support.google.com/adspolicy/answer/7475709.

conversionTrackingStatus

enum (ConversionTrackingStatus)

Es el estado del seguimiento de conversiones. Indica si el cliente utiliza el seguimiento de conversiones y quién es el propietario del seguimiento de conversiones de este cliente. Si este cliente utiliza el seguimiento de conversiones de múltiples cuentas, el valor que se devuelve diferirá según el login-customer-id de la solicitud.

enhancedConversionsForLeadsEnabled

boolean

Indica si el cliente habilitó las conversiones avanzadas de clientes potenciales. Si se utiliza el seguimiento de conversiones de múltiples cuentas, este valor se hereda de la cuenta de administrador. Este campo es de solo lectura.

googleAdsConversionCustomer

string

Es el nombre del recurso del cliente en el que se crean y administran las conversiones. Este campo es de solo lectura.

conversionTrackingId

string (int64 format)

Es el ID del seguimiento de conversiones que se utiliza para esta cuenta. Este ID no indica si el cliente utiliza el seguimiento de conversiones (conversionTrackingStatus sí lo indica). Este campo es de solo lectura.

googleAdsCrossAccountConversionTrackingId

string (int64 format)

Es el ID de seguimiento de conversiones del administrador del cliente. Este parámetro se establece cuando el cliente acepta el seguimiento de conversiones y anula conversionTrackingId. Este campo solo se puede administrar a través de la IU de Google Ads. Este campo es de solo lectura.

crossAccountConversionTrackingId

string (int64 format)

Es el ID de seguimiento de conversiones del administrador del cliente. Se establece cuando el cliente habilita el seguimiento de conversiones de múltiples cuentas y anula conversionTrackingId.

ConversionTrackingStatus

Es el estado del seguimiento de conversiones del cliente.

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
NOT_CONVERSION_TRACKED El cliente no utiliza ningún seguimiento de conversiones.
CONVERSION_TRACKING_MANAGED_BY_SELF Este cliente crea y administra las acciones de conversión.
CONVERSION_TRACKING_MANAGED_BY_THIS_MANAGER Las acciones de conversión son creadas y administradas por la cuenta de administrador especificada en el login-customer-id de la solicitud.
CONVERSION_TRACKING_MANAGED_BY_ANOTHER_MANAGER Las acciones de conversión son creadas y administradas por un administrador diferente del cliente o administrador especificado en el login-customer-id de la solicitud.

AccountType

Son los tipos de cuentas de motor posibles.

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
BAIDU Cuenta de Baidu
ENGINE_TRACK Es la cuenta de seguimiento de motor.
FACEBOOK Cuenta de Facebook
FACEBOOK_GATEWAY Cuenta de Facebook administrada a través de la puerta de enlace.
GOOGLE_ADS Cuenta de Google Ads
MICROSOFT Cuenta de Microsoft Advertising
SEARCH_ADS_360 Cuenta de administrador de Search Ads 360.
YAHOO_JAPAN Cuenta de Yahoo! Japan

DoubleClickCampaignManagerSetting

Es el parámetro de configuración de DoubleClick Campaign Manager (DCM) para un cliente administrador.

Representación JSON
{
  "advertiserId": string,
  "networkId": string,
  "timeZone": string
}
Campos
advertiserId

string (int64 format)

Es el ID del anunciante de Campaign Manager asociado con este cliente.

networkId

string (int64 format)

Es el ID de la red de Campaign Manager asociada con este cliente.

timeZone

string

Zona horaria de la red de Campaign Manager asociada a este cliente en formato de la base de datos de zonas horarias de IANA, como America/New_York.

AccountStatus

Son los estados posibles de una cuenta.

Enums
UNSPECIFIED Valor predeterminado
UNKNOWN Valor desconocido.
ENABLED La cuenta puede publicar anuncios.
PAUSED El usuario desactivó la cuenta.
SUSPENDED La cuenta se desactivó mediante un proceso interno.
REMOVED La cuenta se desactivó de forma irrevocable.
DRAFT La cuenta aún se está configurando y todavía no está HABILITADA.

CustomerStatus

Son los estados posibles de un cliente.

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
ENABLED Indica que la cuenta está activa y puede publicar anuncios.
CANCELED Indica que la cuenta está cancelada y no puede publicar anuncios. Un usuario administrador puede reactivarla.
SUSPENDED Indica que la cuenta está suspendida y no puede publicar anuncios. Solo el equipo de asistencia de Google puede activarlo.
CLOSED Indica que la cuenta está cerrada y no puede publicar anuncios. La cuenta de prueba también tendrá el estado CERRADA. El estado es permanente y no se puede volver a abrir.

AccountLevelType

Es un enum que describe los posibles niveles de la cuenta.

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
CLIENT_ACCOUNT_FACEBOOK Cuenta de cliente (Facebook)
CLIENT_ACCOUNT_GOOGLE_ADS Cuenta de cliente (Google Ads)
CLIENT_ACCOUNT_MICROSOFT Cuenta de cliente (Microsoft)
CLIENT_ACCOUNT_YAHOO_JAPAN Cuenta de cliente (Yahoo Japón)
CLIENT_ACCOUNT_ENGINE_TRACK Cuenta de cliente (seguimiento de motor)
MANAGER Es el administrador de nivel superior.
SUB_MANAGER Subadministrador.
ASSOCIATE_MANAGER Cuenta de administrador asociada

CustomerAsset

Es un vínculo entre un cliente y un activo.

Representación JSON
{
  "resourceName": string,
  "asset": string,
  "status": enum (AssetLinkStatus)
}
Campos
resourceName

string

Es el nombre del recurso del recurso del cliente. Los nombres de recursos de CustomerAsset tienen el siguiente formato:

customers/{customerId}/customerAssets/{assetId}~{fieldType}

asset

string

Obligatorio. El recurso que está vinculado al cliente.

status

enum (AssetLinkStatus)

Es el estado del activo del cliente.

CustomerAssetSet

CustomerAssetSet es la vinculación entre un cliente y un conjunto de recursos. Agregar un CustomerAssetSet vincula un conjunto de recursos con un cliente.

Representación JSON
{
  "resourceName": string,
  "assetSet": string,
  "customer": string,
  "status": enum (AssetSetLinkStatus)
}
Campos
resourceName

string

Es el nombre del recurso del conjunto de recursos del cliente. Los nombres de recursos de los recursos del conjunto de recursos tienen el siguiente formato:

customers/{customerId}/customerAssetSets/{asset_set_id}

assetSet

string

Es el conjunto de recursos que está vinculado al cliente.

customer

string

Es el cliente al que está vinculado este conjunto de recursos.

status

enum (AssetSetLinkStatus)

Es el estado del recurso del conjunto de recursos del cliente. Solo lectura.

AccessibleBiddingStrategy

Representa una vista de los objetos BiddingStrategies que son propiedad del cliente y se comparten con él.

A diferencia de BiddingStrategy, este recurso incluye las estrategias que son propiedad de los administradores del cliente y que se comparten con este cliente, además de las estrategias que son propiedad de este cliente. Este recurso no proporciona métricas y solo expone un subconjunto limitado de los atributos de BiddingStrategy.

Representación JSON
{
  "resourceName": string,
  "id": string,
  "name": string,
  "type": enum (BiddingStrategyType),
  "ownerCustomerId": string,
  "ownerDescriptiveName": string,

  // Union field scheme can be only one of the following:
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  }
  // End of list of possible types for union field scheme.
}
Campos
resourceName

string

Es el nombre del recurso de la estrategia de ofertas accesible. Los nombres de los recursos de AccessibleBiddingStrategy tienen el siguiente formato:

customers/{customerId}/accessibleBiddingStrategies/{biddingStrategyId}

id

string (int64 format)

El ID de la estrategia de ofertas.

name

string

El nombre de la estrategia de ofertas.

type

enum (BiddingStrategyType)

Es el tipo de estrategia de ofertas.

ownerCustomerId

string (int64 format)

Es el ID del cliente propietario de la estrategia de ofertas.

ownerDescriptiveName

string

Es el nombre descriptivo del cliente propietario de la estrategia de ofertas.

Campo de unión scheme. Es el esquema de ofertas.

Solo se puede establecer uno. scheme puede ser una de las siguientes opciones:

maximizeConversionValue

object (MaximizeConversionValue)

Es una estrategia de ofertas automáticas que te ayuda a obtener el mayor valor de conversión posible para tus campañas sin exceder tu presupuesto.

maximizeConversions

object (MaximizeConversions)

Es una estrategia de ofertas automáticas que te ayuda a obtener la mayor cantidad posible de conversiones para tus campañas sin exceder tu presupuesto.

targetCpa

object (TargetCpa)

Es una estrategia de ofertas que establece ofertas para ayudarte a obtener la mayor cantidad posible de conversiones con el costo por adquisición (CPA) objetivo que estableciste.

targetImpressionShare

object (TargetImpressionShare)

Es una estrategia de ofertas que se optimiza automáticamente en función de un porcentaje elegido de impresiones.

targetRoas

object (TargetRoas)

Es una estrategia de ofertas que te ayuda a maximizar los ingresos y, al mismo tiempo, aumentar el promedio de un retorno de la inversión publicitaria objetivo (ROAS) específico.

targetSpend

object (TargetSpend)

Es una estrategia de ofertas que establece tus ofertas para ayudarte a obtener la mayor cantidad posible de clics sin exceder tu presupuesto.

MaximizeConversionValue

Es una estrategia de ofertas automáticas que te ayuda a obtener el mayor valor de conversión posible para tus campañas sin exceder tu presupuesto.

Representación JSON
{
  "targetRoas": number
}
Campos
targetRoas

number

Es la opción de retorno de la inversión publicitaria (ROAS) objetivo. Si se establece, la estrategia de ofertas maximizará los ingresos y, al mismo tiempo, aumentará el promedio del retorno de la inversión publicitaria objetivo. Si el ROAS objetivo es alto, es posible que la estrategia de ofertas no pueda invertir todo el presupuesto. Si no se establece el ROAS objetivo, la estrategia de ofertas intentará alcanzar el ROAS más alto posible para el presupuesto.

MaximizeConversions

Es una estrategia de ofertas automáticas que te ayuda a obtener la mayor cantidad posible de conversiones para tus campañas sin exceder tu presupuesto.

Representación JSON
{
  "targetCpa": string,
  "targetCpaMicros": string
}
Campos
targetCpa

string (int64 format)

La opción de costo por adquisición (CPA) objetivo Este es el importe promedio que deseas invertir por adquisición.

targetCpaMicros

string (int64 format)

La opción de costo por adquisición (CPA) objetivo Este es el importe promedio que deseas invertir por adquisición.

TargetCpa

Es una estrategia de ofertas automáticas que establece ofertas para ayudarte a obtener la mayor cantidad posible de conversiones con el costo por adquisición (CPA) objetivo que estableciste.

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

string (int64 format)

Objetivo de CPA promedio. Este objetivo debe ser mayor o igual que la unidad facturable mínima según la moneda de la cuenta.

TargetImpressionShare

Es una estrategia de ofertas automáticas que establece ofertas para que un determinado porcentaje de los anuncios de búsqueda se muestren en la parte superior de la primera página (o en otra ubicación objetivo).

Representación JSON
{
  "location": enum (TargetImpressionShareLocation),
  "locationFractionMicros": string,
  "cpcBidCeilingMicros": string
}
Campos
location

enum (TargetImpressionShareLocation)

Es la ubicación objetivo en la página de resultados de búsqueda.

locationFractionMicros

string (int64 format)

Es la fracción elegida de anuncios que se mostrarán en la ubicación objetivo, expresada en micro unidades. Por ejemplo, el 1% equivale a 10,000.

cpcBidCeilingMicros

string (int64 format)

La oferta de CPC más alta que el sistema de ofertas automáticas puede especificar. Este es un campo obligatorio que ingresa el anunciante que establece el límite máximo y se especifica en micros locales.

TargetRoas

Es una estrategia de ofertas automáticas que te ayuda a maximizar los ingresos y, al mismo tiempo, obtener un promedio de un retorno de la inversión publicitaria objetivo (ROAS) específico.

Representación JSON
{
  "targetRoas": number
}
Campos
targetRoas

number

Los ingresos elegidos (según los datos de conversiones) por unidad de inversión.

TargetSpend

Es una estrategia de ofertas automáticas que establece tus ofertas para ayudarte a obtener la mayor cantidad posible de clics sin exceder tu presupuesto.

Representación JSON
{
  "targetSpendMicros": string,
  "cpcBidCeilingMicros": string
}
Campos
targetSpendMicros
(deprecated)

string (int64 format)

El objetivo de inversión en el que se maximizan los clics. Un ofertante de TargetSpend intentará gastar la menor cantidad de este valor o el importe de inversión de regulación natural. Si no se especifica, el presupuesto se utiliza como el objetivo de inversión. Este campo está obsoleto y ya no se debe usar. Consulta https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html para obtener más detalles.

cpcBidCeilingMicros

string (int64 format)

El límite de oferta máximo que se puede establecer con la estrategia de ofertas. El límite se aplica a todas las palabras clave administradas por la estrategia.

ManagerLinkStatus

Son los posibles estados de un vínculo.

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
ACTIVE Indica la relación vigente actual
INACTIVE Indica que la relación finalizó
PENDING Indica que el administrador solicitó la relación, pero el cliente aún no la aceptó.
REFUSED El administrador solicitó la relación, pero el cliente la rechazó.
CANCELED Indica que el administrador solicitó la relación, pero la canceló.

CustomerClient

Es un vínculo entre el cliente determinado y un cliente de cliente. Los objetos CustomerClient solo existen para los clientes administradores. Se incluyen todos los clientes directos e indirectos, así como el administrador.

Representación JSON
{
  "resourceName": string,
  "appliedLabels": [
    string
  ],
  "status": enum (CustomerStatus),
  "clientCustomer": string,
  "hidden": boolean,
  "level": string,
  "timeZone": string,
  "testAccount": boolean,
  "manager": boolean,
  "descriptiveName": string,
  "currencyCode": string,
  "id": string
}
Campos
resourceName

string

Es el nombre del recurso del cliente. Los nombres de recursos de CustomerClient tienen el siguiente formato: customers/{customerId}/customerClients/{client_customer_id}

appliedLabels[]

string

Son los nombres de los recursos de las etiquetas que son propiedad del cliente solicitante y que se aplican al cliente. Los nombres de los recursos de etiquetas tienen el siguiente formato:

customers/{customerId}/labels/{label_id}

status

enum (CustomerStatus)

Es el estado del cliente. Solo lectura.

clientCustomer

string

Es el nombre del recurso del cliente-cliente que está vinculado al cliente determinado. Solo lectura.

hidden

boolean

Especifica si esta es una cuenta oculta.

Solo lectura.

level

string (int64 format)

Es la distancia entre el cliente y el cliente potencial determinados. Para la vinculación propia, el valor del nivel será 0. Solo lectura.

timeZone

string

Representación de cadena del Common Locale Data Repository (CLDR) de la zona horaria del cliente, por ejemplo, America/Los_Angeles. Solo lectura.

testAccount

boolean

Identifica si el cliente es una cuenta de prueba. Solo lectura.

manager

boolean

Identifica si el cliente es un administrador. Solo lectura.

descriptiveName

string

Nombre descriptivo del cliente. Solo lectura.

currencyCode

string

Es el código de moneda (por ejemplo, “USD” o “EUR”) del cliente. Solo lectura.

id

string (int64 format)

Es el ID del cliente. Solo lectura.

DynamicSearchAdsSearchTermView

Es una vista de los términos de búsqueda de los anuncios dinámicos de búsqueda.

Representación JSON
{
  "resourceName": string,
  "landingPage": string
}
Campos
resourceName

string

Es el nombre del recurso de la vista del término de búsqueda de los anuncios dinámicos de búsqueda. Los nombres de los recursos de la vista de términos de búsqueda de los anuncios de búsqueda dinámicos tienen el siguiente formato:

customers/{customerId}/dynamicSearchAdsSearchTermViews/{adGroupId}~{search_term_fingerprint}~{headline_fingerprint}~{landing_page_fingerprint}~{page_url_fingerprint}

landingPage

string

Es la URL de la página de destino de la impresión, seleccionada de forma dinámica.

Este campo es de solo lectura.

GenderView

Es un recurso de vista de género. Representa la vista de las métricas de rendimiento de un cliente agregadas por género. Todas las estadísticas se agregan a nivel del grupo de anuncios.

Nota: Si bien puedes segmentar las métricas por rango de edad con ageRangeView o por género con genderView, la API de Search Ads 360 no admite la segmentación de métricas por rango de edad y género de forma simultánea en una sola consulta. El análisis del rendimiento en ambas dimensiones combinadas no se admite en la API de Search Ads 360.

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

string

Es el nombre del recurso de la vista de género. Los nombres de los recursos de la vista de género tienen el siguiente formato:

customers/{customerId}/genderViews/{adGroupId}~{criterionId}

GeoTargetConstant

Es una constante de segmentación geográfica.

Representación JSON
{
  "resourceName": string,
  "status": enum (GeoTargetConstantStatus),
  "id": string,
  "name": string,
  "countryCode": string,
  "targetType": string,
  "canonicalName": string,
  "parentGeoTarget": string
}
Campos
resourceName

string

Es el nombre del recurso de la constante de segmentación geográfica. Los nombres de recursos de las constantes de segmentación geográfica tienen el siguiente formato:

geoTargetConstants/{geo_target_constant_id}

status

enum (GeoTargetConstantStatus)

Es el estado de la constante de segmentación geográfica.

id

string (int64 format)

Es el ID de la constante de segmentación geográfica.

name

string

Es el nombre en inglés de la constante de segmentación geográfica.

countryCode

string

Es el código de país ISO-3166-1 alpha-2 asociado con el objetivo.

targetType

string

Es el tipo de objetivo de la constante de segmentación geográfica.

canonicalName

string

Es el nombre en inglés completamente calificado, que consta del nombre del objetivo y el de su elemento superior y país.

parentGeoTarget

string

Es el nombre del recurso de la constante de segmentación geográfica principal. Los nombres de recursos de las constantes de segmentación geográfica tienen el siguiente formato:

geoTargetConstants/{parent_geo_target_constant_id}

GeoTargetConstantStatus

Son los estados posibles de una constante de segmentación geográfica.

Enums
UNSPECIFIED No se especificó ningún valor.
UNKNOWN

El valor recibido no se conoce en esta versión.

Este es un valor de solo respuesta.

ENABLED La constante de segmentación geográfica es válida.
REMOVAL_PLANNED La constante de segmentación geográfica es obsoleta y se quitará.

KeywordView

Una vista de palabras clave

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

string

Es el nombre del recurso de la vista de palabra clave. Los nombres de los recursos de la vista de palabras clave tienen el siguiente formato:

customers/{customerId}/keywordViews/{adGroupId}~{criterionId}

Etiqueta

Es una etiqueta.

Representación JSON
{
  "resourceName": string,
  "status": enum (LabelStatus),
  "textLabel": {
    object (TextLabel)
  },
  "id": string,
  "name": string
}
Campos
resourceName

string

Nombre del recurso. Los nombres de recursos de las etiquetas tienen el siguiente formato: customers/{ownerCustomerId}/labels/{label_id}

status

enum (LabelStatus)

Es el estado de la etiqueta. Solo lectura.

textLabel

object (TextLabel)

Es un tipo de etiqueta que muestra texto sobre un fondo de color.

id

string (int64 format)

Es el ID de la etiqueta. Solo lectura.

name

string

Es el nombre de la etiqueta.

Este campo es obligatorio y no debe estar vacío cuando se crea una etiqueta nueva.

La longitud de esta cadena debe ser entre 1 y 80, inclusive.

LabelStatus

Son los estados posibles de una etiqueta.

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
ENABLED La etiqueta está habilitada.
REMOVED Se quitó la etiqueta.

TextLabel

Es un tipo de etiqueta que muestra texto sobre un fondo de color.

Representación JSON
{
  "backgroundColor": string,
  "description": string
}
Campos
backgroundColor

string

Color de fondo de la etiqueta en formato hexadecimal. Esta cadena debe coincidir con la expresión regular "^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$". Nota: Es posible que el color de fondo no sea visible para las cuentas de administrador.

description

string

Es una breve descripción de la etiqueta. La longitud no debe superar los 200 caracteres.

LanguageConstant

Un idioma

Representación JSON
{
  "resourceName": string,
  "id": string,
  "code": string,
  "name": string,
  "targetable": boolean
}
Campos
resourceName

string

Es el nombre del recurso de la constante de idioma. Los nombres de recursos de las constantes de idioma tienen el siguiente formato:

languageConstants/{criterionId}

id

string (int64 format)

Es el ID de la constante de idioma.

code

string

Es el código de idioma, por ejemplo, "en_US", "en_AU", "es", "fr", etcétera.

name

string

Nombre completo del idioma en inglés, por ejemplo, "Inglés (EE.UU.)", "Español", etcétera.

targetable

boolean

Indica si el idioma se puede segmentar.

LocationView

Una vista de ubicación resume el rendimiento de las campañas según un criterio de ubicación.

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

string

Es el nombre del recurso de la vista de ubicación. Los nombres de los recursos de la vista de ubicación tienen el siguiente formato:

customers/{customerId}/locationViews/{campaignId}~{criterionId}

ProductBiddingCategoryConstant

Es una categoría de ofertas de productos.

Representación JSON
{
  "resourceName": string,
  "level": enum (ProductBiddingCategoryLevel),
  "status": enum (ProductBiddingCategoryStatus),
  "id": string,
  "countryCode": string,
  "productBiddingCategoryConstantParent": string,
  "languageCode": string,
  "localizedName": string
}
Campos
resourceName

string

Es el nombre del recurso de la categoría de ofertas de productos. Los nombres de los recursos de las categorías de ofertas de productos tienen el siguiente formato:

productBiddingCategoryConstants/{countryCode}~{level}~{id}

level

enum (ProductBiddingCategoryLevel)

Es el nivel de la categoría de oferta del producto.

status

enum (ProductBiddingCategoryStatus)

Es el estado de la categoría de ofertas del producto.

id

string (int64 format)

Es el ID de la categoría de ofertas del producto.

Este ID es equivalente al ID de google_product_category, como se describe en este artículo: https://support.google.com/merchants/answer/6324436.

countryCode

string

Es el código de país de dos letras en mayúsculas de la categoría de ofertas del producto.

productBiddingCategoryConstantParent

string

Es el nombre del recurso de la categoría de oferta de producto principal.

languageCode

string

Es el código de idioma de la categoría de oferta del producto.

localizedName

string

Es el valor visible de la categoría de oferta del producto, localizado según languageCode.

ProductBiddingCategoryLevel

Es una enumeración que describe el nivel de la categoría de oferta del producto.

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
LEVEL1 Nivel 1.
LEVEL2 Nivel 2.
LEVEL3 Nivel 3.
LEVEL4 Nivel 4.
LEVEL5 Nivel 5

ProductBiddingCategoryStatus

Es una enumeración que describe el estado de la categoría de ofertas del producto.

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
ACTIVE La categoría está activa y se puede usar para establecer ofertas.
OBSOLETE La categoría está obsoleta. Solo se usa para generar informes.

ProductGroupView

Es una vista del grupo de productos.

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

string

El nombre del recurso de la vista del grupo de productos. Los nombres de los recursos de la vista del grupo de productos tienen el siguiente formato:

customers/{customerId}/productGroupViews/{adGroupId}~{criterionId}

ShoppingPerformanceView

Es la vista del rendimiento de Shopping.

Proporciona estadísticas de las campañas de Shopping y de máximo rendimiento agregadas en varios niveles de dimensiones del producto. Los valores de la dimensión del producto de Merchant Center, como la marca, la categoría, los atributos personalizados, el estado del producto y el tipo de producto, reflejarán el estado de cada dimensión en la fecha y hora en que se registró el evento correspondiente.

La cantidad de impresiones y clics para los que shoppingPerformanceView devuelve estadísticas puede ser diferente de la de los informes de campañas. shoppingPerformanceView muestra las impresiones y los clics en los productos que aparecen en los anuncios, mientras que los informes de la campaña muestran las impresiones y los clics en los anuncios propiamente dichos. Según el formato, un anuncio puede mostrar de cero a varios productos, por lo que es posible que las cifras no coincidan.

En la IU de Search Ads 360, puedes consultar las impresiones y los clics de los productos que aparecen en los anuncios seleccionando una columna de "Atributos del producto" en el editor de informes. Por ejemplo, seleccionar la columna "Marca" equivale a seleccionar segments.product_brand.

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

string

Es el nombre del recurso de la vista de rendimiento de Shopping. Los nombres de los recursos de la vista del rendimiento de las compras tienen el siguiente formato: customers/{customerId}/shoppingPerformanceView

UserList

Es una lista de usuarios. Es una lista de usuarios a los que un cliente puede segmentar sus anuncios. La clave única de una lista de usuarios consta de los siguientes campos: id. Ten en cuenta que el name también debe ser único para las listas de usuarios que pertenecen a un cliente determinado, excepto en algunos casos en los que accessReason se establece en SHARED. Si se incumple la restricción de nombre único, se produce el error UserListError.INVALID_NAME.

Representación JSON
{
  "resourceName": string,
  "type": enum (UserListType),
  "id": string,
  "name": string
}
Campos
resourceName

string

Es el nombre del recurso de la lista de usuarios. Los nombres de recursos de las listas de usuarios tienen el siguiente formato:

customers/{customerId}/userLists/{userListId}

type

enum (UserListType)

Es el tipo de esta lista.

Este campo es de solo lectura.

id

string (int64 format)

Es el ID de la lista de usuarios.

name

string

Es el nombre de esta lista de usuarios. Es único por lista de usuarios, excepto en algunos casos en los que una lista de usuarios con el mismo nombre tiene accessReason establecido en SHARED.

UserListType

Es una enumeración que contiene los posibles tipos de listas de usuarios.

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
REMARKETING UserList representado como una colección de tipos de conversión.
LOGICAL Es una UserList representada como una combinación de otras listas de usuarios o intereses.
EXTERNAL_REMARKETING Es la lista de usuarios creada en la plataforma de Google Ad Manager.
RULE_BASED Es la UserList asociada a una regla.
SIMILAR Es una UserList que incluye usuarios similares a los de otra UserList.
CRM_BASED Es la lista de datos de CRM de origen que proporciona el anunciante en forma de correos electrónicos o en otros formatos.

UserLocationView

Es una vista de la ubicación del usuario.

La vista Ubicación del usuario incluye todas las métricas agregadas a nivel del país, con una fila por país. Registra las métricas en la ubicación física real del usuario, ya sea una ubicación de segmentación o no. Si se usan otros campos de segmento, es posible que obtengas más de una fila por país.

Representación JSON
{
  "resourceName": string,
  "countryCriterionId": string,
  "targetingLocation": boolean
}
Campos
resourceName

string

Es el nombre del recurso de la vista de ubicación del usuario. Los nombres de los recursos de la vista UserLocation tienen el siguiente formato:

customers/{customerId}/userLocationViews/{countryCriterionId}~{targetingLocation}

countryCriterionId

string (int64 format)

Es el ID del criterio para el país.

targetingLocation

boolean

Indica si se segmentó la ubicación o no.

WebpageView

Es la visualización de una página web.

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

string

Es el nombre del recurso de la vista de la página web. Los nombres de los recursos de la vista de página web tienen el siguiente formato:

customers/{customerId}/webpageViews/{adGroupId}~{criterionId}

Visitar

Una visita

Representación JSON
{
  "resourceName": string,
  "id": string,
  "criterionId": string,
  "merchantId": string,
  "adId": string,
  "clickId": string,
  "visitDateTime": string,
  "productId": string,
  "productChannel": enum (ProductChannel),
  "productLanguageCode": string,
  "productStoreId": string,
  "productCountryCode": string,
  "assetId": string,
  "assetFieldType": enum (AssetFieldType)
}
Campos
resourceName

string

Es el nombre del recurso de la visita. Los nombres de los recursos de visitas tienen el siguiente formato:

customers/{customerId}/visits/{adGroupId}~{criterionId}~{ds_visit_id}

id

string (int64 format)

Es el ID de la visita.

criterionId

string (int64 format)

ID de palabra clave de Search Ads 360. Un valor de 0 indica que la palabra clave no tiene atributo.

merchantId

string (int64 format)

El ID de cuenta de inventario de Search Ads 360 que contiene el producto en el que se hizo clic. Search Ads 360 genera este ID cuando vincula una cuenta de inventario en Search Ads 360.

adId

string (int64 format)

ID del anuncio Un valor de 0 indica que el anuncio no se atribuye.

clickId

string

Una string única para cada visita que se pasa a la página de destino como el parámetro de URL de ID de clic

visitDateTime

string

La marca de tiempo del evento de visita. La marca de tiempo se encuentra en la zona horaria del cliente y en el formato “dd-MM-aaaa HH:mm:ss”.

productId

string

El ID del producto en el que se hizo clic.

productChannel

enum (ProductChannel)

El canal de ventas del producto en el que se hizo clic: en línea o local.

productLanguageCode

string

El idioma (ISO-639-1) que se configuró para el feed de Merchant Center que contiene datos sobre el producto.

productStoreId

string

Indica la tienda del anuncio del inventario local en el que se hizo clic. Debe coincidir con los IDs de tienda que se usan en el feed de productos locales.

productCountryCode

string

Indica el país (formato ISO-3166) registrado para el feed de inventario que contiene el producto en el que se hizo clic.

assetId

string (int64 format)

Es el ID del recurso con el que se interactuó durante el evento de visita.

assetFieldType

enum (AssetFieldType)

Es el tipo de campo del recurso del evento de visita.

ProductChannel

Es una enumeración que describe la localidad de una oferta de producto.

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
ONLINE El artículo se vende en línea.
LOCAL El artículo se vende en tiendas locales.

Conversión

Una conversión

Representación JSON
{
  "resourceName": string,
  "id": string,
  "criterionId": string,
  "merchantId": string,
  "adId": string,
  "clickId": string,
  "visitId": string,
  "advertiserConversionId": string,
  "productId": string,
  "productChannel": enum (ProductChannel),
  "productLanguageCode": string,
  "productStoreId": string,
  "productCountryCode": string,
  "attributionType": enum (AttributionType),
  "conversionDateTime": string,
  "conversionLastModifiedDateTime": string,
  "conversionVisitDateTime": string,
  "conversionQuantity": string,
  "conversionRevenueMicros": string,
  "floodlightOriginalRevenue": string,
  "floodlightOrderId": string,
  "status": enum (ConversionStatus),
  "assetId": string,
  "assetFieldType": enum (AssetFieldType)
}
Campos
resourceName

string

Es el nombre del recurso de la conversión. Los nombres de los recursos de conversión tienen el siguiente formato:

customers/{customerId}/conversions/{adGroupId}~{criterionId}~{ds_conversion_id}

id

string (int64 format)

El ID de la conversión.

criterionId

string (int64 format)

ID de criterio de Search Ads 360. Un valor de 0 indica que el criterio no se atribuye.

merchantId

string (int64 format)

El ID de cuenta de inventario de Search Ads 360 que contiene el producto en el que se hizo clic. Search Ads 360 genera este ID cuando vincula una cuenta de inventario en Search Ads 360.

adId

string (int64 format)

ID del anuncio Un valor de 0 indica que el anuncio no se atribuye.

clickId

string

Es una string única para la visita a la que se atribuye la conversión; esta se pasa a la página de destino como el parámetro de URL de clic de ID.

visitId

string (int64 format)

Es el ID de visita de Search Ads 360 al que se atribuye la conversión.

advertiserConversionId

string

En el caso de las conversiones sin conexión, se trata de un ID que proporcionan los anunciantes. Si un anunciante no especifica ese ID, se genera uno mediante Search Ads 360 En el caso de las conversiones en línea, esto es igual a la columna de ID o a la columna floodlightOrderId según las instrucciones de Floodlight del anunciante.

productId

string

El ID del producto en el que se hizo clic.

productChannel

enum (ProductChannel)

El canal de ventas del producto en el que se hizo clic: en línea o local.

productLanguageCode

string

El idioma (ISO-639-1) que se configuró para el feed de Merchant Center que contiene datos sobre el producto.

productStoreId

string

Indica la tienda del anuncio del inventario local en el que se hizo clic. Debe coincidir con los IDs de tienda que se usan en el feed de productos locales.

productCountryCode

string

Indica el país (formato ISO-3166) registrado para el feed de inventario que contiene el producto en el que se hizo clic.

attributionType

enum (AttributionType)

A qué se atribuye la conversión: visita o palabra clave+anuncio.

conversionDateTime

string

La marca de tiempo del evento de conversión.

conversionLastModifiedDateTime

string

Es la marca de tiempo de la última vez que se modificó la conversión.

conversionVisitDateTime

string

Es la marca de tiempo de la visita a la que se atribuye la conversión.

conversionQuantity

string (int64 format)

La cantidad de artículos que registra la conversión, según lo determinado por el parámetro qty url. El anunciante es responsable de propagar los parámetros de forma dinámica (como la cantidad de artículos que se venden en la conversión). De lo contrario, el valor predeterminado es 1.

conversionRevenueMicros

string (int64 format)

Los ingresos ajustados en micros para el evento de conversión. Siempre se mostrará en la moneda de la cuenta de entrega.

floodlightOriginalRevenue

string (int64 format)

Los ingresos originales sin cambios asociados con el evento de Floodlight (en la moneda del informe actual), antes de las modificaciones de la instrucción de la moneda de Floodlight.

floodlightOrderId

string

Es el ID de pedido de Floodlight que proporciona el anunciante para la conversión.

status

enum (ConversionStatus)

Es el estado de la conversión, HABILITADA o ELIMINADA.

assetId

string (int64 format)

Es el ID del recurso con el que se interactuó durante el evento de conversión.

assetFieldType

enum (AssetFieldType)

Es el tipo de campo del recurso del evento de conversión.

AttributionType

Tipo de atribución de conversión en SearchAds360

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
VISIT La conversión se atribuye a una visita.
CRITERION_AD La conversión se atribuye a un criterio y a un par de anuncios.

ConversionStatus

Son los estados posibles de una conversión.

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
ENABLED La conversión está habilitada.
REMOVED Se quitó la conversión.

Métricas

Son los datos de las métricas.

Representación JSON
{
  "allConversionsValueByConversionDate": number,
  "allConversionsByConversionDate": number,
  "conversionCustomMetrics": [
    {
      object (Value)
    }
  ],
  "conversionsValueByConversionDate": number,
  "conversionsByConversionDate": number,
  "historicalCreativeQualityScore": enum (QualityScoreBucket),
  "historicalLandingPageQualityScore": enum (QualityScoreBucket),
  "historicalSearchPredictedCtr": enum (QualityScoreBucket),
  "interactionEventTypes": [
    enum (InteractionEventType)
  ],
  "rawEventConversionMetrics": [
    {
      object (Value)
    }
  ],
  "absoluteTopImpressionPercentage": number,
  "allConversionsFromInteractionsRate": number,
  "allConversionsValue": number,
  "allConversions": number,
  "allConversionsValuePerCost": number,
  "allConversionsFromClickToCall": number,
  "allConversionsFromDirections": number,
  "allConversionsFromInteractionsValuePerInteraction": number,
  "allConversionsFromMenu": number,
  "allConversionsFromOrder": number,
  "allConversionsFromOtherEngagement": number,
  "allConversionsFromStoreVisit": number,
  "visits": number,
  "allConversionsFromStoreWebsite": number,
  "averageCost": number,
  "averageCpc": number,
  "averageCpm": number,
  "clicks": string,
  "contentBudgetLostImpressionShare": number,
  "contentImpressionShare": number,
  "contentRankLostImpressionShare": number,
  "conversionsFromInteractionsRate": number,
  "clientAccountConversionsValue": number,
  "conversionsValuePerCost": number,
  "conversionsFromInteractionsValuePerInteraction": number,
  "clientAccountConversions": number,
  "costMicros": string,
  "costPerAllConversions": number,
  "costPerConversion": number,
  "costPerCurrentModelAttributedConversion": number,
  "crossDeviceConversions": number,
  "crossDeviceConversionsByConversionDate": number,
  "crossDeviceConversionsValue": number,
  "crossDeviceConversionsValueByConversionDate": number,
  "ctr": number,
  "conversions": number,
  "conversionsValue": number,
  "averageQualityScore": number,
  "historicalQualityScore": string,
  "impressions": string,
  "interactionRate": number,
  "interactions": string,
  "invalidClickRate": number,
  "invalidClicks": string,
  "generalInvalidClickRate": number,
  "generalInvalidClicks": string,
  "mobileFriendlyClicksPercentage": number,
  "searchAbsoluteTopImpressionShare": number,
  "searchBudgetLostAbsoluteTopImpressionShare": number,
  "searchBudgetLostImpressionShare": number,
  "searchBudgetLostTopImpressionShare": number,
  "searchClickShare": number,
  "searchExactMatchImpressionShare": number,
  "searchImpressionShare": number,
  "searchRankLostAbsoluteTopImpressionShare": number,
  "searchRankLostImpressionShare": number,
  "searchRankLostTopImpressionShare": number,
  "searchTopImpressionShare": number,
  "topImpressionPercentage": number,
  "valuePerAllConversions": number,
  "valuePerAllConversionsByConversionDate": number,
  "valuePerConversion": number,
  "valuePerConversionsByConversionDate": number,
  "clientAccountViewThroughConversions": string,
  "orders": number,
  "averageOrderValueMicros": string,
  "averageCartSize": number,
  "costOfGoodsSoldMicros": string,
  "grossProfitMicros": string,
  "grossProfitMargin": number,
  "revenueMicros": string,
  "unitsSold": number,
  "clientAccountCrossSellCostOfGoodsSoldMicros": string,
  "crossSellCostOfGoodsSoldMicros": string,
  "clientAccountCrossSellGrossProfitMicros": string,
  "crossSellGrossProfitMicros": string,
  "clientAccountCrossSellRevenueMicros": string,
  "crossSellRevenueMicros": string,
  "clientAccountCrossSellUnitsSold": number,
  "crossSellUnitsSold": number,
  "clientAccountLeadCostOfGoodsSoldMicros": string,
  "leadCostOfGoodsSoldMicros": string,
  "clientAccountLeadGrossProfitMicros": string,
  "leadGrossProfitMicros": string,
  "clientAccountLeadRevenueMicros": string,
  "leadRevenueMicros": string,
  "clientAccountLeadUnitsSold": number,
  "leadUnitsSold": number,
  "uniqueUsers": string,
  "averageImpressionFrequencyPerUser": number
}
Campos
allConversionsValueByConversionDate

number

El valor de todas las conversiones. Cuando se selecciona esta columna con la fecha, los valores de la columna de fecha significan la fecha de conversión. Los detalles de las columnas by_conversion_date están disponibles en Acerca de la columna "Todas las conversiones".

allConversionsByConversionDate

number

La cantidad total de conversiones. Esto incluye todas las conversiones, independientemente del valor de includeInConversionsMetric. Cuando se selecciona esta columna con la fecha, los valores de la columna de fecha significan la fecha de conversión. Los detalles de las columnas by_conversion_date están disponibles en Acerca de la columna "Todas las conversiones".

conversionCustomMetrics[]

object (Value)

Son las métricas personalizadas de conversiones.

conversionsValueByConversionDate

number

Es la suma del valor de las conversiones aptas para ofertas según la fecha de conversión. Cuando se selecciona esta columna con la fecha, los valores de la columna de fecha significan la fecha de conversión.

conversionsByConversionDate

number

Es la suma de las conversiones por fecha de conversión para los tipos de conversiones aptas para ofertas. Puede ser fraccionaria debido al modelado de atribución. Cuando se selecciona esta columna con la fecha, los valores de la columna de fecha significan la fecha de conversión.

historicalCreativeQualityScore

enum (QualityScoreBucket)

Es el historial del nivel de calidad de la creatividad.

historicalLandingPageQualityScore

enum (QualityScoreBucket)

Es la calidad del historial de experiencia en la página de destino.

historicalSearchPredictedCtr

enum (QualityScoreBucket)

Es el historial de la tasa de clics (CTR) prevista de la búsqueda.

interactionEventTypes[]

enum (InteractionEventType)

Son los tipos de interacciones pagadas y gratuitas.

rawEventConversionMetrics[]

object (Value)

Son las métricas de conversión de eventos sin procesar.

absoluteTopImpressionPercentage

number

El porcentaje de impresiones en la parte superior absoluta de la página de búsqueda es el porcentaje de tus impresiones de anuncios de búsqueda que se muestran en la posición más destacada de la Búsqueda.

allConversionsFromInteractionsRate

number

Son todas las conversiones provenientes de interacciones (a diferencia de las conversiones posimpresión) divididas por la cantidad de interacciones con el anuncio.

allConversionsValue

number

El valor de todas las conversiones.

allConversions

number

La cantidad total de conversiones. Esto incluye todas las conversiones, independientemente del valor de includeInConversionsMetric.

allConversionsValuePerCost

number

Es el valor de todas las conversiones dividido por el costo total de las interacciones con los anuncios (como los clics en anuncios de texto o las vistas de anuncios de video).

allConversionsFromClickToCall

number

Es la cantidad de veces que los usuarios hicieron clic en el botón "Llamar" para llamar a una empresa mientras interactuaban con un anuncio o después de hacerlo. Este número no incluye si se conectó la llamada ni su duración.

Esta métrica solo se aplica a los elementos del feed.

allConversionsFromDirections

number

Indica la cantidad de veces que los usuarios hicieron clic en el botón "Cómo llegar" para navegar a una empresa después de hacer clic en un anuncio.

Esta métrica solo se aplica a los elementos del feed.

allConversionsFromInteractionsValuePerInteraction

number

Es el valor de todas las conversiones provenientes de interacciones dividido por la cantidad total de interacciones.

allConversionsFromMenu

number

Es la cantidad de veces que los usuarios hicieron clic en un vínculo para ver el menú de una empresa después de hacer clic en un anuncio.

Esta métrica solo se aplica a los elementos del feed.

allConversionsFromOrder

number

Es la cantidad de veces que los usuarios realizaron un pedido en una empresa después de hacer clic en un anuncio.

Esta métrica solo se aplica a los elementos del feed.

allConversionsFromOtherEngagement

number

Es la cantidad de otras conversiones (por ejemplo, publicar una opinión o guardar la ubicación de una empresa) que se produjeron después de que los usuarios hicieron clic en un anuncio.

Esta métrica solo se aplica a los elementos del feed.

allConversionsFromStoreVisit

number

Es la cantidad estimada de veces que las personas visitaron una empresa después de hacer clic en un anuncio.

Esta métrica solo se aplica a los elementos del feed.

visits

number

Clics que Search Ads 360 registró y reenvió de forma correcta a la página de destino de un anunciante.

allConversionsFromStoreWebsite

number

Indica la cantidad de veces que los usuarios fueron redirigidos a la URL de una empresa después de hacer clic en un anuncio.

Esta métrica solo se aplica a los elementos del feed.

averageCost

number

Es el importe promedio que pagas por cada interacción. Para obtener este importe, se divide el costo total de tus anuncios por la cantidad total de interacciones.

averageCpc

number

El costo total de todos los clics dividido por la cantidad total de clics recibidos. Esta métrica es un valor monetario y se muestra en la moneda del cliente de forma predeterminada. Consulta el parámetro metrics_currency en la cláusula PARAMETERS.

averageCpm

number

Costo por cada mil impresiones (CPM) promedio. Esta métrica es un valor monetario y se muestra en la moneda del cliente de forma predeterminada. Consulta el parámetro metrics_currency en la cláusula PARAMETERS.

clicks

string (int64 format)

La cantidad de clics.

contentBudgetLostImpressionShare

number

Es el porcentaje estimado de veces que tu anuncio era apto para mostrarse en la Red de Display, pero no lo hizo porque tu presupuesto era demasiado bajo. Nota: El porcentaje de impresiones perdidas del presupuesto de contenido se informa en un rango de 0 a 0.9. Cualquier valor superior a 0.9 se informa como 0.9001.

contentImpressionShare

number

Es la cantidad de impresiones que recibiste en la Red de Display dividida por la cantidad estimada de impresiones que podrías haber recibido.

Nota: El porcentaje de impresiones de contenido se informa en un rango de 0.1 a 1. Cualquier valor inferior a 0.1 se informa como 0.0999.

contentRankLostImpressionShare

number

El porcentaje estimado de impresiones en la Red de Display que no recibieron tus anuncios debido a un ranking del anuncio bajo.

Nota: El porcentaje de impresiones perdidas de clasificación del contenido se informa en un rango de 0 a 0.9. Cualquier valor superior a 0.9 se informa como 0.9001.

conversionsFromInteractionsRate

number

Es la cantidad promedio de conversiones aptas para oferta (provenientes de la interacción) por interacción apta para conversión. Indica la frecuencia promedio con la que una interacción con el anuncio genera una conversión apta para ofertas.

clientAccountConversionsValue

number

El valor de las conversiones de la cuenta de cliente. Esto solo incluye las acciones de conversión que tienen el atributo includeInClientAccountConversionsMetric establecido en true. Si usas ofertas basadas en conversiones, tus estrategias de ofertas se optimizarán para estas conversiones.

conversionsValuePerCost

number

Es el valor de la conversión apta para ofertas dividido por el costo total de las interacciones aptas para conversiones.

conversionsFromInteractionsValuePerInteraction

number

Es el valor de las conversiones provenientes de las interacciones dividido por la cantidad de interacciones con el anuncio. Esto solo incluye las acciones de conversión que tienen el atributo includeInConversionsMetric establecido en true. Si usas ofertas basadas en conversiones, tus estrategias de ofertas se optimizarán para estas conversiones.

clientAccountConversions

number

La cantidad de conversiones de la cuenta de cliente. Esto solo incluye las acciones de conversión que tienen el atributo includeInClientAccountConversionsMetric establecido en true. Si usas ofertas basadas en conversiones, tus estrategias de ofertas se optimizarán para estas conversiones.

costMicros

string (int64 format)

La suma del costo por clic (CPC) y el costo por cada mil impresiones (CPM) durante este período. Esta métrica es un valor monetario y se muestra en la moneda del cliente de forma predeterminada. Consulta el parámetro metrics_currency en la cláusula PARAMETERS para obtener más detalles.

costPerAllConversions

number

Es el costo de las interacciones con anuncios dividido por todas las conversiones.

costPerConversion

number

Es el costo promedio apto para la conversión por conversión apta para ofertas.

costPerCurrentModelAttributedConversion

number

Es el costo de las interacciones con anuncios dividido por las conversiones atribuidas al modelo actual. Esto solo incluye las acciones de conversión que tienen el atributo includeInConversionsMetric establecido en true. Si usas ofertas basadas en conversiones, tus estrategias de ofertas se optimizarán para estas conversiones.

crossDeviceConversions

number

Conversiones que se generan cuando un cliente hace clic en un anuncio en un dispositivo y, luego, genera una conversión en otro dispositivo o navegador. Las conversiones en dispositivos múltiples ya están incluidas en allConversions.

crossDeviceConversionsByConversionDate

number

Es la cantidad de conversiones en dispositivos múltiples por fecha de conversión. Los detalles de las columnas by_conversion_date están disponibles en Acerca de la columna "Todas las conversiones"

crossDeviceConversionsValue

number

Es la suma del valor de las conversiones en dispositivos múltiples.

crossDeviceConversionsValueByConversionDate

number

Es la suma del valor de las conversiones en dispositivos múltiples por fecha de conversión. Los detalles de las columnas by_conversion_date están disponibles en Acerca de la columna "Todas las conversiones"

ctr

number

La cantidad de clics que recibe tu anuncio (clics) dividida por la cantidad de veces que se muestra tu anuncio (impresiones).

conversions

number

La cantidad de conversiones. Esto solo incluye las acciones de conversión que tienen el atributo includeInConversionsMetric como verdadero. Si usas ofertas basadas en conversiones, tus estrategias de ofertas se optimizarán para estas conversiones.

conversionsValue

number

Es la suma de los valores de conversión de las conversiones incluidas en el campo "conversiones". Esta métrica es útil solo si ingresó un valor para sus acciones de conversión.

averageQualityScore

number

Es el nivel de calidad promedio.

historicalQualityScore

string (int64 format)

El historial del nivel de calidad.

impressions

string (int64 format)

Recuento de la frecuencia con la que tu anuncio apareció en una página de resultados de búsqueda o en un sitio web en la Red de Google.

interactionRate

number

Es la frecuencia con la que las personas interactúan con tu anuncio después de que se les muestra. Es la cantidad de interacciones dividida por la cantidad de veces que se muestra tu anuncio.

interactions

string (int64 format)

Es la cantidad de interacciones. Una interacción es la acción principal del usuario asociada a un formato de anuncio, es decir, los clics en los anuncios de texto y de Shopping, las vistas de los anuncios de video, etcétera.

invalidClickRate

number

Es el porcentaje de clics que se filtraron de la cantidad total de clics (clics filtrados y no filtrados) durante el período del informe.

invalidClicks

string (int64 format)

Es la cantidad de clics que Google considera ilegítimos y por los que no te cobra.

generalInvalidClickRate

number

Es el porcentaje de clics que se filtraron de la cantidad total de clics (clics filtrados y no filtrados) por ser clics no válidos generales. Se trata de clics que Google no considera legítimos y que se detectan a través de medios de filtrado de rutina (es decir, tráfico no válido conocido en centros de datos, bots y arañas, o bien otros rastreadores, patrones irregulares, etc.). No pagas por ellos y no afectan las estadísticas de tu cuenta. Consulta Cómo filtrar el tráfico no válido para garantizar la calidad.

generalInvalidClicks

string (int64 format)

Es la cantidad de clics no válidos generales. Se trata de un subconjunto de tus clics no válidos que se detectan a través de medios de filtrado de rutina (como tráfico no válido conocido en centros de datos, bots y arañas, o bien otros rastreadores, patrones irregulares, etc.). No pagas por ellos y no afectan las estadísticas de tu cuenta. Consulta Cómo filtrar el tráfico no válido para garantizar la calidad.

mobileFriendlyClicksPercentage

number

Es el porcentaje de clics desde dispositivos móviles que dirigen a una página optimizada para dispositivos móviles.

searchAbsoluteTopImpressionShare

number

Es el porcentaje de las impresiones de los anuncios de Shopping o de búsqueda del cliente que se muestran en la posición más destacada de Shopping. Consulta Acerca de las métricas en la parte superior y la parte superior absoluta de la página para obtener más información. Cualquier valor inferior a 0.1 se informa como 0.0999.

searchBudgetLostAbsoluteTopImpressionShare

number

Es la cifra que estima la frecuencia con la que tu anuncio no se mostró en el primer lugar entre los anuncios en la parte superior de la página en los resultados de la búsqueda debido a un presupuesto bajo.

Nota: El porcentaje de impresiones perdidas en la parte superior absoluta de la página de búsqueda (presupuesto) se informa en un rango de 0 a 0.9. Cualquier valor superior a 0.9 se informa como 0.9001.

searchBudgetLostImpressionShare

number

El porcentaje estimado de veces que tu anuncio era apto para mostrarse en la Red de Búsqueda, pero no lo hizo porque tu presupuesto era demasiado bajo.

Nota: El porcentaje de impresiones perdidas del presupuesto de búsqueda se informa en un rango de 0 a 0.9. Cualquier valor superior a 0.9 se informa como 0.9001.

searchBudgetLostTopImpressionShare

number

Es el porcentaje estimado de veces que tu anuncio no se mostró junto a los principales resultados de la búsqueda orgánica debido a un presupuesto bajo.

Nota: El porcentaje de impresiones perdidas en la parte superior de la página de búsqueda por falta de presupuesto se informa en un rango de 0 a 0.9. Cualquier valor superior a 0.9 se informa como 0.9001.

searchClickShare

number

Es la cantidad de clics que recibiste en la Red de Búsqueda dividida por la cantidad estimada de clics que podrías haber recibido.

Nota: El porcentaje de clics en la búsqueda se informa en un rango de 0.1 a 1. Cualquier valor inferior a 0.1 se informa como 0.0999.

searchExactMatchImpressionShare

number

Son las impresiones que recibiste divididas por la cantidad estimada de impresiones que podrías haber recibido en la Red de Búsqueda para los términos de búsqueda que coincidieron de manera exacta con tus palabras clave (o que eran variantes cercanas de tu palabra clave), independientemente de los tipos de concordancia de tus palabras clave.

Nota: El porcentaje de impresiones de concordancia exacta de búsqueda se informa en un rango de 0.1 a 1. Cualquier valor inferior a 0.1 se informa como 0.0999.

searchImpressionShare

number

Es la cantidad de impresiones que recibiste en la Red de Búsqueda dividida por la cantidad estimada de impresiones que podrías haber recibido.

Nota: El porcentaje de impresiones de búsqueda se informa en un rango de 0.1 a 1. Cualquier valor inferior a 0.1 se informa como 0.0999.

searchRankLostAbsoluteTopImpressionShare

number

Es la cifra que estima la frecuencia con la que tu anuncio no se mostró en el primer lugar entre los anuncios en la parte superior de la página en los resultados de la búsqueda debido a un ranking del anuncio bajo.

Nota: El porcentaje de impresiones perdidas en la parte superior absoluta de la página de búsqueda se informa en un rango de 0 a 0.9. Cualquier valor superior a 0.9 se informa como 0.9001.

searchRankLostImpressionShare

number

Es el porcentaje estimado de impresiones en la Red de Búsqueda que tus anuncios no recibieron debido a un ranking del anuncio bajo. Nota: El porcentaje de impresiones perdidas de la clasificación de búsqueda se informa en un rango de 0 a 0.9. Cualquier valor superior a 0.9 se informa como 0.9001.

searchRankLostTopImpressionShare

number

Es la cifra que estima la frecuencia con la que tu anuncio no se mostró junto a los principales resultados de la búsqueda orgánica debido a un ranking del anuncio bajo.

Nota: El porcentaje de impresiones perdidas en la parte superior de la página de búsqueda por clasificación se informa en un rango de 0 a 0.9. Cualquier valor superior a 0.9 se informa como 0.9001.

searchTopImpressionShare

number

Son las impresiones que recibiste entre los anuncios en la parte superior de la página en comparación con la cantidad estimada de impresiones que podrías haber recibido entre los anuncios en la parte superior de la página. Nota: El porcentaje de impresiones en la parte superior de la página de búsqueda se informa en un rango de 0.1 a 1. Cualquier valor inferior a 0.1 se informa como 0.0999.

Por lo general, los anuncios en la parte superior de la página aparecen arriba de los primeros resultados orgánicos, aunque es posible que, en determinadas búsquedas, se muestren debajo de esos resultados.

topImpressionPercentage

number

Es el porcentaje de tus impresiones de anuncios que se muestran junto a los primeros resultados de la búsqueda orgánica.

valuePerAllConversions

number

Es el valor de todas las conversiones dividido por la cantidad de todas las conversiones.

valuePerAllConversionsByConversionDate

number

Es el valor de todas las conversiones dividido por la cantidad de todas las conversiones. Cuando se selecciona esta columna con la fecha, los valores de la columna de fecha significan la fecha de conversión. Los detalles de las columnas by_conversion_date están disponibles en Acerca de la columna "Todas las conversiones".

valuePerConversion

number

Es el valor de la conversión apta para ofertas dividido por la cantidad de conversiones aptas para ofertas. Muestra cuánto vale, en promedio, cada una de las conversiones aptas para ofertas.

valuePerConversionsByConversionDate

number

Es el valor de las conversiones aptas para ofertas por fecha de conversión dividido por las conversiones aptas para ofertas por fecha de conversión. Muestra cuánto vale, en promedio, cada una de las conversiones aptas para ofertas (según la fecha de conversión). Cuando se selecciona esta columna con la fecha, los valores de la columna de fecha significan la fecha de conversión.

clientAccountViewThroughConversions

string (int64 format)

Es la cantidad total de conversiones posimpresión. Esto sucede cuando un cliente ve un anuncio con imágenes o rich media y, luego, completa una conversión en su sitio sin interactuar con otro anuncio (por ejemplo, si haces clic en él).

orders

number

Los pedidos son la cantidad total de conversiones por compras que recibiste atribuidas a tus anuncios.

Cómo funciona: Registras las conversiones con datos del carrito de las compras realizadas en tu sitio web. Si una conversión se atribuye a interacciones anteriores con tus anuncios (clics en anuncios de texto o de Shopping, vistas de anuncios de video, etc.), se registra como un pedido.

Ejemplo: Una persona hizo clic en un anuncio de Shopping sobre un sombrero y, luego, compró el mismo sombrero y una camisa en un pedido en tu sitio web. Si bien se compraron 2 productos, esta acción cuenta como 1 pedido.

Esta métrica solo está disponible si registras conversiones con datos del carrito.

averageOrderValueMicros

string (int64 format)

El valor promedio del pedido indica los ingresos promedio que generaste por cada pedido atribuido a tus anuncios.

Cómo funciona: Registras las conversiones con datos del carrito de las compras realizadas en tu sitio web. El valor promedio del pedido corresponde a los ingresos totales de tus pedidos divididos por la cantidad total de pedidos.

Ejemplo: Recibiste 3 pedidos que generaron ingresos por un valor de USD 10, USD 15 y USD 20 respectivamente. El valor promedio del pedido es de USD 15 = (USD 10 + USD 15 + USD 20)/3.

Esta métrica solo está disponible si registras conversiones con datos del carrito.

averageCartSize

number

El tamaño promedio del carrito indica la cantidad promedio de productos en cada pedido atribuido a tus anuncios.

Cómo funciona: Registras las conversiones con datos del carrito de las compras realizadas en tu sitio web. El tamaño promedio del carrito corresponde a la cantidad total de productos vendidos dividida por la cantidad total de pedidos que recibiste.

Ejemplo: Recibiste 2 pedidos, el primero incluía 3 productos y el segundo, 2. El tamaño promedio del carrito es 2.5 productos = (3+2)/2.

Esta métrica solo está disponible si registras conversiones con datos del carrito.

costOfGoodsSoldMicros

string (int64 format)

El costo de bienes vendidos (CBV) es el costo total de los productos que vendiste en pedidos atribuidos a tus anuncios.

Cómo funciona: Puedes agregar un valor de costo de bienes vendidos a cada producto en Merchant Center. Si registras las conversiones con datos del carrito, los productos que vendiste se corresponden con su valor de costo de bienes vendidos, y esto se puede usar para calcular la ganancia bruta que obtuviste en cada pedido.

Ejemplo: Un usuario hizo clic en el anuncio de Shopping de un sombrero y, luego, compró el mismo sombrero y una camisa. El sombrero tiene un valor de costo de bienes vendidos de USD 3 y la camisa tiene un valor de costo de bienes vendidos de USD 5. El costo de bienes vendidos para este pedido es de USD 8 = USD 3 + USD 5.

Esta métrica solo está disponible si registras conversiones con datos del carrito.

grossProfitMicros

string (int64 format)

Las ganancias brutas son aquellas que obtienes de los pedidos atribuidos a tus anuncios menos el costo de bienes vendidos (CBV).

Cómo funciona: Las ganancias brutas corresponden a los ingresos que obtienes por las ventas que se atribuyen a tus anuncios menos el costo de bienes vendidos. El cálculo de las ganancias brutas solo incluye los productos que tienen un valor de costo de bienes vendidos en Merchant Center.

Ejemplo: Un usuario hizo clic en el anuncio de Shopping de un sombrero y, luego, compró el mismo sombrero y una camisa a través de un pedido de tu sitio web. El sombrero cuesta USD 10 y la camisa, USD 20. El sombrero tiene un valor de costo de bienes vendidos de USD 3, pero la camisa no tiene un valor de costo de bienes vendidos. El cálculo de la ganancia bruta para este pedido solo tendrá en cuenta el sombrero, por lo que es de USD 7 = USD 10 - USD 3.

Esta métrica solo está disponible si registras conversiones con datos del carrito.

grossProfitMargin

number

El margen de ganancias brutas corresponde al porcentaje de ganancias brutas que obtuviste a partir de los pedidos atribuidos a tus anuncios, después de restar el costo de bienes vendidos (CBV).

Cómo funciona: Registras las conversiones con datos del carrito de las compras realizadas en tu sitio web. El margen de ganancias brutas corresponde a las ganancias brutas que obtuviste, dividida entre los ingresos totales y multiplicada por 100%. El cálculo del margen de ganancias brutas solo incluye los productos que tienen un valor de costo de bienes vendidos en Merchant Center.

Ejemplo: Un usuario compró un sombrero y una camisa a través de un pedido en tu sitio web. El sombrero cuesta USD 10 y tiene un valor de costo de bienes vendidos de USD 3. La camisa cuesta USD 20, pero no tiene ningún valor de costo de bienes vendidos. El cálculo del margen de ganancias brutas para este pedido solo tendrá en cuenta el sombrero porque tiene un valor de costo de bienes vendidos, por lo que es del 70% = (USD 10 - USD 3)/USD 10 x 100%.

Esta métrica solo está disponible si registras conversiones con datos del carrito.

revenueMicros

string (int64 format)

Los ingresos corresponden al importe total que obtuviste de los pedidos atribuidos a tus anuncios.

Cómo funciona: Registras las conversiones con datos del carrito de las compras realizadas en tu sitio web. Los ingresos corresponden al valor total de todos los pedidos que recibiste atribuidos a tus anuncios, menos los descuentos.

Ejemplo: Un usuario hizo clic en el anuncio de Shopping de un sombrero y, luego, compró el mismo sombrero y una camisa a través de un pedido de tu sitio web. El sombrero cuesta USD 10 y la camisa, USD 20. Todo el pedido tiene un descuento de USD 5. Los ingresos de este pedido son de USD 25 = (USD 10 + USD 20) - USD 5.

Esta métrica solo está disponible si registras conversiones con datos del carrito.

unitsSold

number

Las unidades vendidas son la cantidad total de productos vendidos de pedidos atribuidos a tus anuncios.

Cómo funciona: Registras las conversiones con datos del carrito de las compras realizadas en tu sitio web. Las unidades vendidas son la cantidad total de productos vendidos de todos los pedidos atribuidos a tus anuncios.

Ejemplo: Una persona hizo clic en un anuncio de Shopping sobre un sombrero y, luego, compró el mismo sombrero, una camisa y una chaqueta. Las unidades vendidas en este pedido son 3.

Esta métrica solo está disponible si registras conversiones con datos del carrito.

clientAccountCrossSellCostOfGoodsSoldMicros

string (int64 format)

El costo de bienes vendidos (CBV) por ventas cruzadas de la cuenta del cliente es el costo total de los productos vendidos como resultado de la publicidad de un producto diferente.

Cómo funciona: Registras las conversiones con datos del carrito de las compras realizadas en tu sitio web. Si el anuncio con el que se interactuó antes de la compra tiene un producto asociado (consulta Anuncios de Shopping), este producto se considerará como el anunciado. Cualquier producto incluido en el pedido que realice el cliente es un producto vendido. Si estos productos no coinciden, se considerará una venta cruzada. El costo de bienes vendidos en forma cruzada es el costo total de los productos vendidos que no se anunciaron.

Ejemplo: Un usuario hizo clic en el anuncio de Shopping de un sombrero y, luego, compró el mismo sombrero y una camisa. El sombrero tiene un valor de costo de bienes vendidos de USD 3 y la camisa tiene un valor de costo de bienes vendidos de USD 5. El costo de bienes vendidos en forma cruzada de este pedido es de USD 5.

Esta métrica solo está disponible si registras conversiones con datos del carrito. Esta métrica es un valor monetario y se muestra en la moneda del cliente de forma predeterminada. Consulta el parámetro metrics_currency en la cláusula PARAMETERS.

crossSellCostOfGoodsSoldMicros

string (int64 format)

El costo de bienes vendidos en forma cruzada (CBV) es el costo total de los productos vendidos como resultado de la publicidad de un producto diferente.

Cómo funciona: Registras las conversiones con datos del carrito de las compras realizadas en tu sitio web. Si el anuncio con el que se interactuó antes de la compra tiene un producto asociado (consulta Anuncios de Shopping), este producto se considerará como el anunciado. Cualquier producto incluido en el pedido que realice el cliente es un producto vendido. Si estos productos no coinciden, se considerará una venta cruzada. El costo de bienes vendidos en forma cruzada es el costo total de los productos vendidos que no se anunciaron.

Ejemplo: Un usuario hizo clic en el anuncio de Shopping de un sombrero y, luego, compró el mismo sombrero y una camisa. El sombrero tiene un valor de costo de bienes vendidos de USD 3 y la camisa tiene un valor de costo de bienes vendidos de USD 5. El costo de bienes vendidos en forma cruzada de este pedido es de USD 5.

Esta métrica solo está disponible si registras conversiones con datos del carrito. Esta métrica es un valor monetario y se muestra en la moneda del cliente de forma predeterminada. Consulta el parámetro metrics_currency en la cláusula PARAMETERS.

clientAccountCrossSellGrossProfitMicros

string (int64 format)

Las ganancias brutas por ventas cruzadas de la cuenta del cliente son las ganancias que obtuviste de los productos vendidos como resultado de la publicidad de un producto diferente, menos el costo de bienes vendidos (CBV).

Cómo funciona: Registras las conversiones con datos del carrito de las compras realizadas en tu sitio web. Si el anuncio con el que se interactuó antes de la compra tiene un producto asociado (consulta Anuncios de Shopping), este producto se considerará como el anunciado. Cualquier producto incluido en la compra es un producto vendido. Si estos productos no coinciden, se considerará una venta cruzada. Las ganancias brutas por ventas cruzadas son los ingresos que obtuviste a partir de ventas cruzadas que se atribuyeron a tus anuncios menos el costo de los bienes vendidos.

Ejemplo: Un usuario hizo clic en el anuncio de Shopping de un sombrero y, luego, compró el mismo sombrero y una camisa. La camisa cuesta USD 20 y tiene un valor de costo de bienes vendidos de USD 5. Las ganancias brutas por ventas cruzadas de este pedido son de USD 15 = USD 20 - USD 5.

Esta métrica solo está disponible si registras conversiones con datos del carrito. Esta métrica es un valor monetario y se muestra en la moneda del cliente de forma predeterminada. Consulta el parámetro metrics_currency en la cláusula PARAMETERS.

crossSellGrossProfitMicros

string (int64 format)

Las ganancias brutas por ventas cruzadas son las ganancias que obtuviste de los productos vendidos como resultado de la publicidad de un producto diferente, menos el costo de bienes vendidos (CBV).

Cómo funciona: Registras las conversiones con datos del carrito de las compras realizadas en tu sitio web. Si el anuncio con el que se interactuó antes de la compra tiene un producto asociado (consulta Anuncios de Shopping), este producto se considerará como el anunciado. Cualquier producto incluido en la compra es un producto vendido. Si estos productos no coinciden, se considerará una venta cruzada. Las ganancias brutas por ventas cruzadas son los ingresos que obtuviste a partir de ventas cruzadas que se atribuyeron a tus anuncios menos el costo de los bienes vendidos.

Ejemplo: Un usuario hizo clic en el anuncio de Shopping de un sombrero y, luego, compró el mismo sombrero y una camisa. La camisa cuesta USD 20 y tiene un valor de costo de bienes vendidos de USD 5. Las ganancias brutas por ventas cruzadas de este pedido son de USD 15 = USD 20 - USD 5.

Esta métrica solo está disponible si registras conversiones con datos del carrito.

Esta métrica es un valor monetario y se muestra en la moneda del cliente de forma predeterminada. Consulta el parámetro metrics_currency en la cláusula PARAMETERS.

clientAccountCrossSellRevenueMicros

string (int64 format)

Los ingresos por ventas cruzadas de la cuenta del cliente son el importe total que obtuviste por los productos vendidos como resultado de la publicidad de un producto diferente.

Cómo funciona: Registras las conversiones con datos del carrito de las compras realizadas en tu sitio web. Si el anuncio con el que se interactuó antes de la compra tiene un producto asociado (consulta Anuncios de Shopping), este producto se considerará como el anunciado. Cualquier producto incluido en el pedido que realice el cliente es un producto vendido. Si estos productos no coinciden, se considerará una venta cruzada. Los ingresos por ventas cruzadas corresponden al valor total que obtuviste por la venta cruzada que se atribuyó a tus anuncios.

Ejemplo: Un usuario hizo clic en el anuncio de Shopping de un sombrero y, luego, compró el mismo sombrero y una camisa. El sombrero cuesta USD 10 y la camisa, USD 20. Los ingresos por venta cruzada de este pedido son de USD 20.

Esta métrica solo está disponible si registras conversiones con datos del carrito. Esta métrica es un valor monetario y se muestra en la moneda del cliente de forma predeterminada. Consulta el parámetro metrics_currency en la cláusula PARAMETERS.

crossSellRevenueMicros

string (int64 format)

Los ingresos por ventas cruzadas corresponden al importe total que obtuviste por los productos vendidos como resultado de la publicidad de un producto diferente.

Cómo funciona: Registras las conversiones con datos del carrito de las compras realizadas en tu sitio web. Si el anuncio con el que se interactuó antes de la compra tiene un producto asociado (consulta Anuncios de Shopping), este producto se considerará como el anunciado. Cualquier producto incluido en el pedido que realice el cliente es un producto vendido. Si estos productos no coinciden, se considerará una venta cruzada. Los ingresos por ventas cruzadas corresponden al valor total que obtuviste por la venta cruzada que se atribuyó a tus anuncios.

Ejemplo: Un usuario hizo clic en el anuncio de Shopping de un sombrero y, luego, compró el mismo sombrero y una camisa. El sombrero cuesta USD 10 y la camisa, USD 20. Los ingresos por venta cruzada de este pedido son de USD 20.

Esta métrica solo está disponible si registras conversiones con datos del carrito. Esta métrica es un valor monetario y se muestra en la moneda del cliente de forma predeterminada. Consulta el parámetro metrics_currency en la cláusula PARAMETERS.

clientAccountCrossSellUnitsSold

number

Las unidades vendidas en forma cruzada de la cuenta del cliente son la cantidad total de productos vendidos como resultado de la publicidad de un producto diferente.

Cómo funciona: Registras las conversiones con datos del carrito de las compras realizadas en tu sitio web. Si el anuncio con el que se interactuó antes de la compra tiene un producto asociado (consulta Anuncios de Shopping), este producto se considerará como el anunciado. Cualquier producto incluido en el pedido que realice el cliente es un producto vendido. Si estos productos no coinciden, se considerará una venta cruzada. Las unidades vendidas en forma cruzada son la cantidad total de productos de venta cruzada de todos los pedidos atribuidos a tus anuncios.

Ejemplo: Una persona hizo clic en un anuncio de Shopping sobre un sombrero y, luego, compró el mismo sombrero, una camisa y una chaqueta. Las unidades vendidas en forma cruzada de este pedido son 2.

Esta métrica solo está disponible si registras conversiones con datos del carrito.

crossSellUnitsSold

number

"Unidades vendidas en forma cruzada" es la cantidad total de productos vendidos como resultado de la publicidad de un producto diferente.

Cómo funciona: Registras las conversiones con datos del carrito de las compras realizadas en tu sitio web. Si el anuncio con el que se interactuó antes de la compra tiene un producto asociado (consulta Anuncios de Shopping), este producto se considerará como el anunciado. Cualquier producto incluido en el pedido que realice el cliente es un producto vendido. Si estos productos no coinciden, se considerará una venta cruzada. Las unidades vendidas en forma cruzada son la cantidad total de productos de venta cruzada de todos los pedidos atribuidos a tus anuncios.

Ejemplo: Una persona hizo clic en un anuncio de Shopping sobre un sombrero y, luego, compró el mismo sombrero, una camisa y una chaqueta. Las unidades vendidas en forma cruzada de este pedido son 2.

Esta métrica solo está disponible si registras conversiones con datos del carrito.

clientAccountLeadCostOfGoodsSoldMicros

string (int64 format)

El costo de bienes vendidos (CBV) de la cuenta de cliente por producto promocionado es el costo total de los productos vendidos como resultado de la publicidad del mismo producto.

Cómo funciona: Registras las conversiones con datos del carrito de las compras realizadas en tu sitio web. Si el anuncio con el que se interactuó tiene un producto asociado (consulta Anuncios de Shopping), este producto se considerará como el anunciado. Cualquier producto incluido en el pedido que realice el cliente es un producto vendido. Si los productos anunciados y vendidos coinciden, el costo de estos productos se registra en el costo de bienes vendidos a clientes potenciales.

Ejemplo: Un usuario hizo clic en el anuncio de Shopping de un sombrero y, luego, compró el mismo sombrero y una camisa. El sombrero tiene un valor de costo de bienes vendidos de USD 3 y la camisa tiene un valor de costo de bienes vendidos de USD 5. El costo de bienes vendidos por producto promocionado de este pedido es de USD 3.

Esta métrica solo está disponible si registras conversiones con datos del carrito. Esta métrica es un valor monetario y se muestra en la moneda del cliente de forma predeterminada. Consulta el parámetro metrics_currency en la cláusula PARAMETERS.

leadCostOfGoodsSoldMicros

string (int64 format)

El costo de bienes vendidos (CBV) por producto promocionado es el costo total de los productos vendidos como resultado de la publicidad del mismo producto.

Cómo funciona: Registras las conversiones con datos del carrito de las compras realizadas en tu sitio web. Si el anuncio con el que se interactuó tiene un producto asociado (consulta Anuncios de Shopping), este producto se considerará como el anunciado. Cualquier producto incluido en el pedido que realice el cliente es un producto vendido. Si los productos anunciados y vendidos coinciden, el costo de estos productos se registra en el costo de bienes vendidos a clientes potenciales.

Ejemplo: Un usuario hizo clic en el anuncio de Shopping de un sombrero y, luego, compró el mismo sombrero y una camisa. El sombrero tiene un valor de costo de bienes vendidos de USD 3 y la camisa tiene un valor de costo de bienes vendidos de USD 5. El costo de bienes vendidos por producto promocionado de este pedido es de USD 3.

Esta métrica solo está disponible si registras conversiones con datos del carrito. Esta métrica es un valor monetario y se muestra en la moneda del cliente de forma predeterminada. Consulta el parámetro metrics_currency en la cláusula PARAMETERS.

clientAccountLeadGrossProfitMicros

string (int64 format)

Las ganancias brutas por producto promocionado de la cuenta del cliente son las ganancias que obtuviste de los productos vendidos como resultado de la publicidad del mismo producto, menos el costo de bienes vendidos (CBV).

Cómo funciona: Registras las conversiones con datos del carrito de las compras realizadas en tu sitio web. Si el anuncio con el que se interactuó antes de la compra tiene un producto asociado (consulta Anuncios de Shopping), este producto se considerará como el anunciado. Cualquier producto incluido en el pedido que realice el cliente es un producto vendido. Si los productos anunciados y vendidos coinciden, los ingresos que obtuviste de esas ventas menos el costo de bienes vendidos son tus ganancias brutas por clientes potenciales.

Ejemplo: Un usuario hizo clic en el anuncio de Shopping de un sombrero y, luego, compró el mismo sombrero y una camisa. El sombrero cuesta USD 10 y tiene un valor de costo de bienes vendidos de USD 3. Las ganancias brutas por producto promocionado de este pedido son USD 7 = USD 10 - USD 3.

Esta métrica solo está disponible si registras conversiones con datos del carrito. Esta métrica es un valor monetario y se muestra en la moneda del cliente de forma predeterminada. Consulta el parámetro metrics_currency en la cláusula PARAMETERS.

leadGrossProfitMicros

string (int64 format)

Las ganancias brutas por producto promocionado son las ganancias que obtuviste de los productos vendidos como resultado de la publicidad del mismo producto, menos el costo de bienes vendidos (CBV).

Cómo funciona: Registras las conversiones con datos del carrito de las compras realizadas en tu sitio web. Si el anuncio con el que se interactuó antes de la compra tiene un producto asociado (consulta Anuncios de Shopping), este producto se considerará como el anunciado. Cualquier producto incluido en el pedido que realice el cliente es un producto vendido. Si los productos anunciados y vendidos coinciden, los ingresos que obtuviste de esas ventas menos el costo de bienes vendidos son tus ganancias brutas por clientes potenciales.

Ejemplo: Un usuario hizo clic en el anuncio de Shopping de un sombrero y, luego, compró el mismo sombrero y una camisa. El sombrero cuesta USD 10 y tiene un valor de costo de bienes vendidos de USD 3. Las ganancias brutas por producto promocionado de este pedido son USD 7 = USD 10 - USD 3.

Esta métrica solo está disponible si registras conversiones con datos del carrito. Esta métrica es un valor monetario y se muestra en la moneda del cliente de forma predeterminada. Consulta el parámetro metrics_currency en la cláusula PARAMETERS.

clientAccountLeadRevenueMicros

string (int64 format)

Los ingresos por clientes potenciales de la cuenta del cliente son el importe total que obtuviste por los productos vendidos como resultado de la publicidad del mismo producto.

Cómo funciona: Registras las conversiones con datos del carrito de las compras realizadas en tu sitio web. Si el anuncio con el que se interactuó antes de la compra tiene un producto asociado (consulta Anuncios de Shopping), este producto se considerará como el anunciado. Cualquier producto incluido en el pedido que realice el cliente es un producto vendido. Si los productos promocionados y vendidos coinciden, el valor total que obtuviste por las ventas de estos productos se muestra en los ingresos por clientes potenciales.

Ejemplo: Un usuario hizo clic en el anuncio de Shopping de un sombrero y, luego, compró el mismo sombrero y una camisa. El sombrero cuesta USD 10 y la camisa, USD 20. Los ingresos por producto promocionado de este pedido son de USD 10.

Esta métrica solo está disponible si registras conversiones con datos del carrito. Esta métrica es un valor monetario y se muestra en la moneda del cliente de forma predeterminada. Consulta el parámetro metrics_currency en la cláusula PARAMETERS.

leadRevenueMicros

string (int64 format)

Los ingresos por producto promocionado corresponden al importe total que obtuviste por los productos vendidos como resultado de la publicidad del mismo producto.

Cómo funciona: Registras las conversiones con datos del carrito de las compras realizadas en tu sitio web. Si el anuncio con el que se interactuó antes de la compra tiene un producto asociado (consulta Anuncios de Shopping), este producto se considerará como el anunciado. Cualquier producto incluido en el pedido que realice el cliente es un producto vendido. Si los productos promocionados y vendidos coinciden, el valor total que obtuviste por las ventas de estos productos se muestra en los ingresos por clientes potenciales.

Ejemplo: Un usuario hizo clic en el anuncio de Shopping de un sombrero y, luego, compró el mismo sombrero y una camisa. El sombrero cuesta USD 10 y la camisa, USD 20. Los ingresos por producto promocionado de este pedido son de USD 10.

Esta métrica solo está disponible si registras conversiones con datos del carrito. Esta métrica es un valor monetario y se muestra en la moneda del cliente de forma predeterminada. Consulta el parámetro metrics_currency en la cláusula PARAMETERS.

clientAccountLeadUnitsSold

number

Las unidades vendidas a clientes potenciales de la cuenta del cliente son la cantidad total de productos vendidos como resultado de la publicidad del mismo producto.

Cómo funciona: Registras las conversiones con datos del carrito de las compras realizadas en tu sitio web. Si el anuncio con el que se interactuó antes de la compra tiene un producto asociado (consulta Anuncios de Shopping), este producto se considerará como el anunciado. Cualquier producto incluido en el pedido que realice el cliente es un producto vendido. Si los productos promocionados y vendidos coinciden, la cantidad total de estos productos vendidos se muestra en unidades vendidas a clientes potenciales.

Ejemplo: Una persona hizo clic en un anuncio de Shopping sobre un sombrero y, luego, compró el mismo sombrero, una camisa y una chaqueta. Las unidades vendidas a clientes potenciales en este pedido son 1.

Esta métrica solo está disponible si registras conversiones con datos del carrito.

leadUnitsSold

number

Las unidades vendidas del producto promocionado corresponden a la cantidad total de productos vendidos como resultado de la publicidad del mismo producto.

Cómo funciona: Registras las conversiones con datos del carrito de las compras realizadas en tu sitio web. Si el anuncio con el que se interactuó antes de la compra tiene un producto asociado (consulta Anuncios de Shopping), este producto se considerará como el anunciado. Cualquier producto incluido en el pedido que realice el cliente es un producto vendido. Si los productos promocionados y vendidos coinciden, la cantidad total de estos productos vendidos se muestra en unidades vendidas a clientes potenciales.

Ejemplo: Una persona hizo clic en un anuncio de Shopping sobre un sombrero y, luego, compró el mismo sombrero, una camisa y una chaqueta. Las unidades vendidas a clientes potenciales en este pedido son 1.

Esta métrica solo está disponible si registras conversiones con datos del carrito.

uniqueUsers

string (int64 format)

Es la cantidad de usuarios únicos que vieron tu anuncio durante el período solicitado. Esta métrica no se puede agregar y solo se puede solicitar para períodos de 92 días o menos. Esta métrica está disponible para los siguientes tipos de campañas: Display, video, discovery y aplicaciones.

averageImpressionFrequencyPerUser

number

Es la cantidad promedio de veces que un usuario único vio tu anuncio durante el período solicitado. Esta métrica no se puede agregar y solo se puede solicitar para períodos de 92 días o menos. Esta métrica está disponible para los siguientes tipos de campañas: Display, video, discovery y aplicaciones.

Valor

Es un contenedor de datos genérico.

Representación JSON
{

  // Union field value can be only one of the following:
  "booleanValue": boolean,
  "int64Value": string,
  "floatValue": number,
  "doubleValue": number,
  "stringValue": string
  // End of list of possible types for union field value.
}
Campos
Campo de unión value. Es un valor. value puede ser solo uno de los parámetros siguientes:
booleanValue

boolean

Un valor booleano.

int64Value

string (int64 format)

Es un int64.

floatValue

number

Es un número de punto flotante.

doubleValue

number

Un valor doble.

stringValue

string

Una string.

QualityScoreBucket

Es un enum que enumera los posibles discretizaciones del nivel de calidad.

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
BELOW_AVERAGE La calidad de la creatividad está por debajo del promedio.
AVERAGE La calidad de la creatividad es promedio.
ABOVE_AVERAGE La calidad de la creatividad está por encima del promedio.

InteractionEventType

Es una enumeración que describe los posibles tipos de interacciones pagadas y gratuitas.

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
CLICK Haz clic para ir al sitio. En la mayoría de los casos, esta interacción navega a una ubicación externa, generalmente la página de destino del anunciante. También es el InteractionEventType predeterminado para los eventos de clic.
ENGAGEMENT Es la intención expresada por el usuario de interactuar con el anuncio integrado.
VIDEO_VIEW El usuario vio un anuncio de video.
NONE Es el InteractionEventType predeterminado para los eventos de conversión de anuncios. Se usa cuando una fila de conversión del anuncio NO indica que las interacciones gratuitas (por ejemplo, las conversiones del anuncio) se deben "promocionar" y registrar como parte de las métricas principales. Simplemente, son otras conversiones (de anuncios).

Segmentos

Son campos de solo segmentación.

Representación JSON
{
  "adFormatType": enum (AdFormatType),
  "adNetworkType": enum (AdNetworkType),
  "conversionActionCategory": enum (ConversionActionCategory),
  "conversionCustomDimensions": [
    {
      object (Value)
    }
  ],
  "dayOfWeek": enum (DayOfWeek),
  "device": enum (Device),
  "keyword": {
    object (Keyword)
  },
  "productChannel": enum (ProductChannel),
  "productChannelExclusivity": enum (ProductChannelExclusivity),
  "productCondition": enum (ProductCondition),
  "productSoldCondition": enum (ProductCondition),
  "rawEventConversionDimensions": [
    {
      object (Value)
    }
  ],
  "conversionAction": string,
  "conversionActionName": string,
  "date": string,
  "geoTargetCity": string,
  "geoTargetCountry": string,
  "geoTargetMetro": string,
  "geoTargetPostalCode": string,
  "geoTargetRegion": string,
  "hour": integer,
  "month": string,
  "productBiddingCategoryLevel1": string,
  "productBiddingCategoryLevel2": string,
  "productBiddingCategoryLevel3": string,
  "productBiddingCategoryLevel4": string,
  "productBiddingCategoryLevel5": string,
  "productBrand": string,
  "productCountry": string,
  "productCustomAttribute0": string,
  "productCustomAttribute1": string,
  "productCustomAttribute2": string,
  "productCustomAttribute3": string,
  "productCustomAttribute4": string,
  "productItemId": string,
  "productLanguage": string,
  "productSoldBiddingCategoryLevel1": string,
  "productSoldBiddingCategoryLevel2": string,
  "productSoldBiddingCategoryLevel3": string,
  "productSoldBiddingCategoryLevel4": string,
  "productSoldBiddingCategoryLevel5": string,
  "productSoldBrand": string,
  "productSoldCustomAttribute0": string,
  "productSoldCustomAttribute1": string,
  "productSoldCustomAttribute2": string,
  "productSoldCustomAttribute3": string,
  "productSoldCustomAttribute4": string,
  "productSoldItemId": string,
  "productSoldTitle": string,
  "productSoldTypeL1": string,
  "productSoldTypeL2": string,
  "productSoldTypeL3": string,
  "productSoldTypeL4": string,
  "productSoldTypeL5": string,
  "productStoreId": string,
  "productTitle": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "quarter": string,
  "verticalAdsEventParticipantDisplayNames": string,
  "verticalAdsHotelClass": string,
  "verticalAdsListing": string,
  "verticalAdsListingBrand": string,
  "verticalAdsListingCity": string,
  "verticalAdsListingCountry": string,
  "verticalAdsListingRegion": string,
  "verticalAdsPartnerAccount": string,
  "verticalAdsVertical": enum (VerticalAdsItemVerticalType),
  "week": string,
  "year": integer,
  "assetInteractionTarget": {
    object (AssetInteractionTarget)
  }
}
Campos
adFormatType

enum (AdFormatType)

Es el tipo de formato del anuncio.

adNetworkType

enum (AdNetworkType)

Tipo de red del anuncio

conversionActionCategory

enum (ConversionActionCategory)

Es la categoría de la acción de conversión.

conversionCustomDimensions[]

object (Value)

Son las dimensiones personalizadas de la conversión.

dayOfWeek

enum (DayOfWeek)

Día de la semana, por ejemplo, LUNES.

device

enum (Device)

Dispositivo al que se aplican las métricas.

keyword

object (Keyword)

Es el criterio de palabra clave.

productChannel

enum (ProductChannel)

Canal del producto.

productChannelExclusivity

enum (ProductChannelExclusivity)

Exclusividad de canal del producto.

productCondition

enum (ProductCondition)

Estado del producto.

productSoldCondition

enum (ProductCondition)

Estado del producto vendido.

rawEventConversionDimensions[]

object (Value)

Son las dimensiones de conversión del evento sin procesar.

conversionAction

string

El nombre del recurso de la acción de conversión.

conversionActionName

string

Nombre de la acción de conversión.

date

string

Fecha a la que se aplican las métricas. Formato dd-MM-aaaa, por ejemplo, 17-04-2018.

geoTargetCity

string

Es el nombre del recurso de la constante de segmentación geográfica que representa una ciudad.

geoTargetCountry

string

Es el nombre del recurso de la constante de segmentación geográfica que representa un país.

geoTargetMetro

string

Es el nombre del recurso de la constante de segmentación geográfica que representa un área metropolitana.

geoTargetPostalCode

string

Es el nombre del recurso de la constante de segmentación geográfica que representa un código postal.

geoTargetRegion

string

Es el nombre del recurso de la constante de segmentación geográfica que representa una región.

hour

integer

Hora del día como un número entre 0 y 23, inclusive.

month

string

Mes representado por la fecha del primer día del mes. Tiene el formato aaaa-MM-dd.

productBiddingCategoryLevel1

string

Categoría de oferta (nivel 1) del producto.

productBiddingCategoryLevel2

string

Categoría de oferta (nivel 2) del producto.

productBiddingCategoryLevel3

string

Categoría de oferta (nivel 3) del producto.

productBiddingCategoryLevel4

string

Categoría de oferta (nivel 4) del producto.

productBiddingCategoryLevel5

string

Categoría de oferta (nivel 5) del producto.

productBrand

string

Es la marca del producto.

productCountry

string

Es el nombre del recurso de la constante de segmentación geográfica para el país de venta del producto.

productCustomAttribute0

string

Atributo personalizado 0 del producto.

productCustomAttribute1

string

Atributo personalizado 1 del producto.

productCustomAttribute2

string

Atributo personalizado 2 del producto.

productCustomAttribute3

string

Atributo personalizado 3 del producto.

productCustomAttribute4

string

Atributo personalizado 4 del producto.

productItemId

string

Es el ID del artículo.

productLanguage

string

Nombre del recurso de la constante de idioma del idioma del producto.

productSoldBiddingCategoryLevel1

string

Categoría de oferta (nivel 1) del producto vendido.

productSoldBiddingCategoryLevel2

string

Categoría de oferta (nivel 2) del producto vendido.

productSoldBiddingCategoryLevel3

string

Categoría de oferta (nivel 3) del producto vendido.

productSoldBiddingCategoryLevel4

string

Categoría de oferta (nivel 4) del producto vendido.

productSoldBiddingCategoryLevel5

string

Categoría de oferta (nivel 5) del producto vendido.

productSoldBrand

string

La marca del producto vendido.

productSoldCustomAttribute0

string

Atributo personalizado 0 del producto vendido.

productSoldCustomAttribute1

string

Atributo personalizado 1 del producto vendido.

productSoldCustomAttribute2

string

Atributo personalizado 2 del producto vendido.

productSoldCustomAttribute3

string

Atributo personalizado 3 del producto vendido.

productSoldCustomAttribute4

string

Atributo personalizado 4 del producto vendido.

productSoldItemId

string

El ID del artículo vendido.

productSoldTitle

string

El título del producto vendido.

productSoldTypeL1

string

Tipo (nivel 1) del producto vendido.

productSoldTypeL2

string

Tipo (nivel 2) del producto vendido.

productSoldTypeL3

string

Tipo (nivel 3) del producto vendido.

productSoldTypeL4

string

Tipo (nivel 4) del producto vendido.

productSoldTypeL5

string

Tipo (nivel 5) del producto vendido.

productStoreId

string

Es el ID de tienda del producto.

productTitle

string

Título del producto.

productTypeL1

string

Tipo de producto (nivel 1).

productTypeL2

string

Tipo de producto (nivel 2)

productTypeL3

string

Tipo de producto (nivel 3)

productTypeL4

string

Tipo de producto (nivel 4).

productTypeL5

string

Tipo de producto (nivel 5).

quarter

string

Trimestre representado por la fecha del primer día del trimestre. Usa el año calendario para los trimestres. Por ejemplo, el segundo trimestre de 2018 comienza el 2018-04-01. Tiene el formato aaaa-MM-dd.

verticalAdsEventParticipantDisplayNames

string

Son los nombres visibles de los participantes en la ficha de un evento, como artistas, oradores o equipos.

verticalAdsHotelClass

string (int64 format)

Es la categoría del hotel. Por lo general, se encuentran en el rango de 1 a 5 estrellas, pero se pueden personalizar por completo en el feed de hoteles.

verticalAdsListing

string

Es la ficha asociada a una impresión, un clic o una conversión de la ficha.

verticalAdsListingBrand

string

Es la marca asociada a una ficha específica dentro de un contexto de anuncios verticales, por ejemplo, la marca de un alquiler de automóviles, una casa de vacaciones o un evento.

verticalAdsListingCity

string

Ciudad en la que se encuentra la ficha de anuncios verticales.

verticalAdsListingCountry

string

Es el país en el que se encuentra la ficha de anuncios verticales.

verticalAdsListingRegion

string

Es la región en la que se encuentra la ficha de anuncios verticales.

verticalAdsPartnerAccount

string (int64 format)

Es una cuenta de socio específica dentro de un Centro de socios (por ejemplo, Hotel Center) que proporciona datos del feed de inventario para los anuncios verticales.

verticalAdsVertical

enum (VerticalAdsItemVerticalType)

Es el tipo de anuncio vertical, como Alquileres de vacaciones, Alquileres de automóviles o Eventos, que se usa para categorizar y segmentar los datos en el contexto de los anuncios verticales.

week

string

Semana definida como de lunes a domingo y representada por la fecha del lunes. Tiene el formato aaaa-MM-dd.

year

integer

Año, con el formato aaaa.

assetInteractionTarget

object (AssetInteractionTarget)

Solo se usa con las métricas de CustomerAsset, CampaignAsset y AdGroupAsset. Indica si las métricas de interacción se produjeron en el recurso en sí o en otro recurso o unidad de anuncio. Las interacciones (por ejemplo, los clics) se registran en todas las partes del anuncio publicado (por ejemplo, el anuncio en sí y otros componentes, como los vínculos a sitios) cuando se publican juntos. Cuando interactionOnThisAsset es verdadero, significa que las interacciones se producen en este recurso específico. Cuando interactionOnThisAsset es falso, significa que las interacciones no se producen en este recurso específico, sino en otras partes del anuncio publicado con el que se publica este recurso.

AdFormatType

Enumera los tipos de formato de Google Ads.

Ten en cuenta que esta segmentación solo está disponible para las campañas de video y de generación de demanda. En el caso de los recursos, solo se admiten los recursos de video.

Enums
UNSPECIFIED No se especificó ningún valor.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
VERTICAL_ADS_PROMOTION Es un formato de anuncio que promociona una entidad específica dentro de una vertical, por ejemplo, un anuncio de hotel en la vertical de Viajes en la Búsqueda.
TEXT Es un formato de anuncio de texto estándar. Actualmente, solo se usa para los anuncios de la Red de Búsqueda.

AdNetworkType

Enumera los tipos de redes de publicidad de Google.

Enums
UNSPECIFIED No se especifica.
UNKNOWN El valor es desconocido en esta versión.
SEARCH Búsqueda en Google
SEARCH_PARTNERS Socios de búsqueda
CONTENT Red de Display
YOUTUBE_WATCH Videos de YouTube
MIXED Es de varias redes.

Palabra clave

Es un segmento de criterio de palabra clave.

Representación JSON
{
  "info": {
    object (KeywordInfo)
  },
  "adGroupCriterion": string
}
Campos
info

object (KeywordInfo)

Es información sobre la palabra clave.

adGroupCriterion

string

Es el nombre del recurso AdGroupCriterion.

ProductChannelExclusivity

Es una enumeración que describe la disponibilidad de una oferta de producto.

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
SINGLE_CHANNEL El artículo se vende solo a través de un canal, ya sea en tiendas locales o en línea, como lo indica su ProductChannel.
MULTI_CHANNEL El artículo coincide con su contraparte en las tiendas en línea o locales, lo que indica que está disponible para la compra en ambos ShoppingProductChannels.

ProductCondition

Es una enumeración que describe la condición de una oferta de producto.

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
OLD El estado del producto es antiguo.
NEW El estado del producto es nuevo.
REFURBISHED El estado del producto es reacondicionado.
USED El estado del producto es usado.

VerticalAdsItemVerticalType

Es un enum que describe el tipo vertical del elemento de anuncios verticales para SharedSet del tipo VERTICAL_ADS_ITEM_GROUP_RULE_LIST.

Enums
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para el valor que se devuelve. Representa un valor desconocido en esta versión.
HOTELS Es la vertical de viajes de hoteles.
VACATION_RENTALS Vertical de viajes de alquileres de vacaciones.
RENTAL_CARS Vertical de viajes de alquiler de automóviles.
EVENTS Vertical de viajes de eventos.
THINGS_TO_DO Vertical de viajes de Cosas que hacer.
FLIGHTS Vertical de viajes de vuelos.

AssetInteractionTarget

Es un segmento de AssetInteractionTarget.

Representación JSON
{
  "asset": string,
  "interactionOnThisAsset": boolean
}
Campos
asset

string

Es el nombre del recurso del activo.

interactionOnThisAsset

boolean

Solo se usa con las métricas de CustomerAsset, CampaignAsset y AdGroupAsset. Indica si las métricas de interacción se produjeron en el recurso en sí o en otro recurso o unidad de anuncio.