Package google.ads.searchads360.v0.resources

Índice

AccessibleBiddingStrategy

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

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

Campos
resource_name

string

Es el nombre del recurso de la estrategia de ofertas a la que se puede acceder. Los nombres de los recursos de AccessibleBiddingStrategy tienen el siguiente formato:

customers/{customer_id}/accessibleBiddingStrategies/{bidding_strategy_id}

id

int64

El ID de la estrategia de ofertas.

name

string

El nombre de la estrategia de ofertas.

type

BiddingStrategyType

Es el tipo de estrategia de ofertas.

owner_customer_id

int64

El ID del cliente al que pertenece la estrategia de ofertas.

owner_descriptive_name

string

descriptive_name del cliente propietario de la estrategia de ofertas.

Campo de unión scheme. El esquema de ofertas.

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

maximize_conversion_value

MaximizeConversionValue

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

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

target_roas

TargetRoas

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

target_spend

TargetSpend

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

MaximizeConversionValue

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

Campos
target_roas

double

Es la opción de retorno de la inversión publicitaria (ROAS) objetivo. Si se establece, la estrategia de ofertas maximizará los ingresos y, al mismo tiempo, aplicará un 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 el presupuesto completo. Si no se establece el ROAS objetivo, la estrategia de ofertas intentará alcanzar el ROAS más alto posible para el presupuesto.

MaximizeConversions

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

Campos
target_cpa

int64

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

target_cpa_micros

int64

La opción de costo por adquisición (CPA) objetivo. 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 porcentaje determinado de anuncios de búsqueda se muestre en la parte superior de la primera página (o en otra ubicación segmentada).

Campos
location

TargetImpressionShareLocation

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

location_fraction_micros

int64

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

cpc_bid_ceiling_micros

int64

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

TargetRoas

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

Campos
target_roas

double

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

cpc_bid_ceiling_micros

int64

El límite de oferta máximo que se puede establecer con la estrategia de ofertas. El límite se aplica a todas las palabras clave administradas por la estrategia.

Un anuncio

Campos
resource_name

string

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

customers/{customer_id}/ads/{ad_id}

final_urls[]

string

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

type

AdType

El tipo de anuncio.

id

int64

El ID del anuncio.

display_url

string

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

name

string

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

Campo de unión ad_data. Detalles relevantes para el 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

Detalles relacionados con un anuncio de texto expandido.

responsive_search_ad

SearchAds360ResponsiveSearchAdInfo

Detalles relacionados con un anuncio de búsqueda responsivo.

product_ad

SearchAds360ProductAdInfo

Detalles relacionados con un anuncio de producto.

expanded_dynamic_search_ad

SearchAds360ExpandedDynamicSearchAdInfo

Detalles relacionados con un anuncio dinámico de búsqueda expandido.

Grupo de anuncios

Un grupo de anuncios.

Campos
resource_name

string

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

customers/{customer_id}/adGroups/{ad_group_id}

status

AdGroupStatus

El estado del grupo de anuncios.

type

AdGroupType

El tipo de grupo de anuncios.

ad_rotation_mode

AdGroupAdRotationMode

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

creation_time

string

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

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

labels[]

string

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

effective_labels[]

string

Los nombres de recursos de las etiquetas eficaces adjuntas a este grupo de anuncios. Una etiqueta eficaz 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).

cpc_bid_micros

int64

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

engine_status

AdGroupEngineStatus

El estado del motor para el grupo de anuncios.

AdGroupAd

Un anuncio del grupo de anuncios

Campos
resource_name

string

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

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

status

AdGroupAdStatus

El estado del anuncio.

ad

Ad

El anuncio

creation_time

string

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

Los nombres de recursos de las etiquetas efectivas adjuntas a este anuncio. Una etiqueta eficaz es una etiqueta heredada o asignada directamente a este anuncio.

engine_id

string

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

engine_status

AdGroupAdEngineStatus

