Package google.ads.searchads360.v0.common

Índice

AdScheduleInfo

Representa un criterio de AdSchedule.

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

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

Campos
start_minute

MinuteOfHour

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

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

end_minute

MinuteOfHour

Minutos después de la hora de finalización de este programa. El programa no incluye el minuto final.

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

day_of_week

DayOfWeek

Es el día de la semana al que se aplica la programación.

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

start_hour

int32

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

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

end_hour

int32

Hora de finalización en formato de 24 horas. 24 significa el final del día. Este campo debe estar entre 0 y 24, inclusive.

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

AdTextAsset

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

Campos
text

string

Texto del recurso

AgeRangeInfo

Un criterio de rango de edad.

Campos
type

AgeRangeType

Tipo de rango de edad.

AssetInteractionTarget

Un segmento AssetInteractionTarget.

Campos
asset

string

Es el nombre del recurso del activo.

interaction_on_this_asset

bool

Solo se utiliza con las métricas CustomerAsset, CampaignAsset y AdGroupAsset. Indica si las métricas de interacción ocurrieron en el recurso mismo o en un recurso o unidad de anuncios diferentes.

AssetUsage

Contiene la información de uso del activo.

Campos
asset

string

Es el nombre del recurso del activo.

served_asset_field_type

ServedAssetFieldType

Es el tipo de campo publicado del activo.

AudienceInfo

Un criterio de público.

Campos
audience

string

Es el nombre del recurso de público.

BusinessProfileLocation

Datos de ubicación del Perfil de Negocio sincronizados desde la cuenta del Perfil de Negocio vinculada

Campos
labels[]

string

El anunciante especificó la etiqueta para la ubicación en la cuenta del Perfil de Negocio. Esta información se sincroniza desde la cuenta del Perfil de Negocio.

store_code

string

Código de tienda del Perfil de Negocio de esta ubicación Se sincroniza desde la cuenta del Perfil de Negocio.

listing_id

int64

Es el ID de la ficha de esta ubicación del Perfil de Negocio. Se sincroniza desde la cuenta del Perfil de Negocio vinculada.

CallToActionAsset

Un recurso de llamado a la acción.

Campos
call_to_action

CallToActionType

Llamado a la acción.

CustomParameter

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

Campos
key

string

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

value

string

Es el valor que se reemplazará.

DeviceInfo

Es un criterio de dispositivo.

Campos
type

Device

Tipo del dispositivo.

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 reduce para los clics que parecen menos probables.

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

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.

GenderInfo

Un criterio de género.

Campos
type

GenderType

El tipo de género.

ImageAsset

Un recurso de imagen.

Campos
mime_type

MimeType

Es el tipo de MIME del recurso de imagen.

full_size

ImageDimension

Metadatos de esta imagen en su tamaño original

file_size

int64

Es el tamaño del archivo del recurso de imagen en bytes.

ImageDimension

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

Campos
height_pixels

int64

Es la altura de la imagen.

width_pixels

int64

Ancho de la imagen.

url

string

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

Palabra clave

Un segmento de criterio de palabra clave.

Campos
info

KeywordInfo

Información de la palabra clave

ad_group_criterion

string

El nombre del recurso AdGroupCriterion.

KeywordInfo

Un criterio de palabra clave.

Campos
match_type

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).

LanguageInfo

Un criterio de idioma.

Campos
language_constant

string

El nombre del recurso de la constante de idioma.

ListingGroupInfo

Un criterio de grupo de fichas.

Campos
type

ListingGroupType

Tipo del grupo de fichas.

LocationGroupInfo

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

Campos
geo_target_constants[]

string

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.

radius_units

LocationGroupRadiusUnits

Unidad del radio. Las millas y los metros son compatibles con las constantes de objetivos geográficos. Las millas y los metros son compatibles con los conjuntos de elementos del feed. Es obligatorio y se debe establecer en las operaciones CREATE.

feed_item_sets[]

string

Los FeedItemSets cuyos FeedItems están segmentados Si se especifican varios IDs, se segmentan todos los artículos que aparecen en, al menos, un conjunto. Este campo no se puede usar con geo_target_constants. Este parámetro es opcional y solo se puede establecer en operaciones de creación.

