Package google.ads.searchads360.v0.resources

Índice

AccessibleBiddingStrategy

Representa una vista de BiddingStrategies que pertenece al cliente y que se comparte con él.

A diferencia de BiddingStrategy, este recurso incluye estrategias que son propiedad de los administradores del cliente y que se comparten con él, además de las 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

Es el nombre del recurso de la estrategia de ofertas accesible. Los nombres de 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

El tipo de estrategia de ofertas.

owner_customer_id

int64

Es el ID del cliente propietario de la estrategia de oferta.

owner_descriptive_name

string

el nombre descriptivo del cliente propietario de la estrategia de oferta.

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

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

maximize_conversion_value

MaximizeConversionValue

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

maximize_conversions

MaximizeConversions

Una estrategia de ofertas automáticas que te permite 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 aplica optimizaciones automáticamente en función de un porcentaje de impresiones determinado.

target_roas

TargetRoas

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

target_spend

TargetSpend

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

MaximizeConversionValue

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

Campos
target_roas

double

La opción de retorno de la inversión publicitaria (ROAS) objetivo. Si se establece, la estrategia de ofertas maximizará los ingresos y, a la vez, se 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 permite 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 determinado porcentaje de anuncios de búsqueda se muestre en la parte superior de la primera página (o de 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 los anuncios que se mostrarán en la ubicación de segmentación en microsegundos. Por ejemplo, 1% equivale a 10,000.

cpc_bid_ceiling_micros

int64

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

TargetRoas

Es una estrategia de ofertas automáticas que te ayuda a maximizar los ingresos, a la vez que obtienes un retorno de la inversión publicitaria (ROAS) objetivo promedio 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. Para obtener más información, consulta https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html.

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

Son los detalles relacionados con un anuncio de búsqueda responsivo.

product_ad

SearchAds360ProductAdInfo

Son detalles relacionados con un anuncio de productos.

expanded_dynamic_search_ad

SearchAds360ExpandedDynamicSearchAdInfo

Son los detalles relacionados con un anuncio dinámico de búsqueda expandido.

AdGroup

Un grupo de anuncios.

Campos
resource_name

string

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

customers/{customer_id}/adGroups/{ad_group_id}

status

AdGroupStatus

El estado del grupo de anuncios.

type

AdGroupType

El tipo del grupo de anuncios.

ad_rotation_mode

AdGroupAdRotationMode

El modo de rotación de anuncios del grupo de anuncios.

creation_time

string

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

TargetingSetting

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

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 de los grupos 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 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[]

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 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 SearchAds 360, usa "ad_group_ad.ad.id".

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

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 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 de recurso del recurso del grupo de anuncios. Los nombres de recursos 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

Es el nombre del recurso del conjunto de recursos del grupo de anuncios. Los nombres de los 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

Es 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

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

AdGroupAudienceView

La vista de público de un grupo de anuncios. Incluye datos de rendimiento de los intereses y las listas de remarketing para anuncios de la Red de Display y la Red de YouTube, así como las listas de remarketing para anuncios de búsqueda (RLSA), agregadas a nivel del público.

Campos
resource_name

string

Es 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 ofertas 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 de modificadores de oferta 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. Es el criterio del modificador de ofertas del grupo de anuncios.

Obligatorio para las operaciones de creación a partir de la versión 5. criterion puede ser una de las siguientes opciones:

device

DeviceInfo

Un criterio de dispositivo

AdGroupCriterion

Un criterio del grupo de anuncios. El informe ad_group_criterion 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 los 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

Son estimaciones para 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 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".

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, luego, 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. Es 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

Son estimaciones para ofertas de criterio en varias posiciones.

Campos
top_of_page_cpc_micros

int64

Es 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

Un contenedor para la información sobre la calidad de los criterios 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 de 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 los recursos de la etiqueta del criterio del grupo de anuncios tienen el siguiente formato: customers/{customer_id}/adGroupCriterionLabels/{ad_group_id}~{criterion_id}~{label_id}

ad_group_criterion

string

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

label

string

Es la etiqueta asignada al criterio del grupo de anuncios.

AdGroupLabel

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 los recursos de etiquetas de grupos 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

Una vista de rango de edad

Campos
resource_name

string

El nombre del recurso de la vista del 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 una parte de un anuncio que se puede compartir en 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 utiliza.

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

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

name

string

Nombre opcional del recurso.

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

Es un recurso de texto destacado unificado.

page_feed_asset

UnifiedPageFeedAsset

Un recurso de feed de página 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 recursos de los grupos 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 con la que está asociado este grupo de recursos. Es el recurso vinculado al grupo de recursos.

name

string

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

final_urls[]

string

Una lista de las 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 inhabiliten.

final_mobile_urls[]

string

Una lista de las 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 inhabiliten.

status

AssetGroupStatus

El estado del grupo de recursos.

path1

string

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

path2

string

Es la segunda parte del texto que puede aparecer como agregado a la URL que se muestra en el anuncio. Este campo solo se puede configurar cuando se establece la ruta de acceso1.

ad_strength

AdStrength

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 vinculará un recurso con un grupo de recursos.

Campos
resource_name

string

El nombre del recurso del recurso del grupo de recursos. El nombre del recurso del grupo de recursos tiene la siguiente forma:

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

asset_group

string

El grupo de recursos al que se vincula este recurso.

asset

string

El recurso al que se vincula este recurso del 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.

status

AssetLinkStatus

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[]

AssetUsage

Recursos publicados.

AssetGroupListingGroupFilter

AssetGroupListingGroupFilter representa el nodo del árbol de filtro de un grupo 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 del filtro de grupos de fichas 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

El ID del ListingGroupFilter.

type

ListingGroupFilterType

Tipo de nodo del filtro de grupo de fichas.

vertical

ListingGroupFilterVertical

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

case_value

ListingGroupFilterDimension

Valor de dimensión con la que este grupo de fichas está definiendo mejor a su elemento superior. No se define para el grupo raíz.

parent_listing_group_filter

string

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

path

ListingGroupFilterDimensionPath

Es la ruta de acceso 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 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 alta 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 la siguiente forma:

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

asset_group

string

Es el grupo de recursos al que pertenece el indicador de este 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

AudienceInfo

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

AssetGroupTopCombinationView

Una vista sobre el 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 superior del grupo de recursos. Los nombres de los recursos de la vista de combinación superior de AssetGroup tienen la siguiente forma: “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

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

Campos
id

int64

El ID del conjunto de recursos.

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}/assetSets/{asset_set_id}