Estado adicional del anuncio en la cuenta de motor externa. Los estados posibles (según el tipo de cuenta externa) incluyen activo, apto, revisión pendiente, etcétera.

last_modified_time

string

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

AdGroupAdEffectiveLabel

Es una relación entre un anuncio de grupo de anuncios y una etiqueta eficaz. Una etiqueta eficaz es una etiqueta heredada o asignada directamente a este anuncio de grupo de anuncios.

Campos
resource_name

string

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

ad_group_ad

string

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

label

string

La etiqueta efectiva asignada al anuncio del grupo de anuncios.

owner_customer_id

int64

El ID del cliente propietario de la etiqueta vigente

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 la etiqueta de anuncio del grupo de anuncios tienen el siguiente formato: customers/{customer_id}/adGroupAdLabels/{ad_group_id}~{ad_id}~{label_id}

ad_group_ad

string

El anuncio del grupo de anuncios al que se 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 del recurso del grupo de anuncios.

AdGroupAssetSet

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

Campos
resource_name

string

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

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

ad_group

string

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

asset_set

string

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

status

AssetSetLinkStatus

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

AdGroupAudienceView

Una vista del público del grupo de anuncios. Incluye datos de rendimiento de los intereses y las listas de remarketing para anuncios de la Red de Display y de 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 del 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 los recursos del modificador de ofertas del grupo de anuncios tienen el siguiente formato:

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

bid_modifier

double

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

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

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

device

DeviceInfo

Un criterio de dispositivo.

AdGroupCriterion

Un criterio del grupo de anuncios. El informe ad_group_criterion solo muestra 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 del criterio del grupo de anuncios tienen el siguiente formato:

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

creation_time

string

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

status

AdGroupCriterionStatus

El estado del criterio.

Este es el estado de la entidad de criterio del grupo de anuncios, configurada por el cliente. Nota: Es posible que los informes de la IU incorporen información adicional que afecte si un criterio es apto para ejecutarse. En algunos casos, un criterio que se quita en la API aún puede mostrarse como habilitado en la IU. Por ejemplo, las campañas predeterminadas se mostrarán a los usuarios de todos los rangos de edad, a menos que se excluyan. La IU mostrará cada rango de edad como "habilitado", ya que son aptos para ver los anuncios, pero AdGroupCriterion.status mostrará “quitado”, ya que no se agregó ningún criterio positivo.

quality_info

QualityInfo

Información sobre la calidad del criterio.

type

CriterionType

El tipo del criterio.

labels[]

string

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

effective_labels[]

string

Los nombres de recursos de las etiquetas efectivas 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

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.

engine_id

string

ID del criterio del grupo de anuncios en la cuenta de motor externo. Este campo solo se usa 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 debe orientar (false) o excluir (true) el criterio.

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

bid_modifier

double

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

cpc_bid_micros

int64

La oferta de CPC (costo por clic).

effective_cpc_bid_micros

int64

La oferta de CPC (costo por clic) efectiva.

engine_status

AdGroupCriterionEngineStatus

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

final_url_suffix

string

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

tracking_url_template

string

La plantilla de URL para crear una URL de seguimiento.

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

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

keyword

KeywordInfo

Palabra clave.

listing_group

ListingGroupInfo

Grupo de fichas.

age_range

AgeRangeInfo

Rango de edad

gender

GenderInfo

Género

user_list

UserListInfo

Lista de usuarios

webpage

WebpageInfo

Página web

location

LocationInfo

Ubicación.

PositionEstimates

Estimaciones de las ofertas de criterios en varias posiciones.

Campos
top_of_page_cpc_micros

int64

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

QualityInfo

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

Campos
quality_score

int32

El nivel de calidad.

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

AdGroupCriterionEffectiveLabel

Es una relación entre un criterio del grupo de anuncios y una etiqueta eficaz. Una etiqueta eficaz es una etiqueta heredada o asignada directamente a este criterio del grupo de anuncios.

Campos
resource_name

string