radius

int64

Es la distancia en unidades que especifica el radio alrededor de las ubicaciones de segmentación. Es obligatorio y se debe establecer en las operaciones CREATE.

LocationInfo

Un criterio de ubicación.

Campos
geo_target_constant

string

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

ManualCpa

Este tipo no tiene campos.

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

ManualCpc

Son ofertas manuales basadas en clics en las que el usuario paga por clic.

Campos
enhanced_cpc_enabled

bool

Si las ofertas deben mejorarse en función de los datos del Optimizador de conversiones.

ManualCpm

Este tipo no tiene campos.

Son ofertas manuales basadas en impresiones en las que el usuario paga por mil impresiones.

MaximizeConversionValue

Una estrategia de ofertas automáticas para ayudarte a obtener el mayor valor de conversión para tus campañas sin exceder tu presupuesto.

Campos
cpc_bid_ceiling_micros

int64

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 oferta de cartera.

cpc_bid_floor_micros

int64

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 es mutable para las estrategias de ofertas de cartera.

target_roas

double

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, promediará el retorno de la inversión publicitaria objetivo. Si el ROAS objetivo es alto, es posible que la estrategia de ofertas no pueda invertir el presupuesto completo. 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.

Campos
cpc_bid_ceiling_micros

int64

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 oferta de cartera.

cpc_bid_floor_micros

int64

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 es mutable para las estrategias de ofertas de cartera.

target_cpa_micros

int64

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 microunidades de la moneda de la estrategia de ofertas. Si se establece, la estrategia de ofertas obtendrá la mayor cantidad posible de conversiones sin superar el costo por acción objetivo. Si no se establece el CPA objetivo, la estrategia de ofertas intentará alcanzar el CPA más bajo posible según el presupuesto.

Métricas

Datos de métricas.

Campos
all_conversions_value_by_conversion_date

double

El valor de todas las conversiones. Cuando se selecciona esta columna con la fecha, los valores de la columna de fecha representan la fecha de conversión. Los detalles de las columnas by_conversion_date están disponibles en https://support.google.com/sa360/answer/9250611.

all_conversions_by_conversion_date

double

La cantidad total de conversiones. Esto incluye todas las conversiones, independientemente del valor de include_in_conversions_metric. Cuando se selecciona esta columna con la fecha, los valores de la columna de fecha representan la fecha de conversión. Los detalles de las columnas by_conversion_date están disponibles en https://support.google.com/sa360/answer/9250611.

conversion_custom_metrics[]

Value

Las métricas personalizadas de conversión

conversions_value_by_conversion_date

double

Es la suma del valor de las conversiones aptas para oferta por fecha de conversión. Cuando se selecciona esta columna con la fecha, los valores de la columna de fecha representan la fecha de conversión.

conversions_by_conversion_date

double

Es la suma de conversiones por fecha de conversión para los tipos de conversión aptos para ofertas. Puede ser fraccionario debido al modelado de atribución. Cuando se selecciona esta columna con la fecha, los valores de la columna de fecha representan la fecha de conversión.

historical_creative_quality_score

QualityScoreBucket

El historial de nivel de calidad de la creatividad.

historical_landing_page_quality_score

QualityScoreBucket

La calidad de la experiencia histórica en la página de destino.

historical_search_predicted_ctr

QualityScoreBucket

La tasa de clics (CTR) prevista de la búsqueda histórica.

interaction_event_types[]

InteractionEventType

Los tipos de interacciones pagas y gratuitas.

raw_event_conversion_metrics[]

Value

Las métricas de conversión de eventos sin procesar

absolute_top_impression_percentage

double

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.

all_conversions_from_interactions_rate

double

Todas las conversiones generadas a partir de interacciones (en lugar de las conversiones posimpresión) divididas por la cantidad de interacciones con el anuncio.

all_conversions_value

double

El valor de todas las conversiones.

all_conversions

double

La cantidad total de conversiones. Esto incluye todas las conversiones, independientemente del valor de include_in_conversions_metric.

all_conversions_value_per_cost

double

