Package google.ads.searchads360.v0.resources

Índice

AccessibleBiddingStrategy

Representa una vista de las estrategias de ofertas que pertenecen al cliente y que se comparten con él.

A diferencia de la estrategia de ofertas, este recurso incluye estrategias que pertenecen a los administradores del cliente y que se comparten con este, además de estrategias que son propiedad de este cliente. Este recurso no proporciona métricas y solo expone un subconjunto limitado de los atributos de BiddingStrategy.

Campos
resource_name

string

El nombre del recurso de la estrategia de oferta accesible. Los nombres de los recursos de AccessibleBiddingStrategy tienen el siguiente formato:

customers/{customer_id}/accessibleBiddingStrategies/{bidding_strategy_id}

id

int64

El ID de la estrategia de ofertas.

name

string

El nombre de la estrategia de ofertas.

type

BiddingStrategyType

Es el tipo de estrategia de ofertas.

owner_customer_id

int64

El ID del cliente propietario de la estrategia de ofertas.

owner_descriptive_name

string

descriptive_name del cliente propietario de la estrategia de ofertas

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

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

maximize_conversion_value

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.

maximize_conversions

MaximizeConversions

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

target_cpa

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.

target_impression_share

TargetImpressionShare

Es una estrategia de ofertas que realiza optimizaciones automáticamente en función de un porcentaje determinado de impresiones.

target_roas

TargetRoas

Es una estrategia de oferta que te ayuda a maximizar los ingresos mientras obtienes un retorno de la inversión publicitaria (ROAS) objetivo específico.

target_spend

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.

Campos
target_roas

double

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, 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 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

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

Campos
target_cpa

int64

La opción de costo por adquisición (CPA) objetivo. Es el importe promedio que deseas invertir por adquisición.

target_cpa_micros

int64

La opción de costo por adquisición (CPA) objetivo. 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.

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.

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 de segmentación).

Campos
location

TargetImpressionShareLocation

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

location_fraction_micros

int64

La fracción elegida de anuncios para que se muestren en la ubicación de segmentación en microsegundos. Por ejemplo, 1% es igual 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.

TargetRoas

Es una estrategia de ofertas automáticas que te ayuda a maximizar los ingresos mientras obtienes un retorno de la inversión publicitaria (ROAS) objetivo específico.

Campos
target_roas

double

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.

Campos
target_spend_micros
(deprecated)

int64

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

Un anuncio

Campos
resource_name

string

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

customers/{customer_id}/ads/{ad_id}

final_urls[]

string

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

type

AdType

El tipo de anuncio.

id

int64

El ID del anuncio.

display_url

string

La URL que aparece en la descripción del anuncio para algunos formatos de anuncios.

name

string

El nombre del anuncio. Esto solo se utiliza para identificar el anuncio. No es necesario que sea único y no afecta el anuncio publicado. Por el momento, el campo de nombre solo es compatible con DisplayUploadAd, ImageAd, ShoppingComparisonListingAd y VideoAd.

Campo de unión ad_data. Son los detalles pertinentes al tipo de anuncio. Se debe establecer exactamente un valor. Las direcciones (ad_data) solo pueden ser una de las siguientes opciones:
text_ad

SearchAds360TextAdInfo

Son los detalles relacionados con un anuncio de texto.

expanded_text_ad

SearchAds360ExpandedTextAdInfo

Son los detalles relacionados con un anuncio de texto expandido.

responsive_search_ad

SearchAds360ResponsiveSearchAdInfo

Detalles relacionados con un anuncio de búsqueda responsivo.

product_ad

SearchAds360ProductAdInfo

Detalles relacionados con un anuncio de producto.

expanded_dynamic_search_ad

SearchAds360ExpandedDynamicSearchAdInfo

Son los detalles que pertenecen a un anuncio dinámico de búsqueda expandido.

Grupo de anuncios

Un grupo de anuncios

Campos
resource_name

string

El nombre del recurso del grupo de anuncios. Los nombres de recursos del grupo de anuncios tienen el siguiente formato:

customers/{customer_id}/adGroups/{ad_group_id}

status

AdGroupStatus

El estado del grupo de anuncios.

type

AdGroupType

Indica el tipo de grupo de anuncios.

ad_rotation_mode

AdGroupAdRotationMode

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

creation_time

string

Es la marca de tiempo cuando se creó este 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”.

targeting_setting

TargetingSetting

Parámetro de configuración de la segmentación para funciones relacionadas.

labels[]

string

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

engine_id

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 "ad_group.id".

start_date

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

end_date

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

language_code

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

last_modified_time

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

int64

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

cpc_bid_micros

int64

La oferta de CPC (costo por clic) máxima.

engine_status

AdGroupEngineStatus

El estado del motor para el grupo de anuncios.

AdGroupAd

Un anuncio del grupo de anuncios.

Campos
resource_name

string

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

customers/{customer_id}/adGroupAds/{ad_group_id}~{ad_id}

status

AdGroupAdStatus

El estado del anuncio.

ad

Ad

El anuncio

creation_time

string

Es la marca de tiempo cuando se creó este ad_group_ad. 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.

engine_id

string

ID del anuncio en la cuenta de motor externa. Este campo es solo para la cuenta de Search Ads 360, por ejemplo, Yahoo Japan, Microsoft, Baidu, etc. Para una entidad que no sea de Search Ads 360, usa "ad_group_ad.ad.id" en su lugar.

engine_status

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.

last_modified_time

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

AdGroupAdLabel

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

Campos
resource_name

string

El nombre del recurso de la etiqueta de anuncio del grupo de anuncios. Los nombres de los recursos de las etiquetas de anuncios del grupo de anuncios tienen el siguiente formato: customers/{customer_id}/adGroupAdLabels/{ad_group_id}~{ad_id}~{label_id}

ad_group_ad

string

El anuncio del grupo de anuncios al que se adjuntó la etiqueta

label

string

La etiqueta asignada al anuncio del grupo de anuncios.

AdGroupAsset

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

Campos
resource_name

string

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

customers/{customer_id}/adGroupAssets/{ad_group_id}~{asset_id}~{field_type}

ad_group

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

AssetLinkStatus

Estado del recurso del grupo de anuncios.

AdGroupAssetSet

AdGroupAssetSet es la vinculación entre un grupo de anuncios y un conjunto de recursos. Cuando se crea un AdGroupAssetSet, se vincula un conjunto de recursos con un grupo de anuncios.

Campos
resource_name

string

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