El nombre del recurso de la etiqueta de vigencia del criterio del grupo de anuncios. Los nombres de recursos de la etiqueta efectiva del criterio del grupo de anuncios tienen el siguiente formato: customers/{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 eficaz.

label

string

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

owner_customer_id

int64

El ID del cliente al que pertenece 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 los criterios del grupo de anuncios tienen el siguiente formato: customers/{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

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 eficaz. Una etiqueta eficaz 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 etiquetas efectivos del grupo de anuncios tienen el siguiente formato: customers/{customer_id}/adGroupEffectiveLabels/{ad_group_id}~{label_id}

ad_group

string

El grupo de anuncios al que se adjunta la etiqueta efectiva.

label

string

La etiqueta efectiva asignada al grupo de anuncios.

owner_customer_id

int64

El ID del cliente al que pertenece la etiqueta efectiva.

AdGroupLabel

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

Campos
resource_name

string

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

ad_group

string

El grupo de anuncios al que se adjunta la etiqueta.

label

string

La etiqueta asignada al grupo de anuncios.

owner_customer_id

int64

El ID del cliente propietario de la etiqueta.

AgeRangeView

Vista de rango de edad.

Campos
resource_name

string

Es el nombre del recurso de la vista de rango de edad. Los nombres de los recursos de la vista de rango de edad 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 recursos 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 los recursos de los recursos tienen el siguiente formato:

customers/{customer_id}/assets/{asset_id}

type

AssetType

Es el tipo de activo.

final_urls[]

string

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

status

AssetStatus

El estado del recurso.

creation_time

string

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

last_modified_time

string

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

id

int64

El ID del activo.

name

string

Es el nombre opcional del activo.

tracking_url_template

string

Plantilla de URL para crear una URL de seguimiento.

engine_status

AssetEngineStatus

El estado del motor de un recurso.

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

YoutubeVideoAsset

Un activo de video de YouTube

image_asset

ImageAsset

Un recurso de imagen.

text_asset

TextAsset

Un recurso de texto

callout_asset

UnifiedCalloutAsset

Un recurso de texto destacado unificado.

page_feed_asset

UnifiedPageFeedAsset

Un recurso de feed de páginas unificado

mobile_app_asset

MobileAppAsset

Un recurso de aplicación para dispositivos móviles.

call_asset

UnifiedCallAsset

Un recurso de llamada unificado.

call_to_action_asset

CallToActionAsset

Un recurso de llamado a la acción

location_asset

UnifiedLocationAsset

Un recurso de ubicación unificado.

AssetGroup

Un grupo de recursos. AssetGroupAsset se usa para vincular un recurso al grupo de recursos. AssetGroupSignal se usa para asociar un indicador a un grupo de recursos.

Campos
resource_name

string

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

customers/{customer_id}/assetGroups/{asset_group_id}

id

int64

El ID del grupo de recursos.

campaign

string

La campaña con la que está asociado este grupo de recursos. 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 máxima de 128. Debe ser único en una campaña.

final_urls[]

string

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

final_mobile_urls[]

string

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

status

AssetGroupStatus

El estado del grupo de recursos.

path1

string

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

path2

string

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

ad_strength

AdStrength

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

AssetGroupAsset

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

Campos
resource_name

string

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

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

asset_group

string

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

asset

string

El recurso al que está vinculado 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 del vínculo entre un activo y un grupo de recursos.

AssetGroupAssetCombinationData

Datos de combinación de recursos del grupo de recursos

Campos
asset_combination_served_assets[]

AssetUsage

Elementos publicados.

AssetGroupListingGroupFilter

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

Campos
resource_name

string

El nombre del recurso del filtro de grupo de fichas del grupo de recursos. El nombre del recurso 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.

id

int64

El ID de ListingGroupFilter.

type

ListingGroupFilterType

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

vertical

ListingGroupFilterVertical

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

case_value

ListingGroupFilterDimension

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

parent_listing_group_filter

string

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

path

ListingGroupFilterDimensionPath

Es la ruta de dimensiones que define este filtro de grupo de fichas.

AssetGroupSignal

AssetGroupSignal representa un indicador en un grupo de recursos. La existencia de un indicador le indica a la campaña de máximo rendimiento quié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

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

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

AudienceInfo

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

AssetGroupTopCombinationView

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

Campos
resource_name

string

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

asset_group_top_combinations[]

AssetGroupAssetCombinationData

Las combinaciones principales 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

El ID del conjunto de activos.

resource_name

string

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

customers/{customer_id}/assetSets/{asset_set_id}

AssetSetAsset

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

Campos
resource_name

string

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

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

asset_set

string

El conjunto de recursos al que está vinculado este recurso del conjunto de recursos.

asset

string

El recurso al que está vinculado este recurso del conjunto de recursos.

status

AssetSetAssetStatus

El estado del recurso del conjunto de recursos. Solo lectura.

Público

El público es una opción de segmentación eficaz que te permite cruzar diferentes atributos de segmento, 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 máxima de 255.

description

string

Descripción de este público.

BiddingStrategy

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

El tipo de estrategia de ofertas. Para crear una estrategia de ofertas, establece 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 en los clientes administradores, esta moneda se puede establecer en la creación y se establece de forma predeterminada en la moneda del cliente administrador. En el caso de los clientes de publicación, no se puede establecer este campo. Todas las estrategias de un cliente de publicación usan implícitamente la moneda del cliente de publicación. En todos los casos, el campo effective_currency_code muestra 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 utiliza la estrategia de ofertas (código ISO 4217 de tres letras).

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

Las métricas de la estrategia de ofertas se 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. Es el 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.

maximize_conversion_value

MaximizeConversionValue

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

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

target_outrank_share

TargetOutrankShare

Es una estrategia de ofertas que establece ofertas según la fracción objetivo de las subastas en las que el anunciante debería tener un ranking superior a un competidor específico. Este campo ya no está disponible. No se podrá crear una estrategia de ofertas nueva con este campo ni adjuntar estrategias de ofertas con este campo a una campaña. Se permiten las mutaciones a estrategias que ya tienen este esquema propagado.

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

Una campaña.

Campos
resource_name

string

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

customers/{customer_id}/campaigns/{campaign_id}

status

CampaignStatus

El estado de la campaña.

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

serving_status

CampaignServingStatus

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

bidding_strategy_system_status

BiddingStrategySystemStatus

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

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 etiquetas de parámetros personalizados en un tracking_url_template, final_urls o mobile_final_urls.

real_time_bidding_setting

RealTimeBiddingSetting

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

network_settings

NetworkSettings

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

dynamic_search_ads_setting

DynamicSearchAdsSetting

Es 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 para controlar las campañas de Shopping.

geo_target_type_setting

GeoTargetTypeSetting

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

effective_labels[]

string

Los nombres de los recursos de las etiquetas eficaces 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 que se identifica con "bidding_strategy". 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. Por el contrario, 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 de 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

Configuración de optimización selectiva para esta campaña, que incluye un conjunto de acciones de conversión para las que se optimizará esta campaña Esta función solo se aplica a las campañas de aplicaciones que utilizan MULTI_CHANNEL como AdvertisingChannelType y APP_CAMPAIGN o APP_CAMPAIGN_FOR_ENGAGEMENT como AdvertisingChannelSubType.

optimization_goal_setting

OptimizationGoalSetting

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

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

engine_id

string

ID de la campaña en la cuenta de motor externa. Este campo es solo para una cuenta que no es de Google Ads, por ejemplo, Yahoo Japan, Microsoft, Baidu, etc. Para la entidad de Google Ads, usa "campaign.id".

excluded_parent_asset_field_types[]

AssetFieldType

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

create_time

string

La marca de tiempo de la creación de esta campaña. La marca de tiempo se encuentra en la zona horaria del cliente y en el formato “dd-MM-aaaa HH:mm:ss”. create_time dejará de estar disponible en la versión 1. En su lugar, usa creation_time.

creation_time

string

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

last_modified_time

string

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

id

int64

El ID de la campaña.

name

string

El nombre de la campaña.

Este campo es obligatorio y no debe estar vacío cuando se crean campañas nuevas.

No debe contener caracteres nulos (punto de código 0x0), de salto de línea NL (punto de código 0xA) ni de retorno de carro (punto de código 0xD).

tracking_url_template

string

La plantilla de URL para crear una URL de seguimiento.

campaign_budget

string

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 seguimiento paralelo.

url_expansion_opt_out

bool

Indica si se inhabilitó la expansión de URLs a URLs más segmentadas. Si se inhabilitó (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 Google Merchant Center del anunciante. Si se habilita (falso), 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 de BiddingStrategy) o estándar, y estar 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 utiliza la campaña.

manual_cpa

ManualCpa

Estrategia de ofertas de CPA manual estándar. Es una 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

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

manual_cpm

ManualCpm

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

maximize_conversions

MaximizeConversions

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

maximize_conversion_value

MaximizeConversionValue

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

target_cpa

TargetCpa

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

target_impression_share

TargetImpressionShare

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

target_roas

TargetRoas

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

target_spend

TargetSpend

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

percent_cpc

PercentCpc

Estrategia de ofertas de CPC porcentual estándar en la que las ofertas son una fracción del precio anunciado de un 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. Es el nombre de dominio de Internet que representa este parámetro de configuración, por ejemplo, "google.com" o "www.google.com".

language_code

string

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

use_supplied_urls_only

bool

Indica si la campaña utiliza exclusivamente las URLs proporcionadas por el anunciante.

GeoTargetTypeSetting

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

Campos
positive_geo_target_type

PositiveGeoTargetType

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

negative_geo_target_type

NegativeGeoTargetType

Es el parámetro de configuración que se usa para la segmentación geográfica negativa en esta campaña en particular.

NetworkSettings

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

Campos
target_search_network

bool

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

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

La lista de tipos de objetivos de optimización.

SelectiveOptimization

Configuración de optimización selectiva para esta campaña, que incluye un conjunto de acciones de conversión en función de las cuales se optimizará esta campaña. Esta función solo se aplica a las campañas de aplicaciones que utilizan MULTI_CHANNEL como AdvertisingChannelType y APP_CAMPAIGN o APP_CAMPAIGN_FOR_ENGAGEMENT como AdvertisingChannelSubType.

Campos
conversion_actions[]

string

Es el conjunto seleccionado de nombres de recursos para las acciones de conversión que se utilizarán 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 puede promocionar la campaña y cómo esta interactúa con otras campañas de Shopping.

Campos
feed_label

string

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

use_vehicle_inventory

bool

Indica si deseas segmentar anuncios para 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, con valores entre 0 y 2, inclusive. Este campo es opcional para las campañas de Shopping inteligentes, pero debe ser igual a 3 si se establece.

enable_local

bool

Si deseas incluir productos locales.

TrackingSetting

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

Campos
tracking_url

string

Es la URL que se 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 los 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 el vínculo entre una campaña y un conjunto de recursos. Cuando agregas un CampaignAssetSet, se vincula un conjunto de recursos con una campaña.

Campos
resource_name

string

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

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

campaign

string

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

asset_set

string

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

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

Campos
resource_name

string

El nombre del recurso de la vista de público de la campaña. Los nombres de los recursos de la vista del 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 los recursos del presupuesto de la campaña tienen el siguiente formato:

customers/{customer_id}/campaignBudgets/{campaign_budget_id}

delivery_method

BudgetDeliveryMethod

El método de publicación que determina el ritmo al que se invierte el presupuesto de la campaña.

El valor predeterminado es STANDARD si no se especifica en una operación de creación.

period

BudgetPeriod

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

amount_micros

int64

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

CampaignCriterion

Un criterio de campaña.

Campos
resource_name

string

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

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

display_name

string

El nombre visible del criterio.

Este campo se ignora para las 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 modificación.

bid_modifier

float

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

negative

bool

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

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

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

keyword

KeywordInfo

Palabra clave.

location

LocationInfo

Ubicación.

device

DeviceInfo

Dispositivo.

age_range

AgeRangeInfo

Rango de edad.

gender

GenderInfo

Género

user_list

UserListInfo

Lista de usuarios.

language

LanguageInfo

de HashiCorp.

webpage

WebpageInfo

Página web.

location_group

LocationGroupInfo

Grupo por ubicación

CampaignEffectiveLabel

Representa una relación entre una campaña y una etiqueta eficaz. Una etiqueta efectiva es una etiqueta heredada o asignada directamente a esta campaña.

Campos
resource_name

string

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

campaign

string

La campaña a la que se adjunta la etiqueta efectiva.

label

string

La etiqueta eficaz asignada a la campaña.

owner_customer_id

int64

El ID del cliente al que pertenece 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 los recursos de la etiqueta de la campaña tienen el siguiente formato: customers/{customer_id}/campaignLabels/{campaign_id}~{label_id}.

campaign

string

La 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 datos del carrito

Campos
resource_name

string

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

Conversión

Una conversión.

Campos
resource_name

string

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

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

id

int64

El ID de la conversión.

criterion_id

int64

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

merchant_id

int64

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

ad_id

int64

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

click_id

string

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

visit_id

int64

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

advertiser_conversion_id

string

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

product_id

string

El ID del producto en el que se hizo clic.

product_channel

ProductChannel

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

product_language_code

string

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

product_store_id

string

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

product_country_code

string

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

attribution_type

AttributionType

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

conversion_date_time

string

La marca de tiempo del evento de conversión.

conversion_last_modified_date_time

string

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

conversion_visit_date_time

string

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

conversion_quantity

int64

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

conversion_revenue_micros

int64

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

floodlight_original_revenue

int64

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

floodlight_order_id

string

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

status

ConversionStatus

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

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 los recursos de las acciones de conversión tienen el siguiente formato:

customers/{customer_id}/conversionActions/{conversion_action_id}

creation_time

string

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

status

ConversionActionStatus

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

type

ConversionActionType

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

category

ConversionActionCategory

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

value_settings

ValueSettings

Configuración relacionada con el valor de los eventos de conversión asociados con esta acción de conversión.

attribution_model_settings

AttributionModelSettings

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

floodlight_settings

FloodlightSettings

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

id

int64

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 es apta para establecer ofertas en todas las campañas, independientemente de su objetivo de conversión de clientes o 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 un objetivo de conversión personalizado configurado con una acción de conversión primary_for_goal = false, esa acción de conversión aún puede recibir ofertas. De forma predeterminada, primary_for_goal será verdadero si no se establece. En la versión 9, primary_for_goal solo se puede establecer en falso después de la creación a través de una operación "update" porque 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 debe incluirse en la métrica "Conversiones".

click_through_lookback_window_days

int64

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

app_id

string

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

AttributionModelSettings

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

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

Configuración relacionada con el valor de los eventos de conversión asociados con esta acción de conversión.

Campos
default_value

double

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

default_currency_code

string

Es el código de moneda que se debe usar cuando los eventos de conversión de esta acción de conversión se envían con un código de moneda no válido o faltante, o cuando esta acción de conversión está configurada para 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

Una variable personalizada de conversión. Consulta "Información sobre 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 debe constar de una letra "u" seguida 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 del evento de conversión.

owner_customer

string

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

family

ConversionCustomVariableFamily

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

cardinality

ConversionCustomVariableCardinality

Cardinalidad de la variable personalizada de conversión.

floodlight_conversion_custom_variable_info

FloodlightConversionCustomVariableInfo

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

custom_column_ids[]

int64

Los IDs de las columnas personalizadas que usan esta variable personalizada de conversión.

FloodlightConversionCustomVariableInfo

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

Campos
floodlight_variable_type

FloodlightVariableType

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

floodlight_variable_data_type

FloodlightVariableDataType

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

ConversionTrackingSetting

Es un conjunto 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

Si el cliente aceptó las Condiciones sobre los datos del cliente Si utilizas el seguimiento de conversiones de múltiples cuentas, este valor se hereda del administrador. Este campo es de solo lectura. Para obtener más información, consulta https://support.google.com/adspolicy/answer/7475709.

conversion_tracking_status

ConversionTrackingStatus

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

enhanced_conversions_for_leads_enabled

bool

Si el cliente aceptó 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

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

google_ads_cross_account_conversion_tracking_id

int64

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

cross_account_conversion_tracking_id

int64

El ID del 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

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 los recursos de las columnas personalizadas tienen el siguiente formato:

customers/{customer_id}/customColumns/{custom_column_id}

id

int64

Es el ID de la columna personalizada.

name

string

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

description

string

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 {"metrics.clicks", "metrics.impressions"}.

render_type

CustomColumnRenderType

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 los recursos del cliente tienen el siguiente formato:

customers/{customer_id}

conversion_tracking_setting

ConversionTrackingSetting

Configuración del seguimiento de conversiones de un cliente

account_type

AccountType

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

double_click_campaign_manager_setting

DoubleClickCampaignManagerSetting

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

account_status

AccountStatus

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

last_modified_time

string

La fecha y hora en la que se modificó este cliente por última vez. La fecha y hora se encuentran en la zona horaria del cliente y en el formato “dd-MM-aaaa HH:mm:ss.ssssss”.

engine_id

string

ID de la cuenta de la cuenta de motor externa.

status

CustomerStatus

El estado del cliente.

creation_time

string

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

id

int64

El ID del cliente.

descriptive_name

string

Nombre descriptivo no único y opcional del cliente.

currency_code

string

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

time_zone

string

El ID de la zona horaria local del cliente.

tracking_url_template

string

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

final_url_suffix

string

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

auto_tagging_enabled

bool

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

manager

bool

Si el cliente es un administrador

CustomerAsset

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

Campos
resource_name

string

Es el nombre del recurso del activo del cliente. Los nombres de los recursos de 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. Cuando agregas un CustomerAssetSet, se 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 los recursos de los activos del conjunto de activos tienen el siguiente formato:

customers/{customer_id}/customerAssetSets/{asset_set_id}

asset_set

string

El conjunto de recursos que está vinculado al cliente.

customer

string

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

status

AssetSetLinkStatus

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

CustomerClient

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

Campos
resource_name

string

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

applied_labels[]

string

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

customers/{customer_id}/labels/{label_id}

status

CustomerStatus

Es el estado del cliente del cliente. Solo lectura.

client_customer

string

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

hidden

bool

Especifica si se trata de una cuenta oculta.

Solo lectura.

level

int64

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

time_zone

string

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

test_account

bool

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

manager

bool

Identifica si el cliente es un administrador. Solo lectura.

descriptive_name

string

Es un nombre descriptivo para el cliente. Solo lectura.

currency_code

string

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

id

int64

El ID del cliente del cliente. Solo lectura.

DoubleClickCampaignManagerSetting

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

Campos
advertiser_id

int64

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

network_id

int64

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

time_zone

string

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

DynamicSearchAdsSearchTermView

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

Campos
resource_name

string

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

Este campo es de solo lectura.

GenderView

Una vista de género. El recurso gender_view refleja el estado de publicación efectivo, en lugar de los criterios que se agregaron. Un grupo de anuncios sin criterios de género se muestra de forma predeterminada 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

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 constantes de segmentaciones geográficas tienen el siguiente formato:

geoTargetConstants/{geo_target_constant_id}

status

GeoTargetConstantStatus

Estado constante de la segmentación geográfica.

id

int64

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

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

canonical_name

string

El nombre en inglés completamente calificado, que consiste en el nombre del destino y el de su país y superior.

parent_geo_target

string

El nombre del recurso de la constante superior de orientación geográfica. Los nombres de recursos de constante 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

Una etiqueta.

Campos
resource_name

string

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

status

LabelStatus

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 durante la creación de una etiqueta nueva.

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

LanguageConstant

Un idioma

Campos
resource_name

string

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

languageConstants/{criterion_id}

id

int64

Es el ID de la constante de idioma.

code

string

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

name

string

Es el nombre completo del idioma en inglés, por ejemplo, "Inglés (Estados Unidos)", "Español", etcétera.

targetable

bool

Indica si el idioma es apto para la segmentación.

ListingGroupFilterDimension

Dimensiones de ficha para el filtro de grupo de fichas y elementos 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 un 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 están en el nivel 1, sus hijos, 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 de productos.

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

ProductBrand

Es la marca del producto.

Campos
value

string

Es el valor de cadena de la marca del producto.

ProductChannel

Localidad de la oferta de un producto.

Campos
channel

ListingGroupFilterProductChannel

Es el valor de la localidad.

ProductCondition

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

Campos
condition

ListingGroupFilterProductCondition

Valor de la condición.

ProductCustomAttribute

Atributo personalizado de la oferta de un producto.

Campos
index

ListingGroupFilterCustomAttributeIndex

Indica el índice del atributo personalizado.

value

string

Es el valor de cadena del atributo personalizado del producto.

ProductItemId

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

La ruta de definición de dimensiones que definen un filtro de grupo de fichas.

Campos
dimensions[]

ListingGroupFilterDimension

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

LocationView

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

Campos
resource_name

string

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

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

ProductBiddingCategoryConstant

Una categoría de ofertas de productos.

Campos
resource_name

string

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

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

level

ProductBiddingCategoryLevel

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

status

ProductBiddingCategoryStatus

Es el estado de la categoría de ofertas 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

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 ofertas del producto superior.

language_code

string

Código de idioma de la categoría de ofertas del producto.

localized_name

string

Es el valor de la categoría de ofertas del producto localizado según language_code.

ProductGroupView

Una vista de grupo de productos

Campos
resource_name

string

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

La categoría del artefacto.

selectable_with[]

string

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

attribute_resources[]

string

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

Este campo solo se establece para 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 artefactos cuya categoría es RESOURCE.

segments[]

string

En este campo, se enumeran los nombres de todos los artefactos, ya sea un segmento o algún otro recurso, que segmentan las métricas cuando se incluyen en las búsquedas y cuando se usa el artefacto descrito en la cláusula FROM. Solo se configura 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 establece para los artefactos de la categoría SEGMENT o ATTRIBUTE.

data_type

SearchAds360FieldDataType

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

name

string

Es el nombre del artefacto.

selectable

bool

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

filterable

bool

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

sortable

bool

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

type_url

string

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

is_repeated

bool

Indica si el artefacto del campo está repetido.

ShoppingPerformanceView

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

Campos
resource_name

string

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

UserList

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

Campos
resource_name

string

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

customers/{customer_id}/userLists/{user_list_id}

type

UserListType

Es el tipo de esta lista.

Este campo es de solo lectura.

id

int64

Es el ID de la lista de usuarios.

name

string

Es el nombre de esta lista de usuarios. Según access_reason, es posible que el nombre de la lista de usuarios no sea único (por ejemplo, si access_reason=SHARED).

UserLocationView

Vista de la ubicación del usuario.

La vista Ubicación del usuario incluye todas las métricas agregadas a nivel del país, una fila por país. Genera informes sobre las métricas en la ubicación física real del usuario, según la ubicación de segmentación o no. Si se usan otros campos de segmentación, 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 del país.

targeting_location

bool

Indica si se orientó la ubicación 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

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

asset_field_type

AssetFieldType

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

WebpageView

Una vista de página web.

Campos
resource_name

string

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

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