Es el valor de todas las conversiones dividido por el costo total de las interacciones con los anuncios (como los clics en los anuncios de texto o las vistas de los anuncios de video).

all_conversions_from_click_to_call

double

Indica la cantidad de veces que los usuarios hicieron clic en el botón "Llamar" para llamar a una tienda mientras hacían clic en 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.

all_conversions_from_directions

double

Indica la cantidad de veces que los usuarios hicieron clic en el botón "Cómo llegar" para navegar a una tienda después de hacer clic en un anuncio.

Esta métrica solo se aplica a los elementos del feed.

all_conversions_from_interactions_value_per_interaction

double

Es el valor de todas las conversiones generadas a partir de interacciones dividido por la cantidad total de interacciones.

all_conversions_from_menu

double

Indica la cantidad de veces que los usuarios hicieron clic en un vínculo para ver el menú de una tienda después de hacer clic en un anuncio.

Esta métrica solo se aplica a los elementos del feed.

all_conversions_from_order

double

Es la cantidad de veces que los usuarios realizaron un pedido en una tienda después de hacer clic en un anuncio.

Esta métrica solo se aplica a los elementos del feed.

all_conversions_from_other_engagement

double

Es la cantidad de conversiones (por ejemplo, publicar una opinión o guardar la ubicación de una tienda) 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.

all_conversions_from_store_visit

double

Es la cantidad estimada de veces que los usuarios visitaron una tienda después de hacer clic en un anuncio.

Esta métrica solo se aplica a los elementos del feed.

visits

double

Clics que Search Ads 360 registró y reenvió de forma correcta a la página de destino de un anunciante.

all_conversions_from_store_website

double

Es la cantidad de veces que se redireccionó a los usuarios a la URL de una tienda después de hacer clic en un anuncio.

Esta métrica solo se aplica a los elementos del feed.

average_cost

double

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.

average_cpc

double

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 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

average_cpm

double

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 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

clicks

int64

La cantidad de clics.

content_budget_lost_impression_share

double

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 el rango de 0 a 0.9. Cualquier valor superior a 0.9 se informa como 0.9001.

content_impression_share

double

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.

content_rank_lost_impression_share

double

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.

conversions_from_interactions_rate

double

Es la cantidad promedio de conversiones aptas para ofertas (a partir de la interacción) por interacción apta para conversiones. Muestra la frecuencia promedio con la que una interacción con el anuncio genera una conversión apta para oferta.

client_account_conversions_value

double

El valor de las conversiones de la cuenta de cliente. Esto solo incluye las acciones de conversión que tienen el atributo include_in_client_account_conversions_metric como verdadero. Si usas ofertas basadas en conversiones, tus estrategias de ofertas se optimizarán para estas conversiones.

conversions_value_per_cost

double

Es el valor de la conversión apta para ofertas dividido por el costo total de las interacciones aptas para conversiones.

conversions_from_interactions_value_per_interaction

double

Es el valor de las conversiones a partir de las interacciones dividido por la cantidad de interacciones con el anuncio. Esto solo incluye las acciones de conversión que tienen el atributo include_in_conversions_metric como verdadero. Si usas ofertas basadas en conversiones, tus estrategias de ofertas se optimizarán para estas conversiones.

client_account_conversions

double

La cantidad de conversiones de la cuenta de cliente. Esto solo incluye las acciones de conversión que tienen el atributo include_in_client_account_conversions_metric como verdadero. Si usas ofertas basadas en conversiones, tus estrategias de ofertas se optimizarán para estas conversiones.

cost_micros

int64

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 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

cost_per_all_conversions

double

Es el costo de las interacciones con el anuncio dividido por todas las conversiones.

cost_per_conversion

double

Es el costo apto para conversiones promedio por conversión apta para oferta.

cost_per_current_model_attributed_conversion

double

Es el costo de las interacciones con anuncios dividido por las conversiones atribuidas del modelo actual. Esto solo incluye las acciones de conversión que tienen el atributo include_in_conversions_metric como verdadero. Si usas ofertas basadas en conversiones, tus estrategias de ofertas se optimizarán para estas conversiones.