customers/{customer_id}/adGroupAssetSets/{ad_group_id}~{asset_set_id}

ad_group

string

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

asset_set

string

Es el conjunto de recursos vinculado al grupo de anuncios.

status

AssetSetLinkStatus

El estado del conjunto de recursos del grupo de anuncios. Solo lectura.

AdGroupAudienceView

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

Campos
resource_name

string

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

customers/{customer_id}/adGroupAudienceViews/{ad_group_id}~{criterion_id}

AdGroupBidModifier

Representa un modificador de oferta del grupo de anuncios.

Campos
resource_name

string

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

customers/{customer_id}/adGroupBidModifiers/{ad_group_id}~{criterion_id}

bid_modifier

double

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

Campo de unión criterion. El criterio de este modificador de oferta del grupo de anuncios.

Es obligatorio en las operaciones de creación a partir de V5. criterion puede ser una de las siguientes opciones:

device

DeviceInfo

Un criterio de dispositivo.

AdGroupCriterion

Un criterio del grupo de anuncios. El informe de criterios de grupo de anuncios solo muestra los criterios que se agregaron explícitamente al grupo de anuncios.

Campos
resource_name

string

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

customers/{customer_id}/adGroupCriteria/{ad_group_id}~{criterion_id}

creation_time

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

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.

quality_info

QualityInfo

Información sobre la calidad del criterio.

type

CriterionType

El tipo del criterio.

labels[]

string

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

position_estimates

PositionEstimates

Estimaciones de ofertas de criterio en varias posiciones.

final_urls[]

string

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

engine_id

string

ID del criterio del grupo de anuncios en la cuenta de motor externo. Este campo es solo para las cuentas que no son de Google Ads; por ejemplo, Yahoo Japan, Microsoft, Baidu, etc. Para la entidad de Google Ads, usa "ad_group_criterion.criterion_id" en su lugar.

last_modified_time

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

criterion_id

int64

El ID del criterio.

ad_group

string

El grupo de anuncios al que pertenece el criterio

negative

bool

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

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

bid_modifier

double

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.

cpc_bid_micros

int64

La oferta de CPC (costo por clic).

effective_cpc_bid_micros

int64

La oferta de CPC (costo por clic) efectiva.

engine_status

AdGroupCriterionEngineStatus

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

final_url_suffix

string

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

tracking_url_template

string

La plantilla de URL para crear una URL de seguimiento.

Campo de unión criterion. El criterio del grupo de anuncios.

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

keyword

KeywordInfo

Palabra clave.

listing_group

ListingGroupInfo

Grupo de fichas.

age_range

AgeRangeInfo

Rango de edad.

gender

GenderInfo

Género.

user_list

UserListInfo

Lista de usuarios

webpage

WebpageInfo

Página web

location

LocationInfo

Ubicación.

PositionEstimates

Estimaciones de ofertas de criterio en varias posiciones.

Campos
top_of_page_cpc_micros

int64

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

QualityInfo

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

Campos
quality_score

int32

El nivel de calidad.

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

AdGroupCriterionLabel

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

Campos
resource_name

string

El nombre del recurso de la etiqueta de criterio del grupo de anuncios. Los nombres de recursos de la etiqueta de criterio del grupo de anuncios tienen el siguiente formato: customers/{customer_id}/adGroupCriterionLabels/{ad_group_id}~{criterion_id}~{label_id}

ad_group_criterion

string

El criterio del grupo de anuncios al que se adjuntó la etiqueta.

label

string

Es la etiqueta asignada al criterio del grupo de anuncios.

AdGroupLabel

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

Campos
resource_name

string

El nombre del recurso de la etiqueta del grupo de anuncios. Los nombres de recursos de la etiqueta del grupo de anuncios tienen el siguiente formato: customers/{customer_id}/adGroupLabels/{ad_group_id}~{label_id}

ad_group

string

El grupo de anuncios al que se adjuntó la etiqueta

label

string

La etiqueta asignada al grupo de anuncios.

AgeRangeView

Vista de rango de edad

Campos
resource_name

string

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

customers/{customer_id}/ageRangeViews/{ad_group_id}~{criterion_id}

Recurso

El recurso es parte de un anuncio que se puede compartir entre varios anuncios. Puede ser una imagen (ImageAsset), un video (YouTubeVideoAsset), etc. Los recursos son inmutables y no se pueden quitar. Para detener la publicación de un recurso, quítalo de la entidad que lo está usando.

Campos
resource_name

string

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

customers/{customer_id}/assets/{asset_id}

type

AssetType

Es el tipo de activo.

final_urls[]

string

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

status

AssetStatus

El estado del recurso.

creation_time

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

last_modified_time

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

id

int64

El ID del activo.

name

string

Es el nombre opcional del activo.

tracking_url_template

string

Plantilla de URL para crear una URL de seguimiento.

engine_status

AssetEngineStatus

El estado del motor de un recurso.

Campo de unión asset_data. El tipo específico del activo. Las direcciones (asset_data) solo pueden ser una de las siguientes opciones:
youtube_video_asset

YoutubeVideoAsset

Un activo de video de YouTube

image_asset

ImageAsset

Un recurso de imagen

text_asset

TextAsset

Un recurso de texto

callout_asset

UnifiedCalloutAsset

Un recurso de texto destacado unificado

page_feed_asset

UnifiedPageFeedAsset

Un recurso de feed de páginas unificado

mobile_app_asset

MobileAppAsset

Un recurso de aplicación para dispositivos móviles

call_asset

UnifiedCallAsset

Un recurso de llamada unificado

call_to_action_asset

CallToActionAsset

Un recurso de llamado a la acción

location_asset

UnifiedLocationAsset

Un recurso de ubicación unificado

AssetGroup

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.

Campos
resource_name

string

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

customers/{customer_id}/assetGroups/{asset_group_id}

id

int64

El ID del grupo de recursos.

campaign

string

La campaña a la que está asociado este grupo de recursos. El recurso que está vinculado al grupo de recursos.

name

string

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

final_urls[]

string

Una lista de las URL finales después de todos los redireccionamientos multidominio. De forma predeterminada, en las campañas de máximo rendimiento, las URLs son aptas para la expansión, a menos que se inhabiliten.

final_mobile_urls[]

string

Una lista de las URL finales para dispositivos móviles después de todos los redireccionamientos multidominio. De forma predeterminada, en las campañas de máximo rendimiento, las URLs son aptas para la expansión, a menos que se inhabiliten.

status

AssetGroupStatus

