Índice
AccessibleBiddingStrategy(mensaje)AccessibleBiddingStrategy.MaximizeConversionValue(mensaje)AccessibleBiddingStrategy.MaximizeConversions(mensaje)AccessibleBiddingStrategy.TargetCpa(mensaje)AccessibleBiddingStrategy.TargetImpressionShare(mensaje)AccessibleBiddingStrategy.TargetRoas(mensaje)AccessibleBiddingStrategy.TargetSpend(mensaje)Ad(mensaje)AdGroup(mensaje)AdGroupAd(mensaje)AdGroupAdEffectiveLabel(mensaje)AdGroupAdLabel(mensaje)AdGroupAsset(mensaje)AdGroupAssetSet(mensaje)AdGroupAudienceView(mensaje)AdGroupBidModifier(mensaje)AdGroupCriterion(mensaje)AdGroupCriterion.PositionEstimates(mensaje)AdGroupCriterion.QualityInfo(mensaje)AdGroupCriterionEffectiveLabel(mensaje)AdGroupCriterionLabel(mensaje)AdGroupEffectiveLabel(mensaje)AdGroupLabel(mensaje)AgeRangeView(mensaje)Asset(mensaje)AssetGroup(mensaje)AssetGroupAsset(mensaje)AssetGroupAssetCombinationData(mensaje)AssetGroupListingGroupFilter(mensaje)AssetGroupSignal(mensaje)AssetGroupTopCombinationView(mensaje)AssetSet(mensaje)AssetSetAsset(mensaje)Audience(mensaje)BiddingStrategy(mensaje)Campaign(mensaje)Campaign.DynamicSearchAdsSetting(mensaje)Campaign.GeoTargetTypeSetting(mensaje)Campaign.NetworkSettings(mensaje)Campaign.OptimizationGoalSetting(mensaje)Campaign.SelectiveOptimization(mensaje)Campaign.ShoppingSetting(mensaje)Campaign.TrackingSetting(mensaje)CampaignAsset(mensaje)CampaignAssetSet(mensaje)CampaignAudienceView(mensaje)CampaignBudget(mensaje)CampaignCriterion(mensaje)CampaignEffectiveLabel(mensaje)CampaignLabel(mensaje)CartDataSalesView(mensaje)Conversion(mensaje)ConversionAction(mensaje)ConversionAction.AttributionModelSettings(mensaje)ConversionAction.FloodlightSettings(mensaje)ConversionAction.ValueSettings(mensaje)ConversionCustomVariable(mensaje)ConversionCustomVariable.FloodlightConversionCustomVariableInfo(mensaje)ConversionTrackingSetting(mensaje)CustomColumn(mensaje)Customer(mensaje)CustomerAsset(mensaje)CustomerAssetSet(mensaje)CustomerClient(mensaje)CustomerManagerLink(mensaje)DoubleClickCampaignManagerSetting(mensaje)DynamicSearchAdsSearchTermView(mensaje)GenderView(mensaje)GeoTargetConstant(mensaje)KeywordView(mensaje)Label(mensaje)LanguageConstant(mensaje)ListingGroupFilterDimension(mensaje)ListingGroupFilterDimension.ProductBiddingCategory(mensaje)ListingGroupFilterDimension.ProductBrand(mensaje)ListingGroupFilterDimension.ProductChannel(mensaje)ListingGroupFilterDimension.ProductCondition(mensaje)ListingGroupFilterDimension.ProductCustomAttribute(mensaje)ListingGroupFilterDimension.ProductItemId(mensaje)ListingGroupFilterDimension.ProductType(mensaje)ListingGroupFilterDimensionPath(mensaje)LocationView(mensaje)ProductBiddingCategoryConstant(mensaje)ProductGroupView(mensaje)SearchAds360Field(mensaje)ShoppingPerformanceView(mensaje)UserList(mensaje)UserLocationView(mensaje)Visit(mensaje)WebpageView(mensaje)
AccessibleBiddingStrategy
Representa una vista de los objetos BiddingStrategies que son propiedad del cliente y se comparten con él.
A diferencia de BiddingStrategy, este recurso incluye las estrategias que son propiedad de los administradores del cliente y que se comparten con este cliente, además de las estrategias que son propiedad de este cliente. Este recurso no proporciona métricas y solo expone un subconjunto limitado de los atributos de BiddingStrategy.
| Campos | |
|---|---|
resource_name |
Es el nombre del recurso de la estrategia de ofertas accesible. Los nombres de los recursos de AccessibleBiddingStrategy tienen el siguiente formato:
|
id |
El ID de la estrategia de ofertas. |
name |
El nombre de la estrategia de ofertas. |
type |
Es el tipo de estrategia de ofertas. |
owner_customer_id |
Es el ID del cliente propietario de la estrategia de ofertas. |
owner_descriptive_name |
Es el nombre descriptivo del cliente propietario de la estrategia de ofertas. |
Campo de unión Solo se puede establecer uno. |
|
maximize_conversion_value |
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 |
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. |
target_cpa |
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 |
Es una estrategia de ofertas que se optimiza automáticamente en función de un porcentaje elegido de impresiones. |
target_roas |
Es una estrategia de ofertas que te ayuda a maximizar los ingresos y, al mismo tiempo, aumentar el promedio de un retorno de la inversión publicitaria (ROAS) objetivo específico. |
target_spend |
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 |
Es la opción de retorno de la inversión publicitaria (ROAS) objetivo. Si se configura, la estrategia de ofertas maximizará los ingresos y, al mismo tiempo, aumentará el promedio del retorno de la inversión publicitaria objetivo. Si el ROAS objetivo es alto, es posible que la estrategia de ofertas no pueda invertir todo el presupuesto. Si no se establece el ROAS objetivo, la estrategia de ofertas intentará alcanzar el ROAS más alto posible para el presupuesto. |
MaximizeConversions
Es una estrategia de ofertas automáticas que te ayuda a obtener la mayor cantidad posible de conversiones para tus campañas sin exceder tu presupuesto.
| Campos | |
|---|---|
target_cpa |
Es la opción de costo por adquisición (CPA) objetivo. Este es el importe promedio que deseas invertir por adquisición. |
target_cpa_micros |
Es la opción de costo por adquisición (CPA) objetivo. Este es el importe promedio que deseas invertir por adquisición. |
TargetCpa
Es una estrategia de ofertas automáticas que establece ofertas para ayudarte a obtener la mayor cantidad posible de conversiones con el costo por adquisición (CPA) objetivo que estableciste.
| Campos | |
|---|---|
target_cpa_micros |
Objetivo de CPA promedio. Este objetivo debe ser mayor o igual que la unidad facturable mínima según la moneda de la cuenta. |
TargetRoas
Es una estrategia de ofertas automáticas que te ayuda a maximizar los ingresos y, al mismo tiempo, obtener un promedio de un retorno de la inversión publicitaria (ROAS) objetivo específico.
| Campos | |
|---|---|
target_roas |
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 |
El objetivo de inversión en el que se maximizan los clics. Un ofertante de TargetSpend intentará gastar la menor cantidad de este valor o el importe de inversión de regulación natural. Si no se especifica, el presupuesto se utiliza como el objetivo de inversión. Este campo está obsoleto y ya no se debe usar. Consulta https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html para obtener más detalles. |
cpc_bid_ceiling_micros |
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. |
Anuncio
Un anuncio
| Campos | |
|---|---|
resource_name |
Es el nombre del recurso del anuncio. Los nombres de recursos de los anuncios tienen el siguiente formato:
|
final_urls[] |
La lista de posibles URLs finales después de todos los redireccionamientos entre dominios del anuncio. |
final_app_urls[] |
Es una lista de URLs finales de la aplicación que se usarán en dispositivos móviles si el usuario tiene instalada la aplicación específica. |
final_mobile_urls[] |
Es la lista de posibles URLs finales para dispositivos móviles después de todos los redireccionamientos entre dominios del anuncio. |
type |
El tipo de anuncio. |
id |
El ID del anuncio. |
tracking_url_template |
La plantilla de URL para crear una URL de seguimiento. |
final_url_suffix |
Es el sufijo que se usa cuando se construye una URL final. |
display_url |
La URL que aparece en la descripción del anuncio para algunos formatos de anuncios. |
name |
El nombre del anuncio. Esto solo se utiliza para identificar el anuncio. No es necesario que sea único y no afecta el anuncio publicado. |
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 |
Son los detalles relacionados con un anuncio de texto. |
expanded_text_ad |
Son los detalles relacionados con un anuncio de texto expandido. |
responsive_search_ad |
Son los detalles relacionados con un anuncio de búsqueda responsivo. |
product_ad |
Son los detalles relacionados con un anuncio de producto. |
expanded_dynamic_search_ad |
Son los detalles relacionados con un anuncio dinámico de búsqueda expandido. |
Grupo de anuncios
Es un grupo de anuncios.
| Campos | |
|---|---|
resource_name |
Es el nombre del recurso del grupo de anuncios. Los nombres de recursos de los grupos de anuncios tienen el siguiente formato:
|
status |
El estado del grupo de anuncios. |
type |
Es el tipo del grupo de anuncios. |
ad_rotation_mode |
Es el modo de rotación de anuncios del grupo de anuncios. |
creation_time |
Es la marca de tiempo de la creación de este ad_group. La marca de tiempo se encuentra en la zona horaria del cliente y en el formato “dd-MM-aaaa HH:mm:ss”. |
targeting_setting |
Es el parámetro de configuración para las funciones relacionadas con la segmentación. |
labels[] |
Los nombres de recursos de las etiquetas adjuntas a este grupo de anuncios. |
effective_labels[] |
Son los nombres de recursos de las etiquetas efectivas adjuntas a este grupo de anuncios. Una etiqueta efectiva es una etiqueta heredada o asignada directamente a este grupo de anuncios. |
engine_id |
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 |
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 |
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 |
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 |
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 |
El ID del grupo de anuncios. |
name |
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). |
tracking_url_template |
La plantilla de URL para crear una URL de seguimiento. |
cpc_bid_micros |
La oferta de CPC (costo por clic) máxima. |
engine_status |
El estado del motor para el grupo de anuncios. |
final_url_suffix |
Es la plantilla de URL para agregar parámetros a la URL final. |
AdGroupAd
Es un anuncio del grupo de anuncios.
| Campos | |
|---|---|
resource_name |
Es el nombre del recurso del anuncio. Los nombres de recursos de los anuncios del grupo de anuncios tienen el siguiente formato:
|
status |
El estado del anuncio. |
ad |
Es el anuncio. |
creation_time |
Es la marca de tiempo de la creación de 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[] |
Los nombres de recursos de las etiquetas adjuntas a este anuncio de grupo de anuncios. |
effective_labels[] |
Son los nombres de recursos de las etiquetas vigentes adjuntas a este anuncio. Una etiqueta efectiva es una etiqueta heredada o asignada directamente a este anuncio. |
engine_id |
ID del anuncio en la cuenta de motor externa. Este campo solo se usa para la cuenta de Search Ads 360; por ejemplo, Yahoo Japan, Microsoft, Baidu, etc. En el caso de una entidad que no sea de Search Ads 360, usa "ad_group_ad.ad.id". |
engine_status |
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 |
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”. |
AdGroupAdEffectiveLabel
Es una relación entre un anuncio del grupo de anuncios y una etiqueta efectiva. Una etiqueta eficaz es una etiqueta heredada o asignada directamente a este anuncio del grupo de anuncios.
| Campos | |
|---|---|
resource_name |
Es el nombre del recurso de la etiqueta efectiva del anuncio del grupo de anuncios. Los nombres de recursos de las etiquetas efectivas de los anuncios de grupo de anuncios tienen el siguiente formato: |
ad_group_ad |
Es el anuncio del grupo de anuncios al que se adjunta la etiqueta efectiva. |
label |
Es la etiqueta efectiva asignada al anuncio del grupo de anuncios. |
owner_customer_id |
Es el ID del cliente propietario de la etiqueta efectiva. |
AdGroupAdLabel
Es una relación entre un anuncio del grupo de anuncios y una etiqueta.
| Campos | |
|---|---|
resource_name |
Es el nombre del recurso de la etiqueta del anuncio del grupo de anuncios. Los nombres de recursos de las etiquetas de anuncios de grupo de anuncios tienen el siguiente formato: |
ad_group_ad |
Es el anuncio del grupo de anuncios al que se adjunta la etiqueta. |
label |
Es la etiqueta asignada al anuncio del grupo de anuncios. |
owner_customer_id |
Es el ID del cliente propietario de la etiqueta. |
AdGroupAsset
Es un vínculo entre un grupo de anuncios y un recurso.
| Campos | |
|---|---|
resource_name |
Es el nombre del recurso del recurso del grupo de anuncios. Los nombres de los recursos de AdGroupAsset tienen el siguiente formato:
|
ad_group |
Obligatorio. El grupo de anuncios al que está vinculado el recurso. |
asset |
Obligatorio. El recurso que está vinculado al grupo de anuncios. |
status |
Es el estado de la asociación del recurso del grupo de anuncios. |
AdGroupAssetSet
AdGroupAssetSet es la vinculación entre un grupo de anuncios y un conjunto de recursos. La creación de un AdGroupAssetSet vincula un conjunto de recursos con un grupo de anuncios.
| Campos | |
|---|---|
resource_name |
Es el nombre del recurso del conjunto de recursos del grupo de anuncios. Los nombres de recursos de los conjuntos de recursos del grupo de anuncios tienen el siguiente formato:
|
ad_group |
Es el grupo de anuncios al que está vinculado este conjunto de recursos. |
asset_set |
Es el conjunto de recursos que está vinculado al grupo de anuncios. |
status |
Es el estado del conjunto de recursos del grupo de anuncios. Solo lectura. |
AdGroupAudienceView
Es una vista del público del grupo de anuncios. Incluye datos de rendimiento de las listas de intereses y de remarketing para los anuncios de la Red de Display y la Red de YouTube, y las listas de remarketing para anuncios de búsqueda (RLSA), agregados a nivel del público.
| Campos | |
|---|---|
resource_name |
Es el nombre del recurso de la vista de público del grupo de anuncios. Los nombres de los recursos de la vista del público del grupo de anuncios tienen el siguiente formato:
|
AdGroupBidModifier
Representa un modificador de ofertas del grupo de anuncios.
| Campos | |
|---|---|
resource_name |
Es el nombre del recurso del modificador de ofertas del grupo de anuncios. Los nombres de recursos de los modificadores de ofertas del grupo de anuncios tienen el siguiente formato:
|
bid_modifier |
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 Se requiere en las operaciones de creación a partir de la versión 5. |
|
device |
Es un criterio del dispositivo. |
AdGroupCriterion
Es un criterio del grupo de anuncios. El informe ad_group_criterion solo devuelve los criterios que se agregaron de forma explícita al grupo de anuncios.
| Campos | |
|---|---|
resource_name |
Es el nombre del recurso del criterio del grupo de anuncios. Los nombres de recursos de los criterios del grupo de anuncios tienen el siguiente formato:
|
creation_time |
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 |
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 |
Es información sobre la calidad del criterio. |
type |
El tipo del criterio. |
labels[] |
Los nombres de recursos de las etiquetas adjuntas a este criterio de grupo de anuncios. |
effective_labels[] |
Son los nombres de recursos de las etiquetas vigentes adjuntas a este criterio de grupo de anuncios. Una etiqueta eficaz es una etiqueta heredada o asignada directamente a este criterio de grupo de anuncios. |
position_estimates |
Son las estimaciones de las ofertas de criterios en varias posiciones. |
final_urls[] |
La lista de posibles URLs finales después de todos los redireccionamientos entre dominios del anuncio. |
final_mobile_urls[] |
Es la lista de posibles URLs finales para dispositivos móviles después de todos los redireccionamientos entre dominios. |
url_custom_parameters[] |
Es la lista de asignaciones que se usan para sustituir las etiquetas de parámetros personalizados en un objeto |
engine_id |
ID del criterio del grupo de anuncios en la cuenta de motor externo. Este campo es solo para una cuenta que no es de Google Ads, por ejemplo, Yahoo Japan, Microsoft, Baidu, etc. Para la entidad de Google Ads, usa "ad_group_criterion.criterion_id". |
last_modified_time |
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 |
El ID del criterio. |
ad_group |
Es el grupo de anuncios al que pertenece el criterio. |
negative |
Indica si se segmenta ( Este campo es inmutable. Para cambiar un criterio de positivo a negativo, quítalo y vuelve a agregarlo. |
bid_modifier |
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 |
La oferta de CPC (costo por clic). |
effective_cpc_bid_micros |
La oferta de CPC (costo por clic) efectiva. |
engine_status |
El estado del motor para el criterio del grupo de anuncios. |
final_url_suffix |
Plantilla de URL para agregar parámetros a la URL final. |
tracking_url_template |
La plantilla de URL para crear una URL de seguimiento. |
Campo de unión Se debe establecer exactamente uno. |
|
keyword |
Es la palabra clave. |
listing_group |
Es el grupo de fichas. |
age_range |
Es el rango de edad. |
gender |
Es el género. |
user_list |
Es la lista de usuarios. |
webpage |
Página web |
location |
Ubicación. |
PositionEstimates
Son las estimaciones de las ofertas de criterios en varias posiciones.
| Campos | |
|---|---|
top_of_page_cpc_micros |
Es la estimación de la oferta de CPC requerida para que el anuncio se muestre en la parte superior de la primera página de los resultados de la búsqueda. |
QualityInfo
Es un contenedor de información sobre la calidad del criterio del grupo de anuncios.
| Campos | |
|---|---|
quality_score |
El nivel de calidad. Este campo no se puede propagar si Google no tiene suficiente información para determinar un valor. |
AdGroupCriterionEffectiveLabel
Es una relación entre un criterio del grupo de anuncios y una etiqueta efectiva. Una etiqueta eficaz es una etiqueta heredada o asignada directamente a este criterio de grupo de anuncios.
| Campos | |
|---|---|
resource_name |
Es el nombre del recurso de la etiqueta efectiva del criterio del grupo de anuncios. Los nombres de recursos de las etiquetas efectivas del criterio del grupo de anuncios tienen el siguiente formato: |
ad_group_criterion |
Es el criterio del grupo de anuncios al que se adjunta la etiqueta efectiva. |
label |
Es la etiqueta efectiva asignada al criterio del grupo de anuncios. |
owner_customer_id |
Es el ID del cliente propietario de la etiqueta efectiva. |
AdGroupCriterionLabel
Es una relación entre un criterio del grupo de anuncios y una etiqueta.
| Campos | |
|---|---|
resource_name |
Es el nombre del recurso de la etiqueta del criterio del grupo de anuncios. Los nombres de recursos de las etiquetas de criterios del grupo de anuncios tienen el siguiente formato: |
ad_group_criterion |
Es el criterio del grupo de anuncios al que se adjunta la etiqueta. |
label |
Es la etiqueta asignada al criterio del grupo de anuncios. |
owner_customer_id |
Es el ID del cliente propietario de la etiqueta. |
AdGroupEffectiveLabel
Es una relación entre un grupo de anuncios y una etiqueta efectiva. Una etiqueta efectiva es una etiqueta heredada o asignada directamente a este grupo de anuncios.
| Campos | |
|---|---|
resource_name |
Es el nombre del recurso de la etiqueta efectiva del grupo de anuncios. Los nombres de recursos de las etiquetas efectivas del grupo de anuncios tienen el siguiente formato: |
ad_group |
Es el grupo de anuncios al que se adjunta la etiqueta efectiva. |
label |
Es la etiqueta efectiva asignada al grupo de anuncios. |
owner_customer_id |
Es el ID del cliente propietario de la etiqueta efectiva. |
AdGroupLabel
Es una relación entre un grupo de anuncios y una etiqueta.
| Campos | |
|---|---|
resource_name |
Es el nombre del recurso de la etiqueta del grupo de anuncios. Los nombres de recursos de las etiquetas del grupo de anuncios tienen el siguiente formato: |
ad_group |
Es el grupo de anuncios al que se adjunta la etiqueta. |
label |
Es la etiqueta asignada al grupo de anuncios. |
owner_customer_id |
Es el ID del cliente propietario de la etiqueta. |
AgeRangeView
Es una vista de rango de edad.
| Campos | |
|---|---|
resource_name |
Es el nombre del recurso de la vista del rango de edades. Los nombres de los recursos de la vista de rango de edades tienen el siguiente formato:
|
Recurso
Un recurso es una parte de un anuncio que se puede compartir en varios anuncios. Puede ser una imagen (ImageAsset), un video (YoutubeVideoAsset), etcétera. Los activos son inmutables y no se pueden quitar. Para que un recurso deje de publicarse, quítalo de la entidad que lo usa.
| Campos | |
|---|---|
resource_name |
Es el nombre del recurso del activo. Los nombres de recursos de los recursos de activos tienen el siguiente formato:
|
type |
Es el tipo de recurso. |
final_urls[] |
Una lista de las posibles URLs finales después de todos los redireccionamientos entre dominios. |
final_mobile_urls[] |
Es una lista de las posibles URLs finales para dispositivos móviles después de todos los redireccionamientos entre dominios. |
url_custom_parameters[] |
Es una lista de asignaciones que se utilizarán para sustituir las etiquetas de parámetros personalizados de URL en tracking_url_template, final_urls o final_mobile_urls. |
status |
El estado del recurso. |
creation_time |
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 |
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 |
El ID del activo. |
name |
Nombre opcional del activo. |
tracking_url_template |
Plantilla de URL para crear una URL de seguimiento. |
final_url_suffix |
Es la plantilla de URL para agregar parámetros a las URLs de página de destino que se publican con el seguimiento paralelo. |
engine_status |
Es el estado del motor de un recurso. |
Campo de unión asset_data. Es el tipo específico del activo. Las direcciones (asset_data) solo pueden ser una de las siguientes opciones: |
|
youtube_video_asset |
Es un recurso de video de YouTube. |
image_asset |
Es un recurso de imagen. |
text_asset |
Es un recurso de texto. |
callout_asset |
Es un recurso de texto destacado unificado. |
sitelink_asset |
Es un recurso de vínculo a sitio unificado. |
page_feed_asset |
Es un recurso de feed de páginas unificado. |
mobile_app_asset |
Es un recurso de aplicación para dispositivos móviles. |
call_asset |
Es un recurso de llamada unificado. |
call_to_action_asset |
Es un recurso de llamado a la acción. |
location_asset |
Es un recurso de ubicación unificado. |
AssetGroup
Es un grupo de recursos. AssetGroupAsset se usa para vincular un recurso al grupo de recursos. AssetGroupSignal se usa para asociar un indicador a un grupo de recursos.
| Campos | |
|---|---|
resource_name |
Es el nombre del recurso del grupo de recursos. Los nombres de los recursos de los grupos de recursos tienen el siguiente formato:
|
id |
Es el ID del grupo de recursos. |
campaign |
Es la campaña con la que está asociado este grupo de recursos. Es el recurso que está vinculado al grupo de recursos. |
name |
Obligatorio. Es el nombre del grupo de recursos. Obligatorio. Debe tener una longitud mínima de 1 y una longitud máxima de 128. Debe ser único en una campaña. |
final_urls[] |
Es una lista de URLs finales después de todos los redireccionamientos entre dominios. En las campañas de máximo rendimiento, de forma predeterminada, las URLs son aptas para la expansión, a menos que se inhabilite la opción. |
final_mobile_urls[] |
Es una lista de URLs finales para dispositivos móviles después de todos los redireccionamientos entre dominios. En las campañas de máximo rendimiento, de forma predeterminada, las URLs son aptas para la expansión, a menos que se inhabilite la opción. |
status |
Es el estado del grupo de recursos. |
path1 |
Es la primera parte del texto que puede aparecer anexada a la URL que se muestra en el anuncio. |
path2 |
Es la segunda parte del texto que puede aparecer anexada a la URL que se muestra en el anuncio. Este campo solo se puede configurar cuando se establece path1. |
ad_strength |
Calidad general del anuncio de este grupo de recursos. |
AssetGroupAsset
AssetGroupAsset es la vinculación entre un recurso y un grupo de recursos. Agregar un AssetGroupAsset vincula un recurso con un grupo de recursos.
| Campos | |
|---|---|
resource_name |
Es el nombre del recurso del recurso del grupo de recursos. El nombre del recurso del recurso del grupo de recursos tiene el siguiente formato:
|
asset_group |
Es el grupo de recursos al que se vincula este recurso del grupo de recursos. |
asset |
Es el recurso al que se vincula este recurso del grupo de recursos. |
field_type |
Es la descripción de la posición del recurso dentro del grupo de recursos. Por ejemplo: HEADLINE, YOUTUBE_VIDEO, etcétera |
status |
Es el estado de la vinculación entre un recurso y un grupo de recursos. |
AssetGroupAssetCombinationData
Datos de combinación de recursos del grupo de recursos
| Campos | |
|---|---|
asset_combination_served_assets[] |
Son los recursos que se publican. |
AssetGroupListingGroupFilter
AssetGroupListingGroupFilter representa un nodo de árbol de filtro de grupo de fichas en un grupo de recursos.
| Campos | |
|---|---|
resource_name |
Es el nombre del recurso del filtro de grupo de fichas y elementos del grupo de recursos. El nombre del recurso del filtro de grupo de fichas y elementos del grupo de recursos tiene el siguiente formato:
|
asset_group |
Es el grupo de recursos del que forma parte este filtro de grupo de fichas y elementos del grupo de recursos. |
id |
Es el ID de ListingGroupFilter. |
type |
Es el tipo de un nodo de filtro de grupo de fichas. |
vertical |
Vertical que representa el árbol de nodos actual. Todos los nodos del mismo árbol deben pertenecer a la misma vertical. |
case_value |
Es el valor de la dimensión con el que este grupo de fichas segmenta su grupo superior. No se define para el grupo raíz. |
parent_listing_group_filter |
Es el nombre del recurso de la subdivisión del grupo de fichas principal. Es nulo para el nodo del filtro del grupo de fichas raíz. |
path |
Es la ruta de acceso de las dimensiones que definen este filtro del 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énes son los usuarios que tienen más probabilidades de generar una conversión. Las campañas de máximo rendimiento utilizan el indicador para encontrar usuarios nuevos con una intención similar o superior y así conseguir conversiones en las redes de Búsqueda, Display, video y mucho más.
| Campos | |
|---|---|
resource_name |
Es el nombre del recurso del indicador del grupo de recursos. El nombre del recurso del indicador del grupo de recursos tiene el siguiente formato:
|
asset_group |
Es el grupo de recursos al que pertenece este indicador del grupo de recursos. |
Campo de unión signal. Es el indicador del grupo de recursos. Las direcciones (signal) solo pueden ser una de las siguientes opciones: |
|
audience |
Es el indicador de público que utilizará la campaña de máximo rendimiento. |
AssetGroupTopCombinationView
Es una vista del uso de las principales combinaciones de recursos del grupo de recursos.
| Campos | |
|---|---|
resource_name |
Es el nombre del recurso de la vista de la combinación principal del grupo de recursos. Los nombres de los recursos de la vista de combinaciones principales del grupo de recursos tienen el siguiente formato: "customers/{customer_id}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}" |
asset_group_top_combinations[] |
Son las principales combinaciones de recursos que se publicaron juntas. |
AssetSet
Es un conjunto de recursos que representa una colección de recursos. Usa AssetSetAsset para vincular un recurso al conjunto de recursos.
| Campos | |
|---|---|
id |
Es el ID del conjunto de recursos. |
resource_name |
Es el nombre del recurso del conjunto de recursos. Los nombres de los recursos de los conjuntos de recursos tienen el siguiente formato:
|
AssetSetAsset
AssetSetAsset es la vinculación entre un recurso y un conjunto de recursos. Agregar un objeto AssetSetAsset vincula un recurso con un conjunto de recursos.
| Campos | |
|---|---|
resource_name |
Es el nombre del recurso del recurso del conjunto de recursos. Los nombres de recursos de los recursos del conjunto de recursos tienen el siguiente formato:
|
asset_set |
El conjunto de recursos al que está vinculado este recurso del conjunto de recursos. |
asset |
El recurso al que está vinculado este recurso del conjunto de recursos. |
status |
Es el estado del recurso del conjunto de recursos. Solo lectura. |
Público
Los públicos son una opción de segmentación eficaz que te permite mezclar diferentes atributos de segmentos, como afinidades y datos demográficos detallados, para crear públicos que representen secciones de tus segmentos objetivo.
| Campos | |
|---|---|
resource_name |
Es el nombre del recurso del público. Los nombres de los públicos tienen el siguiente formato:
|
id |
Es el ID del público. |
name |
Obligatorio. Es el nombre del público. Debe ser único para todos los públicos. Debe tener una longitud mínima de 1 y una longitud máxima de 255. |
description |
Es la descripción de este público. |
BiddingStrategy
Es una estrategia de ofertas.
| Campos | |
|---|---|
resource_name |
Es el nombre del recurso de la estrategia de ofertas. Los nombres de los recursos de la estrategia de ofertas tienen el siguiente formato:
|
status |
El estado de la estrategia de ofertas. Este campo es de solo lectura. |
type |
Es el tipo de estrategia de ofertas. Crea una estrategia de ofertas estableciendo el esquema de ofertas. Este campo es de solo lectura. |
currency_code |
Es la moneda que usa la estrategia de ofertas (código de tres letras ISO 4217). En el caso de las estrategias de ofertas de las cuentas de clientes administradas, esta moneda se puede establecer durante la creación y, de forma predeterminada, se establece la moneda de la cuenta de cliente administrada. En el caso de los clientes de publicación, este campo no se puede establecer. Todas las estrategias de un cliente de publicación utilizan implícitamente la moneda del cliente de publicación. En todos los casos, el campo effective_currency_code devuelve la moneda que usa la estrategia. |
id |
El ID de la estrategia de ofertas. |
name |
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 |
Es la moneda que usa la estrategia de ofertas (código de tres letras ISO 4217). En el caso de las estrategias de ofertas de las cuentas de cliente administradas, esta es la moneda que establece el anunciante cuando crea la estrategia. Para la publicación de anuncios a los clientes, este es el currency_code del cliente. Las métricas de la estrategia de ofertas se registran en esta moneda. Este campo es de solo lectura. |
campaign_count |
Es la cantidad de campañas asociadas a esta estrategia de ofertas. Este campo es de solo lectura. |
non_removed_campaign_count |
Es la cantidad de campañas no quitadas asociadas a esta estrategia de ofertas. Este campo es de solo lectura. |
Campo de unión Solo se puede establecer uno. |
|
enhanced_cpc |
Es una estrategia de ofertas que aumenta las ofertas para los clics que parecen tener más probabilidades de generar una conversión y las disminuye para los clics que parecen tener menos probabilidades de hacerlo. |
maximize_conversion_value |
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 |
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. |
target_cpa |
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 |
Es una estrategia de ofertas que se optimiza automáticamente en función de un porcentaje elegido de impresiones. |
target_outrank_share |
Es una estrategia de ofertas que establece ofertas en función de la fracción objetivo de las subastas en las que el anunciante debería superar a un competidor específico. Este campo ya no está disponible. Si creas una estrategia de ofertas nueva con este campo o adjuntas estrategias de ofertas con este campo a una campaña, se producirá un error. Se permiten las mutaciones a estrategias que ya tienen este esquema completado. |
target_roas |
Es una estrategia de ofertas que te ayuda a maximizar los ingresos y, al mismo tiempo, aumentar el promedio de un retorno de la inversión publicitaria (ROAS) objetivo específico. |
target_spend |
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
Es una campaña.
| Campos | |
|---|---|
resource_name |
Es el nombre del recurso de la campaña. Los nombres de recursos de las campañas tienen el siguiente formato:
|
status |
El estado de la campaña. Cuando se agrega una campaña nueva, el estado predeterminado es ENABLED. |
serving_status |
Es el estado de publicación de anuncios de la campaña. |
bidding_strategy_system_status |
Es el estado del sistema de la estrategia de ofertas de la campaña. |
ad_serving_optimization_status |
Es el estado de optimización de la publicación de anuncios de la campaña. |
advertising_channel_type |
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 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 |
Es un perfeccionamiento opcional de Se puede configurar solo cuando se crean campañas. Una vez creada la campaña, no se puede modificar el campo. |
url_custom_parameters[] |
Es la lista de asignaciones que se usan para sustituir las etiquetas de parámetros personalizados en un objeto |
real_time_bidding_setting |
Es la configuración de las ofertas en tiempo real, una función que solo está disponible para las campañas segmentadas para la red de Ad Exchange. |
network_settings |
Es la configuración de red de la campaña. |
dynamic_search_ads_setting |
Es el parámetro de configuración para controlar los anuncios dinámicos de búsqueda (DSA). |
shopping_setting |
Es el parámetro de configuración que controla las campañas de Shopping. |
geo_target_type_setting |
Es el parámetro de configuración de la segmentación geográfica de los anuncios. |
effective_labels[] |
Son los nombres de recursos de las etiquetas vigentes adjuntas a esta campaña. Una etiqueta efectiva es una etiqueta heredada o asignada directamente a esta campaña. |
labels[] |
Los nombres de recursos de las etiquetas adjuntas a esta campaña. |
bidding_strategy_type |
El tipo de estrategia de ofertas. La estrategia de ofertas se puede crear estableciendo el esquema de ofertas para crear una estrategia de ofertas estándar o el campo Este campo es de solo lectura. |
accessible_bidding_strategy |
Es el nombre del recurso de AccessibleBiddingStrategy, una vista de solo lectura de los atributos sin restricciones de la estrategia de ofertas de cartera adjunta identificada por "bidding_strategy". Estará vacío si la campaña no utiliza una estrategia de cartera. Los atributos de estrategia sin restricciones están disponibles para todos los clientes con los que se comparte la estrategia y se leen desde el recurso AccessibleBiddingStrategy. En cambio, los atributos restringidos solo están disponibles para el cliente propietario de la estrategia y sus administradores. Los atributos restringidos solo se pueden leer desde el recurso BiddingStrategy. |
frequency_caps[] |
Es una lista que limita la frecuencia con la que cada usuario verá los anuncios de esta campaña. |
selective_optimization |
Es el parámetro de configuración de optimización selectiva para esta campaña, que incluye un conjunto de acciones de conversión para optimizar esta campaña. Esta función solo se aplica a las campañas de aplicaciones que utilizan MULTI_CHANNEL como AdvertisingChannelType y APP_CAMPAIGN o APP_CAMPAIGN_FOR_ENGAGEMENT como AdvertisingChannelSubType. |
optimization_goal_setting |
Es la configuración del objetivo de optimización para esta campaña, que incluye un conjunto de tipos de objetivos de optimización. |
tracking_setting |
Es la configuración a nivel de la campaña para la información de seguimiento. |
engine_id |
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[] |
Son los tipos de campos de recursos que se deben excluir de esta campaña. Esta campaña no heredará los vínculos del recurso con estos tipos de campos del nivel superior. |
create_time |
La marca de tiempo de la creación de esta campaña. La marca de tiempo se encuentra en la zona horaria del cliente y en el formato “aaaa-MM-dd HH:mm:ss”. create_time dejará de estar disponible en la versión 1. En su lugar, usa creation_time. |
creation_time |
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 |
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”. |
feed_types[] |
Son los tipos de feeds que se adjuntan directamente a esta campaña. |
id |
El ID de la campaña. |
name |
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 |
La plantilla de URL para crear una URL de seguimiento. |
campaign_budget |
Es el nombre del recurso del presupuesto de la campaña. |
start_date |
La fecha en que comenzó la campaña en la zona horaria del cliente en formato AAAA-MM-DD. |
end_date |
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 |
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 |
Representa la inhabilitación de la expansión de URL a URLs más segmentadas. Si se inhabilita (verdadero), solo se segmentarán las URLs finales del grupo de recursos o las URLs especificadas en los feeds de datos de la empresa o de Google Merchant Center del anunciante. Si se habilita (false), se segmentará todo el dominio. Este campo solo se puede establecer para las campañas de máximo rendimiento, en las que el valor predeterminado es falso. |
Campo de unión Debe ser de cartera (creada a través del servicio BiddingStrategy) o estándar, es decir, incorporada en la campaña. |
|
bidding_strategy |
Es el nombre del recurso de la estrategia de ofertas de cartera que usa la campaña. |
manual_cpa |
Es la estrategia de ofertas de CPA manual estándar. Estrategia de ofertas manual que permite al anunciante establecer la oferta por acción especificada por el anunciante. Solo se admite para las campañas de Servicios Locales. |
manual_cpc |
Es la estrategia de ofertas estándar de CPC manual. Es un sistema de ofertas manuales basado en clics en el que el usuario paga por clic. |
manual_cpm |
Es la estrategia de ofertas de CPM manual estándar. Es una estrategia de ofertas manuales basada en impresiones en la que el usuario paga por cada mil impresiones. |
maximize_conversions |
Estrategia de ofertas estándar de Maximizar conversiones que maximiza automáticamente la cantidad de conversiones sin exceder tu presupuesto. |
maximize_conversion_value |
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 |
Es una estrategia de ofertas CPA objetivo estándar que establece las ofertas automáticamente para ayudarte a obtener la mayor cantidad posible de conversiones con el costo por adquisición (CPA) objetivo que estableciste. |
target_impression_share |
Estrategia de ofertas Porcentaje de impresiones objetivo. Es una estrategia de ofertas automáticas que establece ofertas para alcanzar un porcentaje de impresiones elegido. |
target_roas |
Estrategia de ofertas ROAS objetivo estándar que maximiza automáticamente los ingresos y, al mismo tiempo, calcula el promedio de un retorno de la inversión publicitaria (ROAS) objetivo específico. |
target_spend |
Es una estrategia de ofertas estándar de Inversión objetivo que establece automáticamente tus ofertas para ayudarte a obtener la mayor cantidad posible de clics sin exceder tu presupuesto. |
percent_cpc |
Es una estrategia de ofertas de CPC porcentual estándar en la que las ofertas son una fracción del precio publicitado de algún bien o servicio. |
target_cpm |
Es una estrategia de ofertas que optimiza automáticamente el costo por mil impresiones. |
DynamicSearchAdsSetting
Es el parámetro de configuración para controlar los anuncios dinámicos de búsqueda (DSA).
| Campos | |
|---|---|
domain_name |
Obligatorio. Nombre de dominio de Internet que representa este parámetro de configuración, por ejemplo, "google.com" o "www.google.com". |
language_code |
Obligatorio. Es el código de idioma que especifica el idioma del dominio, por ejemplo, "en". |
use_supplied_urls_only |
Indica si la campaña usa exclusivamente URLs proporcionadas por el anunciante. |
GeoTargetTypeSetting
Representa una colección de parámetros de configuración relacionados con la segmentación geográfica de los anuncios.
| Campos | |
|---|---|
positive_geo_target_type |
Es el parámetro de configuración que se usa para la segmentación geográfica positiva en esta campaña en particular. |
negative_geo_target_type |
Es el parámetro de configuración que se usa para la segmentación geográfica negativa en esta campaña en particular. |
NetworkSettings
Es la configuración de red de la campaña.
| Campos | |
|---|---|
target_google_search |
Si los anuncios se publicarán con los resultados de la búsqueda de google.com. |
target_search_network |
Indica si los anuncios se publicarán en sitios de socios en la Red de Búsqueda de Google (se requiere que |
target_content_network |
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 |
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 para esta campaña, que incluye un conjunto de tipos de objetivos de optimización.
| Campos | |
|---|---|
optimization_goal_types[] |
Es la lista de tipos de objetivos de optimización. |
SelectiveOptimization
Es el parámetro de configuración de optimización selectiva para esta campaña, que incluye un conjunto de acciones de conversión para optimizar esta campaña. Esta función solo se aplica a las campañas de aplicaciones que utilizan MULTI_CHANNEL como AdvertisingChannelType y APP_CAMPAIGN o APP_CAMPAIGN_FOR_ENGAGEMENT como AdvertisingChannelSubType.
| Campos | |
|---|---|
conversion_actions[] |
Es el conjunto seleccionado de nombres de recursos para las acciones de conversión que se utilizan para optimizar esta campaña. |
ShoppingSetting
Es el parámetro de configuración de las campañas de Shopping. Define el universo de productos que se pueden promocionar con la campaña y cómo esta campaña interactúa con otras campañas de Shopping.
| Campos | |
|---|---|
feed_label |
Es la etiqueta de feed de los productos que se incluirán en la campaña. Solo se puede establecer uno de los campos feed_label o sales_country. Si se usa en lugar de sales_country, el campo feed_label acepta códigos de país en el mismo formato, por ejemplo, "XX". De lo contrario, puede ser cualquier cadena que se use para la etiqueta del feed en Google Merchant Center. |
use_vehicle_inventory |
Indica si se segmentará el inventario de fichas de vehículos. |
merchant_id |
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 |
Es el país de venta de los productos que se incluirán en la campaña. |
campaign_priority |
Es la prioridad de la campaña. Las campañas con prioridades numéricamente más altas tienen prioridad sobre las que tienen prioridades más bajas. Este campo es obligatorio para las campañas de Shopping y debe tener valores entre 0 y 2, inclusive. Este campo es opcional para las campañas de Shopping inteligentes, pero debe ser igual a 3 si se configura. |
enable_local |
Indica si se deben incluir productos locales. |
TrackingSetting
Es la configuración a nivel de la campaña para la información de seguimiento.
| Campos | |
|---|---|
tracking_url |
Es 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 |
Es el nombre del recurso del recurso de la campaña. Los nombres de recursos de CampaignAsset tienen el siguiente formato:
|
status |
Es el estado del recurso de la campaña. |
campaign |
La campaña a la que está vinculado el recurso. |
asset |
El recurso que está vinculado a la campaña. |
CampaignAssetSet
CampaignAssetSet es la vinculación entre una campaña y un conjunto de recursos. Agregar un CampaignAssetSet vincula un conjunto de recursos con una campaña.
| Campos | |
|---|---|
resource_name |
Es el nombre del recurso del conjunto de recursos de la campaña. Los nombres de recursos de los recursos del conjunto de recursos tienen el siguiente formato:
|
campaign |
Es la campaña a la que está vinculado este conjunto de recursos. |
asset_set |
Es el conjunto de recursos que está vinculado a la campaña. |
status |
Es el estado del recurso del conjunto de recursos de la campaña. Solo lectura. |
CampaignAudienceView
Es una vista del público de la campaña. Incluye datos de rendimiento de los intereses y las listas de remarketing para los anuncios de la Red de Display y la Red de YouTube, y las listas de remarketing para anuncios de búsqueda (RLSA), agregados por campaña y criterio de público. En esta vista, solo se incluyen los públicos adjuntos a nivel de la campaña.
| Campos | |
|---|---|
resource_name |
Es el nombre del recurso de la vista de público de la campaña. Los nombres de los recursos de la vista de público de la campaña tienen el siguiente formato:
|
CampaignBudget
Un presupuesto de campaña
| Campos | |
|---|---|
resource_name |
Es el nombre del recurso del presupuesto de la campaña. Los nombres de recursos de los presupuestos de la campaña tienen el siguiente formato:
|
delivery_method |
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 |
Período en el que se debe invertir el presupuesto. El valor predeterminado es DAILY si no se especifica. |
amount_micros |
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
Es un criterio de campaña.
| Campos | |
|---|---|
resource_name |
Es el nombre del recurso del criterio de campaña. Los nombres de recursos de los criterios de la campaña tienen el siguiente formato:
|
display_name |
Es el nombre visible del criterio. Este campo se ignora para las mutaciones. |
type |
El tipo del criterio. |
status |
El estado del criterio. |
last_modified_time |
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 |
El ID del criterio. Este campo se ignora durante la mutación. |
bid_modifier |
Es 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 |
Indica si se segmenta ( |
Campo de unión Se debe establecer exactamente uno. |
|
keyword |
Es la palabra clave. |
location |
Ubicación. |
device |
Dispositivo. |
age_range |
Es el rango de edad. |
gender |
Es el género. |
user_list |
Es la lista de usuarios. |
language |
de HashiCorp. |
webpage |
Página web. |
location_group |
Grupo por ubicación |
CampaignEffectiveLabel
Representa una relación entre una campaña y una etiqueta efectiva. Una etiqueta efectiva es una etiqueta heredada o asignada directamente a esta campaña.
| Campos | |
|---|---|
resource_name |
Nombre del recurso. Los nombres de los recursos CampaignEffectivelabel tienen el siguiente formato: |
campaign |
Campaña a la que se adjunta la etiqueta efectiva. |
label |
Es la etiqueta efectiva asignada a la campaña. |
owner_customer_id |
Es el ID del cliente propietario de la etiqueta efectiva. |
CampaignLabel
Representa una relación entre una campaña y una etiqueta.
| Campos | |
|---|---|
resource_name |
Nombre del recurso. Los nombres de recursos de las etiquetas de la campaña tienen el siguiente formato: |
campaign |
Campaña a la que se adjunta la etiqueta. |
label |
Es la etiqueta asignada a la campaña. |
owner_customer_id |
Es el ID del cliente propietario de la etiqueta. |
CartDataSalesView
Vista de ventas de los datos del carrito.
| Campos | |
|---|---|
resource_name |
Es el nombre del recurso de la vista de datos de ventas del carrito. Los nombres de los recursos de la vista de ventas de datos del carrito tienen el siguiente formato: |
Conversión
Una conversión
| Campos | |
|---|---|
resource_name |
Es el nombre del recurso de la conversión. Los nombres de los recursos de conversión tienen el siguiente formato:
|
id |
El ID de la conversión. |
criterion_id |
ID de criterio de Search Ads 360. Un valor de 0 indica que el criterio no se atribuye. |
merchant_id |
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 |
ID del anuncio Un valor de 0 indica que el anuncio no se atribuye. |
click_id |
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 |
Es el ID de visita de Search Ads 360 al que se atribuye la conversión. |
advertiser_conversion_id |
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 |
El ID del producto en el que se hizo clic. |
product_channel |
El canal de ventas del producto en el que se hizo clic: en línea o local. |
product_language_code |
El idioma (ISO-639-1) que se configuró para el feed de Merchant Center que contiene datos sobre el producto. |
product_store_id |
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 |
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 |
A qué se atribuye la conversión: visita o palabra clave+anuncio. |
conversion_date_time |
La marca de tiempo del evento de conversión. |
conversion_last_modified_date_time |
Es la marca de tiempo de la última vez que se modificó la conversión. |
conversion_visit_date_time |
Es la marca de tiempo de la visita a la que se atribuye la conversión. |
conversion_quantity |
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 |
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 |
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 |
Es el ID de pedido de Floodlight que proporciona el anunciante para la conversión. |
status |
Es el estado de la conversión, HABILITADA o ELIMINADA. |
asset_id |
Es el ID del recurso con el que se interactuó durante el evento de conversión. |
asset_field_type |
Es el tipo de campo del recurso del evento de conversión. |
ConversionAction
Es una acción de conversión.
| Campos | |
|---|---|
resource_name |
Es el nombre del recurso de la acción de conversión. Los nombres de recursos de las acciones de conversión tienen el siguiente formato:
|
creation_time |
Marca de tiempo de la creación de la actividad de Floodlight, con formato ISO 8601. |
status |
Es el estado de esta acción de conversión para la acumulación de eventos de conversión. |
type |
El tipo de esta acción de conversión. |
category |
Es la categoría de las conversiones registradas para esta acción de conversión. |
value_settings |
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 |
Es la configuración relacionada con el modelo de atribución de esta acción de conversión. |
floodlight_settings |
Es la configuración de Floodlight para los tipos de conversiones de Floodlight. |
id |
Es el ID de la acción de conversión. |
name |
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 |
Si el bit primary_for_goal de una acción de conversión es falso, la acción de conversión no se puede ofertar para ninguna campaña, independientemente de su objetivo de conversión del cliente o de su objetivo de conversión de la campaña. Sin embargo, los objetivos de conversión personalizados no respetan primary_for_goal, por lo que, si una campaña tiene configurado un objetivo de conversión personalizado con una acción de conversión primary_for_goal = false, esa acción de conversión seguirá siendo apta para ofertas. De forma predeterminada, primary_for_goal será verdadero si no se configura. En la versión 9, primary_for_goal solo se puede establecer como falso después de la creación a través de una operación de "actualización", ya que no se declara como opcional. |
owner_customer |
Es el nombre del recurso del cliente propietario de la acción de conversión o nulo si se trata de una acción de conversión definida por el sistema. |
include_in_client_account_conversions_metric |
Indica si esta acción de conversión se debe incluir en la métrica "client_account_conversions". |
include_in_conversions_metric |
Indica si esta acción de conversión se debe incluir en la métrica "conversiones". |
click_through_lookback_window_days |
Es la cantidad máxima de días que pueden transcurrir entre una interacción (por ejemplo, un clic) y un evento de conversión. |
app_id |
Es el ID de la aplicación para una acción de conversión en la aplicación. |
AttributionModelSettings
Es la configuración relacionada con el modelo de atribución de esta acción de conversión.
| Campos | |
|---|---|
attribution_model |
Es el tipo de modelo de atribución de esta acción de conversión. |
data_driven_model_status |
Es el estado del modelo de atribución basada en datos para la acción de conversión. |
FloodlightSettings
Es la configuración relacionada con una acción de conversión de Floodlight.
| Campos | |
|---|---|
activity_group_tag |
Es la cadena que se usa para identificar un grupo de actividades de Floodlight cuando se informan las conversiones. |
activity_tag |
Cadena que se usa para identificar una actividad de Floodlight cuando se informan las conversiones. |
activity_id |
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 |
Es el valor que se usará cuando los eventos de conversión de esta acción de conversión se envíen con un valor no válido, no permitido o faltante, o cuando esta acción de conversión esté configurada para usar siempre el valor predeterminado. |
default_currency_code |
Es el código de moneda que se usará cuando los eventos de conversión de esta acción de conversión se envíen con un código de moneda no válido o faltante, o cuando esta acción de conversión esté configurada para usar siempre el valor predeterminado. |
always_use_default_value |
Controla si se usan el valor predeterminado y el código de moneda predeterminado en lugar del valor y el código de moneda especificados en los eventos de conversión para esta acción de conversión. |
ConversionCustomVariable
Es 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 |
Es el nombre del recurso de la variable personalizada de conversión. Los nombres de los recursos de las variables personalizadas de conversión tienen el siguiente formato:
|
id |
Es el ID de la variable personalizada de conversión. |
name |
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 |
Obligatorio. Es la etiqueta de la variable personalizada de conversión. La etiqueta debe ser única y constar de un carácter "u" seguido directamente de un número menor o igual a 100. Por ejemplo, “u4”. |
status |
Es el estado de la variable personalizada de conversión para la acumulación de eventos de conversión. |
owner_customer |
Es el nombre del recurso del cliente propietario de la variable personalizada de conversión. |
family |
Es la familia de la variable personalizada de conversión. |
cardinality |
Es la cardinalidad de la variable personalizada de conversión. |
floodlight_conversion_custom_variable_info |
Son los campos para las variables personalizadas de conversión de Floodlight de Search Ads 360. |
custom_column_ids[] |
Son los IDs de las columnas personalizadas que utilizan esta variable personalizada de conversión. |
FloodlightConversionCustomVariableInfo
Es información sobre las variables personalizadas de conversión de Floodlight de Search Ads 360.
| Campos | |
|---|---|
floodlight_variable_type |
Es el tipo de variable de Floodlight definido en Search Ads 360. |
floodlight_variable_data_type |
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 a nivel del cliente relacionados con el seguimiento de conversiones de Search Ads 360.
| Campos | |
|---|---|
accepted_customer_data_terms |
Indica si el cliente aceptó las condiciones sobre los datos del cliente. Si se utiliza el seguimiento de conversiones de múltiples cuentas, este valor se hereda 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 |
Es el estado del seguimiento de conversiones. Indica si el cliente utiliza el seguimiento de conversiones y quién es el propietario del seguimiento de conversiones de este cliente. Si este cliente utiliza el seguimiento de conversiones de múltiples cuentas, el valor que se devuelve diferirá según el |
enhanced_conversions_for_leads_enabled |
Indica si el cliente habilitó las conversiones avanzadas de clientes potenciales. Si se utiliza el seguimiento de conversiones de múltiples cuentas, este valor se hereda del administrador. Este campo es de solo lectura. |
google_ads_conversion_customer |
Es el nombre del recurso del cliente en el que se crean y administran las conversiones. Este campo es de solo lectura. |
conversion_tracking_id |
Es el ID del seguimiento de conversiones que se utiliza para esta cuenta. Este ID no indica si el cliente utiliza el seguimiento de conversiones (conversion_tracking_status sí lo indica). Este campo es de solo lectura. |
google_ads_cross_account_conversion_tracking_id |
Es el ID de seguimiento de conversiones del administrador del cliente. Se establece cuando el cliente habilita el seguimiento de conversiones y anula 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 |
Es el ID de seguimiento de conversiones del administrador del cliente. Se establece cuando el cliente habilita el seguimiento de conversiones de múltiples cuentas y anula conversion_tracking_id. |
CustomColumn
Es una columna personalizada. Consulta la columna personalizada de Search Ads 360 en https://support.google.com/sa360/answer/9633916
| Campos | |
|---|---|
resource_name |
Es el nombre del recurso de la columna personalizada. Los nombres de recursos de las columnas personalizadas tienen el siguiente formato:
|
id |
Es el ID de la columna personalizada. |
name |
Es el nombre definido por el usuario de la columna personalizada. |
description |
Es la descripción definida por el usuario de la columna personalizada. |
value_type |
Es el tipo del valor del resultado de la columna personalizada. |
references_attributes |
Es verdadero cuando la columna personalizada hace referencia a uno o más atributos. |
references_metrics |
Es verdadero cuando la columna personalizada hace referencia a una o más métricas. |
queryable |
Es verdadero cuando la columna personalizada está disponible para usarse en la consulta de SearchAds360Service.Search y SearchAds360Service.SearchStream. |
referenced_system_columns[] |
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" hace referencia a las columnas del sistema de {"metrics.clicks", "metrics.impressions"}. |
render_type |
Indica cómo se debe interpretar el valor del resultado de la columna personalizada. |
Cliente
Un cliente.
| Campos | |
|---|---|
resource_name |
Es el nombre del recurso del cliente. Los nombres de recursos del cliente tienen el siguiente formato:
|
conversion_tracking_setting |
Es el parámetro de configuración del seguimiento de conversiones de un cliente. |
account_type |
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 |
Es el parámetro de configuración de DoubleClick Campaign Manager (DCM) para un cliente administrador. |
account_status |
Estado de la cuenta (por ejemplo, Habilitada, Detenida, Quitada, etcétera) |
last_modified_time |
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 |
ID de la cuenta de la cuenta de motor externa. |
status |
El estado del cliente. |
creation_time |
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”. |
manager_id |
Es el ID de cliente del administrador. Un valor de 0 indica que el cliente no tiene un administrador de SA360. |
manager_descriptive_name |
Es el nombre descriptivo del administrador. |
sub_manager_id |
Es el ID de cliente del subadministrador. Un valor de 0 indica que el cliente no tiene un administrador secundario de SA360. |
sub_manager_descriptive_name |
Es el nombre descriptivo del subadministrador. |
associate_manager_id |
Es el ID de cliente del administrador asociado. Un valor de 0 indica que el cliente no tiene un administrador asociado de SA360. |
associate_manager_descriptive_name |
Es el nombre descriptivo del administrador asociado. |
account_level |
Es el nivel de la cuenta del cliente: Administrador, Subadministrador, Administrador asociado o Cuenta de servicio. |
id |
El ID del cliente. |
descriptive_name |
Nombre descriptivo no único y opcional del cliente. |
currency_code |
La moneda en la que opera la cuenta. Se admite un subconjunto de códigos de moneda del estándar ISO 4217. |
time_zone |
El ID de la zona horaria local del cliente. |
tracking_url_template |
Es la plantilla de URL para crear una URL de seguimiento a partir de parámetros. |
final_url_suffix |
Es la plantilla de URL para agregar parámetros a la URL final. |
auto_tagging_enabled |
Indica si el etiquetado automático está habilitado para el cliente. |
manager |
Indica si el cliente es administrador. |
CustomerAsset
Es un vínculo entre un cliente y un recurso.
| Campos | |
|---|---|
resource_name |
Es el nombre del recurso del recurso del cliente. Los nombres de recursos CustomerAsset tienen el siguiente formato:
|
asset |
Obligatorio. El recurso que está vinculado al cliente. |
status |
Es el estado del recurso del cliente. |
CustomerAssetSet
CustomerAssetSet es la vinculación entre un cliente y un conjunto de recursos. Agregar un CustomerAssetSet vincula un conjunto de recursos con un cliente.
| Campos | |
|---|---|
resource_name |
Es el nombre del recurso del conjunto de recursos del cliente. Los nombres de recursos de los recursos del conjunto de recursos tienen el siguiente formato:
|
asset_set |
Es el conjunto de recursos que está vinculado al cliente. |
customer |
Es el cliente al que está vinculado este conjunto de recursos. |
status |
Es el estado del recurso del conjunto de recursos del cliente. Solo lectura. |
CustomerClient
Es un vínculo entre el cliente determinado y un cliente de cliente. Los objetos CustomerClient solo existen para los clientes administradores. Se incluyen todos los clientes directos e indirectos, así como el administrador.
| Campos | |
|---|---|
resource_name |
Es el nombre del recurso del cliente. Los nombres de recursos de CustomerClient tienen el siguiente formato: |
applied_labels[] |
Son los nombres de recursos de las etiquetas que son propiedad del cliente solicitante y que se aplican al cliente. Los nombres de los recursos de etiquetas tienen el siguiente formato:
|
status |
Es el estado del cliente. Solo lectura. |
client_customer |
Es el nombre del recurso del cliente-cliente que está vinculado al cliente determinado. Solo lectura. |
level |
Es la distancia entre el cliente y el cliente potencial determinados. Para la vinculación propia, el valor del nivel será 0. Solo lectura. |
time_zone |
Representación de cadena del Common Locale Data Repository (CLDR) de la zona horaria del cliente, por ejemplo, America/Los_Angeles. Solo lectura. |
test_account |
Identifica si el cliente es una cuenta de prueba. Solo lectura. |
manager |
Identifica si el cliente es un administrador. Solo lectura. |
descriptive_name |
Nombre descriptivo del cliente. Solo lectura. |
currency_code |
Es el código de moneda (por ejemplo, "USD", "EUR") del cliente. Solo lectura. |
id |
Es el ID del cliente. Solo lectura. |
CustomerManagerLink
Representa la relación de vinculación entre el cliente y el administrador.
| Campos | |
|---|---|
resource_name |
Nombre del recurso. Los nombres de los recursos CustomerManagerLink tienen el siguiente formato: |
status |
Es el estado de la vinculación entre el cliente y el administrador. |
manager_customer |
Es el cliente administrador vinculado al cliente. |
manager_link_id |
Es el ID de la vinculación entre el cliente y el administrador. Este campo es de solo lectura. |
start_time |
Es la marca de tiempo de cuando se creó el CustomerManagerLink. La marca de tiempo se encuentra en la zona horaria del cliente y en el formato “dd-MM-aaaa HH:mm:ss”. |
DoubleClickCampaignManagerSetting
Es el parámetro de configuración de DoubleClick Campaign Manager (DCM) para un cliente administrador.
| Campos | |
|---|---|
advertiser_id |
Es el ID del anunciante de Campaign Manager asociado con este cliente. |
network_id |
Es el ID de la red de Campaign Manager asociada con este cliente. |
time_zone |
Zona horaria de la red de Campaign Manager asociada a este cliente en formato de la base de datos de zonas horarias de IANA, como America/New_York. |
DynamicSearchAdsSearchTermView
Es una vista de los términos de búsqueda de los anuncios dinámicos de búsqueda.
| Campos | |
|---|---|
resource_name |
Es el nombre del recurso de la vista del término de búsqueda de los anuncios dinámicos de búsqueda. Los nombres de los recursos de la vista de términos de búsqueda de los anuncios de búsqueda dinámicos tienen el siguiente formato:
|
landing_page |
Es la URL de la página de destino de la impresión seleccionada de forma dinámica. Este campo es de solo lectura. |
GenderView
Es una vista de género. El recurso gender_view refleja el estado de publicación efectivo, en lugar de los criterios que se agregaron. De forma predeterminada, un grupo de anuncios sin criterios de género se muestra a todos los géneros, por lo que todos los géneros aparecen en gender_view con estadísticas.
| Campos | |
|---|---|
resource_name |
Es el nombre del recurso de la vista de género. Los nombres de los recursos de la vista de género tienen el siguiente formato:
|
GeoTargetConstant
Es una constante de segmentación geográfica.
| Campos | |
|---|---|
resource_name |
Es el nombre del recurso de la constante de segmentación geográfica. Los nombres de recursos de las constantes de segmentación geográfica tienen el siguiente formato:
|
status |
Es el estado de la constante de segmentación geográfica. |
id |
Es el ID de la constante de segmentación geográfica. |
name |
Es el nombre en inglés de la constante de segmentación geográfica. |
country_code |
Es el código de país ISO-3166-1 alpha-2 asociado con el objetivo. |
target_type |
Es el tipo de segmentación de la constante de segmentación geográfica. |
canonical_name |
Es el nombre en inglés completamente calificado, que consta del nombre del objetivo y el de su elemento superior y país. |
parent_geo_target |
Es el nombre del recurso de la constante de segmentación geográfica principal. Los nombres de recursos de las constantes de segmentación geográfica tienen el siguiente formato:
|
KeywordView
Una vista de palabras clave
| Campos | |
|---|---|
resource_name |
Es el nombre del recurso de la vista de palabras clave. Los nombres de los recursos de la vista de palabras clave tienen el siguiente formato:
|
Etiqueta
Es una etiqueta.
| Campos | |
|---|---|
resource_name |
Nombre del recurso. Los nombres de los recursos de etiquetas tienen el siguiente formato: |
status |
Es el estado de la etiqueta. Solo lectura. |
text_label |
Es un tipo de etiqueta que muestra texto sobre un fondo de color. |
id |
Es el ID de la etiqueta. Solo lectura. |
name |
Es el nombre de la etiqueta. Este campo es obligatorio y no debe estar vacío cuando se crea una etiqueta nueva. La longitud de esta cadena debe ser entre 1 y 80, inclusive. |
LanguageConstant
Un idioma
| Campos | |
|---|---|
resource_name |
Es el nombre del recurso de la constante de idioma. Los nombres de recursos de las constantes de idioma tienen el siguiente formato:
|
id |
Es el ID de la constante de idioma. |
code |
Es el código de idioma, por ejemplo, "en_US", "en_AU", "es", "fr", etcétera. |
name |
Nombre completo del idioma en inglés, por ejemplo, "English (US)", "Spanish", etcétera. |
targetable |
Indica si el idioma se puede segmentar. |
ListingGroupFilterDimension
Son las dimensiones de la ficha para el filtro de grupo de fichas del grupo de recursos.
| Campos | |
|---|---|
Campo de unión dimension. Siempre está presente la dimensión de uno de los siguientes tipos. Las direcciones (dimension) solo pueden ser una de las siguientes opciones: |
|
product_bidding_category |
Es la categoría de oferta de un producto. |
product_brand |
Es la marca de una oferta de producto. |
product_channel |
Es la localidad de una oferta de producto. |
product_condition |
Es el estado de una oferta de producto. |
product_custom_attribute |
Es el atributo personalizado de una oferta de producto. |
product_item_id |
Es el ID del artículo de una oferta de producto. |
product_type |
Es el tipo de oferta de un producto. |
ProductBiddingCategory
Es un elemento de una categoría de oferta en un nivel determinado. Las categorías de nivel superior se encuentran en el nivel 1, sus secundarias en el nivel 2, y así sucesivamente. Actualmente, admitimos hasta 5 niveles. El usuario debe especificar un tipo de dimensión que indique el nivel de la categoría. Todos los casos de la misma subdivisión deben tener el mismo tipo de dimensión (nivel de categoría).
| Campos | |
|---|---|
level |
Indica el nivel de la categoría en la taxonomía. |
id |
Es el ID de la categoría de ofertas del producto. Este ID es equivalente al ID de google_product_category, como se describe en este artículo: https://support.google.com/merchants/answer/6324436 |
ProductBrand
Es la marca del producto.
| Campos | |
|---|---|
value |
Es el valor de cadena de la marca del producto. |
ProductChannel
Es la localidad de una oferta de producto.
| Campos | |
|---|---|
channel |
Es el valor de la localidad. |
ProductCondition
Es el estado de una oferta de producto.
| Campos | |
|---|---|
condition |
Es el valor de la condición. |
ProductCustomAttribute
Es el atributo personalizado de una oferta de producto.
| Campos | |
|---|---|
index |
Indica el índice del atributo personalizado. |
value |
Es el valor de cadena del atributo personalizado del producto. |
ProductItemId
Es el ID del artículo de una oferta de producto.
| Campos | |
|---|---|
value |
Es el valor del ID. |
ProductType
Es el tipo de oferta de un producto.
| Campos | |
|---|---|
level |
Es el nivel del tipo. |
value |
Es el valor del tipo. |
ListingGroupFilterDimensionPath
Es la ruta que define las dimensiones que definen un filtro de grupo de fichas.
| Campos | |
|---|---|
dimensions[] |
Es la ruta de acceso completa de las dimensiones a través de la jerarquía de filtros del grupo de fichas (sin incluir el nodo raíz) hasta este filtro del grupo de fichas. |
LocationView
Una vista de ubicación resume el rendimiento de las campañas según un criterio de ubicación.
| Campos | |
|---|---|
resource_name |
Es el nombre del recurso de la vista de ubicación. Los nombres de los recursos de la vista de ubicación tienen el siguiente formato:
|
ProductBiddingCategoryConstant
Es una categoría de oferta de producto.
| Campos | |
|---|---|
resource_name |
Es el nombre del recurso de la categoría de ofertas de productos. Los nombres de los recursos de las categorías de ofertas de productos tienen el siguiente formato:
|
level |
Es el nivel de la categoría de ofertas del producto. |
status |
Es el estado de la categoría de oferta del producto. |
id |
Es el ID de la categoría de ofertas del producto. Este ID es equivalente al ID de google_product_category, como se describe en este artículo: https://support.google.com/merchants/answer/6324436. |
country_code |
Es el código de país de dos letras en mayúsculas de la categoría de ofertas del producto. |
product_bidding_category_constant_parent |
Es el nombre del recurso de la categoría de oferta de producto principal. |
language_code |
Es el código de idioma de la categoría de oferta del producto. |
localized_name |
Es el valor mostrado de la categoría de ofertas del producto, localizado según language_code. |
ProductGroupView
Es una vista del grupo de productos.
| Campos | |
|---|---|
resource_name |
El nombre del recurso de la vista del grupo de productos. Los nombres de los recursos de la vista del grupo de productos tienen el siguiente formato:
|
SearchAds360Field
Es un campo o recurso (artefacto) que utiliza SearchAds360Service.
| Campos | |
|---|---|
resource_name |
Es el nombre del recurso del artefacto. Los nombres de los recursos de artefactos tienen el siguiente formato:
|
category |
Es la categoría del artefacto. |
selectable_with[] |
Son los nombres de todos los recursos, segmentos y métricas que se pueden seleccionar con el artefacto descrito. |
attribute_resources[] |
Son 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 los artefactos cuya categoría es RESOURCE. |
metrics[] |
En este campo, se enumeran 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 establece para los artefactos cuya categoría es RESOURCE. |
segments[] |
En este campo, se enumeran los nombres de todos los artefactos, ya sean segmentos o algún 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 establece para los artefactos cuya categoría es RESOURCE. |
enum_values[] |
Valores que puede asumir el artefacto si es un campo de tipo ENUM. Este campo solo se configura para los artefactos de categoría SEGMENT o ATTRIBUTE. |
data_type |
Este campo determina los operadores que se pueden usar con el artefacto en las cláusulas WHERE. |
name |
Es el nombre del artefacto. |
selectable |
Indica si el artefacto se puede usar en una cláusula SELECT en las búsquedas. |
filterable |
Indica si el artefacto se puede usar en una cláusula WHERE en las búsquedas. |
sortable |
Indica si el artefacto se puede usar en una cláusula ORDER BY en las búsquedas. |
type_url |
Es la URL del archivo .proto que describe el tipo de datos del artefacto. |
is_repeated |
Indica si el artefacto de campo se repite. |
ShoppingPerformanceView
Vista del rendimiento de Shopping. Proporciona estadísticas de las campañas de Shopping agregadas en varios niveles de dimensiones del producto. Los valores de las dimensiones del producto de Merchant Center, como la marca, la categoría, los atributos personalizados, la condición del producto y el tipo de producto, reflejarán el estado de cada dimensión en la fecha y hora en que se registró el evento correspondiente.
| Campos | |
|---|---|
resource_name |
Es el nombre del recurso de la vista de rendimiento de Shopping. Los nombres de los recursos de la vista del rendimiento de las compras tienen el siguiente formato: |
UserList
Es una lista de usuarios. Es una lista de usuarios a los que un cliente puede segmentar sus anuncios.
| Campos | |
|---|---|
resource_name |
Es el nombre del recurso de la lista de usuarios. Los nombres de recursos de las listas de usuarios tienen el siguiente formato:
|
type |
Es el tipo de esta lista. Este campo es de solo lectura. |
id |
Es el ID de la lista de usuarios. |
name |
Es el nombre de esta lista de usuarios. Según su access_reason, es posible que el nombre de la lista de usuarios no sea único (por ejemplo, si access_reason=SHARED). |
UserLocationView
Es una vista de la ubicación del usuario.
La vista Ubicación del usuario incluye todas las métricas agregadas a nivel del país, con una fila por país. Registra las métricas en la ubicación física real del usuario, ya sea una ubicación de segmentación o no. Si se usan otros campos de segmento, es posible que obtengas más de una fila por país.
| Campos | |
|---|---|
resource_name |
Es el nombre del recurso de la vista de ubicación del usuario. Los nombres de los recursos de la vista UserLocation tienen el siguiente formato:
|
country_criterion_id |
Es el ID del criterio para el país. |
targeting_location |
Indica si la ubicación se segmentó o no. |
Visitar
Una visita.
| Campos | |
|---|---|
resource_name |
Es el nombre del recurso de la visita. Los nombres de los recursos de visitas tienen el siguiente formato:
|
id |
Es el ID de la visita. |
criterion_id |
ID de palabra clave de Search Ads 360. Un valor de 0 indica que la palabra clave no tiene atributo. |
merchant_id |
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 |
ID del anuncio Un valor de 0 indica que el anuncio no se atribuye. |
click_id |
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 |
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 |
El ID del producto en el que se hizo clic. |
product_channel |
El canal de ventas del producto en el que se hizo clic: en línea o local. |
product_language_code |
El idioma (ISO-639-1) que se configuró para el feed de Merchant Center que contiene datos sobre el producto. |
product_store_id |
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 |
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 |
ID del recurso con el que se interactuó durante el evento de visita. |
asset_field_type |
Es el tipo de campo del recurso del evento de visita. |
WebpageView
Es una vista de una página web.
| Campos | |
|---|---|
resource_name |
Es el nombre del recurso de la vista de la página web. Los nombres de los recursos de la vista de página web tienen el siguiente formato:
|