AssetSetAsset

AssetSetAsset es el vínculo entre un recurso y un conjunto de recursos. Si agregas un AssetSetAsset, se vinculará un recurso con un conjunto de recursos.

Campos
resource_name

string

El nombre del recurso del elemento del conjunto de recursos. Los nombres de los recursos de los conjuntos 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

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

Público

El público es una opción de segmentación eficaz que te permite combinar 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

Es 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 única para todos los públicos. Debe tener una longitud mínima de 1 y una longitud máxima de 255.

description

string

Es la descripción de este público.

BiddingStrategy

Una estrategia de ofertas

Campos
resource_name

string

El nombre del recurso de la estrategia de ofertas. Los nombres de los recursos de las estrategias 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

El tipo de estrategia de ofertas. Para crear una estrategia de ofertas, configura el esquema de ofertas.

Este campo es de solo lectura.

currency_code

string

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

En el caso de las estrategias de oferta de clientes con acceso de administrador, esta moneda se puede configurar durante la creación y, de forma predeterminada, se establece la moneda del cliente administrador. Este campo no se puede establecer para los clientes que prestan servicios, ya que todas las estrategias de un cliente en servicio utilizan implícitamente la moneda de dicho 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 de tres letras ISO 4217).

En el caso de las estrategias de ofertas de clientes administradores, se trata de la moneda que establece el anunciante al crear la estrategia. Para brindar servicios a los clientes, este es el valor de 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 oferta.

Este campo es de solo lectura.

non_removed_campaign_count

int64

Es la cantidad de campañas no quitadas vinculadas a esta estrategia de oferta.

Este campo es de solo lectura.

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

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

enhanced_cpc

EnhancedCpc

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

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

maximize_conversions

MaximizeConversions

Una estrategia de ofertas automáticas que te permite 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 aplica optimizaciones automáticamente en función de un porcentaje de impresiones determinado.

target_outrank_share

TargetOutrankShare

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

target_roas