cross_device_conversions

double

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 all_conversions.

cross_device_conversions_by_conversion_date

double

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 https://support.google.com/sa360/answer/9250611.

cross_device_conversions_value

double

Es la suma del valor de las conversiones en dispositivos múltiples.

cross_device_conversions_value_by_conversion_date

double

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 https://support.google.com/sa360/answer/9250611.

ctr

double

La cantidad de clics que recibe tu anuncio (clics) dividida por la cantidad de veces que se muestra tu anuncio (impresiones).

conversions

double

La cantidad de conversiones. Esto solo incluye las acciones de conversión que tienen el atributo include_in_conversions_metric como verdadero. Si usas ofertas basadas en conversiones, tus estrategias de ofertas se optimizarán para estas conversiones.

conversions_value

double

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.

average_quality_score

double

El nivel de calidad promedio.

historical_quality_score

int64

El historial del nivel de calidad.

impressions

int64

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.

interaction_rate

double

Es la frecuencia con la que los usuarios interactúan con su anuncio después de verlo. Es la cantidad de interacciones dividida por la cantidad de veces que se muestra tu anuncio.

interactions

int64

Es la cantidad de interacciones. Una interacción es la acción principal que realizan los usuarios en relación con un formato de anuncio, es decir, los clics en los anuncios de texto y de Shopping, las vistas en los anuncios de video, etcétera.

invalid_click_rate

double

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.

invalid_clicks

int64

Es la cantidad de clics que Google considera ilegítimos y por los que no se le cobra.

general_invalid_click_rate

double

Es el porcentaje de clics que se filtraron de la cantidad total de clics (clics filtrados y no filtrados) debido a clics no válidos generales. Estos son clics que Google considera ilegítimos y que se detectan a través de métodos de filtrado de rutina (es decir, tráfico no válido conocido del centro de datos, bots y arañas, o bien otros rastreadores, patrones irregulares, etcétera). No paga por ellos y no afectan las estadísticas de su cuenta. Consulta la página de ayuda en https://support.google.com/campaignmanager/answer/6076504 para obtener más detalles.

general_invalid_clicks

int64

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 paga por ellos y no afectan las estadísticas de su cuenta. Consulta la página de ayuda en https://support.google.com/campaignmanager/answer/6076504 para obtener más información.

mobile_friendly_clicks_percentage

double

Es el porcentaje de clics desde dispositivos móviles que dirigen a una página optimizada para dispositivos móviles.

search_absolute_top_impression_share

double

Es el porcentaje de impresiones de anuncios de Shopping o de búsqueda del cliente que se muestran en la posición más destacada de Shopping. Consulta https://support.google.com/sa360/answer/9566729 para obtener más información. Cualquier valor inferior a 0.1 se informa como 0.0999.

search_budget_lost_absolute_top_impression_share

double

Es el número 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 de resultados de la búsqueda debido a un presupuesto bajo. Nota: El porcentaje absoluto de impresiones perdidas en la parte superior de la página de búsqueda 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.

search_budget_lost_impression_share

double

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.

search_budget_lost_top_impression_share

double

Es el número 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 presupuesto bajo. Nota: El porcentaje de impresiones perdidas en la parte superior de la página de búsqueda 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.

search_click_share

double

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 de búsqueda se informa en un rango de 0.1 a 1. Cualquier valor inferior a 0.1 se informa como 0.0999.

search_exact_match_impression_share

double

Es la cantidad de impresiones que recibió dividida por la cantidad estimada de impresiones que podría haber recibido en la Red de Búsqueda para los términos de búsqueda que coincidieron de manera exacta con sus palabras clave (o que eran variantes cercanas de su palabra clave), independientemente de sus tipos de concordancia de 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.

search_impression_share

double

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.

search_rank_lost_absolute_top_impression_share

double

Es la cifra que calcula 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 absoluto de impresiones perdidas en la parte superior de la página de búsqueda (clasificación) se informa en un rango de 0 a 0.9. Cualquier valor superior a 0.9 se informa como 0.9001.

search_rank_lost_impression_share

double

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.

search_rank_lost_top_impression_share

double