El estado del grupo de recursos.

path1

string

Primera parte del texto que puede aparecer anexado a la URL que aparece en el anuncio.

path2

string

Es la segunda parte del texto que puede aparecer adjunta a la URL que aparece en el anuncio. Este campo solo se puede establecer cuando se establece la ruta 1.

ad_strength

AdStrength

Es la calidad general del anuncio de este grupo de recursos.

AssetGroupAsset

AssetGroupAsset es el vínculo entre un recurso y un grupo de recursos. Si agregas un AssetGroupAsset, se vincula un activo con un grupo de recursos.

Campos
resource_name

string

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

customers/{customer_id}/assetGroupAssets/{asset_group_id}~{asset_id}~{field_type}

asset_group

string

El grupo de recursos que se vincula con este grupo de recursos.

asset

string

El recurso que se vincula con este grupo de recursos.

field_type

AssetFieldType

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

status

AssetLinkStatus

El estado del vínculo entre un recurso y un grupo de recursos.

AssetGroupAssetCombinationData

Datos de combinación de recursos del grupo de recursos

Campos
asset_combination_served_assets[]

AssetUsage

Elementos publicados.

AssetGroupListingGroupFilter

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

Campos
resource_name

string

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

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

asset_group

string

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

id

int64

Es el ID de ListingGroupFilter.

type

ListingGroupFilterType

Tipo de un nodo de filtro de grupos de fichas.

vertical

ListingGroupFilterVertical

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

case_value

ListingGroupFilterDimension

Es el valor de la dimensión con la que este grupo de fichas define mejor el elemento superior. No definido para el grupo raíz.

parent_listing_group_filter

string

Nombre del recurso de la subdivisión del grupo de fichas superior. Nulo para el nodo de filtro del grupo de la lista raíz.

path

ListingGroupFilterDimensionPath

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

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én tiene más probabilidades de generar conversiones. Las campañas de máximo rendimiento utilizan el indicador para buscar personas nuevas con una intención similar o más sólida para encontrar conversiones en la Búsqueda, Display, video y mucho más.

Campos
resource_name

string

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/{customer_id}/assetGroupSignals/{asset_group_id}~{signal_id}

asset_group

string

El grupo de recursos al que pertenece este indicador de grupo de recursos.

Campo de unión signal. El indicador del grupo de recursos. Las direcciones (signal) solo pueden ser una de las siguientes opciones:
audience

AudienceInfo

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

AssetGroupTopCombinationView

Una vista del uso de la combinación de recursos del anuncio del grupo de anuncios.

Campos
resource_name

string