TargetRoas

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

target_spend

TargetSpend

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

Campaña

Una campaña

Campos
resource_name

string

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

customers/{customer_id}/campaigns/{campaign_id}

status

CampaignStatus

El estado de la campaña.

Cuando se agrega una campaña nueva, 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

Es 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

Definición opcional para 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

Es la lista de asignaciones usadas para sustituir etiquetas de parámetros personalizados en 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 orientadas a la red de Ad Exchange.

network_settings

NetworkSettings

La configuración de red para 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 el parámetro de configuración para controlar las campañas de Shopping.

geo_target_type_setting

GeoTargetTypeSetting

Es el parámetro de 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, puedes configurar 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 del recurso de AccessibleBiddingStrategy, una vista de solo lectura de los atributos no restringidos de la estrategia de ofertas de cartera adjunta que se identifica mediante “Bidding_strategy”. Este campo está vacío si la campaña no utiliza una estrategia de cartera. Los atributos de estrategias no restringidos 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

El parámetro de configuración de optimización selectiva de esta campaña, que incluye un conjunto de acciones de conversión para realizar optimizaciones. 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

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 campos de recursos que deben excluirse de esta campaña. Esta campaña no heredará los vínculos de recursos con estos tipos de campos del nivel superior.

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

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 utilizado para adjuntar 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 URLs 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 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

Es la estrategia de oferta de cartera que utiliza la campaña.

manual_cpa

ManualCpa

Estrategia de ofertas de CPA manual estándar. Estrategia de ofertas manuales que permite al anunciante establecer la oferta por acción especificada por el anunciante. Se admite solo para las campañas de Servicios Locales.

manual_cpc

ManualCpc

Estrategia de ofertas de CPC manual estándar. Ofertas manuales basadas en clics, donde el usuario paga por clic.

manual_cpm

ManualCpm

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

maximize_conversions

MaximizeConversions

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

maximize_conversion_value

MaximizeConversionValue

Es una 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 una estrategia de oferta de CPA objetivo estándar que establece ofertas automáticamente para ayudarlo a obtener la mayor cantidad posible de conversiones con el costo por adquisición (CPA) objetivo que estableció.

target_impression_share

TargetImpressionShare

Es la 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 una estrategia de ofertas ROAS objetivo estándar que maximiza los ingresos automáticamente a la vez que se promedia un retorno de la inversión publicitaria (ROAS) objetivo específico.

target_spend

TargetSpend

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

percent_cpc

PercentCpc

Estrategia de oferta de CPC de porcentaje estándar en la que las ofertas son una fracción del precio anunciado para algún producto 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. Indica 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 solo 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

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 el parámetro de configuración que se utiliza para la segmentación geográfica negativa en esta campaña en particular.

NetworkSettings

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

Campos
target_search_network

bool