Es el número 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 de la clasificación se informa en un rango de 0 a 0.9. Cualquier valor superior a 0.9 se informa como 0.9001.

search_top_impression_share

double

Es la cantidad de impresiones que recibiste entre los anuncios de la parte superior de la página en comparación con la cantidad estimada de impresiones que podrías haber recibido entre esos anuncios. Nota: El porcentaje de impresiones en la parte superior de la página de búsqueda se informa en el 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.

top_impression_percentage

double

Es el porcentaje de tus impresiones de anuncios que se muestran junto a los principales resultados de la búsqueda orgánica.

value_per_all_conversions

double

Es el valor de todas las conversiones dividido por la cantidad total de conversiones.

value_per_all_conversions_by_conversion_date

double

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 representan la fecha de conversión. Los detalles de las columnas by_conversion_date están disponibles en https://support.google.com/sa360/answer/9250611.

value_per_conversion

double

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 oferta.

value_per_conversions_by_conversion_date

double

Es el valor de las conversiones aptas para oferta por fecha de conversión dividido por las conversiones aptas para oferta por fecha de conversión. Muestra cuánto vale, en promedio, cada una de las conversiones aptas para ofertas (por fecha de conversión). Cuando se selecciona esta columna con la fecha, los valores de la columna de fecha representan la fecha de conversión.

client_account_view_through_conversions

int64

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).

client_account_cross_sell_cost_of_goods_sold_micros

int64

El costo de bienes vendidos en forma cruzada (CBV) de la cuenta de 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 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

cross_sell_cost_of_goods_sold_micros

int64

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 los 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: Alguien hizo clic en un 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 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

client_account_cross_sell_gross_profit_micros

int64

Las ganancias brutas por ventas cruzadas de la cuenta de 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: Alguien hizo clic en un 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 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

cross_sell_gross_profit_micros

int64

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 los 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: Alguien hizo clic en un 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 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

client_account_cross_sell_revenue_micros

int64

Los ingresos por ventas cruzadas de la cuenta de cliente 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: Alguien hizo clic en un 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 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

cross_sell_revenue_micros

int64

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 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

client_account_cross_sell_units_sold

double

Las unidades vendidas en forma cruzada de cuenta de 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 de 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.

cross_sell_units_sold

double

"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 de 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.

client_account_lead_cost_of_goods_sold_micros

int64

El costo de bienes vendidos a clientes potenciales (CBV) de la cuenta de cliente 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: Alguien hizo clic en un 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 a clientes potenciales 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 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

lead_cost_of_goods_sold_micros

int64

El costo de bienes vendidos a clientes potenciales (CBV) 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 a clientes potenciales 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 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

client_account_lead_gross_profit_micros

int64

Las ganancias brutas por clientes potenciales de la cuenta de 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: Alguien hizo clic en un 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 clientes potenciales 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 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

lead_gross_profit_micros

int64

Las ganancias brutas por clientes potenciales 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 clientes potenciales 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 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

client_account_lead_revenue_micros

int64

Los ingresos por clientes potenciales de la cuenta de cliente 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 los 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: Alguien hizo clic en un 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 clientes potenciales 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 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

lead_revenue_micros

int64

Los ingresos por clientes potenciales 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: Alguien hizo clic en un 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 clientes potenciales 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 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

client_account_lead_units_sold

double

Las unidades de venta directa vendidas de la cuenta de cliente 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 los 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 de 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.

lead_units_sold

double

Las unidades vendidas a clientes potenciales vendidas 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 de 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.

MobileAppAsset

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

Campos
app_id

string

Obligatorio. Es una cadena que identifica de forma exclusiva 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.

app_store

MobileAppVendor

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

PercentCpc

Es una estrategia de ofertas en la que las ofertas son una fracción del precio anunciado de un bien o servicio.

Campos
cpc_bid_ceiling_micros

int64

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.

enhanced_cpc_enabled

bool

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

RealTimeBiddingSetting

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

Campos
opt_in

bool

Si la campaña está habilitada para las ofertas en tiempo real.

SearchAds360ExpandedDynamicSearchAdInfo

Un anuncio dinámico de búsqueda expandido.

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.