El nombre del recurso de la vista de combinación en la parte superior del grupo de recursos. Los nombres de los recursos de la vista de combinación principal de AssetGroup tienen el siguiente formato: `"customers/{customer_id}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}"

asset_group_top_combinations[]

AssetGroupAssetCombinationData

Las principales combinaciones de recursos que se publicaron juntos.

AssetSet

Un conjunto de recursos que representa un conjunto de recursos. Usa AssetSetAsset para vincular un activo al conjunto de recursos.

Campos
id

int64

El ID del conjunto de activos.

resource_name

string

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

customers/{customer_id}/assetSets/{asset_set_id}

AssetSetAsset

AssetSetAsset es el vínculo entre un activo y un conjunto de recursos. Cuando se agrega un AssetSetAsset, se vincula un activo con un conjunto de recursos.

Campos
resource_name

string

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

customers/{customer_id}/assetSetAssets/{asset_set_id}~{asset_id}

asset_set

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

AssetSetAssetStatus

El estado del activo del conjunto de elementos. Solo lectura.

Público

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

Campos
resource_name

string

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

customers/{customer_id}/audiences/{audience_id}

id

int64

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 máxima de 255.

description

string

Es la descripción de este público.

BiddingStrategy

Una estrategia de ofertas

Campos
resource_name

string

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

customers/{customer_id}/biddingStrategies/{bidding_strategy_id}

status

BiddingStrategyStatus

El estado de la estrategia de ofertas.

Este campo es de solo lectura.

type

BiddingStrategyType

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

Este campo es de solo lectura.

currency_code

string

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

Para las estrategias de ofertas en clientes administradores, esta moneda se puede configurar durante la creación y se establece de forma predeterminada en la moneda del cliente administrador. Para brindar servicio a los clientes, este campo no se puede configurar. Todas las estrategias de un cliente de entrega usan de forma implícita la moneda de ese cliente. En todos los casos, el campoeffective_currency_code muestra la moneda utilizada por la estrategia.

id

int64

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

effective_currency_code

string

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

En el caso de las estrategias de ofertas en clientes administradores, esta es la moneda que establece el anunciante cuando crea la estrategia. Para brindar servicio a los clientes, corresponde al currency_code del cliente.

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

Este campo es de solo lectura.

campaign_count

int64

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

Este campo es de solo lectura.

non_removed_campaign_count

int64

Es la cantidad de campañas no quitadas que se adjuntan 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 una. scheme puede ser una de las siguientes opciones:

enhanced_cpc

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 menos probables.

maximize_conversion_value

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.

maximize_conversions

MaximizeConversions

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

target_cpa

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.

target_impression_share

TargetImpressionShare

Es una estrategia de ofertas que realiza optimizaciones automáticamente en función de un porcentaje determinado de impresiones.

target_outrank_share

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 tener un ranking superior a un competidor específico. Este campo ya no está disponible. No se podrá crear una estrategia de oferta nueva con este campo o adjuntar estrategias de oferta con este campo a una campaña. Se permiten las mutaciones de las estrategias que ya completaron este esquema.

target_roas

TargetRoas

Es una estrategia de oferta que te ayuda a maximizar los ingresos mientras obtienes un retorno de la inversión publicitaria (ROAS) objetivo específico.

target_spend

TargetSpend

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

Campaña

Una campaña

Campos
resource_name

string

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

customers/{customer_id}/campaigns/{campaign_id}

status

CampaignStatus

El estado de la campaña.

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

serving_status

CampaignServingStatus

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

bidding_strategy_system_status

BiddingStrategySystemStatus

El estado del sistema de la estrategia de ofertas de la campaña.

ad_serving_optimization_status

AdServingOptimizationStatus

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

advertising_channel_type

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

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.

advertising_channel_sub_type

AdvertisingChannelSubType

Perfeccionamiento opcional a advertising_channel_type. 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.

url_custom_parameters[]

CustomParameter

La lista de asignaciones utilizadas para sustituir etiquetas de parámetros personalizados en un tracking_url_template, final_urls o mobile_final_urls.

real_time_bidding_setting

RealTimeBiddingSetting

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

network_settings

NetworkSettings

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

dynamic_search_ads_setting

DynamicSearchAdsSetting

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

shopping_setting

ShoppingSetting

Es la configuración para controlar las campañas de Shopping.

geo_target_type_setting

GeoTargetTypeSetting

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

labels[]

string

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

bidding_strategy_type

BiddingStrategyType

El tipo de estrategia de ofertas.

Para crear una estrategia de ofertas, debes establecer el esquema de ofertas para crear una estrategia de ofertas estándar o el campo bidding_strategy para crear una estrategia de ofertas de cartera.

Este campo es de solo lectura.

accessible_bidding_strategy

string

Nombre de recurso de AccessibleBiddingStrategy, una vista de solo lectura de los atributos sin restricciones de la estrategia de oferta de cartera adjunta que se identifica por “Bidding_strategy”. Vacío, si la campaña no utiliza una estrategia de cartera. Los atributos de estrategias 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.

frequency_caps[]

FrequencyCapEntry

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

selective_optimization

SelectiveOptimization

Configuración de optimización selectiva para esta campaña, que incluye un conjunto de acciones de conversión en función de las cuales se 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.

optimization_goal_setting

OptimizationGoalSetting

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

tracking_setting

TrackingSetting

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

engine_id

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

excluded_parent_asset_field_types[]

AssetFieldType

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

create_time

string

La marca de tiempo de la creación de esta campaña. La marca de tiempo está en la zona horaria del cliente y en “aaaa-MM-dd HH:mm:ss”. de un conjunto de datos tengan un formato común. create_time dejará de estar disponible en la versión 1. En su lugar, usa create_time.

creation_time

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

last_modified_time

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

id

int64

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

tracking_url_template

string

La plantilla de URL para crear una URL de seguimiento.

campaign_budget

string

El presupuesto de la campaña.

start_date

string

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

end_date

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.

final_url_suffix

string

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

url_expansion_opt_out

bool

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

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

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

bidding_strategy

string

Estrategia de oferta de cartera que utiliza la campaña

manual_cpa

ManualCpa

Estrategia de ofertas CPA manuales estándar Es la estrategia de ofertas manuales que permite que el anunciante establezca la oferta por acción específica del anunciante. Solo se admite para las campañas de Servicios Locales.

manual_cpc

ManualCpc

Estrategia de ofertas de CPC manuales estándar Ofertas manuales basadas en clics en las que el usuario paga por clic.

manual_cpm

ManualCpm

Estrategia de ofertas de CPM manuales estándar Ofertas manuales basadas en impresiones en las que el usuario paga por cada mil impresiones.

maximize_conversions

MaximizeConversions

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

maximize_conversion_value

MaximizeConversionValue

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

target_cpa

TargetCpa

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

target_impression_share

TargetImpressionShare

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

target_roas

TargetRoas

Es la estrategia de ofertas ROAS objetivo estándar que maximiza los ingresos automáticamente y, a la vez, promedia un retorno de la inversión publicitaria (ROAS) objetivo específico.

target_spend

TargetSpend

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

percent_cpc

PercentCpc

Es la estrategia de ofertas de CPC de porcentaje estándar en la que las ofertas son una fracción del precio anunciado de algún bien o servicio.

target_cpm

TargetCpm

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

DynamicSearchAdsSetting

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

Campos
domain_name

string

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

language_code

string

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

use_supplied_urls_only

bool

Si la campaña utiliza exclusivamente URL proporcionadas por el anunciante.

GeoTargetTypeSetting

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

Campos
positive_geo_target_type

PositiveGeoTargetType

Es la configuración que se utiliza para la segmentación geográfica positiva en esta campaña en particular.

negative_geo_target_type

NegativeGeoTargetType

Es la configuración que se utiliza para la segmentación geográfica negativa en esta campaña en particular.

NetworkSettings

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

Campos
target_search_network

bool

Si los anuncios se publicarán en sitios asociados en la Red de Búsqueda de Google (requiere que target_google_search también sea true).

target_content_network

bool

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.

target_partner_search_network

bool

Indica si los anuncios se publicarán en la red de socios de Google. Esta función solo está disponible para algunas cuentas de socios de Google seleccionadas.

OptimizationGoalSetting

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

Campos
optimization_goal_types[]

OptimizationGoalType

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

SelectiveOptimization

Configuración de optimización selectiva para esta campaña, que incluye un conjunto de acciones de conversión en función de las cuales se 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.

Campos
conversion_actions[]

string

Es el conjunto de acciones de conversión seleccionado para optimizar esta campaña.

ShoppingSetting

Es la configuración de las campañas de Shopping. Define el universo de los productos que puede promocionar la campaña y cómo interactúa esta campaña con otras campañas de Shopping.

Campos
feed_label

string

Etiqueta de feed de los productos que se incluirán en la campaña. Solo se puede establecer uno de los atributos feed_label o sales_country. Si se usa en lugar de sales_country, el campo feed_label acepta códigos de país con el mismo formato, por ejemplo: “XX”. De lo contrario, puede ser cualquier cadena que se use para la etiqueta de feed en Google Merchant Center.

use_vehicle_inventory

bool

Indica si se debe orientar al inventario de fichas de vehículos.

merchant_id

int64

Es el 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.

sales_country

string

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

campaign_priority

int32

Prioridad de la campaña. Las campañas con prioridades numéricamente más altas tienen prioridad sobre aquellas con prioridades más bajas. Este campo es obligatorio para las campañas de Shopping, con 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 establece.

enable_local

bool

Indica si se deben incluir productos locales.

TrackingSetting

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

Campos
tracking_url

string

La URL que se usa para el seguimiento dinámico.

CampaignAsset

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

Campos
resource_name

string

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

customers/{customer_id}/campaignAssets/{campaign_id}~{asset_id}~{field_type}

status

AssetLinkStatus

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.

Campos
resource_name

string

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

customers/{customer_id}/campaignAssetSets/{campaign_id}~{asset_set_id}

campaign

string

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

asset_set

string

Es el conjunto de recursos vinculado a la campaña.

status

AssetSetLinkStatus

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

CampaignAudienceView

Una vista de público de la campaña Incluye datos de rendimiento de intereses y listas de remarketing para anuncios de la Red de Display y de YouTube, y listas de remarketing para anuncios de búsqueda (RLSA), agregados por campaña y criterio del público. Esta vista solo incluye los públicos adjuntos a nivel de la campaña.

Campos
resource_name

string

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

customers/{customer_id}/campaignAudienceViews/{campaign_id}~{criterion_id}

CampaignBudget

El presupuesto de una campaña

Campos
resource_name

string

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

customers/{customer_id}/campaignBudgets/{campaign_budget_id}

delivery_method

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

BudgetPeriod

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

amount_micros

int64

El importe del presupuesto en la moneda local de la cuenta. El importe se especifica en micros, en el que un millón es equivalente a una unidad de moneda. El gasto mensual está limitado a 30.4 veces este importe.

CampaignCriterion

Un criterio de campaña.

Campos
resource_name

string

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

customers/{customer_id}/campaignCriteria/{campaign_id}~{criterion_id}

display_name

string

El nombre visible del criterio.

Este campo se ignora para las modificaciones.

type

CriterionType

El tipo del criterio.

status

CampaignCriterionStatus

El estado del criterio.

last_modified_time

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

criterion_id

int64

El ID del criterio.

Este campo se ignora durante la modificación.

bid_modifier

float

El modificador de las ofertas cuando coincide el criterio. 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

bool

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

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

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

keyword

KeywordInfo

Palabra clave.

location

LocationInfo

Ubicación.

device

DeviceInfo

Dispositivo.

age_range

AgeRangeInfo

Rango de edad.

gender

GenderInfo

Género.

user_list

UserListInfo

Lista de usuarios

language

LanguageInfo

de HashiCorp.

webpage

WebpageInfo

Página web

location_group

LocationGroupInfo

Grupo por ubicación

CampaignLabel

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

Campos
resource_name

string

Nombre del recurso. Los nombres de los recursos de etiqueta de campaña tienen el siguiente formato: customers/{customer_id}/campaignLabels/{campaign_id}~{label_id}

campaign

string

La campaña a la que se adjuntó la etiqueta

label

string

La etiqueta asignada a la campaña.

CartDataSalesView

Vista de ventas con datos del carrito

Campos
resource_name

string

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

Conversión

Una conversión.

Campos
resource_name

string

El nombre del recurso de la conversión. Los nombres de los recursos de conversión tienen el siguiente formato:

customers/{customer_id}/conversions/{ad_group_id}~{criterion_id}~{ds_conversion_id}

id

int64

El ID de la conversión.

criterion_id

int64

ID de criterio de Search Ads 360. Un valor de 0 indica que el criterio no se atribuye.

merchant_id

int64

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.

ad_id

int64

ID del anuncio Un valor de 0 indica que el anuncio no se atribuye.

click_id

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.

visit_id

int64

Indica el ID de visita de Search Ads 360 al que se atribuye la conversión.

advertiser_conversion_id

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 Floodlight_order_id según las instrucciones de Floodlight del anunciante.

product_id

string

El ID del producto en el que se hizo clic.

product_channel

ProductChannel

El canal de ventas del producto en el que se hizo clic: en línea o local.

product_language_code

string

El idioma (ISO-639-1) que se configuró para el feed de Merchant Center que contiene datos sobre el producto.

product_store_id

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.

product_country_code

string

Indica el país (formato ISO-3166) registrado para el feed de inventario que contiene el producto en el que se hizo clic.

attribution_type

AttributionType

A qué se atribuye la conversión: visita o palabra clave+anuncio.

conversion_date_time

string

La marca de tiempo del evento de conversión.

conversion_last_modified_date_time

string

Es la marca de tiempo de la última vez que se modificó la conversión.

conversion_visit_date_time

string

Es la marca de tiempo de la visita a la que se atribuye la conversión.

conversion_quantity

int64

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.

conversion_revenue_micros

int64

Los ingresos ajustados en micros para el evento de conversión. Siempre se mostrará en la moneda de la cuenta de entrega.

floodlight_original_revenue

int64

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.

floodlight_order_id

string

Es el ID de pedido de Floodlight que proporciona el anunciante para la conversión.

status

ConversionStatus

El estado de la conversión, ya sea HABILITADA o QUITADA.

asset_id

int64

Es el ID del recurso con el que se interactuó durante el evento de conversión.

asset_field_type

AssetFieldType

Es el tipo de campo del recurso del evento de conversión.

ConversionAction

Una acción de conversión

Campos
resource_name

string

El nombre del recurso de la acción de conversión. Los nombres de los recursos de la acción de conversión tienen el siguiente formato:

customers/{customer_id}/conversionActions/{conversion_action_id}

creation_time

string

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

status

ConversionActionStatus

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

type

ConversionActionType

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

category

ConversionActionCategory

Es la categoría de conversiones que se informa para esta acción de conversión.

value_settings

ValueSettings

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

attribution_model_settings

AttributionModelSettings

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

floodlight_settings

FloodlightSettings

Configuración de Floodlight para los tipos de conversión de Floodlight.

id

int64

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.

primary_for_goal

bool

Si el bit main_for_goal de una acción de conversión es falso, esta acción no se puede ofertar para ninguna campaña, independientemente de su objetivo de conversión de clientes o su objetivo de conversión de campaña. Sin embargo, los objetivos de conversión personalizados no respetan la configuración principal_for_goal. Por lo tanto, si una campaña tiene un objetivo de conversión personalizado configurado con una acción de conversión principal_for_goal = falso, esa acción de conversión aún es apta para oferta. De forma predeterminada, primary_for_goal será verdadera si no se establece. En la versión 9, primary_for_goal solo se puede establecer como falso después de crearse a través de una "actualización". la operación porque no se declaró como opcional.

owner_customer

string

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

include_in_client_account_conversions_metric

bool

Si esta acción de conversión debe incluirse en la columna "client_account_conversions" métrica

include_in_conversions_metric

bool

Si esta acción de conversión debe incluirse en la columna "Conversiones" métrica

click_through_lookback_window_days

int64

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

app_id

string

Es el ID de aplicación de una acción de conversión de aplicación.

AttributionModelSettings

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

Campos
attribution_model

AttributionModel

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

data_driven_model_status

DataDrivenModelStatus

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

FloodlightSettings

Configuración relacionada con una acción de conversión de Floodlight.

Campos
activity_group_tag

string

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

activity_tag

string

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

activity_id

int64

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

ValueSettings

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

Campos
default_value

double

Es el valor que se utiliza cuando los eventos de conversión para esta acción de conversión se envían 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.

default_currency_code

string

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

always_use_default_value

bool

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

ConversionCustomVariable

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

Campos
resource_name

string

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

customers/{customer_id}/conversionCustomVariables/{conversion_custom_variable_id}

id

int64

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. La etiqueta de la variable personalizada de conversión. La etiqueta debe ser única y contener una “u” carácter seguido directamente de un número menor que 100 o igual a 100. Por ejemplo: “u4”.

status

ConversionCustomVariableStatus

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

owner_customer

string

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

family

ConversionCustomVariableFamily

Familia de la variable personalizada de conversión.

cardinality

ConversionCustomVariableCardinality

Cardinalidad de la variable personalizada de conversión.

floodlight_conversion_custom_variable_info

FloodlightConversionCustomVariableInfo

Campos para las variables personalizadas de conversiones de Floodlight de Search Ads 360.

custom_column_ids[]

int64

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

FloodlightConversionCustomVariableInfo

Información para las variables personalizadas de conversión de Floodlight de Search Ads 360.

Campos
floodlight_variable_type

FloodlightVariableType

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

floodlight_variable_data_type

FloodlightVariableDataType

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

ConversionTrackingSetting

Es una colección de parámetros de configuración para todo el cliente relacionados con el seguimiento de conversiones de Search Ads 360.

Campos
accepted_customer_data_terms

bool

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 del administrador. Este campo es de solo lectura. Para obtener más información, consulta https://support.google.com/adspolicy/answer/7475709.

conversion_tracking_status

ConversionTrackingStatus

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 muestra variará según el login-customer-id de la solicitud.

enhanced_conversions_for_leads_enabled

bool

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 del administrador. Este campo es de solo lectura.

google_ads_conversion_customer

string

El nombre del recurso del cliente en el que se crean y administran las conversiones. Este campo es de solo lectura.

conversion_tracking_id

int64

El ID de seguimiento de conversiones utilizado para esta cuenta. Este ID no indica si el cliente utiliza el seguimiento de conversiones (conversion_tracking_status lo hace). Este campo es de solo lectura.

google_ads_cross_account_conversion_tracking_id

int64

El ID de seguimiento de conversiones del administrador del cliente. Se establece cuando el cliente habilita el seguimiento de conversiones y anula el parámetro conversion_tracking_id. Este campo solo se puede administrar a través de la IU de Google Ads. Este campo es de solo lectura.

cross_account_conversion_tracking_id

int64

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 el parámetro conversion_tracking_id.

CustomColumn

Una columna personalizada. Consulta la columna personalizada de Search Ads 360 en https://support.google.com/sa360/answer/9633916.

Campos
resource_name

string

El nombre del recurso de la columna personalizada. Los nombres de recursos de las columnas personalizadas tienen el siguiente formato:

customers/{customer_id}/customColumns/{custom_column_id}

id

int64

Es el ID de la columna personalizada.

name

string

Es el nombre de la columna personalizada definido por el usuario.

description

string

Descripción de la columna personalizada definida por el usuario.

value_type

CustomColumnValueType

Es el tipo del valor del resultado de la columna personalizada.

references_attributes

bool

Es verdadero cuando la columna personalizada se refiere a uno o más atributos.

references_metrics

bool

Verdadero cuando la columna personalizada se refiere a una o más métricas.

queryable

bool

Verdadero cuando la columna personalizada está disponible para usarse en la consulta de SearchAds360Service.Search y SearchAds360Service.SearchStream.

referenced_system_columns[]

string

Es la lista de las columnas del sistema a las que se hace referencia en esta columna personalizada. Por ejemplo, una columna personalizada "suma de impresiones y clics" hizo referencia a las columnas del sistema de {"metrics.clicks", "metrics.impresiones"}.

Cliente

Un cliente.

Campos
resource_name

string

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

customers/{customer_id}

conversion_tracking_setting

ConversionTrackingSetting

Es la configuración del seguimiento de conversiones de un cliente.

account_type

AccountType

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

double_click_campaign_manager_setting

DoubleClickCampaignManagerSetting

Configuración de DoubleClick Campaign Manager (DCM) para un cliente administrador.

account_status

AccountStatus

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

last_modified_time

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

engine_id

string

ID de la cuenta de la cuenta de motor externa.

status

CustomerStatus

El estado del cliente.

creation_time

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

id

int64

El ID del cliente.

descriptive_name

string

Nombre descriptivo no único y opcional del cliente.

currency_code

string

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

time_zone

string

El ID de la zona horaria local del cliente.

tracking_url_template

string

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

final_url_suffix

string

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

auto_tagging_enabled

bool

Si el etiquetado automático está habilitado para el cliente

manager

bool

Si el cliente es un administrador.

CustomerAsset

Un vínculo entre un cliente y un recurso.

Campos
resource_name

string

El nombre del recurso del cliente. Los nombres de los recursos CustomerAsset tienen el siguiente formato:

customers/{customer_id}/customerAssets/{asset_id}~{field_type}

asset

string

Obligatorio. El recurso que está vinculado al cliente.

status

AssetLinkStatus

Estado del recurso del cliente.

CustomerAssetSet

CustomerAssetSet es la vinculación entre un cliente y un conjunto de recursos. Si se agrega un CustomerAssetSet, se vincula un conjunto de recursos con un cliente.

Campos
resource_name

string

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

customers/{customer_id}/customerAssetSets/{asset_set_id}

asset_set

string

Es el conjunto de recursos vinculado al cliente.

customer

string

El cliente al que está vinculado este conjunto de recursos.

status

AssetSetLinkStatus

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

CustomerClient

Un vínculo entre un cliente determinado y un cliente cliente. CustomerClients solo existen para los clientes administradores. Se incluyen todos los clientes directos e indirectos, así como el propio administrador.

Campos
resource_name

string

El nombre de recurso del cliente. Los nombres de los recursos CustomerClient tienen el siguiente formato: customers/{customer_id}/customerClients/{client_customer_id}.

applied_labels[]

string

Los nombres de recursos de las etiquetas que son propiedad del cliente solicitante y que se aplican al cliente cliente. Los nombres de recursos de etiquetas tienen el siguiente formato:

customers/{customer_id}/labels/{label_id}

status

CustomerStatus

El estado del cliente. Solo lectura.

client_customer

string

El nombre de recurso del cliente-cliente vinculado al cliente determinado. Solo lectura.

hidden

bool

Especifica si se trata de una cuenta oculta.

Solo lectura.

level

int64

Distancia entre un determinado cliente y un cliente. Para el vínculo propio, el valor del nivel será 0. Solo lectura.

time_zone

string

Representación de cadena del repositorio común de datos de configuración regional (CLDR) de la zona horaria del cliente, por ejemplo, America/Los_Angeles. Solo lectura.

test_account

bool

Identifica si el cliente es una cuenta de prueba. Solo lectura.

manager

bool

Identifica si el cliente es un administrador. Solo lectura.

descriptive_name

string

Es un nombre descriptivo para el cliente. Solo lectura.

currency_code

string

Es el código de moneda (por ejemplo, “USD”, “EUR”) del cliente. Solo lectura.

id

int64

El ID de cliente. Solo lectura.

DoubleClickCampaignManagerSetting

Configuración de DoubleClick Campaign Manager (DCM) para un cliente administrador.

Campos
advertiser_id

int64

Es el ID del anunciante de Campaign Manager asociado con este cliente.

network_id

int64

ID de la red de Campaign Manager asociada con este cliente.

time_zone

string

Es la zona horaria de la red de Campaign Manager asociada a este cliente en el formato de la base de datos de zonas horarias IANA, como América/New_York.

DynamicSearchAdsSearchTermView

Una vista de los términos de búsqueda de los anuncios dinámicos de búsqueda

Campos
resource_name

string

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 vistas de términos de búsqueda de los anuncios dinámicos de búsqueda tienen el siguiente formato:

customers/{customer_id}/dynamicSearchAdsSearchTermViews/{ad_group_id}~{search_term_fingerprint}~{headline_fingerprint}~{landing_page_fingerprint}~{page_url_fingerprint}

landing_page

string

Es la URL de página de destino de la impresión que se seleccionó de forma dinámica.

Este campo es de solo lectura.

GenderView

Vista de género El recurso gender_view refleja el estado de publicación efectivo, en lugar de los criterios que se agregaron. Un grupo de anuncios sin criterios de género se muestra de forma predeterminada para todos los géneros, de modo que todos los géneros aparecen en gender_view con las estadísticas.

Campos
resource_name

string

El nombre del recurso de la vista de género. Los nombres de los recursos de vista de género tienen el siguiente formato:

customers/{customer_id}/genderViews/{ad_group_id}~{criterion_id}

GeoTargetConstant

Una constante de segmentación geográfica.

Campos
resource_name

string

El nombre del recurso de la constante de orientación geográfica. Los nombres de recursos de constantes de segmentaciones geográficas tienen el siguiente formato:

geoTargetConstants/{geo_target_constant_id}

status

GeoTargetConstantStatus

Estado constante de la segmentación geográfica.

id

int64

ID de la constante de orientación geográfica.

name

string

Nombre en inglés de la constante de la segmentación geográfica.

country_code

string

Es el código de país ISO-3166-1 alpha-2 que está asociado con el objetivo.

target_type

string

Tipo de objetivo constante de segmentación geográfica.

canonical_name

string

Es el nombre en inglés completamente calificado, que consta del nombre del objetivo, el de su elemento superior y su país.

parent_geo_target

string

El nombre del recurso de la constante superior de orientación geográfica. Los nombres de recursos de constantes de segmentaciones geográficas tienen el siguiente formato:

geoTargetConstants/{parent_geo_target_constant_id}

KeywordView

Una vista de palabras clave

Campos
resource_name

string

El nombre del recurso de la vista de palabras clave. Los nombres de los recursos de vista de palabras clave tienen el siguiente formato:

customers/{customer_id}/keywordViews/{ad_group_id}~{criterion_id}

Etiqueta

Una etiqueta.

Campos
resource_name

string

Nombre del recurso. Los nombres de recursos de etiquetas tienen el siguiente formato: customers/{customer_id}/labels/{label_id}

status

LabelStatus

Estado de la etiqueta. Solo lectura.

text_label

TextLabel

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

id

int64

Es el ID de la etiqueta. Solo lectura.

name

string

El nombre de la etiqueta.

Este campo es obligatorio y no debe estar vacío durante la creación de una etiqueta nueva.

La longitud de esta cadena debe ser de entre 1 y 80, inclusive.

LanguageConstant

Un idioma.

Campos
resource_name

string

El nombre del recurso de la constante de lenguaje. Los nombres de recursos de constantes de lenguaje tienen el siguiente formato:

languageConstants/{criterion_id}

id

int64

Es el ID de la constante de lenguaje.

code

string

El código de idioma, por ejemplo, "en_US", "en_AU", "es", "fr", etcétera

name

string

El nombre completo del idioma en inglés, por ejemplo, "inglés (EE.UU.)", "español", etcétera

targetable

bool

Si el idioma se puede orientar.

ListingGroupFilterDimension

Dimensiones de la ficha para el filtro del grupo de fichas del grupo de recursos.

Campos
Campo de unión dimension. Una dimensión de uno de los tipos que se indican a continuación siempre está presente. Las direcciones (dimension) solo pueden ser una de las siguientes opciones:
product_bidding_category

ProductBiddingCategory

Es la categoría de ofertas de la oferta de un producto.

product_brand

ProductBrand

Es la marca de la oferta de un producto.

product_channel

ProductChannel

Localidad de la oferta de un producto.

product_condition

ProductCondition

Es la condición de la oferta de un producto.

product_custom_attribute

ProductCustomAttribute

Atributo personalizado de la oferta de un producto.

product_item_id

ProductItemId

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

product_type

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 están en el nivel 1, sus hijos, en el nivel 2, y así sucesivamente. Actualmente, se admiten 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).

Campos
level

ListingGroupFilterBiddingCategoryLevel

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

id

int64

Es el ID de la categoría de ofertas de productos.

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

ProductBrand

Es la marca del producto.

Campos
value

string

Es el valor de cadena de la marca del producto.

ProductChannel

Localidad de la oferta de un producto.

Campos
channel

ListingGroupFilterProductChannel

Valor de la localidad.

ProductCondition

Es la condición de la oferta de un producto.

Campos
condition

ListingGroupFilterProductCondition

Valor de la condición.

ProductCustomAttribute

Atributo personalizado de la oferta de un producto.

Campos
index

ListingGroupFilterCustomAttributeIndex

Indica el índice del atributo personalizado.

value

string

Es el valor de cadena del atributo personalizado del producto.

ProductItemId

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

Campos
value

string

Valor del ID.

ProductType

Es el tipo de oferta de un producto.

Campos
level

ListingGroupFilterProductTypeLevel

Es el nivel del tipo.

value

string

Valor del tipo.

ListingGroupFilterDimensionPath

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

Campos
dimensions[]

ListingGroupFilterDimension

La ruta completa de las dimensiones a través de la jerarquía de filtros de grupos de fichas (sin incluir el nodo raíz) a este filtro de grupos de fichas.

LocationView

Una vista de ubicación resume el rendimiento de las campañas en función de un criterio de ubicación.

Campos
resource_name

string

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/{customer_id}/locationViews/{campaign_id}~{criterion_id}

ProductBiddingCategoryConstant

Una categoría de ofertas de productos

Campos
resource_name

string

El nombre del recurso de la categoría de ofertas de productos. Los nombres de recursos de las categorías de ofertas de productos tienen el siguiente formato:

productBiddingCategoryConstants/{country_code}~{level}~{id}

level

ProductBiddingCategoryLevel

Es el nivel de la categoría de ofertas de productos.

status

ProductBiddingCategoryStatus

Es el estado de la categoría de ofertas de productos.

id

int64

Es el ID de la categoría de ofertas de productos.

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

country_code

string

Es el código de país de dos letras mayúsculas de la categoría de ofertas de productos.

product_bidding_category_constant_parent

string

El nombre del recurso de la categoría de ofertas del producto superior.

language_code

string

Es el código de idioma de la categoría de ofertas de productos.

localized_name

string

Muestra el valor de la categoría de ofertas de productos localizada según language_code.

ProductGroupView

Una vista de grupo de productos

Campos
resource_name

string

El nombre del recurso de la vista del grupo de productos. Los nombres de recursos de la vista de grupos de productos tienen el siguiente formato:

customers/{customer_id}/productGroupViews/{ad_group_id}~{criterion_id}

SearchAds360Field

Un campo o recurso (artefacto) que usa SearchAds360Service.

Campos
resource_name

string

El nombre del recurso del artefacto. Los nombres de recursos de artefactos tienen el siguiente formato:

SearchAds360Fields/{name}

category

SearchAds360FieldCategory

La categoría del artefacto.

selectable_with[]

string

Los nombres de todos los recursos, segmentos y métricas que se pueden seleccionar con el artefacto descrito.

attribute_resources[]

string

Los nombres de todos los recursos que se pueden seleccionar con el artefacto descrito. Los campos de estos recursos no segmentan las métricas cuando se incluyen en las búsquedas.

Este campo solo se configura para artefactos cuya categoría es RESOURCE.

metrics[]

string

Este campo enumera los nombres de todas las métricas que se pueden seleccionar con el artefacto descrito cuando se usa en la cláusula FROM. Solo se configura para los artefactos cuya categoría es RESOURCE.

segments[]

string

Este campo enumera los nombres de todos los artefactos, ya sea un segmento u otro recurso, que segmentan las métricas cuando se incluyen en las búsquedas y cuando el artefacto descrito se usa en la cláusula FROM. Solo se configura para los artefactos cuya categoría es RESOURCE.

enum_values[]

string

Valores que el artefacto puede asumir si es un campo de tipo ENUM.

Este campo solo se establece para los artefactos de la categoría SEGMENT o ATTRIBUTE.

data_type

SearchAds360FieldDataType

Este campo determina los operadores que se pueden usar con el artefacto en las cláusulas WHERE.

name

string

El nombre del artefacto.

selectable

bool

Si el artefacto se puede usar en una cláusula SELECT en las búsquedas.

filterable

bool

Si el artefacto se puede usar en una cláusula WHERE en las búsquedas.

sortable

bool

Si el artefacto se puede usar en una cláusula ORDER BY en las búsquedas.

type_url

string

Es la URL del archivo proto que describe el tipo de datos del artefacto.

is_repeated

bool

Indica si el artefacto del campo está repetido.

ShoppingPerformanceView

Vista del rendimiento de Shopping. Proporciona estadísticas agregadas de las campañas de Shopping en varios niveles de dimensiones de producto. Los valores de las dimensiones del producto de Merchant Center, como marca, categoría, atributos personalizados, estado del producto y tipo de producto, reflejarán el estado de cada dimensión a partir de la fecha y hora en que se registró el evento correspondiente.

Campos
resource_name

string

El nombre del recurso de la vista de rendimiento de Shopping. Los nombres de los recursos de la vista de rendimiento de Shopping tienen el siguiente formato: customers/{customer_id}/shoppingPerformanceView

UserList

Una lista de usuarios Se trata de una lista de usuarios a los que se puede orientar un cliente.

Campos
resource_name

string

El nombre del recurso de la lista de usuarios. Los nombres de los recursos de la lista de usuarios tienen el siguiente formato:

customers/{customer_id}/userLists/{user_list_id}

type

UserListType

Es el tipo de esta lista.

Este campo es de solo lectura.

id

int64

Es el ID de la lista de usuarios.

name

string

Es el nombre de esta lista de usuarios. Según su access_reason, el nombre de la lista de usuarios puede no ser único (por ejemplo, si access_reason=SHARED).

Visitar

Una visita.

Campos
resource_name

string

El nombre del recurso de la visita. Los nombres de los recursos de visitas tienen el siguiente formato:

customers/{customer_id}/visits/{ad_group_id}~{criterion_id}~{ds_visit_id}

id

int64

Es el ID de la visita.

criterion_id

int64

ID de palabra clave de Search Ads 360. El valor 0 indica que la palabra clave no tiene atribución.

merchant_id

int64

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.

ad_id

int64

ID del anuncio Un valor de 0 indica que el anuncio no se atribuye.

click_id

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

visit_date_time

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

product_id

string

El ID del producto en el que se hizo clic.

product_channel

ProductChannel

El canal de ventas del producto en el que se hizo clic: en línea o local.

product_language_code

string

El idioma (ISO-639-1) que se configuró para el feed de Merchant Center que contiene datos sobre el producto.

product_store_id

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.

product_country_code

string

Indica el país (formato ISO-3166) registrado para el feed de inventario que contiene el producto en el que se hizo clic.

asset_id

int64

ID del recurso con el que se interactuó durante el evento de visita.

asset_field_type

AssetFieldType

Es el tipo de campo del recurso del evento de visita.

WebpageView

Una vista de página web

Campos
resource_name

string

El nombre del recurso de la vista de página web. Los nombres de los recursos de vista de página web tienen el siguiente formato:

customers/{customer_id}/webpageViews/{ad_group_id}~{criterion_id}