Indica si los anuncios se publicarán en sitios asociados en la Red de Búsqueda de Google (se 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

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

La lista de tipos de objetivos de optimización.

SelectiveOptimization

El parámetro de configuración de optimización selectiva de esta campaña, que incluye un conjunto de acciones de conversión para realizar optimizaciones. 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 seleccionado de acciones de conversión para optimizar esta campaña.

ShoppingSetting

El parámetro de configuración para las campañas de Shopping. Define el universo de 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 un valor para 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 de feed en Google Merchant Center.

use_vehicle_inventory

bool

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

merchant_id

int64

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

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

campaign_priority

int32

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

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

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

CampaignAsset

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

Campos
resource_name

string

El nombre del recurso del recurso de la campaña. Los nombres de 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

Es el nombre del recurso del conjunto de recursos de la campaña. Los nombres de los recursos de los conjuntos 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

Es 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 los intereses y las listas de remarketing para anuncios de la Red de Display y la Red de YouTube, así como las listas de remarketing para anuncios de búsqueda (RLSA), agregadas por campaña y criterio de 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 del 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 la campaña. Los nombres de los recursos de los criterios de 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 mutaciones.

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 función de mutación.

bid_modifier

float

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

negative

bool

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

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

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

keyword

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 etiquetas de las campañas 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 de 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 SearchAds360 que contiene el producto en el que se hizo clic. Se genera este ID mediante SearchAds360 cuando vincula una cuenta de inventario en SearchAds360.

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

Es el ID de visita de SearchAds360 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

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

asset_id

int64

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

asset_field_type

AssetFieldType

Es el tipo de campo "Asset" 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 las acciones 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 registradas 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 en ninguna campaña, independientemente del objetivo de conversión de su cliente o de su campaña. Sin embargo, los objetivos de conversión personalizados no respetan el objetivo de conversión primary_for_goal. Por lo tanto, si una campaña tiene un objetivo de conversión personalizado configurado con una acción de conversión falsa = Primary_for_goal, esa acción de conversión aún se puede ofertar. De forma predeterminada, el parámetro 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 su creación a través de una operación de "actualización", ya que no se declara como opcional.

owner_customer

string

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

bool

Indica si esta acción de conversión debe incluirse en la métrica "client_account_conversions".

include_in_conversions_metric

bool

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

click_through_lookback_window_days

int64

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

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

Indica el estado del modelo de atribución basada en datos de 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 debe usar cuando los eventos de conversión de esta acción de conversión se envían con un valor no válido, no permitido o faltante, o bien cuando esta acción de conversión está configurada para utilizar siempre el valor predeterminado.

default_currency_code

string

El código de moneda que se debe usar cuando se envían eventos de conversión para esta acción de conversión 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

Es una variable personalizada de conversión. Consulta el artículo "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

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

name

string

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

status

ConversionCustomVariableStatus

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

owner_customer

string

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

family

ConversionCustomVariableFamily

Es la 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 de las variables personalizadas de conversión de Floodlight de Search Ads 360.

custom_column_ids[]

int64

Indica los ID de las columnas personalizadas que utilizan esta variable personalizada de conversión.

FloodlightConversionCustomVariableInfo

Información sobre 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 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 muestre diferirá 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 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

Es el ID del seguimiento de conversiones utilizado para esta cuenta. Este ID no indica si el cliente utiliza el seguimiento de conversiones (conversion_tracking_status sí). 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 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. Esto se establece cuando el cliente habilita el seguimiento de conversiones de múltiples cuentas y anula 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

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

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

queryable

bool

Se establece cuando la columna personalizada está disponible para usarse en la búsqueda de SearchAds360Service.Search y SearchAds360Service.SearchStream.

referenced_system_columns[]

string

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

Cliente

Un cliente.

Campos
resource_name

string

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

customers/{customer_id}

conversion_tracking_setting

ConversionTrackingSetting

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

Parámetro de 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

Es un vínculo entre un cliente y un recurso.

Campos
resource_name

string

El nombre del recurso del recurso del cliente. Los nombres de 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 agregas 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 de los conjuntos de recursos tienen el siguiente formato:

customers/{customer_id}/customerAssetSets/{asset_set_id}

asset_set

string

El conjunto de recursos vinculado al cliente.

customer

string

El cliente con el que está vinculado este conjunto de recursos.

status

AssetSetLinkStatus

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

CustomerClient

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

Campos
resource_name

string

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

applied_labels[]

string

Los nombres de los recursos de las etiquetas que pertenecen al cliente solicitante y que se aplican al cliente cliente. Los nombres de los 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 que está vinculado al cliente determinado. Solo lectura.

hidden

bool

Especifica si se trata de una cuenta oculta.

Solo lectura.

level

int64

Distancia entre un cliente determinado y el cliente. Para la vinculación propia, el valor del nivel será 0. Solo lectura.

time_zone

string

Representación de la cadena del repositorio de datos regional común (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 el nombre descriptivo del cliente. Solo lectura.

currency_code

string

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

id

int64

El ID del cliente. Solo lectura.

DoubleClickCampaignManagerSetting

Parámetro de 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

Zona horaria de la red de Campaign Manager asociada con este cliente en el formato de la base de datos de zonas horarias de IANA, como America/New_York.

DynamicSearchAdsSearchTermView

Vista de los términos de búsqueda de los anuncios dinámicos de búsqueda.

Campos
resource_name

string

El nombre de recurso de la vista del término de búsqueda de los anuncios dinámicos de búsqueda. Los nombres de los recursos de vista de los 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 seleccionada de forma dinámica de la impresión.

Este campo es de solo lectura.

GenderView

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

Campos
resource_name

string

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

customers/{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 segmentación geográfica. Los nombres de recursos constantes de las segmentaciones geográficas tienen el siguiente formato:

geoTargetConstants/{geo_target_constant_id}

status

GeoTargetConstantStatus

Estado constante de la segmentación geográfica

id

int64

El ID de la constante de segmentació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 alfa-2 asociado con el destino.

target_type

string

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

canonical_name

string

Es el nombre en inglés completamente calificado, que consta del nombre del destino, el de su empresa matriz y el país.

parent_geo_target

string

El nombre del recurso de la constante de segmentación geográfica superior. Los nombres de recursos constantes de las 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 de recurso de la vista de palabras clave. Los nombres de los recursos de la 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 los recursos de etiquetas tienen el 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

ID de la etiqueta. Solo lectura.

name

string

El nombre de la etiqueta.

Este campo es obligatorio y no debe estar vacío al crear una etiqueta nueva.

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

LanguageConstant

Un idioma

Campos
resource_name

string

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

targetable

bool

Si el idioma es apto para la segmentación.

ListingGroupFilterDimension

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

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

ProductBiddingCategory

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

product_brand

ProductBrand

Marca de la oferta de un producto

product_channel

ProductChannel

La localidad de la oferta de un producto.

product_condition

ProductCondition

Estado de la oferta de un producto.

product_custom_attribute

ProductCustomAttribute

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

Elemento de una categoría de ofertas en un determinado nivel Las categorías de nivel superior están en el nivel 1, sus hijos, en el nivel 2, etc. Por el momento, 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

ListingGroupFilterBiddingCategoryLevel

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

id

int64

ID de la categoría de ofertas de productos

Este ID equivale al ID google_product_category según 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 la cadena de la marca del producto.

ProductChannel

La localidad de la oferta de un producto.

Campos
channel

ListingGroupFilterProductChannel

Valor de la localidad.

ProductCondition

Estado de la oferta de un producto.

Campos
condition

ListingGroupFilterProductCondition

Valor de la condición.

ProductCustomAttribute

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

Es el valor del ID.

ProductType

Es el tipo de oferta de un producto.

Campos
level

ListingGroupFilterProductTypeLevel

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

Es la ruta completa de las dimensiones a través de la jerarquía de filtros del grupo 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 según 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 las vistas 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 producto. Los nombres de los 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 del producto.

status

ProductBiddingCategoryStatus

Estado de la categoría de ofertas del producto

id

int64

ID de la categoría de ofertas de productos

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

country_code

string

Código de país de dos letras en mayúsculas de la categoría de ofertas de productos.

product_bidding_category_constant_parent

string

Es el nombre del recurso de la categoría de ofertas de productos principal.

language_code

string

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

localized_name

string

Valor de visualización de la categoría de ofertas de productos, localizado en función de language_code.

ProductGroupView

Una vista de un grupo de productos

Campos
resource_name

string

El nombre del recurso de la vista del grupo de productos. Los nombres de los recursos de vista del grupo 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

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

SearchAds360Fields/{name}

category

SearchAds360FieldCategory

Es 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

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 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 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 consultas de búsqueda y cuando el artefacto descrito se utiliza en la cláusula FROM. Solo se configura para 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 está configurado para 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

Es el nombre del artefacto.

selectable

bool

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

filterable

bool

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

sortable

bool

Indica si el artefacto se puede usar en una cláusula ORDER BY en las consultas de búsqueda.

type_url

string

La URL de proto que describe el tipo de datos del artefacto.

is_repeated

bool

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 las dimensiones del producto. Los valores de las dimensiones del producto de Merchant Center, como la marca, la categoría, los atributos personalizados, el estado del producto y el tipo de producto, reflejarán el estado de cada dimensión a partir de la fecha y hora en que se registró el evento correspondiente.

Campos
resource_name

string

Es 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. Esta es una lista de usuarios a los que puede llegar 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

Tipo de esta lista.

Este campo es de solo lectura.

id

int64

Es el ID de la lista de usuarios.

name

string

Nombre de esta lista de usuarios. Según su access_reason, el nombre de la lista de usuarios no puede 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 las 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 está atribuida.

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

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

asset_field_type

AssetFieldType

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

WebpageView

Vista de una página web

Campos
resource_name

string

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

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