ad_tracking_id

int64

Es el ID de seguimiento del anuncio.

SearchAds360ExpandedTextAdInfo

Un anuncio de texto expandido de Search Ads 360

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

Texto agregado con un delimitador a la URL visible generada automáticamente.

path2

string

Texto agregado a path1 con un delimitador.

ad_tracking_id

int64

Es el ID de seguimiento del anuncio.

SearchAds360ProductAdInfo

Este tipo no tiene campos.

Un anuncio de productos de Search Ads 360

SearchAds360ResponsiveSearchAdInfo

Anuncio de búsqueda responsivo de Search Ads 360.

Campos
headlines[]

AdTextAsset

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

descriptions[]

AdTextAsset

Es la 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 agregado a path1 con un delimitador.

ad_tracking_id

int64

Es el ID de seguimiento del anuncio.

SearchAds360TextAdInfo

Un anuncio de texto de Search Ads 360

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.

display_url

string

Es la URL que se muestra en el anuncio.

display_mobile_url

string

Es la URL para dispositivos móviles que se muestra del anuncio.

ad_tracking_id

int64

Es el ID de seguimiento del anuncio.

Segmentos

Segmenta solo los campos.

Campos
ad_network_type

AdNetworkType

Tipo de red del anuncio

conversion_action_category

ConversionActionCategory

Categoría de acción de conversión.

conversion_custom_dimensions[]

Value

Son las dimensiones personalizadas de conversión.

day_of_week

DayOfWeek

Día de la semana, por ejemplo, LUNES.

device

Device

Dispositivo al que se aplican las métricas.

keyword

Keyword

Criterio de palabra clave.

product_channel

ProductChannel

Canal del producto.

product_channel_exclusivity

ProductChannelExclusivity

Exclusividad de canal del producto.

product_condition

ProductCondition

Estado del producto.

product_sold_condition

ProductCondition

Estado del producto vendido.

raw_event_conversion_dimensions[]

Value

Las dimensiones de conversión de eventos sin procesar.

conversion_action

string

El nombre del recurso de la acción de conversión.

conversion_action_name

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.

geo_target_city

string

Es el nombre del recurso de la constante de segmentación geográfica que representa una ciudad.

geo_target_country

string

Es el nombre del recurso de la constante de segmentación geográfica que representa un país.

geo_target_metro

string

Es el nombre del recurso de la constante de segmentación geográfica que representa un área metropolitana.

geo_target_region

string

Es el nombre del recurso de la constante de segmentación geográfica que representa una región.

hour

int32

La hora del día como un número entre 0 y 23, ambos incluidos.

month

string

Es el mes representado por la fecha del primer día de un mes. Debe tener el formato aaaa-MM-dd.

product_bidding_category_level1

string

Categoría de oferta (nivel 1) del producto.

product_bidding_category_level2

string

Categoría de oferta (nivel 2) del producto.

product_bidding_category_level3

string

Categoría de oferta (nivel 3) del producto.

product_bidding_category_level4

string

Categoría de oferta (nivel 4) del producto.

product_bidding_category_level5

string

Categoría de oferta (nivel 5) del producto.

product_brand

string

Es la marca del producto.

product_country

string

Es el nombre del recurso de la constante de segmentación geográfica para el país de venta del producto.

product_custom_attribute0

string

Atributo personalizado 0 del producto.

product_custom_attribute1

string

Atributo personalizado 1 del producto.

product_custom_attribute2

string

Atributo personalizado 2 del producto.

product_custom_attribute3

string

Atributo personalizado 3 del producto.

product_custom_attribute4

string

Atributo personalizado 4 del producto.

product_item_id

string

Es el ID del artículo.

product_language

string

Nombre del recurso de la constante de idioma del idioma del producto.

product_sold_bidding_category_level1

string

Categoría de oferta (nivel 1) del producto vendido.

product_sold_bidding_category_level2

string

Categoría de oferta (nivel 2) del producto vendido.

product_sold_bidding_category_level3

string

Categoría de oferta (nivel 3) del producto vendido.

product_sold_bidding_category_level4

string

