Package google.ads.searchads360.v0.resources

Índice

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

string

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

customers/{customer_id}/accessibleBiddingStrategies/{bidding_strategy_id}

id

int64

El ID de la estrategia de ofertas.

name

string

El nombre de la estrategia de ofertas.

type

BiddingStrategyType

Es el tipo de estrategia de ofertas.

owner_customer_id

int64

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

owner_descriptive_name

string

Es el nombre descriptivo del cliente propietario de la estrategia de ofertas.

Campo de unión scheme. Esquema de ofertas.

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

maximize_conversion_value

MaximizeConversionValue

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

maximize_conversions

MaximizeConversions

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

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 se optimiza automáticamente en función de un porcentaje elegido de impresiones.

target_roas

TargetRoas

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

target_spend

TargetSpend

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

MaximizeConversionValue

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

Campos
target_roas

double

Es la opción de retorno de la inversión publicitaria (ROAS) objetivo. Si se 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

int64

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

int64

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

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 los anuncios de búsqueda se muestren en la parte superior de la primera página (o en otra ubicación objetivo).

Campos
location

TargetImpressionShareLocation

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

location_fraction_micros

int64

Es la fracción elegida de anuncios que se mostrarán en la ubicación objetivo en micro unidades. Por ejemplo, el 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 y, al mismo tiempo, obtener un promedio de un retorno de la inversión publicitaria (ROAS) objetivo específico.

Campos
target_roas

double

Los ingresos elegidos (según los datos de conversiones) por unidad de inversión.

TargetSpend

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

Campos
target_spend_micros
(deprecated)

int64

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

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 recursos de los 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.

final_app_urls[]

FinalAppUrl

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

string

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

type

AdType

El tipo de anuncio.

id

int64

El ID del anuncio.

tracking_url_template

string

La plantilla de URL para crear una URL de seguimiento.

final_url_suffix

string

Es el sufijo que se usa cuando se construye una URL final.

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.

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 los detalles relacionados con un anuncio de producto.

expanded_dynamic_search_ad

SearchAds360ExpandedDynamicSearchAdInfo

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

Grupo de anuncios

Es un grupo de anuncios.

Campos
resource_name

string

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

customers/{customer_id}/adGroups/{ad_group_id}

status

AdGroupStatus

El estado del grupo de anuncios.

type

AdGroupType

Es el tipo del grupo de anuncios.

ad_rotation_mode

AdGroupAdRotationMode

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

creation_time

string

Es la marca de tiempo 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 para las funciones relacionadas con la segmentación.

labels[]

string

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

effective_labels[]

string

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

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

tracking_url_template

string

La plantilla de URL para crear una URL de seguimiento.

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.

final_url_suffix

string

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

AdGroupAd

Es un anuncio del grupo de anuncios.

Campos
resource_name

string

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

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

status

AdGroupAdStatus

El estado del anuncio.

ad

Ad

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

effective_labels[]

string

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

string

ID del anuncio en la cuenta de motor externa. Este campo solo se usa para la cuenta de Search Ads 360; por ejemplo, Yahoo Japan, Microsoft, Baidu, etc. En el caso de una entidad que no sea de Search Ads 360, usa "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”.

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

string

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

ad_group_ad

string

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

label

string

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

owner_customer_id

int64

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

string

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: customers/{owner_customer_id}/adGroupAdLabels/{ad_group_id}~{ad_id}~{label_id}

ad_group_ad

string

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

label

string

Es la etiqueta asignada al anuncio del grupo de anuncios.

owner_customer_id

int64

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

string

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

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

ad_group

string

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

asset

string

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

status

AssetLinkStatus

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

string

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