Categoría de oferta (nivel 4) del producto vendido.

product_sold_bidding_category_level5

string

Categoría de ofertas (nivel 5) del producto vendido.

product_sold_brand

string

La marca del producto vendido.

product_sold_custom_attribute0

string

Atributo personalizado 0 del producto vendido.

product_sold_custom_attribute1

string

Atributo personalizado 1 del producto vendido.

product_sold_custom_attribute2

string

Atributo personalizado 2 del producto vendido.

product_sold_custom_attribute3

string

Atributo personalizado 3 del producto vendido.

product_sold_custom_attribute4

string

Atributo personalizado 4 del producto vendido.

product_sold_item_id

string

El ID del artículo vendido.

product_sold_title

string

El título del producto vendido.

product_sold_type_l1

string

Tipo (nivel 1) del producto vendido.

product_sold_type_l2

string

Tipo (nivel 2) del producto vendido.

product_sold_type_l3

string

Tipo (nivel 3) del producto vendido.

product_sold_type_l4

string

Tipo (nivel 4) del producto vendido.

product_sold_type_l5

string

Tipo (nivel 5) del producto vendido.

product_store_id

string

Es el ID de tienda del producto.

product_title

string

Título del producto.

product_type_l1

string

Tipo de producto (nivel 1).

product_type_l2

string

Tipo de producto (nivel 2)

product_type_l3

string

Tipo de producto (nivel 3)

product_type_l4

string

Tipo de producto (nivel 4).

product_type_l5

string

Tipo de producto (nivel 5).

quarter

string

Es el trimestre representado por la fecha del primer día de un trimestre. Usa el año calendario para los trimestres. Por ejemplo, el segundo trimestre de 2018 comienza el 01-04-2018. Debe tener el formato aaaa-MM-dd.

week

string

Es la semana, definida como del lunes al domingo, y se representa con la fecha del lunes. Debe tener el formato aaaa-MM-dd.

year

int32

Es el año, con el formato aaaa.

asset_interaction_target

AssetInteractionTarget

Solo se usa con las métricas CustomerAsset, CampaignAsset y AdGroupAsset. Indica si las métricas de interacción se produjeron en el recurso en sí o en un recurso o unidad de anuncios diferente. Las interacciones (por ejemplo, clics) se registran en todas las partes del anuncio publicado (por ejemplo, el propio anuncio y otros componentes, como los vínculos a sitios) cuando se publican juntas. Cuando interaction_on_this_asset es verdadero, significa que las interacciones se producen en este recurso específico y, cuando 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.

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.

Campos
target_cpa_micros

int64

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

cpc_bid_ceiling_micros

int64

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.

cpc_bid_floor_micros

int64

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.

TargetCpm

Este tipo no tiene campos.

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

TargetImpressionShare

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

Campos
location

TargetImpressionShareLocation

La ubicación de segmentación en la página de resultados de la búsqueda.

location_fraction_micros

int64

Es la fracción elegida de anuncios que se mostrarán en la ubicación segmentada en micros. Por ejemplo, 1% equivale a 10,000.

cpc_bid_ceiling_micros

int64

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.

TargetOutrankShare

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

Campos
cpc_bid_ceiling_micros

Int64Value

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.

TargetRestriction

Es la lista de parámetros de configuración de la segmentación por dimensión de segmentación.

Campos
targeting_dimension

TargetingDimension

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

bid_only

bool

Indica si se deben restringir tus anuncios para que se muestren solo para los criterios que seleccionaste para esta targeting_dimension o para segmentar todos los valores de esta targeting_dimension 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.

TargetRoas

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

Campos
target_roas

double

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.

cpc_bid_ceiling_micros

int64

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.

cpc_bid_floor_micros

int64

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.

Campos
target_spend_micros
(deprecated)

int64

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 información.

cpc_bid_ceiling_micros

int64

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.

TargetingSetting

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 información sobre la configuración de la segmentación, visita https://support.google.com/google-ads/answer/7365594

Campos
target_restrictions[]

TargetRestriction

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

TextAsset

Un recurso de texto.

Campos
text

string

Es el contenido de texto del recurso de texto.

TextLabel