customers/{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 que está vinculado al grupo de anuncios.

status

AssetSetLinkStatus

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

string

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

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

AdGroupBidModifier

Representa un modificador de ofertas del grupo de anuncios.

Campos
resource_name

string

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

customers/{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 de este modificador de ofertas del grupo de anuncios.

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

device

DeviceInfo

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

string

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

customers/{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

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

effective_labels[]

string

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

position_estimates

PositionEstimates

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

final_urls[]

string

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

final_mobile_urls[]

string

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

url_custom_parameters[]

CustomParameter

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

engine_id

string

ID del criterio del grupo de anuncios en la cuenta de motor externo. Este campo es solo para una cuenta que no es de Google Ads, por ejemplo, Yahoo Japan, Microsoft, Baidu, etc. Para la entidad de Google Ads, usa "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

Es el grupo de anuncios al que pertenece el criterio.

negative

bool

Indica si se segmenta (false) o excluye (true) el criterio.

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

bid_modifier

double

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

cpc_bid_micros

int64

La oferta de CPC (costo por clic).

effective_cpc_bid_micros

int64

La oferta de CPC (costo por clic) efectiva.

engine_status

AdGroupCriterionEngineStatus

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

final_url_suffix

string

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

tracking_url_template

string

La plantilla de URL para crear una URL de seguimiento.

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

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

keyword

KeywordInfo

Es la palabra clave.

listing_group

ListingGroupInfo

Es el grupo de fichas.

age_range

AgeRangeInfo

Es el rango de edad.

gender

GenderInfo

Es el género.

user_list

UserListInfo

Es la lista de usuarios.

webpage

WebpageInfo

Página web

location

LocationInfo

Ubicación.

PositionEstimates

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

Campos
top_of_page_cpc_micros

int64

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

int32

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

string

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

ad_group_criterion

string

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

label

string

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

owner_customer_id

int64

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

string

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

ad_group_criterion

string

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

label

string

Es la etiqueta asignada al criterio del grupo de anuncios.

owner_customer_id

int64

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

string

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

ad_group

string

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

label

string

Es la etiqueta efectiva asignada al grupo de anuncios.

owner_customer_id

int64

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

string

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

ad_group

string

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

label

string

Es la etiqueta asignada al grupo de anuncios.

owner_customer_id

int64

Es el ID del cliente propietario de la etiqueta.

AgeRangeView

Es una vista de rango de edad.

Campos
resource_name

string

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:

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

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

string

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

customers/{customer_id}/assets/{asset_id}

type

AssetType

Es el tipo de recurso.

final_urls[]

string

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

final_mobile_urls[]

string

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

url_custom_parameters[]

CustomParameter

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

AssetStatus

El estado del recurso.

creation_time

string

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

last_modified_time

string

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

id

int64

El ID del activo.

name

string

Nombre opcional del activo.

tracking_url_template

string

Plantilla de URL para crear una URL de seguimiento.

final_url_suffix

string

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

engine_status

AssetEngineStatus

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

YoutubeVideoAsset

Es un recurso de video de YouTube.

image_asset

ImageAsset

Es un recurso de imagen.

text_asset

TextAsset

Es un recurso de texto.

callout_asset

UnifiedCalloutAsset

Es un recurso de texto destacado unificado.

page_feed_asset

UnifiedPageFeedAsset

Es un recurso de feed de páginas unificado.

mobile_app_asset

MobileAppAsset

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

call_asset

UnifiedCallAsset

Es un recurso de llamada unificado.

call_to_action_asset

CallToActionAsset

Es un recurso de llamado a la acción.

location_asset

UnifiedLocationAsset

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

string

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

customers/{customer_id}/assetGroups/{asset_group_id}

id

int64

Es el ID del grupo de recursos.

campaign

string

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

name

string

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

final_urls[]

string

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

final_mobile_urls[]

string

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

status

AssetGroupStatus

Es el estado del grupo de recursos.

path1

string

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

path2

string

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

ad_strength

AdStrength

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

string

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

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

asset_group

string

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

asset

string

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

field_type

AssetFieldType

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

status

AssetLinkStatus

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

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

string

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:

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 y elementos del grupo de recursos.

id

int64

Es el ID de ListingGroupFilter.

type

ListingGroupFilterType

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

vertical

ListingGroupFilterVertical

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

case_value

ListingGroupFilterDimension

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

parent_listing_group_filter

string

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

path

ListingGroupFilterDimensionPath

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

string

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

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

asset_group

string

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

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

AudienceInfo

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

AssetGroupTopCombinationView

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

Campos
resource_name

string

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

asset_group_top_combinations[]

AssetGroupAssetCombinationData

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

int64

Es el ID del conjunto de recursos.

resource_name

string

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

customers/{customer_id}/assetSets/{asset_set_id}

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

string

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

customers/{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

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

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

description

string

Es la descripción de este público.

BiddingStrategy

Es una estrategia de ofertas.

Campos
resource_name

string

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

customers/{customer_id}/biddingStrategies/{bidding_strategy_id}

status

BiddingStrategyStatus

El estado de la estrategia de ofertas.

Este campo es de solo lectura.

type

BiddingStrategyType

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

Este campo es de solo lectura.

currency_code

string

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

En el caso de las estrategias de ofertas de las cuentas de 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

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

int64

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

Este campo es de solo lectura.

non_removed_campaign_count

int64

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

Este campo es de solo lectura.

Campo de unión scheme. Esquema de ofertas.

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

enhanced_cpc

EnhancedCpc

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

maximize_conversion_value

MaximizeConversionValue

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

maximize_conversions

MaximizeConversions

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

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 se optimiza automáticamente en función de un porcentaje elegido de impresiones.

target_outrank_share

TargetOutrankShare

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

TargetRoas

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

target_spend

TargetSpend

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

Campaña

Es una campaña.

Campos
resource_name

string

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

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

Es un perfeccionamiento opcional de 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 que se usan para sustituir las etiquetas de parámetros personalizados en un objeto tracking_url_template, final_urls o mobile_final_urls.

real_time_bidding_setting

RealTimeBiddingSetting

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

NetworkSettings

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

dynamic_search_ads_setting

DynamicSearchAdsSetting

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

shopping_setting

ShoppingSetting

Es el parámetro de configuración que controla 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.

effective_labels[]

string

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

labels[]

string

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

bidding_strategy_type

BiddingStrategyType

El tipo de estrategia de ofertas.

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

Este campo es de solo lectura.

accessible_bidding_strategy

string

Es el nombre del recurso de AccessibleBiddingStrategy, una vista de solo lectura de los atributos sin restricciones de la estrategia de ofertas de cartera adjunta identificada por "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[]

FrequencyCapEntry

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

selective_optimization

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.

optimization_goal_setting

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.

tracking_setting

TrackingSetting

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

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

string

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

feed_types[]

AssetSetType

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

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

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

start_date

string

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

end_date

string

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

final_url_suffix

string

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

url_expansion_opt_out

bool

Representa la inhabilitación de la expansión de URL a URLs más segmentadas. Si 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 campaign_bidding_strategy. Es la estrategia de ofertas de la campaña.

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

bidding_strategy

string

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

manual_cpa

ManualCpa

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

manual_cpc

ManualCpc

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

ManualCpm

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

MaximizeConversions

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

maximize_conversion_value

MaximizeConversionValue

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

TargetImpressionShare

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

target_roas

TargetRoas

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

target_spend

TargetSpend

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

percent_cpc

PercentCpc

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

TargetCpm

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

string

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

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

PositiveGeoTargetType

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

NegativeGeoTargetType

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_search_network

bool

Indica si los anuncios se publicarán en sitios de socios 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

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

OptimizationGoalType

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

string

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

string

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

bool

Indica si se 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

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

bool

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

string

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

string

Es 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

Es el estado del recurso de la campaña.

campaign

string

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

asset

string

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

CampaignAssetSet

CampaignAssetSet es la vinculación entre una campaña y un conjunto de recursos. Agregar un CampaignAssetSet 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 recursos de los recursos del conjunto de recursos tienen el siguiente formato:

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

campaign

string

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

asset_set

string

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

status

AssetSetLinkStatus

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

CampaignAudienceView

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

Campos
resource_name

string

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:

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

CampaignBudget

Un presupuesto de campaña

Campos
resource_name

string

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

customers/{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

Es un criterio de campaña.

Campos
resource_name

string

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

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

display_name

string

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

bid_modifier

float

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

bool

Indica si se segmenta (false) o excluye (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

Es la palabra clave.

location

LocationInfo

Ubicación.

device

DeviceInfo

Dispositivo.

age_range

AgeRangeInfo

Es el rango de edad.

gender

GenderInfo

Es el género.

user_list

UserListInfo

Es la lista de usuarios.

language

LanguageInfo

de HashiCorp.

webpage

WebpageInfo

Página web.

location_group

LocationGroupInfo

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

string

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

campaign

string

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

label

string

Es la etiqueta efectiva asignada a la campaña.

owner_customer_id

int64

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

string

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

campaign

string

Campaña a la que se adjunta la etiqueta.

label

string

Es la etiqueta asignada a la campaña.

owner_customer_id

int64

Es el ID del cliente propietario de la etiqueta.

CartDataSalesView

Vista de ventas de los datos del carrito.

Campos
resource_name

string

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

Conversión

Una conversión

Campos
resource_name

string

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

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

id

int64

El ID de la conversión.

criterion_id

int64

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

merchant_id

int64

El ID de cuenta de inventario de Search Ads 360 que contiene el producto en el que se hizo clic. Search Ads 360 genera este ID cuando vincula una cuenta de inventario en Search Ads 360.

ad_id

int64

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

click_id

string

Es una string única para la visita a la que se atribuye la conversión; esta se pasa a la página de destino como el parámetro de URL de clic de ID.

visit_id

int64

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

advertiser_conversion_id

string

En el caso de las conversiones sin conexión, se trata de un ID que proporcionan los anunciantes. Si un anunciante no especifica ese ID, se genera uno mediante Search Ads 360 En el caso de las conversiones en línea, esto es igual a la columna de ID o a la columna Floodlight_order_id según las instrucciones de Floodlight del anunciante.

product_id

string

El ID del producto en el que se hizo clic.

product_channel

ProductChannel

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

product_language_code

string

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

product_store_id

string

Indica la tienda del anuncio del inventario local en el que se hizo clic. Debe coincidir con los IDs de tienda que se usan en el feed de productos locales.

product_country_code

string

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

attribution_type

AttributionType

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

conversion_date_time

string

La marca de tiempo del evento de conversión.

conversion_last_modified_date_time

string

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

conversion_visit_date_time

string

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

conversion_quantity

int64

La cantidad de artículos que registra la conversión, según lo determinado por el parámetro qty url. El anunciante es responsable de propagar los parámetros de forma dinámica (como la cantidad de artículos que se venden en la conversión). De lo contrario, el valor predeterminado es 1.

conversion_revenue_micros

int64

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

floodlight_original_revenue

int64

Los ingresos originales sin cambios asociados con el evento de Floodlight (en la moneda del informe actual), antes de las modificaciones de la instrucción de la moneda de Floodlight.

floodlight_order_id

string

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

status

ConversionStatus

Es el estado de la conversión, HABILITADA o ELIMINADA.

asset_id

int64

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

asset_field_type

AssetFieldType

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

ConversionAction

Es una acción de conversión.

Campos
resource_name

string

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

customers/{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 las 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

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

id

int64

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

name

string

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

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

primary_for_goal

bool

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

string

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

include_in_client_account_conversions_metric

bool

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

include_in_conversions_metric

bool

Indica si esta acción de conversión se debe incluir 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 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

AttributionModel

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

data_driven_model_status

DataDrivenModelStatus

Es el estado del modelo de atribución basada en datos 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

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

string

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

always_use_default_value

bool

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

string

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

customers/{customer_id}/conversionCustomVariables/{conversion_custom_variable_id}

id

int64

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

name

string

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

tag

string

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

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

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

floodlight_conversion_custom_variable_info

FloodlightConversionCustomVariableInfo

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

custom_column_ids[]

int64

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

FloodlightConversionCustomVariableInfo

Es 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 a nivel del cliente relacionados con el seguimiento de conversiones de Search Ads 360.

Campos
accepted_customer_data_terms

bool

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

ConversionTrackingStatus

Es el estado del seguimiento de conversiones. Indica si el cliente utiliza el seguimiento de conversiones y quién es el propietario del seguimiento de conversiones de este cliente. Si este cliente utiliza el seguimiento de conversiones de múltiples cuentas, el valor que se devuelve diferirá según el login-customer-id de la solicitud.

enhanced_conversions_for_leads_enabled

bool

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

string

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

int64

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

int64

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

int64

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

string

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

customers/{customer_id}/customColumns/{custom_column_id}

id

int64

Es el ID de la columna personalizada.

name

string

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

description

string

Es la descripción definida por el usuario de la columna personalizada.

value_type

CustomColumnValueType

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

references_attributes

bool

Es verdadero cuando la columna personalizada hace referencia a uno o más atributos.

references_metrics

bool

Es verdadero cuando la columna personalizada hace referencia a una o más métricas.

queryable

bool

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

referenced_system_columns[]

string

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

render_type

CustomColumnRenderType

Indica cómo se debe interpretar el valor del resultado de la columna personalizada.

Cliente

Un cliente.

Campos
resource_name

string

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

customers/{customer_id}

conversion_tracking_setting

ConversionTrackingSetting

Es el parámetro de 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

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

manager_id

int64

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

manager_descriptive_name

string

Es el nombre descriptivo del administrador.

sub_manager_id

int64

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

string

Es el nombre descriptivo del subadministrador.

associate_manager_id

int64

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

string

Es el nombre descriptivo del administrador asociado.

account_level

AccountLevelType

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

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

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

final_url_suffix

string

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

auto_tagging_enabled

bool

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

manager

bool

Indica si el cliente es administrador.

CustomerAsset

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

Campos
resource_name

string

Es 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

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

string

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

customers/{customer_id}/customerAssetSets/{asset_set_id}

asset_set

string

Es el conjunto de recursos que está vinculado al cliente.

customer

string

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

status

AssetSetLinkStatus

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

string

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

applied_labels[]

string

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:

customers/{customer_id}/labels/{label_id}

status

CustomerStatus

Es el estado del cliente. Solo lectura.

client_customer

string

Es el nombre del recurso del cliente-cliente que está vinculado al cliente determinado. Solo lectura.

hidden

bool

Especifica si esta es una cuenta oculta.

Solo lectura.

level

int64

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

string

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

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

Nombre descriptivo del cliente. Solo lectura.

currency_code

string

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

id

int64

Es el ID del cliente. Solo lectura.

DoubleClickCampaignManagerSetting

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

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

time_zone

string

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

DynamicSearchAdsSearchTermView

Es una vista de los términos de búsqueda de los anuncios dinámicos de búsqueda.

Campos
resource_name

string

Es el nombre del recurso de la vista del término de búsqueda de los anuncios dinámicos de búsqueda. Los nombres de los recursos de la vista de términos de búsqueda de los anuncios de búsqueda dinámicos tienen el siguiente formato:

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

landing_page

string

Es la URL de la página de destino de la impresión seleccionada de forma dinámica.

Este campo es de solo lectura.

GenderView

Es 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

string

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

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

GeoTargetConstant

Es una constante de segmentación geográfica.

Campos
resource_name

string

Es el nombre del recurso de la constante de segmentación geográfica. Los nombres de recursos de las constantes de segmentación geográfica tienen el siguiente formato:

geoTargetConstants/{geo_target_constant_id}

status

GeoTargetConstantStatus

Es el estado de la constante de segmentación geográfica.

id

int64

Es el ID de la constante de segmentación geográfica.

name

string

Es el nombre en inglés de la constante de segmentación geográfica.

country_code

string

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

target_type

string

Es el tipo de segmentación de la constante de segmentación geográfica.

canonical_name

string

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

string

Es el nombre del recurso de la constante de segmentación geográfica principal. Los nombres de recursos de las constantes de segmentación geográfica tienen el siguiente formato:

geoTargetConstants/{parent_geo_target_constant_id}

KeywordView

Una vista de palabras clave

Campos
resource_name

string

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:

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

Etiqueta

Es una etiqueta.

Campos
resource_name

string

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

status

LabelStatus

Es el estado de la etiqueta. Solo lectura.

text_label

TextLabel

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

id

int64

Es el ID de la etiqueta. Solo lectura.

name

string

Es el nombre de la etiqueta.

Este campo es obligatorio y no debe estar vacío cuando se crea una etiqueta nueva.

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

LanguageConstant

Un idioma

Campos
resource_name

string

Es el nombre del recurso de la constante de idioma. Los nombres de recursos de las constantes de idioma tienen el siguiente formato:

languageConstants/{criterion_id}

id

int64

Es el ID de la constante de idioma.

code

string

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

name

string

Nombre completo del idioma en inglés, por ejemplo, "English (US)", "Spanish", etcétera.

targetable

bool

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

ProductBiddingCategory

Es la categoría de oferta de un producto.

product_brand

ProductBrand

Es la marca de una oferta de producto.

product_channel

ProductChannel

Es la localidad de una oferta de producto.

product_condition

ProductCondition

Es el estado de una oferta de producto.

product_custom_attribute

ProductCustomAttribute

Es el atributo personalizado de una oferta de producto.

product_item_id

ProductItemId

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

product_type

ProductType

Es el tipo de oferta de un producto.

ProductBiddingCategory

Es un elemento de una categoría de oferta en un nivel determinado. Las categorías de nivel superior 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

ListingGroupFilterBiddingCategoryLevel

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

id

int64

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

string

Es el valor de cadena de la marca del producto.

ProductChannel

Es la localidad de una oferta de producto.

Campos
channel

ListingGroupFilterProductChannel

Es el valor de la localidad.

ProductCondition

Es el estado de una oferta de producto.

Campos
condition

ListingGroupFilterProductCondition

Es el valor de la condición.

ProductCustomAttribute

Es el atributo personalizado de una oferta de 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 del 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

Es el nivel del tipo.

value

string

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

string

Es el nombre del recurso de la vista de ubicación. Los nombres de los recursos de la vista de ubicación tienen el siguiente formato:

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

ProductBiddingCategoryConstant

Es una categoría de oferta de producto.

Campos
resource_name

string

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

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

level

ProductBiddingCategoryLevel

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

status

ProductBiddingCategoryStatus

Es el estado de la categoría de oferta del producto.

id

int64

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

string

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

string

Es el nombre del recurso de la categoría de oferta de producto principal.

language_code

string

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

localized_name

string

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

string

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

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

SearchAds360Field

Es un campo o recurso (artefacto) que utiliza SearchAds360Service.

Campos
resource_name

string

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

SearchAds360Fields/{name}

category

SearchAds360FieldCategory

Es la categoría del artefacto.

selectable_with[]

string

Son 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 los artefactos cuya categoría es RESOURCE.

metrics[]

string

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

string

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

string

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

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

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

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 búsquedas.

type_url

string

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

is_repeated

bool

Indica si el artefacto 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

string

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

UserList

Es una lista de usuarios. Es una lista de usuarios a los que un cliente puede segmentar sus anuncios.

Campos
resource_name

string

Es el nombre del recurso de la lista de usuarios. Los nombres de recursos de las listas de usuarios tienen el siguiente formato:

customers/{customer_id}/userLists/{user_list_id}

type

UserListType

Es el tipo de esta lista.

Este campo es de solo lectura.

id

int64

Es el ID de la lista de usuarios.

name

string

Es el nombre de esta lista de usuarios. Según su access_reason, 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

string

Es el nombre del recurso de la vista de ubicación del usuario. Los nombres de los recursos de la vista UserLocation tienen el siguiente formato:

customers/{customer_id}/userLocationViews/{country_criterion_id}~{targeting_location}

country_criterion_id

int64

Es el ID del criterio para el país.

targeting_location

bool

Indica si la ubicación se segmentó o no.

Visitar

Una visita.

Campos
resource_name

string

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

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

id

int64

Es el ID de la visita.

criterion_id

int64

ID de palabra clave de Search Ads 360. Un valor de 0 indica que la palabra clave no tiene atributo.

merchant_id

int64

El ID de cuenta de inventario de Search Ads 360 que contiene el producto en el que se hizo clic. Search Ads 360 genera este ID cuando vincula una cuenta de inventario en Search Ads 360.

ad_id

int64

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

click_id

string

Una string única para cada visita que se pasa a la página de destino como el parámetro de URL de ID de clic

visit_date_time

string

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

product_id

string

El ID del producto en el que se hizo clic.

product_channel

ProductChannel

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

product_language_code

string

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

product_store_id

string

Indica la tienda del anuncio del inventario local en el que se hizo clic. Debe coincidir con los IDs de tienda que se usan en el feed de productos locales.

product_country_code

string

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

asset_id

int64

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

asset_field_type

AssetFieldType

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

WebpageView

Es una 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 los recursos de la vista de página web tienen el siguiente formato:

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