Un tipo de etiqueta que muestra texto sobre un fondo de color.

Campos
background_color

string

Es el 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 descripción breve de la etiqueta. La longitud no debe superar los 200 caracteres.

UnifiedCallAsset

Un recurso de llamada unificado

Campos
country_code

string

Es el código de país de dos letras del número de teléfono. Ejemplos: "US", "us".

phone_number

string

El número de teléfono sin procesar del anunciante Ejemplo: "1234567890", "(123)456-7890"

call_conversion_reporting_state

CallConversionReportingState

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

call_conversion_action

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 call_conversion_reporting_state está configurado como USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION.

ad_schedule_targets[]

AdScheduleInfo

Lista de programaciones que no se superponen y que especifican todos los intervalos de tiempo en los que puede publicarse el recurso. Se puede establecer un máximo de 6 programaciones por día, 42 en total.

call_only

bool

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

call_tracking_enabled

bool

Si se debe habilitar la llamada en el seguimiento de llamadas Se aplica a Microsoft Ads.

use_searcher_time_zone

bool

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

start_date

string

Es la fecha de inicio en la que este recurso entrará en vigencia y puede comenzar a publicarse, en formato aaaa-MM-dd.

end_date

string

Es la última fecha en la que este recurso está vigente y se publica, en formato aaaa-mm-dd.

UnifiedCalloutAsset

Un recurso de texto destacado unificado.

Campos
callout_text

string

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

start_date

string

Es la fecha de inicio en la que este recurso es efectivo y puede comenzar a publicarse, en formato AAAA-MM-DD.

end_date

string

Es la última fecha en la que este recurso está vigente y se publica, en formato aaaa-mm-dd.

ad_schedule_targets[]

AdScheduleInfo

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

use_searcher_time_zone

bool

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

UnifiedLocationAsset

Un recurso de ubicación unificado.

Campos
place_id

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.

business_profile_locations[]

BusinessProfileLocation

Es la lista de ubicaciones de la empresa del cliente. Solo se mostrará 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 apunten al mismo ID de lugar.

location_ownership_type

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 una ubicación afiliada.

UnifiedPageFeedAsset

Un recurso de feed de páginas unificado.

Campos
page_url

string

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

labels[]

string

Las etiquetas que se usan para agrupar las URLs de las páginas.

UnifiedSitelinkAsset

Un recurso de vínculo a sitio unificado

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.

start_date

string

Es la fecha de inicio en la que este recurso es efectivo y puede comenzar a publicarse, en formato AAAA-MM-DD.

end_date

string

Es la última fecha en la que este recurso está vigente y se publica, en formato aaaa-mm-dd.

ad_schedule_targets[]

AdScheduleInfo

Es una lista de programas no superpuestos que especifican todos los intervalos de tiempo para los que se puede publicar el recurso. Se puede establecer un máximo de 6 programaciones por día, 42 en total.

tracking_id

int64

Es el ID que se usa para hacer un seguimiento de los clics del recurso de vínculo a sitio. Esta es una cuenta de Yahoo! Campo solo para Japón.

use_searcher_time_zone

bool

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

mobile_preferred

bool

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

UserListInfo

Un criterio de lista de usuarios. Representa una lista de usuarios que el anunciante define para segmentar sus anuncios.

Campos
user_list

string

El nombre del recurso de la lista de usuarios.

Valor

Un contenedor de datos genérico

Campos
Campo de unión value. Un valor. Las direcciones (value) solo pueden ser una de las siguientes opciones:
boolean_value

bool

Un valor booleano.

int64_value

int64

Un int64.

float_value

float

Un número de punto flotante.

double_value

double

Un valor doble.

string_value

string

Una string.

WebpageConditionInfo

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

Campos
operand

WebpageConditionOperand

Operando de la condición de segmentación de páginas web.

operator

WebpageConditionOperator

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.

WebpageInfo

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

Campos
conditions[]

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.

coverage_percentage

double

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.

criterion_name

string

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.

YoutubeVideoAsset

Un activo de YouTube

Campos
youtube_video_title

string

Título del video de YouTube

youtube_video_id

string

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