- Representación JSON
- AdGroup
- AdGroupStatus
- AdGroupType
- AdGroupAdRotationMode
- AdGroupEngineStatus
- TargetingSetting
- TargetRestriction
- TargetingDimension
- AdGroupAd
- AdGroupAdStatus
- Anuncio
- AdType
- SearchAds360TextAdInfo
- SearchAds360ExpandedTextAdInfo
- SearchAds360ResponsiveSearchAdInfo
- AdTextAsset
- SearchAds360ProductAdInfo
- SearchAds360ExpandedDynamicSearchAdInfo
- AdGroupAdEngineStatus
- AdGroupAdLabel
- AdGroupAsset
- AssetLinkStatus
- AdGroupAssetSet
- AssetSetLinkStatus
- AdGroupAudienceView
- AdGroupBidModifier
- DeviceInfo
- Dispositivo
- AdGroupCriterion
- AdGroupCriterionStatus
- QualityInfo
- CriterionType
- PositionEstimates
- AdGroupCriterionEngineStatus
- KeywordInfo
- KeywordMatchType
- ListingGroupInfo
- ListingGroupType
- AgeRangeInfo
- AgeRangeType
- GenderInfo
- GenderType
- UserListInfo
- WebpageInfo
- WebpageConditionInfo
- WebpageConditionOperand
- WebpageConditionOperator
- LocationInfo
- AdGroupCriterionLabel
- AdGroupLabel
- AgeRangeView
- Recurso
- AssetType
- AssetStatus
- AssetEngineStatus
- YoutubeVideoAsset
- ImageAsset
- MimeType
- ImageDimension
- TextAsset
- UnifiedCalloutAsset
- AdScheduleInfo
- MinuteOfHour
- DayOfWeek
- UnifiedSitelinkAsset
- UnifiedPageFeedAsset
- MobileAppAsset
- MobileAppVendor
- UnifiedCallAsset
- CallConversionReportingState
- CallToActionAsset
- CallToActionType
- UnifiedLocationAsset
- BusinessProfileLocation
- LocationOwnershipType
- AssetGroupAsset
- AssetFieldType
- AssetGroupSignal
- AudienceInfo
- AssetGroupListingGroupFilter
- ListingGroupFilterType
- ListingGroupFilterVertical
- ListingGroupFilterDimension
- ProductBiddingCategory
- ListingGroupFilterBiddingCategoryLevel
- ProductBrand
- ProductChannel
- ListingGroupFilterProductChannel
- ProductCondition
- ListingGroupFilterProductCondition
- ProductCustomAttribute
- ListingGroupFilterCustomAttributeIndex
- ProductItemId
- ProductType
- ListingGroupFilterProductTypeLevel
- ListingGroupFilterDimensionPath
- AssetGroupTopCombinationView
- AssetGroupAssetCombinationData
- AssetUsage
- ServedAssetFieldType
- AssetGroup
- AssetGroupStatus
- AdStrength
- AssetSetAsset
- AssetSetAssetStatus
- AssetSet
- BiddingStrategy
- BiddingStrategyStatus
- BiddingStrategyType
- EnhancedCpc
- MaximizeConversionValue
- MaximizeConversions
- TargetCpa
- TargetImpressionShare
- TargetImpressionShareLocation
- TargetOutrankShare
- TargetRoas
- TargetSpend
- CampaignBudget
- BudgetDeliveryMethod
- BudgetPeriod
- Campaña
- CampaignStatus
- CampaignServingStatus
- BiddingStrategySystemStatus
- AdServingOptimizationStatus
- AdvertisingChannelType
- AdvertisingChannelSubType
- CustomParameter
- RealTimeBiddingSetting
- NetworkSettings
- DynamicSearchAdsSetting
- ShoppingSetting
- GeoTargetTypeSetting
- PositiveGeoTargetType
- NegativeGeoTargetType
- FrequencyCapEntry
- SelectiveOptimization
- OptimizationGoalSetting
- OptimizationGoalType
- TrackingSetting
- ManualCpa
- ManualCpc
- ManualCpm
- PercentCpc
- TargetCpm
- CampaignAsset
- CampaignAssetSet
- CampaignAudienceView
- CampaignCriterion
- CampaignCriterionStatus
- LanguageInfo
- LocationGroupInfo
- LocationGroupRadiusUnits
- CampaignLabel
- CartDataSalesView
- Público
- ConversionAction
- ConversionActionStatus
- ConversionActionType
- ConversionActionCategory
- ValueSettings
- AttributionModelSettings
- AttributionModel
- DataDrivenModelStatus
- FloodlightSettings
- ConversionCustomVariable
- ConversionCustomVariableStatus
- ConversionCustomVariableFamily
- ConversionCustomVariableCardinality
- FloodlightConversionCustomVariableInfo
- FloodlightVariableType
- FloodlightVariableDataType
- Cliente
- ConversionTrackingSetting
- ConversionTrackingStatus
- AccountType
- DoubleClickCampaignManagerSetting
- AccountStatus
- CustomerStatus
- CustomerAsset
- CustomerAssetSet
- AccessibleBiddingStrategy
- MaximizeConversionValue
- MaximizeConversions
- TargetCpa
- TargetImpressionShare
- TargetRoas
- TargetSpend
- CustomerManagerLink
- ManagerLinkStatus
- CustomerClient
- DynamicSearchAdsSearchTermView
- GenderView
- GeoTargetConstant
- GeoTargetConstantStatus
- KeywordView
- Etiqueta
- LabelStatus
- TextLabel
- LanguageConstant
- LocationView
- ProductBiddingCategoryConstant
- ProductBiddingCategoryLevel
- ProductBiddingCategoryStatus
- ProductGroupView
- ShoppingPerformanceView
- UserList
- UserListType
- WebpageView
- Visitar
- ProductChannel
- Conversión
- AttributionType
- ConversionStatus
- Métricas
- Value
- QualityScoreBucket
- InteractionEventType
- Segmentos
- AdNetworkType
- Palabra clave
- ProductChannelExclusivity
- ProductCondition
- AssetInteractionTarget
Una fila que se muestra en la consulta.
Representación JSON |
---|
{ "adGroup": { object ( |
Campos | |
---|---|
adGroup |
Indica el grupo de anuncios al que se hace referencia en la consulta. |
adGroupAd |
Es el anuncio al que se hace referencia en la consulta. |
adGroupAdLabel |
Es la etiqueta de anuncio del grupo de anuncios a la que se hace referencia en la consulta. |
adGroupAsset |
El recurso del grupo de anuncios al que se hace referencia en la búsqueda. |
adGroupAssetSet |
Es el conjunto de recursos del grupo de anuncios al que se hace referencia en la búsqueda. |
adGroupAudienceView |
La vista de público del grupo de anuncios a la que se hace referencia en la consulta. |
adGroupBidModifier |
Es el modificador de ofertas al que se hace referencia en la consulta. |
adGroupCriterion |
El criterio al que se hace referencia en la consulta. |
adGroupCriterionLabel |
Es la etiqueta de criterio del grupo de anuncios a la que se hace referencia en la consulta. |
adGroupLabel |
Es la etiqueta del grupo de anuncios a la que se hace referencia en la consulta. |
ageRangeView |
La vista de rango de edad a la que se hace referencia en la consulta. |
asset |
El recurso al que se hace referencia en la consulta. |
assetGroupAsset |
El recurso del grupo de recursos al que se hace referencia en la consulta. |
assetGroupSignal |
El indicador del grupo de recursos al que se hace referencia en la consulta. |
assetGroupListingGroupFilter |
El filtro de grupo de fichas del grupo de recursos al que se hace referencia en la consulta. |
assetGroupTopCombinationView |
La vista de combinación principal del grupo de recursos a la que se hace referencia en la consulta. |
assetGroup |
Es el grupo de recursos al que se hace referencia en la consulta. |
assetSetAsset |
El conjunto de recursos al que se hace referencia en la consulta. |
assetSet |
El conjunto de recursos al que se hace referencia en la consulta. |
biddingStrategy |
Indica la estrategia de ofertas a la que se hace referencia en la búsqueda. |
campaignBudget |
El presupuesto de la campaña al que se hace referencia en la búsqueda |
campaign |
La campaña a la que se hace referencia en la búsqueda. |
campaignAsset |
El recurso de campaña al que se hace referencia en la búsqueda. |
campaignAssetSet |
Es el conjunto de recursos de la campaña al que se hace referencia en la búsqueda. |
campaignAudienceView |
Es la vista de público de la campaña a la que se hace referencia en la búsqueda. |
campaignCriterion |
El criterio de campaña al que se hace referencia en la búsqueda. |
campaignLabel |
Es la etiqueta de la campaña a la que se hace referencia en la búsqueda. |
cartDataSalesView |
La vista de ventas con datos del carrito a la que se hace referencia en la consulta. |
audience |
El público al que se hace referencia en la consulta. |
conversionAction |
La acción de conversión a la que se hace referencia en la consulta. |
conversionCustomVariable |
Es la variable personalizada de conversión a la que se hace referencia en la consulta. |
customer |
El cliente al que se hace referencia en la consulta. |
customerAsset |
El recurso del cliente al que se hace referencia en la consulta. |
customerAssetSet |
El conjunto de recursos del cliente al que se hace referencia en la consulta. |
accessibleBiddingStrategy |
La estrategia de oferta accesible a la que se hace referencia en la consulta. |
customerManagerLink |
El CustomerManagerLink al que se hace referencia en la consulta. |
customerClient |
El CustomerClient al que se hace referencia en la consulta. |
dynamicSearchAdsSearchTermView |
La vista de los términos de búsqueda de los anuncios dinámicos de búsqueda a la que se hace referencia en la consulta |
genderView |
La vista de género a la que se hace referencia en la consulta. |
geoTargetConstant |
La constante de segmentación geográfica a la que se hace referencia en la consulta. |
keywordView |
La vista de palabras clave a la que se hace referencia en la consulta. |
label |
La etiqueta a la que se hace referencia en la consulta. |
languageConstant |
La constante de lenguaje a la que se hace referencia en la consulta. |
locationView |
La vista de la ubicación a la que se hace referencia en la consulta. |
productBiddingCategoryConstant |
La categoría de ofertas de productos a la que se hace referencia en la consulta. |
productGroupView |
Es la vista del grupo de productos a la que se hace referencia en la consulta. |
shoppingPerformanceView |
La vista de rendimiento de Shopping a la que se hace referencia en la consulta. |
userList |
La lista de usuarios a la que se hace referencia en la consulta. |
webpageView |
Es la vista de la página web a la que se hace referencia en la consulta. |
visit |
La visita a nivel del evento a la que se hace referencia en la consulta. |
conversion |
La conversión a nivel del evento a la que se hace referencia en la consulta. |
metrics |
Las métricas. |
segments |
Los segmentos |
customColumns[] |
Las columnas personalizadas |
Grupo de anuncios
Un grupo de anuncios
Representación JSON |
---|
{ "resourceName": string, "status": enum ( |
Campos | |
---|---|
resourceName |
El nombre del recurso del grupo de anuncios. Los nombres de recursos del grupo de anuncios tienen el siguiente formato:
|
status |
El estado del grupo de anuncios. |
type |
Indica el tipo de grupo de anuncios. |
adRotationMode |
Es el modo de rotación de anuncios del grupo de anuncios. |
creationTime |
Indica la marca de tiempo cuando se creó este grupo de anuncios. La marca de tiempo se encuentra en la zona horaria del cliente y en el formato “dd-MM-aaaa HH:mm:ss”. |
targetingSetting |
Parámetro de configuración de la segmentación para funciones relacionadas. |
labels[] |
Los nombres de recursos de las etiquetas adjuntas a este grupo de anuncios. |
engineId |
ID del grupo de anuncios en la cuenta de motor externo. Este campo es solo para las cuentas que no son de Google Ads; por ejemplo, Yahoo Japan, Microsoft, Baidu, etc. Para la entidad de Google Ads, usa "adGroup.id" en su lugar. |
startDate |
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 |
endDate |
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 |
languageCode |
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 |
lastModifiedTime |
La fecha y hora de la última modificación de este grupo de anuncios. La fecha y hora se encuentran en la zona horaria del cliente y en el formato “dd-MM-aaaa HH:mm:ss.ssssss”. |
id |
El ID del grupo de anuncios. |
name |
El nombre del grupo de anuncios. Este campo es obligatorio y no debe estar vacío cuando se crean grupos de anuncios nuevos. Debe contener menos de 255 caracteres de ancho completo UTF-8. No debe contener caracteres nulos (punto de código 0x0), de salto de línea NL (punto de código 0xA) ni de retorno de carro (punto de código 0xD). |
cpcBidMicros |
La oferta de CPC (costo por clic) máxima. |
engineStatus |
El estado del motor para el grupo de anuncios. |
AdGroupStatus
Son los posibles estados de un grupo de anuncios.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especificó el estado. |
UNKNOWN |
En esta versión, se desconoce el valor recibido. Este es un valor de solo respuesta. |
ENABLED |
El grupo de anuncios está habilitado. |
PAUSED |
El grupo de anuncios está detenido. |
REMOVED |
Se quitó el grupo de anuncios. |
AdGroupType
Es una enumeración que enumera los tipos posibles de un grupo de anuncios.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especificó el tipo. |
UNKNOWN |
En esta versión, se desconoce el valor recibido. Este es un valor de solo respuesta. |
SEARCH_STANDARD |
Es el tipo de grupo de anuncios predeterminado para las campañas de Búsqueda. |
DISPLAY_STANDARD |
Es el tipo de grupo de anuncios predeterminado para las campañas de Display. |
SHOPPING_PRODUCT_ADS |
Es el tipo de grupo de anuncios para las campañas de Shopping que publican anuncios de productos estándares. |
SHOPPING_SHOWCASE_ADS |
Es el tipo de grupo de anuncios que se limita a publicar anuncios de catálogo de productos o de comercios en los resultados de Shopping. |
HOTEL_ADS |
Es el tipo de grupo de anuncios predeterminado para las campañas de hoteles. |
SHOPPING_SMART_ADS |
Indica el tipo de grupo de anuncios en las campañas de Shopping inteligentes. |
VIDEO_BUMPER |
Anuncios de video in-stream cortos que no se pueden omitir. |
VIDEO_TRUE_VIEW_IN_STREAM |
Anuncios de video in-stream TrueView (que se pueden omitir) |
VIDEO_TRUE_VIEW_IN_DISPLAY |
Anuncios de video TrueView en display |
VIDEO_NON_SKIPPABLE_IN_STREAM |
Anuncios de video in-stream que no se pueden omitir. |
VIDEO_OUTSTREAM |
Anuncios de video outstream. |
SEARCH_DYNAMIC_ADS |
Tipo de grupo de anuncios para los grupos de anuncios dinámicos de búsqueda. |
SHOPPING_COMPARISON_LISTING_ADS |
Es el tipo para los grupos de anuncios de las campañas de comparación de productos. |
PROMOTED_HOTEL_ADS |
Es el tipo de grupo de anuncios para los grupos de anuncios de hoteles promocionados. |
VIDEO_RESPONSIVE |
Grupos de anuncios responsivos de video |
VIDEO_EFFICIENT_REACH |
Grupos de anuncios de alcance eficiente de video |
SMART_CAMPAIGN_ADS |
Tipo de grupo de anuncios para las campañas inteligentes. |
TRAVEL_ADS |
Tipo de grupo de anuncios para campañas de viajes. |
AdGroupAdRotationMode
Son los posibles modos de rotación de anuncios de un grupo de anuncios.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especificó el modo de rotación de anuncios. |
UNKNOWN |
En esta versión, se desconoce el valor recibido. Este es un valor de solo respuesta. |
OPTIMIZE |
Optimizar los anuncios del grupo de anuncios en función de los clics o las conversiones |
ROTATE_FOREVER |
Rotar de manera uniforme siempre. |
AdGroupEngineStatus
Estado del motor del grupo de anuncios.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
Se usa solo para el valor que se muestra. Representa el valor desconocido en esta versión. |
AD_GROUP_ELIGIBLE |
Obsoleta. No lo utilices. |
AD_GROUP_EXPIRED |
No se están publicando anuncios para este grupo de anuncios porque la fecha de finalización ya pasó. |
AD_GROUP_REMOVED |
Se eliminó el grupo de anuncios. |
AD_GROUP_DRAFT |
No se está publicando ningún anuncio para este grupo de anuncios porque el grupo de anuncios asociado aún está en forma de borrador. |
AD_GROUP_PAUSED |
Se detuvo el grupo de anuncios. |
AD_GROUP_SERVING |
El grupo de anuncios está activo y publica anuncios actualmente. |
AD_GROUP_SUBMITTED |
Se envió el grupo de anuncios (estado heredado de Microsoft Bing Ads). |
CAMPAIGN_PAUSED |
No se están publicando anuncios para este grupo de anuncios porque la campaña se detuvo. |
ACCOUNT_PAUSED |
No se están publicando anuncios para este grupo de anuncios porque la cuenta se detuvo. |
TargetingSetting
Configuración de las funciones relacionadas con la segmentación a nivel de la campaña y del grupo de anuncios. Para obtener más información sobre la configuración de la segmentación, visita https://support.google.com/google-ads/answer/7365594
Representación JSON |
---|
{
"targetRestrictions": [
{
object ( |
Campos | |
---|---|
targetRestrictions[] |
La configuración de dimensión por segmentación para restringir el alcance de tu campaña o grupo de anuncios. |
TargetRestriction
Es la lista de parámetros de configuración de la segmentación por dimensión de segmentación.
Representación JSON |
---|
{
"targetingDimension": enum ( |
Campos | |
---|---|
targetingDimension |
Es la dimensión de segmentación a la que se aplica esta configuración. |
bidOnly |
Indica si se deben restringir sus anuncios para que se muestren solo para los criterios que seleccionó para esta segmentaciónDimensión o si se deben segmentar para todos los valores de esta segmentaciónDimension y mostrar anuncios según su segmentación en otras TargetingDimensions. Un valor de |
TargetingDimension
Es una enumeración que describe las posibles dimensiones de segmentación.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
Se usa solo para el valor que se muestra. Representa el valor desconocido en esta versión. |
KEYWORD |
Criterios de palabras clave, por ejemplo, "cruceros por mars". KEYWORD puede usarse como una dimensión de oferta personalizada. Las palabras clave siempre son una dimensión de segmentación, por lo que es posible que no se establezcan como la segmentación para "TODAS". con TargetRestriction. |
AUDIENCE |
Criterios de público, que incluyen lista de usuarios, intereses del usuario, público afín personalizado y público en el mercado personalizado. |
TOPIC |
Criterios de temas para la segmentación de categorías de contenido, por ejemplo, "category::Animales>Mascotas" Se usa para la segmentación de Display y video. |
GENDER |
Criterios de orientación por género. |
AGE_RANGE |
Criterios para orientar los anuncios a rangos de edad. |
PLACEMENT |
Criterios de posición, que incluyen sitios web como "www.flores4sale.com", así como aplicaciones para dispositivos móviles, categorías de aplicaciones para dispositivos móviles, videos y canales de YouTube. |
PARENTAL_STATUS |
Criterios de la segmentación por estado parental. |
INCOME_RANGE |
Criterios de segmentación por rango de ingresos. |
AdGroupAd
Un anuncio del grupo de anuncios.
Representación JSON |
---|
{ "resourceName": string, "status": enum ( |
Campos | |
---|---|
resourceName |
Es el nombre del recurso del anuncio. Los nombres de los recursos de anuncios del grupo de anuncios tienen el siguiente formato:
|
status |
El estado del anuncio. |
ad |
El anuncio |
creationTime |
Indica la marca de tiempo de la creación de este adGroupAd. La fecha y hora se encuentran en la zona horaria del cliente y en el formato “dd-MM-aaaa HH:mm:ss.ssssss”. |
labels[] |
Los nombres de recursos de las etiquetas adjuntas a este anuncio de grupo de anuncios. |
engineId |
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 "adGroupAd.ad.id" en su lugar. |
engineStatus |
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. |
lastModifiedTime |
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”. |
AdGroupAdStatus
Indica los posibles estados de un anuncio de grupo de anuncios.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especificó ningún valor. |
UNKNOWN |
En esta versión, se desconoce el valor recibido. Este es un valor de solo respuesta. |
ENABLED |
El anuncio del grupo de anuncios está habilitado. |
PAUSED |
El anuncio del grupo de anuncios está detenido. |
REMOVED |
Se quitó el anuncio del grupo de anuncios. |
Anuncio
Un anuncio
Representación JSON |
---|
{ "resourceName": string, "finalUrls": [ string ], "type": enum ( |
Campos | |
---|---|
resourceName |
Es el nombre del recurso del anuncio. Los nombres de los recursos de anuncios tienen el siguiente formato:
|
finalUrls[] |
La lista de posibles URLs finales después de todos los redireccionamientos entre dominios del anuncio. |
type |
El tipo de anuncio. |
id |
El ID del anuncio. |
displayUrl |
La URL que aparece en la descripción del anuncio para algunos formatos de anuncios. |
name |
El nombre del anuncio. Esto solo se utiliza para identificar el anuncio. No es necesario que sea único y no afecta el anuncio publicado. Por el momento, el campo de nombre solo es compatible con DisplayUploadAd, ImageAd, ShoppingComparisonListingAd y VideoAd. |
Campo de unión ad_data . Son los detalles pertinentes al tipo de anuncio. Se debe establecer exactamente un valor. Las direcciones (ad_data ) solo pueden ser una de las siguientes opciones: |
|
textAd |
Son los detalles relacionados con un anuncio de texto. |
expandedTextAd |
Son los detalles relacionados con un anuncio de texto expandido. |
responsiveSearchAd |
Detalles relacionados con un anuncio de búsqueda responsivo. |
productAd |
Detalles relacionados con un anuncio de producto. |
expandedDynamicSearchAd |
Son los detalles que pertenecen a un anuncio dinámico de búsqueda expandido. |
AdType
Indica los tipos posibles de un anuncio.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especificó ningún valor. |
UNKNOWN |
En esta versión, se desconoce el valor recibido. Este es un valor de solo respuesta. |
TEXT_AD |
Es un anuncio de texto. |
EXPANDED_TEXT_AD |
Es un anuncio de texto expandido. |
CALL_ONLY_AD |
Es un anuncio de solo llamada. |
EXPANDED_DYNAMIC_SEARCH_AD |
El anuncio es un anuncio dinámico de búsqueda expandido. |
HOTEL_AD |
El anuncio es un anuncio de hotel. |
SHOPPING_SMART_AD |
Es un anuncio de Shopping inteligente. |
SHOPPING_PRODUCT_AD |
El anuncio es un anuncio de Shopping estándar. |
VIDEO_AD |
El anuncio es un anuncio de video. |
GMAIL_AD |
Este anuncio es un anuncio de Gmail. |
IMAGE_AD |
Este anuncio es un anuncio con imagen. |
RESPONSIVE_SEARCH_AD |
El anuncio es un anuncio de búsqueda responsivo. |
LEGACY_RESPONSIVE_DISPLAY_AD |
El anuncio es un anuncio de display responsivo heredado. |
APP_AD |
Es un anuncio de aplicación. |
LEGACY_APP_INSTALL_AD |
El anuncio es un anuncio de instalación de aplicaciones heredado. |
RESPONSIVE_DISPLAY_AD |
El anuncio es un anuncio de display responsivo. |
LOCAL_AD |
El anuncio es local. |
HTML5_UPLOAD_AD |
El anuncio es un anuncio gráfico subido con el tipo de producto HTML5_UPLOAD_AD. |
DYNAMIC_HTML5_AD |
El anuncio es un anuncio gráfico que contiene uno de los tipos de producto DYNAMIC_HTML5_*. |
APP_ENGAGEMENT_AD |
Es un anuncio de uso de la aplicación. |
SHOPPING_COMPARISON_LISTING_AD |
Es un anuncio de comparación de productos. |
VIDEO_BUMPER_AD |
Anuncio bumper de video |
VIDEO_NON_SKIPPABLE_IN_STREAM_AD |
Es un anuncio de video in-stream que no se puede omitir. |
VIDEO_OUTSTREAM_AD |
Es un anuncio de video outstream. |
VIDEO_TRUEVIEW_DISCOVERY_AD |
Anuncio de video TrueView en display |
VIDEO_TRUEVIEW_IN_STREAM_AD |
Anuncio de video TrueView in-stream |
VIDEO_RESPONSIVE_AD |
Es un anuncio responsivo de video. |
SMART_CAMPAIGN_AD |
Anuncio de la campaña inteligente. |
APP_PRE_REGISTRATION_AD |
Anuncio universal de registro previo de la aplicación. |
DISCOVERY_MULTI_ASSET_AD |
Anuncio discovery con varios elementos |
DISCOVERY_CAROUSEL_AD |
Anuncio de carrusel discovery. |
TRAVEL_AD |
Anuncio de viajes. |
DISCOVERY_VIDEO_RESPONSIVE_AD |
Anuncio responsivo de video discovery. |
MULTIMEDIA_AD |
Anuncio multimedia |
SearchAds360TextAdInfo
Anuncio de texto de Search Ads 360
Representación JSON |
---|
{ "headline": string, "description1": string, "description2": string, "displayUrl": string, "displayMobileUrl": string, "adTrackingId": string } |
Campos | |
---|---|
headline |
Es el título del anuncio. |
description1 |
La primera línea de la descripción del anuncio. |
description2 |
La segunda línea de la descripción del anuncio. |
displayUrl |
Es la URL visible del anuncio. |
displayMobileUrl |
Es la URL para dispositivos móviles que se muestra del anuncio. |
adTrackingId |
Es el ID de seguimiento del anuncio. |
SearchAds360ExpandedTextAdInfo
Un anuncio de texto expandido de Search Ads 360
Representación JSON |
---|
{ "headline": string, "headline2": string, "headline3": string, "description1": string, "description2": string, "path1": string, "path2": string, "adTrackingId": string } |
Campos | |
---|---|
headline |
Es el título del anuncio. |
headline2 |
El segundo título del anuncio. |
headline3 |
El tercer título del anuncio. |
description1 |
La primera línea de la descripción del anuncio. |
description2 |
La segunda línea de la descripción del anuncio. |
path1 |
Texto agregado con un delimitador a la URL visible generada automáticamente. |
path2 |
Texto agregado a path1 con un delimitador. |
adTrackingId |
Es el ID de seguimiento del anuncio. |
SearchAds360ResponsiveSearchAdInfo
Un anuncio de búsqueda responsivo de Search Ads 360
Representación JSON |
---|
{ "headlines": [ { object ( |
Campos | |
---|---|
headlines[] |
Lista de recursos de texto para los títulos. Cuando se publique el anuncio, los títulos se seleccionarán de esta lista. |
descriptions[] |
Lista de recursos de texto para las descripciones. Cuando se publique el anuncio, se seleccionarán las descripciones de esta lista. |
path1 |
Texto agregado con un delimitador a la URL visible generada automáticamente. |
path2 |
Texto agregado a path1 con un delimitador. |
adTrackingId |
Es el ID de seguimiento del anuncio. |
AdTextAsset
Recurso de texto utilizado dentro de un anuncio.
Representación JSON |
---|
{ "text": string } |
Campos | |
---|---|
text |
Texto del recurso. |
SearchAds360ProductAdInfo
Este tipo no tiene campos.
Un anuncio de productos de Search Ads 360
SearchAds360ExpandedDynamicSearchAdInfo
Un anuncio dinámico de búsqueda expandido.
Representación JSON |
---|
{ "description1": string, "description2": string, "adTrackingId": string } |
Campos | |
---|---|
description1 |
La primera línea de la descripción del anuncio. |
description2 |
La segunda línea de la descripción del anuncio. |
adTrackingId |
Es el ID de seguimiento del anuncio. |
AdGroupAdEngineStatus
Enumera los estados del motor de AdGroupAd.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especificó ningún valor. |
UNKNOWN |
Se usa solo para el valor que se muestra. Representa el valor desconocido en esta versión. |
AD_GROUP_AD_ELIGIBLE |
Obsoleta. No lo utilices. |
AD_GROUP_AD_INAPPROPRIATE_FOR_CAMPAIGN |
Baidu: No se aprobó la creatividad. |
AD_GROUP_AD_MOBILE_URL_UNDER_REVIEW |
Baidu: URL para dispositivos móviles en proceso de revisión. |
AD_GROUP_AD_PARTIALLY_INVALID |
Baidu: La creatividad no es válida en dispositivos móviles, pero sí en computadoras de escritorio. |
AD_GROUP_AD_TO_BE_ACTIVATED |
Baidu: La creatividad está lista para la activación. |
AD_GROUP_AD_NOT_REVIEWED |
Baidu: No se revisó la creatividad. |
AD_GROUP_AD_ON_HOLD |
Obsoleta. No lo utilices. Anteriormente en uso por parte de Gemini |
AD_GROUP_AD_PAUSED |
Se detuvo la creatividad. |
AD_GROUP_AD_REMOVED |
Se quitó la creatividad. |
AD_GROUP_AD_PENDING_REVIEW |
La creatividad está pendiente de revisión. |
AD_GROUP_AD_UNDER_REVIEW |
La creatividad está en proceso de revisión. |
AD_GROUP_AD_APPROVED |
Se aprobó la creatividad. |
AD_GROUP_AD_DISAPPROVED |
Se rechazó la creatividad. |
AD_GROUP_AD_SERVING |
Se está publicando la creatividad. |
AD_GROUP_AD_ACCOUNT_PAUSED |
Se detuvo la creatividad porque se detuvo la cuenta. |
AD_GROUP_AD_CAMPAIGN_PAUSED |
Se detuvo la creatividad porque se detuvo la campaña. |
AD_GROUP_AD_AD_GROUP_PAUSED |
Se detuvo la creatividad porque se detuvo el grupo de anuncios. |
AdGroupAdLabel
Es una relación entre un anuncio del grupo de anuncios y una etiqueta.
Representación JSON |
---|
{ "resourceName": string, "adGroupAd": string, "label": string } |
Campos | |
---|---|
resourceName |
El nombre del recurso de la etiqueta de anuncio del grupo de anuncios. Los nombres de los recursos de las etiquetas de anuncios del grupo de anuncios tienen el siguiente formato: |
adGroupAd |
El anuncio del grupo de anuncios al que se adjuntó la etiqueta |
label |
La etiqueta asignada al anuncio del grupo de anuncios. |
AdGroupAsset
Es un vínculo entre un grupo de anuncios y un recurso.
Representación JSON |
---|
{
"resourceName": string,
"adGroup": string,
"asset": string,
"status": enum ( |
Campos | |
---|---|
resourceName |
El nombre del recurso del grupo de anuncios. Los nombres de los recursos de AdGroupAsset tienen el siguiente formato:
|
adGroup |
Obligatorio. El grupo de anuncios al que está vinculado el recurso. |
asset |
Obligatorio. El recurso que está vinculado al grupo de anuncios. |
status |
Estado del recurso del grupo de anuncios. |
AssetLinkStatus
Es una enumeración que describe los estados del vínculo de un elemento.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
Se usa solo para el valor que se muestra. Representa el valor desconocido en esta versión. |
ENABLED |
El vínculo del recurso está habilitado. |
REMOVED |
Se quitó el vínculo del recurso. |
PAUSED |
El vínculo del recurso está detenido. |
AdGroupAssetSet
AdGroupAssetSet es la vinculación entre un grupo de anuncios y un conjunto de recursos. Cuando se crea un AdGroupAssetSet, se vincula un conjunto de recursos con un grupo de anuncios.
Representación JSON |
---|
{
"resourceName": string,
"adGroup": string,
"assetSet": string,
"status": enum ( |
Campos | |
---|---|
resourceName |
El nombre del recurso del conjunto de recursos del grupo de anuncios. Los nombres de recursos del conjunto de recursos del grupo de anuncios tienen el siguiente formato:
|
adGroup |
El grupo de anuncios al que está vinculado este conjunto de recursos. |
assetSet |
Es el conjunto de recursos vinculado al grupo de anuncios. |
status |
El estado del conjunto de recursos del grupo de anuncios. Solo lectura. |
AssetSetLinkStatus
Los posibles estados de la vinculación entre el conjunto de recursos y su contenedor.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especificó el estado. |
UNKNOWN |
En esta versión, se desconoce el valor recibido. Este es un valor de solo respuesta. |
ENABLED |
La vinculación entre el conjunto de recursos y su contenedor está habilitada. |
REMOVED |
Se quita la vinculación entre el conjunto de recursos y su contenedor. |
AdGroupAudienceView
Una vista de público del grupo de anuncios Incluye datos de rendimiento de intereses y listas de remarketing para anuncios de la Red de Display y de YouTube, y listas de remarketing para anuncios de búsqueda (RLSA), agregadas a nivel del público.
Representación JSON |
---|
{ "resourceName": string } |
Campos | |
---|---|
resourceName |
El nombre del recurso de la vista de público del grupo de anuncios. Los nombres de los recursos de vista de público del grupo de anuncios tienen el siguiente formato:
|
AdGroupBidModifier
Representa un modificador de oferta del grupo de anuncios.
Representación JSON |
---|
{ "resourceName": string, "bidModifier": number, // Union field |
Campos | |
---|---|
resourceName |
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:
|
bidModifier |
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 Es obligatorio en las operaciones de creación a partir de V5. |
|
device |
Un criterio de dispositivo. |
DeviceInfo
Un criterio de dispositivo.
Representación JSON |
---|
{
"type": enum ( |
Campos | |
---|---|
type |
Tipo del dispositivo. |
Dispositivo
Enumera los dispositivos de Google Ads disponibles para la segmentación.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
El valor es desconocido en esta versión. |
MOBILE |
Dispositivos móviles con navegadores completos. |
TABLET |
Tabletas con navegadores completos |
DESKTOP |
Computadoras |
CONNECTED_TV |
Smart TVs y consolas de juegos |
OTHER |
Otros tipos de dispositivos. |
AdGroupCriterion
Un criterio del grupo de anuncios. El informe de adGroupCriterion solo muestra los criterios que se agregaron explícitamente al grupo de anuncios.
Representación JSON |
---|
{ "resourceName": string, "creationTime": string, "status": enum ( |
Campos | |
---|---|
resourceName |
El nombre del recurso del criterio del grupo de anuncios. Los nombres de recursos del criterio del grupo de anuncios tienen el siguiente formato:
|
creationTime |
La marca de tiempo de la creación del criterio del grupo de anuncios. La marca de tiempo se encuentra en la zona horaria del cliente y en el formato “dd-MM-aaaa HH:mm:ss”. |
status |
El estado del criterio. Este es el estado de la entidad de criterio del grupo de anuncios, configurada por el cliente. Nota: Es posible que los informes de la IU incorporen información adicional que afecte si un criterio es apto para ejecutarse. En algunos casos, un criterio que se quita en la API aún puede mostrarse como habilitado en la IU. Por ejemplo, las campañas predeterminadas se mostrarán a los usuarios de todos los rangos de edad, a menos que se excluyan. La IU mostrará cada rango de edad como "habilitado", ya que son aptos para ver los anuncios, pero AdGroupCriterion.status mostrará “quitado”, ya que no se agregó ningún criterio positivo. |
qualityInfo |
Información sobre la calidad del criterio. |
type |
El tipo del criterio. |
labels[] |
Los nombres de recursos de las etiquetas adjuntas a este criterio de grupo de anuncios. |
positionEstimates |
Estimaciones de ofertas de criterio en varias posiciones. |
finalUrls[] |
La lista de posibles URLs finales después de todos los redireccionamientos entre dominios del anuncio. |
engineId |
ID del criterio del grupo de anuncios en la cuenta de motor externo. Este campo es solo para las cuentas que no son de Google Ads; por ejemplo, Yahoo Japan, Microsoft, Baidu, etc. Para la entidad de Google Ads, utilice "adGroupCriterion.criterion_id" en su lugar. |
lastModifiedTime |
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”. |
criterionId |
El ID del criterio. |
adGroup |
El grupo de anuncios al que pertenece el criterio |
negative |
Indica si se debe orientar ( Este campo es inmutable. Para cambiar un criterio de positivo a negativo, quítalo y vuelve a agregarlo. |
bidModifier |
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. |
cpcBidMicros |
La oferta de CPC (costo por clic). |
effectiveCpcBidMicros |
La oferta de CPC (costo por clic) efectiva. |
engineStatus |
El estado del motor para el criterio del grupo de anuncios. |
finalUrlSuffix |
Plantilla de URL para agregar parámetros a la URL final. |
trackingUrlTemplate |
La plantilla de URL para crear una URL de seguimiento. |
Campo de unión Se debe establecer exactamente uno. |
|
keyword |
Palabra clave. |
listingGroup |
Grupo de fichas. |
ageRange |
Rango de edad. |
gender |
Género. |
userList |
Lista de usuarios |
webpage |
Página web |
location |
Ubicación. |
AdGroupCriterionStatus
Indica los posibles estados de un criterio de grupo de anuncios.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especificó ningún valor. |
UNKNOWN |
En esta versión, se desconoce el valor recibido. Este es un valor de solo respuesta. |
ENABLED |
El criterio del grupo de anuncios está habilitado. |
PAUSED |
El criterio del grupo de anuncios está detenido. |
REMOVED |
Se quitó el criterio del grupo de anuncios. |
QualityInfo
Es un contenedor de información de calidad del criterio del grupo de anuncios.
Representación JSON |
---|
{ "qualityScore": integer } |
Campos | |
---|---|
qualityScore |
El nivel de calidad. Este campo no se puede propagar si Google no tiene suficiente información para determinar un valor. |
CriterionType
Es una enumeración que describe los posibles tipos de criterios.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
Se usa solo para el valor que se muestra. Representa el valor desconocido en esta versión. |
KEYWORD |
Palabra clave, por ejemplo, "cruceros por mars". |
PLACEMENT |
Ubicación, también conocida como sitio web, por ejemplo, "www.flores4oferta.com" |
MOBILE_APP_CATEGORY |
Categorías de aplicaciones para celulares a las que orientar sus anuncios. |
MOBILE_APPLICATION |
Aplicaciones para dispositivos móviles a las que se orientará. |
DEVICE |
Dispositivos a los que se orientará. |
LOCATION |
Ubicaciones de segmentación. |
LISTING_GROUP |
Grupos de fichas a los que deseas segmentar los anuncios. |
AD_SCHEDULE |
Programación de anuncios |
AGE_RANGE |
Rango de edad. |
GENDER |
Género. |
INCOME_RANGE |
Rango de ingresos. |
PARENTAL_STATUS |
Estado parental. |
YOUTUBE_VIDEO |
Video de YouTube |
YOUTUBE_CHANNEL |
Canal de YouTube. |
USER_LIST |
Lista de usuarios |
PROXIMITY |
Proximidad. |
TOPIC |
Es una orientación por tema en la Red de Display (por ejemplo, "Mascotas y animales"). |
LISTING_SCOPE |
Es el alcance de la ficha que se debe segmentar. |
LANGUAGE |
de HashiCorp. |
IP_BLOCK |
IpBlock. |
CONTENT_LABEL |
Etiqueta de contenido para la exclusión de categoría. |
CARRIER |
Proveedor. |
USER_INTEREST |
Una categoría que le interesa al usuario. |
WEBPAGE |
Criterio de página web para anuncios dinámicos de búsqueda. |
OPERATING_SYSTEM_VERSION |
Versión del sistema operativo. |
APP_PAYMENT_MODEL |
Modelo de pago de la aplicación. |
MOBILE_DEVICE |
Dispositivo móvil |
CUSTOM_AFFINITY |
Afinidad personalizada. |
CUSTOM_INTENT |
Público basado en intención personalizado. |
LOCATION_GROUP |
Grupo por ubicación. |
CUSTOM_AUDIENCE |
Público personalizado |
COMBINED_AUDIENCE |
Público combinado |
KEYWORD_THEME |
Tema de palabra clave de las campañas inteligentes |
AUDIENCE |
Público |
LOCAL_SERVICE_ID |
ID del Servicio de Anuncios de Servicios Locales. |
BRAND |
Marca |
BRAND_LIST |
Lista de marcas |
LIFE_EVENT |
Acontecimiento |
PositionEstimates
Estimaciones de ofertas de criterio en varias posiciones.
Representación JSON |
---|
{ "topOfPageCpcMicros": string } |
Campos | |
---|---|
topOfPageCpcMicros |
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. |
AdGroupCriterionEngineStatus
Enumera los estados del motor AdGroupCriterion.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
Se usa solo para el valor que se muestra. Representa el valor desconocido en esta versión. |
AD_GROUP_CRITERION_ELIGIBLE |
Obsoleta. No lo utilices. |
AD_GROUP_CRITERION_INAPPROPRIATE_FOR_CAMPAIGN |
Baidu: La oferta o la calidad son demasiado bajas para mostrarse. |
AD_GROUP_CRITERION_INVALID_MOBILE_SEARCH |
Baidu: La oferta o la calidad son demasiado bajas para dispositivos móviles, pero son aptas para mostrarlas en computadoras de escritorio. |
AD_GROUP_CRITERION_INVALID_PC_SEARCH |
Baidu: La oferta o la calidad son demasiado bajas para mostrar anuncios en computadoras de escritorio, pero son aptas para mostrarse en dispositivos móviles. |
AD_GROUP_CRITERION_INVALID_SEARCH |
Baidu: La oferta o la calidad son demasiado bajas para mostrarse. |
AD_GROUP_CRITERION_LOW_SEARCH_VOLUME |
Baidu: Baidu la detuvo debido al bajo volumen de búsquedas. |
AD_GROUP_CRITERION_MOBILE_URL_UNDER_REVIEW |
Baidu: URL para dispositivos móviles en proceso de revisión. |
AD_GROUP_CRITERION_PARTIALLY_INVALID |
Baidu: La página de destino de un dispositivo no es válida, mientras que la del otro dispositivo lo es. |
AD_GROUP_CRITERION_TO_BE_ACTIVATED |
La administración de cuentas de Baidu creó y detuvo la palabra clave, y ya está lista para que la actives. |
AD_GROUP_CRITERION_UNDER_REVIEW |
Baidu: En proceso de revisión por parte de Baidu. Gemini: Criterio en proceso de revisión. |
AD_GROUP_CRITERION_NOT_REVIEWED |
Baidu: Criterio a revisar. |
AD_GROUP_CRITERION_ON_HOLD |
Obsoleta. No lo utilices. Anteriormente en uso por parte de Gemini |
AD_GROUP_CRITERION_PENDING_REVIEW |
Y!J : el criterio está pendiente de revisión |
AD_GROUP_CRITERION_PAUSED |
Se detuvo el criterio. |
AD_GROUP_CRITERION_REMOVED |
Se quitó el criterio. |
AD_GROUP_CRITERION_APPROVED |
Se aprobó el criterio. |
AD_GROUP_CRITERION_DISAPPROVED |
Se ha rechazado el criterio. |
AD_GROUP_CRITERION_SERVING |
El criterio está activo y se está publicando. |
AD_GROUP_CRITERION_ACCOUNT_PAUSED |
Se detuvo el criterio desde que se detuvo la cuenta. |
KeywordInfo
Un criterio de palabras clave.
Representación JSON |
---|
{
"matchType": enum ( |
Campos | |
---|---|
matchType |
El tipo de concordancia de la palabra clave. |
text |
El texto de la palabra clave (como máximo, 80 caracteres y 10 palabras). |
KeywordMatchType
Posibles tipos de concordancia de palabras clave.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
Se usa solo para el valor que se muestra. Representa el valor desconocido en esta versión. |
EXACT |
Concordancia exacta. |
PHRASE |
Concordancia de frase. |
BROAD |
Concordancia amplia. |
ListingGroupInfo
Un criterio de grupo de fichas.
Representación JSON |
---|
{
"type": enum ( |
Campos | |
---|---|
type |
Tipo del grupo de fichas. |
ListingGroupType
Indica el tipo del grupo de fichas.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
Se usa solo para el valor que se muestra. Representa el valor desconocido en esta versión. |
SUBDIVISION |
Subdivisión de productos en alguna dimensión de la ficha. La entrega de estos nodos no se usa en las entradas de las listas de destino, sino que solo define la estructura del árbol. |
UNIT |
Unidad del grupo de fichas que define una oferta. |
AgeRangeInfo
Criterio de rango de edad.
Representación JSON |
---|
{
"type": enum ( |
Campos | |
---|---|
type |
Tipo de rango de edad. |
AgeRangeType
Indica el tipo de rango de edad demográfica (por ejemplo, entre 18 y 24 años).
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
Se usa solo para el valor que se muestra. Representa el valor desconocido en esta versión. |
AGE_RANGE_18_24 |
Tener entre 18 y 24 años. |
AGE_RANGE_25_34 |
Tener entre 25 y 34 años. |
AGE_RANGE_35_44 |
Tener entre 35 y 44 años. |
AGE_RANGE_45_54 |
Entre 45 y 54 años. |
AGE_RANGE_55_64 |
Entre 55 y 64 años. |
AGE_RANGE_65_UP |
65 años o más. |
AGE_RANGE_UNDETERMINED |
Rango de edad indeterminado. |
GenderInfo
Un criterio de género.
Representación JSON |
---|
{
"type": enum ( |
Campos | |
---|---|
type |
El tipo de género. |
GenderType
Es el tipo de género demográfico (por ejemplo, femenino).
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
Se usa solo para el valor que se muestra. Representa el valor desconocido en esta versión. |
MALE |
Hombre. |
FEMALE |
Mujer. |
UNDETERMINED |
Género indeterminado. |
UserListInfo
Un criterio de lista de usuarios. Representa una lista de usuarios definida por el anunciante para el que se segmentará.
Representación JSON |
---|
{ "userList": string } |
Campos | |
---|---|
userList |
El nombre del recurso de la lista de usuarios. |
WebpageInfo
Representa un criterio para segmentar páginas web del sitio web de un anunciante.
Representación JSON |
---|
{
"conditions": [
{
object ( |
Campos | |
---|---|
conditions[] |
Condiciones o expresiones lógicas para la segmentación de páginas web. La lista de condiciones de segmentación de páginas web se crea cuando se evalúa la segmentación. Una lista de condiciones vacía indica que todas las páginas del sitio web de la campaña se segmentan. Este campo es obligatorio para las operaciones de creación y está prohibido en las operaciones de actualización. |
coveragePercentage |
Porcentaje de cobertura de los criterios del sitio web. Es el porcentaje calculado de cobertura del sitio web en función de la segmentación del sitio web, la segmentación negativa del sitio web y las palabras clave negativas del grupo de anuncios y la campaña. Por ejemplo, cuando la cobertura se muestra como 1, indica que tiene una cobertura del 100%. Este campo es de solo lectura. |
criterionName |
El nombre del criterio que define este parámetro. El valor del nombre se usará para identificar, ordenar y filtrar criterios con este tipo de parámetros. Este campo es obligatorio para las operaciones de creación y está prohibido en las operaciones de actualización. |
WebpageConditionInfo
Es una expresión lógica para segmentar los anuncios para páginas web del sitio web de un anunciante.
Representación JSON |
---|
{ "operand": enum ( |
Campos | |
---|---|
operand |
Operando de la condición de segmentación de la página web. |
operator |
Operador de la condición de segmentación de la página web. |
argument |
Argumento de la condición de segmentación de la página web. |
WebpageConditionOperand
El operando de condición de la página web en un criterio de página web.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
Se usa solo para el valor que se muestra. Representa el valor desconocido en esta versión. |
URL |
Operando que denota una condición de segmentación de URL de página web. |
CATEGORY |
Operando que denota una condición de segmentación por categoría de página web. |
PAGE_TITLE |
Operando que denota una condición de segmentación del título de la página web. |
PAGE_CONTENT |
Operando que denota una condición de segmentación por contenido de una página web. |
CUSTOM_LABEL |
Operando que denota una condición de segmentación de etiqueta personalizada de página web. |
WebpageConditionOperator
El operador de condición de la página web en un criterio de página web
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
Se usa solo para el valor que se muestra. Representa el valor desconocido en esta versión. |
EQUALS |
La condición web del argumento es igual a la condición web comparada. |
CONTAINS |
La condición web de argumentos es parte de la condición web comparada. |
LocationInfo
Un criterio de ubicación.
Representación JSON |
---|
{ "geoTargetConstant": string } |
Campos | |
---|---|
geoTargetConstant |
El nombre del recurso constante de la segmentación geográfica. |
AdGroupCriterionLabel
Es una relación entre un criterio del grupo de anuncios y una etiqueta.
Representación JSON |
---|
{ "resourceName": string, "adGroupCriterion": string, "label": string } |
Campos | |
---|---|
resourceName |
El nombre del recurso de la etiqueta de criterio del grupo de anuncios. Los nombres de recursos de la etiqueta de criterio del grupo de anuncios tienen el siguiente formato: |
adGroupCriterion |
El criterio del grupo de anuncios al que se adjuntó la etiqueta. |
label |
Es la etiqueta asignada al criterio del grupo de anuncios. |
AdGroupLabel
Es una relación entre un grupo de anuncios y una etiqueta.
Representación JSON |
---|
{ "resourceName": string, "adGroup": string, "label": string } |
Campos | |
---|---|
resourceName |
El nombre del recurso de la etiqueta del grupo de anuncios. Los nombres de recursos de la etiqueta del grupo de anuncios tienen el siguiente formato: |
adGroup |
El grupo de anuncios al que se adjuntó la etiqueta |
label |
La etiqueta asignada al grupo de anuncios. |
AgeRangeView
Vista de rango de edad
Representación JSON |
---|
{ "resourceName": string } |
Campos | |
---|---|
resourceName |
El nombre del recurso de la vista de rango de edad. Los nombres de los recursos de vista de rango de edad tienen el siguiente formato:
|
Recurso
El recurso es parte de un anuncio que se puede compartir entre varios anuncios. Puede ser una imagen (ImageAsset), un video (YouTubeVideoAsset), etc. Los recursos son inmutables y no se pueden quitar. Para detener la publicación de un recurso, quítalo de la entidad que lo está usando.
Representación JSON |
---|
{ "resourceName": string, "type": enum ( |
Campos | |
---|---|
resourceName |
El nombre del recurso del recurso. Los nombres de los recursos de los recursos tienen el siguiente formato:
|
type |
Es el tipo de activo. |
finalUrls[] |
Una lista de las posibles URLs finales después de todos los redireccionamientos entre dominios. |
status |
El estado del recurso. |
creationTime |
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”. |
lastModifiedTime |
La fecha y hora de la última modificación de este recurso. La fecha y hora se encuentran en la zona horaria del cliente y en el formato “dd-MM-aaaa HH:mm:ss.ssssss”. |
id |
El ID del activo. |
name |
Es el nombre opcional del activo. |
trackingUrlTemplate |
Plantilla de URL para crear una URL de seguimiento. |
engineStatus |
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: |
|
youtubeVideoAsset |
Un activo de video de YouTube |
imageAsset |
Un recurso de imagen |
textAsset |
Un recurso de texto |
calloutAsset |
Un recurso de texto destacado unificado |
sitelinkAsset |
Un recurso de vínculo a sitio unificado |
pageFeedAsset |
Un recurso de feed de páginas unificado |
mobileAppAsset |
Un recurso de aplicación para dispositivos móviles |
callAsset |
Un recurso de llamada unificado |
callToActionAsset |
Un recurso de llamado a la acción |
locationAsset |
Un recurso de ubicación unificado |
AssetType
Es una enumeración que describe los posibles tipos de elementos.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
Se usa solo para el valor que se muestra. Representa el valor desconocido en esta versión. |
YOUTUBE_VIDEO |
Elemento de video de YouTube. |
MEDIA_BUNDLE |
Recurso del paquete de medios. |
IMAGE |
Recurso de imagen |
TEXT |
Recurso de texto. |
LEAD_FORM |
Recurso de formulario de clientes potenciales |
BOOK_ON_GOOGLE |
Recurso de Reservar en Google. |
PROMOTION |
Recurso de promoción |
CALLOUT |
Recurso de texto destacado |
STRUCTURED_SNIPPET |
Recurso de fragmento estructurado. |
SITELINK |
Recurso de vínculo a sitio. |
PAGE_FEED |
Recurso de feed de páginass. |
DYNAMIC_EDUCATION |
Recurso dinámico de Education. |
MOBILE_APP |
Recurso de aplicación para dispositivos móviles |
HOTEL_CALLOUT |
Recurso de texto destacado de hoteles. |
CALL |
Recurso de llamada |
PRICE |
Recurso de precios. |
CALL_TO_ACTION |
Recurso de llamado a la acción. |
DYNAMIC_REAL_ESTATE |
Elemento dinámico de bienes raíces. |
DYNAMIC_CUSTOM |
Recurso personalizado dinámico. |
DYNAMIC_HOTELS_AND_RENTALS |
Recurso dinámico de hoteles y alquileres. |
DYNAMIC_FLIGHTS |
Recurso dinámico de vuelos. |
DISCOVERY_CAROUSEL_CARD |
Activo de la tarjeta de carrusel discovery. |
DYNAMIC_TRAVEL |
Recurso de viaje dinámico. |
DYNAMIC_LOCAL |
Recurso local dinámico |
DYNAMIC_JOBS |
Recurso de trabajos dinámicos. |
LOCATION |
Recurso de ubicación |
HOTEL_PROPERTY |
Recurso de propiedad de hotel. |
AssetStatus
Los posibles estados de un activo.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especificó el estado. |
UNKNOWN |
En esta versión, se desconoce el valor recibido. Este es un valor de solo respuesta. |
ENABLED |
El recurso está habilitado. |
REMOVED |
Se quita el recurso. |
ARCHIVED |
El activo está archivado. |
PENDING_SYSTEM_GENERATED |
El recurso es generado por el sistema y está pendiente de la revisión del usuario. |
AssetEngineStatus
Siguiente ID = 11
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
Se usa solo para el valor que se muestra. Representa el valor desconocido en esta versión. |
SERVING |
El activo está activo. |
SERVING_LIMITED |
El activo está limitado. |
DISAPPROVED |
Se rechazó el recurso (no es apto). |
DISABLED |
El activo está inactivo (pendiente). |
REMOVED |
Se quitó el recurso. |
YoutubeVideoAsset
Un activo de YouTube
Representación JSON |
---|
{ "youtubeVideoTitle": string, "youtubeVideoId": string } |
Campos | |
---|---|
youtubeVideoTitle |
Título del video de YouTube. |
youtubeVideoId |
ID de video de YouTube Este es el valor de cadena de 11 caracteres que se utiliza en la URL del video de YouTube. |
ImageAsset
Un recurso de imagen
Representación JSON |
---|
{ "mimeType": enum ( |
Campos | |
---|---|
mimeType |
Es el tipo de MIME del recurso de imagen. |
fullSize |
Metadatos de esta imagen en su tamaño original |
fileSize |
Tamaño del archivo del recurso de imagen en bytes. |
MimeType
El tipo de MIME
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especificó el tipo de MIME. |
UNKNOWN |
En esta versión, se desconoce el valor recibido. Este es un valor de solo respuesta. |
IMAGE_JPEG |
Es el tipo MIME de imagen o jpeg. |
IMAGE_GIF |
Tipo MIME de imagen o GIF. |
IMAGE_PNG |
Es el tipo MIME de imagen o png. |
FLASH |
Es el tipo de MIME de application/x-shockwave-flash. |
TEXT_HTML |
Es el tipo MIME de text/html. |
PDF |
Tipo MIME de application/pdf. |
MSWORD |
Es el tipo de MIME de application/msword. |
MSEXCEL |
Es el tipo de MIME de application/vnd.ms-excel. |
RTF |
Es el tipo de MIME de application/rtf. |
AUDIO_WAV |
Tipo MIME de audio/wav. |
AUDIO_MP3 |
Tipo MIME de audio/mp3. |
HTML5_AD_ZIP |
Es el tipo de MIME de application/x-html5-ad-zip. |
ImageDimension
Metadatos de una imagen de un tamaño determinado, original o con el tamaño cambiado.
Representación JSON |
---|
{ "heightPixels": string, "widthPixels": string, "url": string } |
Campos | |
---|---|
heightPixels |
Altura de la imagen. |
widthPixels |
Ancho de la imagen. |
url |
Una URL que muestra la imagen con esta altura y este ancho. |
TextAsset
Un recurso de texto
Representación JSON |
---|
{ "text": string } |
Campos | |
---|---|
text |
Contenido de texto del recurso de texto. |
UnifiedCalloutAsset
Un recurso de texto destacado unificado
Representación JSON |
---|
{
"calloutText": string,
"startDate": string,
"endDate": string,
"adScheduleTargets": [
{
object ( |
Campos | |
---|---|
calloutText |
Es el texto destacado. La longitud de esta cadena debe ser entre 1 y 25, inclusive. |
startDate |
Es la fecha de inicio en la que este recurso entrará en vigencia y puede comenzar a publicarse, en formato aaaa-MM-dd. |
endDate |
Es la última fecha en la que este recurso entró en vigencia y aún se está publicando, en formato aaaa-MM-dd. |
adScheduleTargets[] |
Lista de programaciones que no se superponen y que especifican todos los intervalos de tiempo en los que puede publicarse el recurso. Puede haber un máximo de 6 programas por día, 42 en total. |
useSearcherTimeZone |
Indica si se muestra el recurso en la zona horaria del usuario que realiza la búsqueda. Se aplica a Microsoft Ads. |
AdScheduleInfo
Representa un criterio de AdSchedule.
AdSchedule se especifica como el día de la semana y el intervalo de tiempo dentro del cual se mostrarán anuncios.
No se pueden agregar más de seis programaciones de anuncios para el mismo día.
Representación JSON |
---|
{ "startMinute": enum ( |
Campos | |
---|---|
startMinute |
Minutos después de la hora de inicio en la que comienza este programa. Este campo es obligatorio para las operaciones de creación y está prohibido en las operaciones de actualización. |
endMinute |
Minutos después de la hora de finalización en la que finaliza este programa. La programación no incluye el minuto final. Este campo es obligatorio para las operaciones de creación y está prohibido en las operaciones de actualización. |
dayOfWeek |
Día de la semana al que se aplica el programa Este campo es obligatorio para las operaciones de creación y está prohibido en las operaciones de actualización. |
startHour |
Hora de inicio en 24 horas. Este campo debe estar comprendido entre 0 y 23, inclusive. Este campo es obligatorio para las operaciones de creación y está prohibido en las operaciones de actualización. |
endHour |
Hora de finalización en 24 horas 24 significa el final del día. Este campo debe estar comprendido entre 0 y 24, inclusive. Este campo es obligatorio para las operaciones de creación y está prohibido en las operaciones de actualización. |
MinuteOfHour
Enumera los cuartos de hora. Por ejemplo, "FIFTEEN"
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
El valor es desconocido en esta versión. |
ZERO |
Cero minutos después de la hora. |
FIFTEEN |
Quince minutos después de la hora. |
THIRTY |
Treinta minutos después de la hora. |
FORTY_FIVE |
Cuarenta y cinco minutos después de la hora. |
DayOfWeek
Enumera los días de la semana, por ejemplo, "Monday".
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
El valor es desconocido en esta versión. |
MONDAY |
lunes. |
TUESDAY |
martes. |
WEDNESDAY |
miércoles. |
THURSDAY |
jueves. |
FRIDAY |
Viernes. |
SATURDAY |
Sábado. |
SUNDAY |
domingo |
UnifiedSitelinkAsset
Un recurso de vínculo a sitio unificado
Representación JSON |
---|
{
"linkText": string,
"description1": string,
"description2": string,
"startDate": string,
"endDate": string,
"adScheduleTargets": [
{
object ( |
Campos | |
---|---|
linkText |
Texto de visualización de URL del vínculo a sitio. La longitud de esta cadena debe ser entre 1 y 25, inclusive. |
description1 |
Primera línea de la descripción del vínculo a sitio. Si se establece, la longitud debe estar entre 1 y 35, inclusive, y también se debe establecer description2. |
description2 |
Es la segunda línea de la descripción del vínculo a sitio. Si se establece, la longitud debe estar entre 1 y 35, inclusive, y también se debe establecer description1. |
startDate |
Es la fecha de inicio en la que este recurso entrará en vigencia y puede comenzar a publicarse, en formato aaaa-MM-dd. |
endDate |
Es la última fecha en la que este recurso entró en vigencia y aún se está publicando, en formato aaaa-MM-dd. |
adScheduleTargets[] |
Lista de programaciones que no se superponen y que especifican todos los intervalos de tiempo en los que puede publicarse el recurso. Puede haber un máximo de 6 programas por día, 42 en total. |
trackingId |
Es el ID que se usa para hacer un seguimiento de los clics en el recurso de vínculo a sitio. Esta es una cuenta de Yahoo! Japan. |
useSearcherTimeZone |
Indica si se muestra el recurso de vínculo a sitio en la zona horaria del usuario de la búsqueda. Se aplica a Microsoft Ads. |
mobilePreferred |
Indica si se prefiere que el recurso de vínculo a sitio se muestre en dispositivos móviles. Se aplica a Microsoft Ads. |
UnifiedPageFeedAsset
Un recurso de feed de páginas unificado
Representación JSON |
---|
{ "pageUrl": string, "labels": [ string ] } |
Campos | |
---|---|
pageUrl |
Es la página web para la que los anunciantes desean segmentar sus anuncios. |
labels[] |
Las etiquetas que se usan para agrupar las URLs de las páginas. |
MobileAppAsset
Un recurso que representa una aplicación para dispositivos móviles.
Representación JSON |
---|
{
"appId": string,
"appStore": enum ( |
Campos | |
---|---|
appId |
Obligatorio. Es una cadena que identifica de forma exclusiva una aplicación para dispositivos móviles. Solo debe contener el ID nativo de la plataforma, como "com.android.ebay". para Android o "12345689" para iOS. |
appStore |
Obligatorio. La tienda de aplicaciones que distribuye esta app específica. |
MobileAppVendor
El tipo de proveedor de apps para dispositivos móviles
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
Se usa solo para el valor que se muestra. Representa el valor desconocido en esta versión. |
APPLE_APP_STORE |
Proveedor de la aplicación para dispositivos móviles de la App Store de Apple. |
GOOGLE_APP_STORE |
Proveedor de la aplicación para dispositivos móviles de Google App Store. |
UnifiedCallAsset
Un recurso de llamada unificado
Representación JSON |
---|
{ "countryCode": string, "phoneNumber": string, "callConversionReportingState": enum ( |
Campos | |
---|---|
countryCode |
Es el código de país de dos letras del número de teléfono. Ejemplos: "US", "us". |
phoneNumber |
Es el número de teléfono sin procesar del anunciante. Ejemplo: "1234567890", "(123)456-7890" |
callConversionReportingState |
Indica si este recurso de llamada debe usar su propia configuración de conversiones de llamada, seguir la configuración a nivel de la cuenta o inhabilitar la conversión de llamada. |
callConversionAction |
Indica la acción de conversión a la que se atribuye una conversión de llamada. Si no la estableces, se usará la acción de conversión predeterminada. Este campo solo tiene efecto si se establece callConversionReportingState como USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION. |
adScheduleTargets[] |
Lista de programaciones que no se superponen y que especifican todos los intervalos de tiempo en los que puede publicarse el recurso. Puede haber un máximo de 6 programas por día, 42 en total. |
callOnly |
Si en la llamada solo se muestra el número de teléfono sin un vínculo al sitio web Se aplica a Microsoft Ads. |
callTrackingEnabled |
Si se debe habilitar la llamada en el seguimiento de llamadas Se aplica a Microsoft Ads. |
useSearcherTimeZone |
Indica si se muestra la extensión de llamada en la zona horaria del usuario de la búsqueda. Se aplica a Microsoft Ads. |
startDate |
Es la fecha de inicio en la que este recurso entrará en vigencia y puede comenzar a publicarse, en formato aaaa-MM-dd. |
endDate |
Es la última fecha en la que este recurso entró en vigencia y aún se está publicando, en formato aaaa-MM-dd. |
CallConversionReportingState
Tipos de datos posibles para el estado de una acción de conversión de llamada.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
Se usa solo para el valor que se muestra. Representa el valor desconocido en esta versión. |
DISABLED |
La acción de conversión de llamada está inhabilitada. |
USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION |
La acción de conversión de llamada utilizará el tipo de conversión de llamada establecido a nivel de la cuenta. |
USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION |
La acción de conversión de llamada utilizará el tipo de conversión de llamada establecido a nivel del recurso (anuncios solo de llamada o extensiones de llamada). |
CallToActionAsset
Un recurso de llamado a la acción
Representación JSON |
---|
{
"callToAction": enum ( |
Campos | |
---|---|
callToAction |
Llamado a la acción. |
CallToActionType
Es una enumeración que describe posibles tipos de llamados a la acción.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
Se usa solo para el valor que se muestra. Representa el valor desconocido en esta versión. |
LEARN_MORE |
El tipo de llamado a la acción es "Más información". |
GET_QUOTE |
El tipo de llamado a la acción es Obtener cotización. |
APPLY_NOW |
El tipo de llamado a la acción es Aplicar ahora. |
SIGN_UP |
El tipo de llamado a la acción es Registro. |
CONTACT_US |
El tipo de llamado a la acción es Comunicarse con nosotros. |
SUBSCRIBE |
El tipo de llamado a la acción es "Suscribirse". |
DOWNLOAD |
El tipo de llamado a la acción es "descarga". |
BOOK_NOW |
El tipo de llamado a la acción es Reservar ahora. |
SHOP_NOW |
El tipo de llamado a la acción es Comprar ahora. |
BUY_NOW |
El tipo de llamado a la acción es Compra ahora. |
DONATE_NOW |
El tipo de llamado a la acción es Donar ahora. |
ORDER_NOW |
El tipo de llamado a la acción es Pedir ahora. |
PLAY_NOW |
El tipo de llamado a la acción es Reproducir ahora. |
SEE_MORE |
El tipo de llamado a la acción es Ver más. |
START_NOW |
El tipo de llamado a la acción es "Comenzar ahora". |
VISIT_SITE |
El tipo de llamado a la acción es "Visitar sitio". |
WATCH_NOW |
El tipo de llamado a la acción es Mirar ahora. |
UnifiedLocationAsset
Un recurso de ubicación unificado
Representación JSON |
---|
{ "placeId": string, "businessProfileLocations": [ { object ( |
Campos | |
---|---|
placeId |
Los IDs de lugar identifican de forma exclusiva un sitio en la base de datos de Google Places y en Google Maps. Este campo es único para un ID de cliente y un tipo de recurso determinados. Consulta https://developers.google.com/places/web-service/place-id para obtener más información sobre el ID de lugar. |
businessProfileLocations[] |
La lista de ubicaciones de la empresa para el cliente. Esto solo se mostrará si el recurso de ubicación se sincroniza desde la cuenta del Perfil de Negocio. Es posible tener varias fichas del Perfil de Negocio en la misma cuenta que dirijan al mismo ID de lugar. |
locationOwnershipType |
El tipo de propiedad de la ubicación. Si el tipo es BUSINESS_OWNER, se publicará como extensión de ubicación. Si el tipo es AFILIATE, se publicará como ubicación afiliada. |
BusinessProfileLocation
Los datos de ubicación del Perfil de Negocio se sincronizaron desde la cuenta vinculada del Perfil de Negocio.
Representación JSON |
---|
{ "labels": [ string ], "storeCode": string, "listingId": string } |
Campos | |
---|---|
labels[] |
El anunciante especificó la etiqueta para la ubicación en la cuenta del Perfil de Negocio. Esta información se sincroniza desde la cuenta del Perfil de Negocio. |
storeCode |
Es el código de tienda del Perfil de Negocio de esta ubicación. Esta información se sincroniza desde la cuenta del Perfil de Negocio. |
listingId |
Es el ID de la ficha de la ubicación de este Perfil de Negocio. Esta información se sincroniza desde la cuenta vinculada del Perfil de Negocio. |
LocationOwnershipType
Tipos posibles de propiedad de una ubicación.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
Se usa solo para el valor que se muestra. Representa el valor desconocido en esta versión. |
BUSINESS_OWNER |
Propietario de la empresa de ubicación(extensión de ubicación heredada - LE). |
AFFILIATE |
Ubicación afiliada(extensión de ubicación de terceros, ALE). |
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.
Representación JSON |
---|
{ "resourceName": string, "assetGroup": string, "asset": string, "fieldType": enum ( |
Campos | |
---|---|
resourceName |
El nombre del recurso del grupo de recursos. Los nombres de los recursos del grupo de recursos tienen el siguiente formato:
|
assetGroup |
El grupo de recursos que se vincula con este grupo de recursos. |
asset |
El recurso que se vincula con este grupo de recursos. |
fieldType |
Es la descripción de la posición del recurso dentro del grupo de recursos. Por ejemplo: HEADLINE, YOUTUBE_VIDEO, etcétera |
status |
El estado del vínculo entre un recurso y un grupo de recursos. |
AssetFieldType
Es una enumeración que describe las posibles posiciones de un elemento.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
Se usa solo para el valor que se muestra. Representa el valor desconocido en esta versión. |
HEADLINE |
El recurso está vinculado para usarse como título. |
DESCRIPTION |
El activo está vinculado para usarse como descripción. |
MANDATORY_AD_TEXT |
El recurso está vinculado para usarse como texto del anuncio obligatorio. |
MARKETING_IMAGE |
El recurso se vincula para utilizarlo como imagen de marketing. |
MEDIA_BUNDLE |
El recurso está vinculado para usarse como paquete de medios. |
YOUTUBE_VIDEO |
El activo está vinculado para usarse como video de YouTube. |
BOOK_ON_GOOGLE |
El recurso está vinculado para indicar que una campaña de hoteles es "Reserva en Google" habilitado. |
LEAD_FORM |
El recurso está vinculado para usarse como una extensión de formulario de clientes potenciales. |
PROMOTION |
El recurso está vinculado para usarse como extensión de promoción. |
CALLOUT |
El recurso está vinculado para usarse como una extensión de texto destacado. |
STRUCTURED_SNIPPET |
El recurso está vinculado para usarse como una extensión de fragmento estructurado. |
SITELINK |
El recurso está vinculado para usarse como vínculo a sitio. |
MOBILE_APP |
El recurso está vinculado para usarse como una extensión de aplicación para dispositivos móviles. |
HOTEL_CALLOUT |
El recurso está vinculado para usarse como una extensión de texto destacado de hoteles. |
CALL |
El recurso está vinculado para usarse como una extensión de llamada. |
PRICE |
El recurso está vinculado para usarse como una extensión de precios. |
LONG_HEADLINE |
El recurso se vincula para usarse como título largo. |
BUSINESS_NAME |
El recurso está vinculado para usarse como nombre de la empresa. |
SQUARE_MARKETING_IMAGE |
El recurso se vinculó para utilizarlo como una imagen de marketing cuadrada. |
PORTRAIT_MARKETING_IMAGE |
El recurso está vinculado para utilizarse como imagen de marketing vertical. |
LOGO |
El recurso está vinculado para usarse como logotipo. |
LANDSCAPE_LOGO |
El recurso está vinculado para usarse como logotipo horizontal. |
VIDEO |
El activo está vinculado para usarse como logotipo que no es de YouTube. |
CALL_TO_ACTION_SELECTION |
El recurso está vinculado para usarse para seleccionar un llamado a la acción. |
AD_IMAGE |
El recurso está vinculado para usarse para seleccionar una imagen del anuncio. |
BUSINESS_LOGO |
El recurso está vinculado para usarse como logotipo de la empresa. |
HOTEL_PROPERTY |
El recurso está vinculado para usarse como propiedad de hotel en una campaña de máximo rendimiento para objetivos de viaje. |
DISCOVERY_CAROUSEL_CARD |
El recurso está vinculado para usarse como una tarjeta de carrusel discovery. |
AssetGroupSignal
AssetGroupSignal representa un indicador en un grupo de recursos. La existencia de un indicador le indica a la campaña de máximo rendimiento quién tiene más probabilidades de generar conversiones. Las campañas de máximo rendimiento utilizan el indicador para buscar personas nuevas con una intención similar o más sólida para encontrar conversiones en la Búsqueda, Display, video y mucho más.
Representación JSON |
---|
{ "resourceName": string, "assetGroup": string, // Union field |
Campos | |
---|---|
resourceName |
El nombre del recurso del indicador del grupo de recursos. El nombre del recurso del indicador del grupo de recursos tiene el siguiente formato:
|
assetGroup |
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 |
Es el indicador de público que utilizará la campaña de máximo rendimiento. |
AudienceInfo
Un criterio de público.
Representación JSON |
---|
{ "audience": string } |
Campos | |
---|---|
audience |
El nombre del recurso de público. |
AssetGroupListingGroupFilter
AssetGroupListingGroupFilter representa un nodo del árbol de filtro de grupos de fichas en un grupo de recursos.
Representación JSON |
---|
{ "resourceName": string, "assetGroup": string, "id": string, "type": enum ( |
Campos | |
---|---|
resourceName |
El nombre del recurso del filtro de grupo de fichas del grupo de recursos. El nombre del recurso de filtro del grupo de fichas del grupo de recursos tiene el siguiente formato:
|
assetGroup |
Es el grupo de recursos del que forma parte este filtro de grupo de fichas. |
id |
Es el ID de ListingGroupFilter. |
type |
Tipo de un nodo de filtro de grupos de fichas. |
vertical |
Es la vertical que representa el árbol de nodos actual. Todos los nodos del mismo árbol deben pertenecer a la misma vertical. |
caseValue |
Es el valor de la dimensión con la que este grupo de fichas define mejor el elemento superior. No definido para el grupo raíz. |
parentListingGroupFilter |
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 |
Es la ruta de las dimensiones que definen este filtro de grupo de fichas. |
ListingGroupFilterType
El tipo de filtro de grupos de fichas.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
Se usa solo para el valor que se muestra. Representa el valor desconocido en esta versión. |
SUBDIVISION |
Subdivisión de productos en algunas dimensiones de la ficha. |
UNIT_INCLUDED |
Un nodo de hoja de filtro de grupo de fichas incluido. |
UNIT_EXCLUDED |
Un nodo hoja del filtro de grupos de fichas excluido. |
ListingGroupFilterVertical
El tipo de vertical del filtro de grupos de fichas.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
Se usa solo para el valor que se muestra. Representa el valor desconocido en esta versión. |
SHOPPING |
Representa la vertical de compras. La vertical solo se permite en las campañas de máximo rendimiento para venta minorista. |
ListingGroupFilterDimension
Dimensiones de la ficha para el filtro del grupo de fichas del grupo de recursos.
Representación JSON |
---|
{ // Union field |
Campos | |
---|---|
Campo de unión dimension . Una dimensión de uno de los tipos que se indican a continuación siempre está presente. Las direcciones (dimension ) solo pueden ser una de las siguientes opciones: |
|
productBiddingCategory |
Es la categoría de ofertas de la oferta de un producto. |
productBrand |
Es la marca de la oferta de un producto. |
productChannel |
Localidad de la oferta de un producto. |
productCondition |
Es la condición de la oferta de un producto. |
productCustomAttribute |
Atributo personalizado de la oferta de un producto. |
productItemId |
Es el ID de artículo de una oferta de producto. |
productType |
Es el tipo de oferta de un producto. |
ProductBiddingCategory
Es un elemento de una categoría de oferta en un nivel determinado. Las categorías de nivel superior están en el nivel 1, sus hijos, en el nivel 2, y así sucesivamente. Actualmente, se admiten hasta 5 niveles. El usuario debe especificar un tipo de dimensión que indique el nivel de la categoría. Todos los casos de la misma subdivisión deben tener el mismo tipo de dimensión (nivel de categoría).
Representación JSON |
---|
{
"level": enum ( |
Campos | |
---|---|
level |
Indica el nivel de la categoría en la taxonomía. |
id |
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 |
ListingGroupFilterBiddingCategoryLevel
El nivel de la categoría de ofertas del filtro del grupo de fichas.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
Se usa solo para el valor que se muestra. Representa el valor desconocido en esta versión. |
LEVEL1 |
Nivel 1. |
LEVEL2 |
Nivel 2. |
LEVEL3 |
Nivel 3. |
LEVEL4 |
Nivel 4. |
LEVEL5 |
Nivel 5. |
ProductBrand
Es la marca del producto.
Representación JSON |
---|
{ "value": string } |
Campos | |
---|---|
value |
Es el valor de cadena de la marca del producto. |
ProductChannel
Localidad de la oferta de un producto.
Representación JSON |
---|
{
"channel": enum ( |
Campos | |
---|---|
channel |
Valor de la localidad. |
ListingGroupFilterProductChannel
Es una enumeración que describe la localidad de la oferta de un producto.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
Se usa solo para el valor que se muestra. Representa el valor desconocido en esta versión. |
ONLINE |
El artículo se vende en línea. |
LOCAL |
El artículo se vende en tiendas locales. |
ProductCondition
Es la condición de la oferta de un producto.
Representación JSON |
---|
{
"condition": enum ( |
Campos | |
---|---|
condition |
Valor de la condición. |
ListingGroupFilterProductCondition
Es una enumeración que describe el estado de la oferta de un producto.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
Se usa solo para el valor que se muestra. Representa el valor desconocido en esta versión. |
NEW |
El estado del producto es nuevo. |
REFURBISHED |
El estado del producto es reacondicionado. |
USED |
Se usa el estado del producto. |
ProductCustomAttribute
Atributo personalizado de la oferta de un producto.
Representación JSON |
---|
{
"index": enum ( |
Campos | |
---|---|
index |
Indica el índice del atributo personalizado. |
value |
Es el valor de cadena del atributo personalizado del producto. |
ListingGroupFilterCustomAttributeIndex
El índice de los atributos del cliente.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
Se usa solo para el valor que se muestra. Representa el valor desconocido en esta versión. |
INDEX0 |
Primer atributo personalizado del filtro de grupo de fichas. |
INDEX1 |
Segundo atributo personalizado del filtro de grupo de fichas. |
INDEX2 |
Tercer atributo personalizado del filtro de grupo de fichas. |
INDEX3 |
Cuarto atributo personalizado de filtro de grupo de fichas. |
INDEX4 |
Quinto atributo personalizado de filtro de grupo de fichas. |
ProductItemId
Es el ID de artículo de una oferta de producto.
Representación JSON |
---|
{ "value": string } |
Campos | |
---|---|
value |
Valor del ID. |
ProductType
Es el tipo de oferta de un producto.
Representación JSON |
---|
{
"level": enum ( |
Campos | |
---|---|
level |
Es el nivel del tipo. |
value |
Valor del tipo. |
ListingGroupFilterProductTypeLevel
Es una enumeración que describe el nivel del tipo de oferta de un producto.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
Se usa solo para el valor que se muestra. Representa el valor desconocido en esta versión. |
LEVEL1 |
Nivel 1. |
LEVEL2 |
Nivel 2. |
LEVEL3 |
Nivel 3. |
LEVEL4 |
Nivel 4. |
LEVEL5 |
Nivel 5. |
ListingGroupFilterDimensionPath
Es la ruta que define las dimensiones que definen un filtro de grupo de fichas.
Representación JSON |
---|
{
"dimensions": [
{
object ( |
Campos | |
---|---|
dimensions[] |
La ruta completa de las dimensiones a través de la jerarquía de filtros de grupos de fichas (sin incluir el nodo raíz) a este filtro de grupos de fichas. |
AssetGroupTopCombinationView
Una vista del uso de la combinación de recursos del anuncio del grupo de anuncios.
Representación JSON |
---|
{
"resourceName": string,
"assetGroupTopCombinations": [
{
object ( |
Campos | |
---|---|
resourceName |
El nombre del recurso de la vista de combinación en la parte superior del grupo de recursos. Los nombres de los recursos de la vista de combinación principal de AssetGroup tienen el siguiente formato: `"customers/{customerId}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}" |
assetGroupTopCombinations[] |
Las principales combinaciones de recursos que se publicaron juntos. |
AssetGroupAssetCombinationData
Datos de combinación de recursos del grupo de recursos
Representación JSON |
---|
{
"assetCombinationServedAssets": [
{
object ( |
Campos | |
---|---|
assetCombinationServedAssets[] |
Elementos publicados. |
AssetUsage
Contiene la información de uso del activo.
Representación JSON |
---|
{
"asset": string,
"servedAssetFieldType": enum ( |
Campos | |
---|---|
asset |
Nombre del recurso del recurso. |
servedAssetFieldType |
El tipo de campo publicado del recurso. |
ServedAssetFieldType
Los posibles tipos de campo de recursos.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especificó ningún valor. |
UNKNOWN |
En esta versión, se desconoce el valor recibido. Este es un valor de solo respuesta. |
HEADLINE_1 |
El recurso se utiliza en el título 1. |
HEADLINE_2 |
El recurso se utiliza en el título 2. |
HEADLINE_3 |
El recurso se utiliza en el título 3. |
DESCRIPTION_1 |
El recurso se utiliza en la descripción 1. |
DESCRIPTION_2 |
El recurso se utiliza en la descripción 2. |
HEADLINE |
El recurso se utilizó en un título. Usa esta opción solo si el anuncio tiene un solo título. De lo contrario, utiliza las enumeraciones HEADLINE_1, HEADLINE_2 o HEADLINE_3 |
HEADLINE_IN_PORTRAIT |
El recurso se utilizó como título en la imagen vertical. |
LONG_HEADLINE |
El recurso se utilizó en un título largo (empleado en MultiAssetAssetAd). |
DESCRIPTION |
El recurso se utilizó en una descripción. Usa esta opción solo si hay una sola descripción en el anuncio. De lo contrario, utiliza las enumeraciones DESCRIPTION_1 o DESCRIPTION_@ |
DESCRIPTION_IN_PORTRAIT |
El recurso se utilizó como descripción en la imagen vertical. |
BUSINESS_NAME_IN_PORTRAIT |
El recurso se utilizó como nombre de la empresa en la imagen vertical. |
BUSINESS_NAME |
El recurso se utilizó como nombre de la empresa. |
MARKETING_IMAGE |
El recurso se utilizó como imagen de marketing. |
MARKETING_IMAGE_IN_PORTRAIT |
El recurso se utilizó como imagen de marketing en imagen vertical. |
SQUARE_MARKETING_IMAGE |
El recurso se utilizó como imagen de marketing cuadrada. |
PORTRAIT_MARKETING_IMAGE |
El recurso se utilizó como imagen de marketing vertical. |
LOGO |
El recurso se utilizó como logotipo. |
LANDSCAPE_LOGO |
El recurso se utilizó como logotipo horizontal. |
CALL_TO_ACTION |
El recurso se usó como un llamado a la acción. |
YOU_TUBE_VIDEO |
El activo se utilizó como video de YouTube. |
SITELINK |
Este recurso se utiliza como un vínculo a sitio. |
CALL |
Este recurso se utiliza como llamada. |
MOBILE_APP |
Este recurso se usa como aplicación para dispositivos móviles. |
CALLOUT |
Este recurso se utiliza como texto destacado. |
STRUCTURED_SNIPPET |
Este recurso se usa como fragmento estructurado. |
PRICE |
Este recurso se usa como precio. |
PROMOTION |
Este recurso se usa como promoción. |
AD_IMAGE |
Este recurso se utiliza como imagen. |
LEAD_FORM |
El recurso se utiliza como un formulario de clientes potenciales. |
BUSINESS_LOGO |
El recurso se utiliza como un logotipo de la empresa. |
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.
Representación JSON |
---|
{ "resourceName": string, "id": string, "campaign": string, "name": string, "finalUrls": [ string ], "finalMobileUrls": [ string ], "status": enum ( |
Campos | |
---|---|
resourceName |
El nombre del recurso del grupo de recursos. Los nombres de los recursos del grupo de recursos tienen el siguiente formato:
|
id |
El ID del grupo de recursos. |
campaign |
La campaña a la que está asociado este grupo de recursos. El recurso que está vinculado al grupo de recursos. |
name |
Obligatorio. Nombre del grupo de recursos. Obligatorio. Debe tener una longitud mínima de 1 y una máxima de 128. Debe ser único en una campaña. |
finalUrls[] |
Una lista de las URL finales después de todos los redireccionamientos multidominio. De forma predeterminada, en las campañas de máximo rendimiento, las URLs son aptas para la expansión, a menos que se inhabiliten. |
finalMobileUrls[] |
Una lista de las URL finales para dispositivos móviles después de todos los redireccionamientos multidominio. De forma predeterminada, en las campañas de máximo rendimiento, las URLs son aptas para la expansión, a menos que se inhabiliten. |
status |
El estado del grupo de recursos. |
path1 |
Primera parte del texto que puede aparecer anexado a la URL que aparece en el anuncio. |
path2 |
Es la segunda parte del texto que puede aparecer adjunta a la URL que aparece en el anuncio. Este campo solo se puede establecer cuando se establece la ruta 1. |
adStrength |
Es la calidad general del anuncio de este grupo de recursos. |
AssetGroupStatus
Son los estados posibles de un grupo de recursos.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especificó el estado. |
UNKNOWN |
En esta versión, se desconoce el valor recibido. |
ENABLED |
El grupo de recursos está habilitado. |
PAUSED |
El grupo de recursos está detenido. |
REMOVED |
Se quitó el grupo de recursos. |
AdStrength
Es una enumeración que enumera las posibles fortalezas del anuncio.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
Se usa solo para el valor que se muestra. Representa el valor desconocido en esta versión. |
PENDING |
Actualmente, la calidad del anuncio está pendiente. |
NO_ADS |
No se pudo generar ningún anuncio. |
POOR |
Poca fuerza. |
AVERAGE |
Intensidad promedio. |
GOOD |
Buena fuerza. |
EXCELLENT |
Fuerza excelente. |
AssetSetAsset
AssetSetAsset es el vínculo entre un activo y un conjunto de recursos. Cuando se agrega un AssetSetAsset, se vincula un activo con un conjunto de recursos.
Representación JSON |
---|
{
"resourceName": string,
"assetSet": string,
"asset": string,
"status": enum ( |
Campos | |
---|---|
resourceName |
El nombre del recurso del conjunto de recursos. Los nombres de los recursos del conjunto de recursos tienen el siguiente formato:
|
assetSet |
El conjunto de recursos al que está vinculado este recurso del conjunto de recursos. |
asset |
El recurso al que está vinculado este recurso del conjunto de recursos. |
status |
El estado del activo del conjunto de elementos. Solo lectura. |
AssetSetAssetStatus
Son los posibles estados de un activo del conjunto de recursos.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especificó el estado. |
UNKNOWN |
En esta versión, se desconoce el valor recibido. Este es un valor de solo respuesta. |
ENABLED |
El recurso del conjunto de recursos está habilitado. |
REMOVED |
Se quitó el recurso del conjunto de recursos. |
AssetSet
Un conjunto de recursos que representa un conjunto de recursos. Usa AssetSetAsset para vincular un activo al conjunto de recursos.
Representación JSON |
---|
{ "id": string, "resourceName": string } |
Campos | |
---|---|
id |
El ID del conjunto de activos. |
resourceName |
El nombre del recurso del conjunto de recursos. Los nombres de recursos del conjunto de recursos tienen el siguiente formato:
|
BiddingStrategy
Una estrategia de ofertas
Representación JSON |
---|
{ "resourceName": string, "status": enum ( |
Campos | |
---|---|
resourceName |
El nombre del recurso de la estrategia de ofertas. Los nombres de los recursos de la estrategia de ofertas tienen el siguiente formato:
|
status |
El estado de la estrategia de ofertas. Este campo es de solo lectura. |
type |
Es el tipo de estrategia de ofertas. Crea una estrategia de ofertas configurando el esquema de ofertas. Este campo es de solo lectura. |
currencyCode |
Es la moneda que utiliza la estrategia de ofertas (código ISO 4217 de tres letras). Para las estrategias de ofertas en clientes administradores, esta moneda se puede configurar durante la creación y se establece de forma predeterminada en la moneda del cliente administrador. Para brindar servicio a los clientes, este campo no se puede configurar. Todas las estrategias de un cliente de entrega usan de forma implícita la moneda de ese cliente. En todos los casos, el campoeffectiveCurrencyCode muestra la moneda que usó la estrategia. |
id |
El ID de la estrategia de ofertas. |
name |
El nombre de la estrategia de ofertas. Todas las estrategias de ofertas dentro de una cuenta deben tener un nombre distinto. La longitud de esta cadena debe ser de entre 1 y 255, inclusive, en bytes UTF-8 (cortada). |
effectiveCurrencyCode |
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 currencyCode del cliente. Las métricas de la estrategia de ofertas se informan en esta moneda. Este campo es de solo lectura. |
campaignCount |
Es la cantidad de campañas vinculadas a esta estrategia de ofertas. Este campo es de solo lectura. |
nonRemovedCampaignCount |
Es la cantidad de campañas no quitadas que se adjuntan a esta estrategia de ofertas. Este campo es de solo lectura. |
Campo de unión Solo se puede establecer una. |
|
enhancedCpc |
Es una estrategia de ofertas que aumenta las ofertas para los clics que parecen tener más probabilidades de generar una conversión y las disminuye para los clics que parecen menos probables. |
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. |
maximizeConversions |
Una estrategia de ofertas automáticas que te ayudará a obtener la mayor cantidad posible de conversiones para tus campañas sin exceder tu presupuesto. |
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. |
targetImpressionShare |
Es una estrategia de ofertas que realiza optimizaciones automáticamente en función de un porcentaje determinado de impresiones. |
targetOutrankShare |
Es una estrategia de ofertas que establece ofertas según la fracción objetivo de las subastas en las que el anunciante debería tener un ranking superior a un competidor específico. Este campo ya no está disponible. No se podrá crear una estrategia de oferta nueva con este campo o adjuntar estrategias de oferta con este campo a una campaña. Se permiten las mutaciones de las estrategias que ya completaron este esquema. |
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. |
targetSpend |
Es una estrategia de ofertas que establece tus ofertas para ayudarte a obtener la mayor cantidad posible de clics sin exceder tu presupuesto. |
BiddingStrategyStatus
Son los posibles estados de una estrategia de ofertas.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especificó ningún valor. |
UNKNOWN |
En esta versión, se desconoce el valor recibido. Este es un valor de solo respuesta. |
ENABLED |
La estrategia de oferta está habilitada. |
REMOVED |
Se quitó la estrategia de oferta. |
BiddingStrategyType
Es una enumeración que describe los posibles tipos de estrategias de oferta.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
Se usa solo para el valor que se muestra. Representa el valor desconocido en esta versión. |
COMMISSION |
Las comisiones son una estrategia de ofertas automáticas en la que el anunciante paga una parte determinada del valor de conversión. |
ENHANCED_CPC |
El CPC avanzado 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 reduce para los clics que parecen menos probables. |
INVALID |
Se usa solo para el valor que se muestra. Indica que una campaña no tiene una estrategia de ofertas. Esto evita que la campaña publique anuncios. Por ejemplo, es posible que se adjunte una campaña a una estrategia de ofertas de administrador y que, luego, la cuenta de publicación se desvincule de la cuenta de administrador. En este caso, la campaña se desvinculará automáticamente de la estrategia de ofertas de administrador que ahora es inaccesible y cambiará al tipo de estrategia de ofertas NO VÁLIDA. |
MANUAL_CPA |
Es la estrategia de ofertas manuales que permite que el anunciante establezca la oferta por acción específica del anunciante. |
MANUAL_CPC |
Ofertas manuales basadas en clics en las que el usuario paga por clic. |
MANUAL_CPM |
Ofertas manuales basadas en impresiones en las que el usuario paga por cada mil impresiones. |
MANUAL_CPV |
Es una estrategia de ofertas que paga un importe configurable por vista de video. |
MAXIMIZE_CONVERSIONS |
Es una estrategia de ofertas que maximiza automáticamente la cantidad de conversiones según un presupuesto diario. |
MAXIMIZE_CONVERSION_VALUE |
Una estrategia de ofertas automáticas que establece ofertas automáticamente para maximizar los ingresos sin exceder tu presupuesto. |
PAGE_ONE_PROMOTED |
Esquema de ofertas de promoción de la página uno, que establece ofertas de CPC máx. para segmentar impresiones en la primera página o en los espacios promocionados de la primera página en google.com. Este valor de enumeración dejó de estar disponible. |
PERCENT_CPC |
El porcentaje de CPC es una estrategia de ofertas en la que las ofertas son una fracción del precio anunciado de algún bien o servicio. |
TARGET_CPA |
El CPA objetivo 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. |
TARGET_CPM |
El CPM objetivo es una estrategia de ofertas automáticas que establece ofertas para ayudarte a obtener la mayor cantidad posible de impresiones con el costo objetivo por mil impresiones (CPM) que definas. |
TARGET_IMPRESSION_SHARE |
Es una estrategia de ofertas automáticas que establece ofertas para que un porcentaje determinado de anuncios de búsqueda se muestre en la parte superior de la primera página (o en otra ubicación de segmentación). |
TARGET_OUTRANK_SHARE |
El Porcentaje de ranking superior objetivo es una estrategia de ofertas automáticas 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 valor de enumeración dejó de estar disponible. |
TARGET_ROAS |
El ROAS objetivo es una estrategia de ofertas automáticas que te ayuda a maximizar los ingresos y, a la vez, obtener un retorno de la inversión promedio (ROAS) objetivo específico. |
TARGET_SPEND |
La inversión objetivo 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. |
EnhancedCpc
Este tipo no tiene campos.
Es una estrategia de ofertas automáticas que aumenta las ofertas en el caso de los clics que parecen tener más probabilidades de generar una conversión y las disminuye en el caso de los clics que parecen menos probables.
Esta estrategia de ofertas dejó de estar disponible y ya no se puede crear. Usa ManualCpc con EnhancedCpcEnabled configurado como verdadero para obtener una funcionalidad equivalente.
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.
Representación JSON |
---|
{ "cpcBidCeilingMicros": string, "cpcBidFloorMicros": string, "targetRoas": number } |
Campos | |
---|---|
cpcBidCeilingMicros |
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. Solo se puede modificar para las estrategias de oferta de cartera. |
cpcBidFloorMicros |
Es el límite de oferta mínimo que puede establecer la estrategia de ofertas. El límite se aplica a todas las palabras clave administradas por la estrategia. Solo se puede modificar para las estrategias de oferta de cartera. |
targetRoas |
Es la opción de retorno de la inversión publicitaria (ROAS) objetivo. Si se establece, la estrategia de ofertas maximizará los ingresos y, al mismo tiempo, promediará el retorno de la inversión publicitaria objetivo. Si el ROAS objetivo es alto, es posible que la estrategia de ofertas no pueda invertir todo el presupuesto. Si no se establece el ROAS objetivo, la estrategia de ofertas intentará alcanzar el ROAS más alto posible para el presupuesto. |
MaximizeConversions
Una estrategia de ofertas automáticas que te ayudará a obtener la mayor cantidad posible de conversiones para tus campañas sin exceder tu presupuesto.
Representación JSON |
---|
{ "cpcBidCeilingMicros": string, "cpcBidFloorMicros": string, "targetCpaMicros": string } |
Campos | |
---|---|
cpcBidCeilingMicros |
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. Solo se puede modificar para las estrategias de oferta de cartera. |
cpcBidFloorMicros |
Es el límite de oferta mínimo que puede establecer la estrategia de ofertas. El límite se aplica a todas las palabras clave administradas por la estrategia. Solo se puede modificar para las estrategias de oferta de cartera. |
targetCpaMicros |
La opción de costo por acción (CPA) objetivo. Es el importe promedio que desea invertir por acción de conversión especificada en microunidades de la moneda de la estrategia de oferta. Si se establece, la estrategia de ofertas obtendrá la mayor cantidad posible de conversiones sin superar el costo por acción objetivo. Si no se establece el CPA objetivo, la estrategia de ofertas intentará alcanzar el CPA más bajo posible según el presupuesto. |
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.
Representación JSON |
---|
{ "targetCpaMicros": string, "cpcBidCeilingMicros": string, "cpcBidFloorMicros": string } |
Campos | |
---|---|
targetCpaMicros |
Objetivo de CPA promedio. Este objetivo debe ser mayor o igual que la unidad facturable mínima según la moneda de la cuenta. |
cpcBidCeilingMicros |
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. Esto solo se debe establecer para las estrategias de ofertas de cartera. |
cpcBidFloorMicros |
Es el límite de oferta mínimo que puede establecer la estrategia de ofertas. El límite se aplica a todas las palabras clave administradas por la estrategia. Esto solo se debe establecer para las estrategias de ofertas de cartera. |
TargetRoas
Es una estrategia de ofertas automáticas que te ayuda a maximizar los ingresos mientras obtienes un retorno de la inversión publicitaria (ROAS) objetivo específico.
Representación JSON |
---|
{ "targetRoas": number, "cpcBidCeilingMicros": string, "cpcBidFloorMicros": string } |
Campos | |
---|---|
targetRoas |
Obligatorio. Los ingresos elegidos (según los datos de conversiones) por unidad de inversión. El valor debe estar entre 0.01 y 1000.0, inclusive. |
cpcBidCeilingMicros |
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. Esto solo se debe establecer para las estrategias de ofertas de cartera. |
cpcBidFloorMicros |
Es el límite de oferta mínimo que puede establecer la estrategia de ofertas. El límite se aplica a todas las palabras clave administradas por la estrategia. Esto solo se debe establecer para las estrategias de ofertas de cartera. |
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.
Representación JSON |
---|
{ "targetSpendMicros": string, "cpcBidCeilingMicros": string } |
Campos | |
---|---|
targetSpendMicros |
No disponible: Es el objetivo de inversión según el cual se deben maximizar los clics. Un ofertante de TargetSpend intentará gastar la menor cantidad de este valor o el importe de inversión de regulación natural. Si no se especifica, el presupuesto se utiliza como el objetivo de inversión. Este campo está obsoleto y ya no se debe usar. Consulte https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html para obtener más información. |
cpcBidCeilingMicros |
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. |
CampaignBudget
El presupuesto de una campaña
Representación JSON |
---|
{ "resourceName": string, "deliveryMethod": enum ( |
Campos | |
---|---|
resourceName |
El nombre del recurso del presupuesto de la campaña. Los nombres de los recursos de presupuesto de la campaña tienen el siguiente formato:
|
deliveryMethod |
El método de publicación que determina el ritmo al que se invierte el presupuesto de la campaña. El valor predeterminado es STANDARD si no se especifica en una operación de creación. |
period |
Período en el que se debe invertir el presupuesto. El valor predeterminado es DAILY si no se especifica. |
amountMicros |
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. |
BudgetDeliveryMethod
Son los posibles métodos de publicación de un presupuesto.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
Se usa solo para el valor que se muestra. Representa el valor desconocido en esta versión. |
STANDARD |
El servidor de presupuestos limitará la publicación de manera uniforme durante todo el período. |
ACCELERATED |
El servidor de presupuesto no limitará la publicación, y los anuncios se publicarán lo más rápido posible. |
BudgetPeriod
Es el período posible de un presupuesto.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
Se usa solo para el valor que se muestra. Representa el valor desconocido en esta versión. |
DAILY |
Presupuesto diario. |
FIXED_DAILY |
Presupuesto diario fijo |
CUSTOM_PERIOD |
El presupuesto personalizado se puede usar con total_amount para especificar el límite del presupuesto del ciclo de vida del cliente. |
Campaña
Una campaña
Representación JSON |
---|
{ "resourceName": string, "status": enum ( |
Campos | |
---|---|
resourceName |
El nombre del recurso de la campaña. Los nombres de los recursos de la campaña tienen el siguiente formato:
|
status |
El estado de la campaña. Cuando se agrega una nueva campaña, el estado predeterminado es HABILITADO. |
servingStatus |
Es el estado de publicación de anuncios de la campaña. |
biddingStrategySystemStatus |
El estado del sistema de la estrategia de ofertas de la campaña. |
adServingOptimizationStatus |
Es el estado de optimización de la publicación de anuncios de la campaña. |
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 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. |
advertisingChannelSubType |
Perfeccionamiento opcional a Se puede configurar solo cuando se crean campañas. Una vez creada la campaña, no se puede modificar el campo. |
urlCustomParameters[] |
La lista de asignaciones utilizadas para sustituir etiquetas de parámetros personalizados en un |
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. |
networkSettings |
La configuración de red de la campaña. |
dynamicSearchAdsSetting |
Es la configuración para controlar los anuncios dinámicos de búsqueda (DSA). |
shoppingSetting |
Es la configuración para controlar las campañas de Shopping. |
geoTargetTypeSetting |
Es la configuración de la segmentación geográfica de los anuncios. |
labels[] |
Los nombres de recursos de las etiquetas adjuntas a esta campaña. |
biddingStrategyType |
El tipo de estrategia de ofertas. Para crear una estrategia de ofertas, debes establecer el esquema de ofertas para crear una estrategia de ofertas estándar o el campo Este campo es de solo lectura. |
accessibleBiddingStrategy |
Nombre de recurso de AccessibleBiddingStrategy, una vista de solo lectura de los atributos sin restricciones de la estrategia de oferta de cartera adjunta identificada por “BiddingStrategy”. Vacío, si la campaña no utiliza una estrategia de cartera. Los atributos de estrategias sin restricciones están disponibles para todos los clientes con los que se comparte la estrategia y se leen desde el recurso AccessibleBiddingStrategy. En cambio, los atributos restringidos solo están disponibles para el cliente propietario de la estrategia y sus administradores. Los atributos restringidos solo se pueden leer desde el recurso BiddingStrategy. |
frequencyCaps[] |
Una lista que limita la frecuencia con la que cada usuario verá los anuncios de esta campaña. |
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. |
optimizationGoalSetting |
Es la configuración del objetivo de optimización de esta campaña, que incluye un conjunto de tipos de objetivos de optimización. |
trackingSetting |
Configuración a nivel de la campaña para la información de seguimiento. |
engineId |
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". |
excludedParentAssetFieldTypes[] |
Los tipos de campo de recursos que se deben excluir de esta campaña. Esta campaña no heredará desde el nivel superior los vínculos de recursos con estos tipos de campos. |
createTime |
La marca de tiempo de la creación de esta campaña. La marca de tiempo está en la zona horaria del cliente y en “aaaa-MM-dd HH:mm:ss”. de un conjunto de datos tengan un formato común. createTime dejará de estar disponible en la versión 1. En su lugar, usa createTime. |
creationTime |
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”. |
lastModifiedTime |
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 |
El ID de la campaña. |
name |
El nombre de la campaña. Este campo es obligatorio y no debe estar vacío cuando se crean campañas nuevas. No debe contener caracteres nulos (punto de código 0x0), de salto de línea NL (punto de código 0xA) ni de retorno de carro (punto de código 0xD). |
trackingUrlTemplate |
La plantilla de URL para crear una URL de seguimiento. |
campaignBudget |
El presupuesto de la campaña. |
startDate |
La fecha en que comenzó la campaña en la zona horaria del cliente en formato AAAA-MM-DD. |
endDate |
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. |
finalUrlSuffix |
Sufijo que se usa para agregar parámetros de consulta a las páginas de destino que se publican con el seguimiento paralelo. |
urlExpansionOptOut |
Representa la inhabilitación de la expansión de URL a URLs más segmentadas. Si la opción está inhabilitada (verdadero), solo se segmentarán las URLs finales del grupo de recursos o las URLs especificadas en el Google Merchant Center o los feeds de datos de la empresa del anunciante. Si se habilita (false), se segmentará todo el dominio. Este campo solo se puede configurar para las campañas de máximo rendimiento en las que el valor predeterminado es falso. |
Campo de unión Debe ser de cartera (creada a través del servicio BiddingStrategy) o estándar, que está incorporada en la campaña. |
|
biddingStrategy |
Estrategia de oferta de cartera que utiliza la campaña |
manualCpa |
Estrategia de ofertas CPA manuales estándar Es la estrategia de ofertas manuales que permite que el anunciante establezca la oferta por acción específica del anunciante. Solo se admite para las campañas de Servicios Locales. |
manualCpc |
Estrategia de ofertas de CPC manuales estándar Ofertas manuales basadas en clics en las que el usuario paga por clic. |
manualCpm |
Estrategia de ofertas de CPM manuales estándar Ofertas manuales basadas en impresiones en las que el usuario paga por cada mil impresiones. |
maximizeConversions |
Es la estrategia de ofertas estándar Maximizar conversiones que maximiza automáticamente la cantidad de conversiones sin exceder tu presupuesto. |
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. |
targetCpa |
Es la estrategia de ofertas CPA objetivo estándar que establece ofertas automáticamente para ayudarte a obtener la mayor cantidad posible de conversiones con el costo por adquisición (CPA) objetivo que estableciste. |
targetImpressionShare |
Estrategia de ofertas Porcentaje de impresiones objetivo Es una estrategia de ofertas automáticas que establece ofertas para alcanzar un porcentaje determinado de impresiones. |
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. |
targetSpend |
Es la estrategia de ofertas de inversión objetivo estándar que establece tus ofertas automáticamente para ayudarte a obtener la mayor cantidad posible de clics sin exceder tu presupuesto. |
percentCpc |
Es la estrategia de ofertas de CPC de porcentaje estándar en la que las ofertas son una fracción del precio anunciado de algún bien o servicio. |
targetCpm |
Es una estrategia de ofertas que optimiza automáticamente el costo por cada mil impresiones. |
CampaignStatus
Posibles estados de una campaña.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
Se usa solo para el valor que se muestra. Representa el valor desconocido en esta versión. |
ENABLED |
La campaña está activa y puede mostrar anuncios. |
PAUSED |
El usuario detuvo la campaña. |
REMOVED |
Se quitó la campaña. |
CampaignServingStatus
Son los posibles estados de publicación de una campaña.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especificó ningún valor. |
UNKNOWN |
En esta versión, se desconoce el valor recibido. Este es un valor de solo respuesta. |
SERVING |
Entrega. |
NONE |
Ninguno |
ENDED |
Finalizado. |
PENDING |
Pendiente. |
SUSPENDED |
Suspendido. |
BiddingStrategySystemStatus
Indica los posibles estados del sistema de una estrategia de ofertas.
Enumeraciones | |
---|---|
UNSPECIFIED |
Indican que se produjo un error inesperado, por ejemplo, no se encontró ningún tipo de estrategia de ofertas o no se encontró información de estado. |
UNKNOWN |
Se usa solo para el valor que se muestra. Representa el valor desconocido en esta versión. |
ENABLED |
La estrategia de oferta está activa y AdWords no encuentra problemas específicos con la estrategia. |
LEARNING_NEW |
La estrategia de ofertas está aprendiendo porque se creó o reactivó recientemente. |
LEARNING_SETTING_CHANGE |
La estrategia de ofertas está aprendiendo debido a un cambio reciente en la configuración. |
LEARNING_BUDGET_CHANGE |
La estrategia de ofertas está aprendiendo debido a un cambio reciente en el presupuesto. |
LEARNING_COMPOSITION_CHANGE |
La estrategia de ofertas está aprendiendo debido a un cambio reciente en la cantidad de campañas, grupos de anuncios o palabras clave asociados a ella. |
LEARNING_CONVERSION_TYPE_CHANGE |
La estrategia de ofertas depende de los informes de conversiones y el cliente modificó recientemente los tipos de conversión que eran relevantes para la estrategia de ofertas. |
LEARNING_CONVERSION_SETTING_CHANGE |
La estrategia de ofertas depende de los informes de conversiones y el cliente cambió recientemente su configuración de conversiones. |
LIMITED_BY_CPC_BID_CEILING |
La estrategia de ofertas está limitada por su límite de oferta. |
LIMITED_BY_CPC_BID_FLOOR |
La estrategia de oferta está limitada por su oferta mínima. |
LIMITED_BY_DATA |
La estrategia de ofertas está limitada porque no hubo suficiente tráfico de conversiones durante las últimas semanas. |
LIMITED_BY_BUDGET |
Una parte significativa de las palabras clave en esta estrategia de oferta está limitada por el presupuesto. |
LIMITED_BY_LOW_PRIORITY_SPEND |
La estrategia de oferta no puede alcanzar su inversión objetivo porque se le quitó la prioridad de su inversión. |
LIMITED_BY_LOW_QUALITY |
Una fracción significativa de las palabras clave en esta estrategia de oferta tienen un Nivel de calidad bajo. |
LIMITED_BY_INVENTORY |
La estrategia de ofertas no puede invertir todo su presupuesto debido a una segmentación limitada. |
MISCONFIGURED_ZERO_ELIGIBILITY |
Falta el seguimiento de conversiones (no hay pings) ni las listas de remarketing para la SSC. |
MISCONFIGURED_CONVERSION_TYPES |
La estrategia de ofertas depende de los informes de conversiones, y el cliente carece de los tipos de conversión que podrían registrarse con esta estrategia. |
MISCONFIGURED_CONVERSION_SETTINGS |
La estrategia de ofertas depende de los informes de conversiones y la configuración de conversiones del cliente está mal definida. |
MISCONFIGURED_SHARED_BUDGET |
Hay campañas fuera de la estrategia de oferta que comparten presupuestos con campañas incluidas en la estrategia. |
MISCONFIGURED_STRATEGY_TYPE |
La campaña tiene un tipo de estrategia no válido y no se publica. |
PAUSED |
La estrategia de oferta no está activa. No hay campañas, grupos de anuncios ni palabras clave activos asociados a la estrategia de ofertas. O bien, no hay presupuestos activos conectados a la estrategia de ofertas. |
UNAVAILABLE |
Por el momento, esta estrategia de ofertas no admite informes de estado. |
MULTIPLE_LEARNING |
Hubo varios estados del sistema LEARNING_* para esta estrategia de oferta durante el período en cuestión. |
MULTIPLE_LIMITED |
Hubo varios estados del sistema LIMITED_* para esta estrategia de oferta durante el período en cuestión. |
MULTIPLE_MISCONFIGURED |
Hubo varios estados del sistema MISCONFIGURED_* para esta estrategia de oferta durante el período en cuestión. |
MULTIPLE |
Hubo varios estados del sistema para esta estrategia de oferta durante el período en cuestión. |
AdServingOptimizationStatus
Es una enumeración que describe los posibles estados de publicación.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especificó ningún valor. |
UNKNOWN |
En esta versión, se desconoce el valor recibido. Este es un valor de solo respuesta. |
OPTIMIZE |
La publicación de anuncios se optimiza en función de la CTR de la campaña. |
CONVERSION_OPTIMIZE |
La publicación de anuncios se optimiza según la CTR * conversión de la campaña. Si la campaña no se encuentra en la estrategia de oferta del Optimizador de conversiones, se establecerá de forma predeterminada como OPTIMIZED. |
ROTATE |
Los anuncios se rotan de manera uniforme durante 90 días y, luego, se optimizan para obtener clics. |
ROTATE_INDEFINITELY |
Muestra los anuncios de bajo rendimiento de manera más uniforme con los anuncios de mejor rendimiento y no los optimices. |
UNAVAILABLE |
El estado de optimización de la publicación de anuncios no está disponible. |
AdvertisingChannelType
Es una enumeración que describe los distintos tipos de canales de publicidad.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
Se usa solo para el valor que se muestra. Representa el valor desconocido en esta versión. |
SEARCH |
Red de búsqueda. Incluye campañas de Búsqueda+ y en paquetes de Display. |
DISPLAY |
Solo en la Red de Display de Google |
SHOPPING |
Las campañas de Shopping se publican en la propiedad de Shopping y en los resultados de la búsqueda de google.com. |
HOTEL |
de hoteles. |
VIDEO |
Campañas de video. |
MULTI_CHANNEL |
campañas de participación en la aplicación y campañas de participación en la aplicación, que se publican en varios canales. |
LOCAL |
Campañas de anuncios locales. |
SMART |
Campañas inteligentes. |
PERFORMANCE_MAX |
de máximo rendimiento. |
LOCAL_SERVICES |
Campañas de Servicios Locales. |
DISCOVERY |
Campañas discovery. |
TRAVEL |
Campañas de viajes. |
SOCIAL |
Campañas de redes sociales. |
AdvertisingChannelSubType
Es una enumeración que describe los diferentes subtipos de canales.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
Solo se usa como valor de retorno. Representa el valor desconocido en esta versión. |
SEARCH_MOBILE_APP |
Campañas de aplicaciones para dispositivos móviles para la Búsqueda. |
DISPLAY_MOBILE_APP |
Campañas de aplicaciones para dispositivos móviles para la Red de Display. |
SEARCH_EXPRESS |
Campañas de AdWords Express para la búsqueda |
DISPLAY_EXPRESS |
Campañas de AdWords Express para la Red de Display. |
SHOPPING_SMART_ADS |
Campañas de Shopping inteligentes. |
DISPLAY_GMAIL_AD |
Campañas publicitarias de Gmail. |
DISPLAY_SMART_CAMPAIGN |
Campañas inteligentes de la Red de Display. No se pueden crear campañas nuevas de este subtipo. |
VIDEO_OUTSTREAM |
Campañas de video outstream. |
VIDEO_ACTION |
Campañas de video TrueView for Action. |
VIDEO_NON_SKIPPABLE |
Campañas de video con anuncios de video que no se pueden omitir. |
APP_CAMPAIGN |
Campañas de aplicaciones que le permiten promocionar fácilmente su aplicación para Android o iOS en las Propiedades de Google más importantes, incluidas la Búsqueda, Play, YouTube y la Red de Display de Google. |
APP_CAMPAIGN_FOR_ENGAGEMENT |
Campaña de participación en la aplicación, centrada en impulsar la reactivación de la participación con la app en varias de las Propiedades principales de Google, como la Búsqueda, YouTube y la Red de Display de Google. |
LOCAL_CAMPAIGN |
Campañas especializadas para la publicidad local |
SHOPPING_COMPARISON_LISTING_ADS |
Campañas de comparación de productos. |
SMART_CAMPAIGN |
Campañas inteligentes estándares. |
VIDEO_SEQUENCE |
Campañas de video con anuncios de video en secuencia. |
APP_CAMPAIGN_FOR_PRE_REGISTRATION |
Campaña de aplicaciones con registro previo, especializada para publicitar el registro previo de aplicaciones para dispositivos móviles, que se orienta a varios canales de publicidad en Google Play, YouTube y la Red de Display. |
VIDEO_REACH_TARGET_FREQUENCY |
Campaña de alcance de video con estrategia de ofertas de frecuencia objetivo |
TRAVEL_ACTIVITIES |
Campañas de actividades de viajes. |
SOCIAL_FACEBOOK_TRACKING_ONLY |
Facebook solo realiza el seguimiento de las campañas de redes sociales. |
CustomParameter
Una asignación que pueden usar las etiquetas de parámetros personalizados en un trackingUrlTemplate
, finalUrls
o mobile_final_urls
.
Representación JSON |
---|
{ "key": string, "value": string } |
Campos | |
---|---|
key |
La clave que coincide con el nombre de etiqueta del parámetro. |
value |
Valor que se va a sustituir. |
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.
Representación JSON |
---|
{ "optIn": boolean } |
Campos | |
---|---|
optIn |
Si la campaña está habilitada para ofertas en tiempo real |
NetworkSettings
La configuración de red de la campaña.
Representación JSON |
---|
{ "targetGoogleSearch": boolean, "targetSearchNetwork": boolean, "targetContentNetwork": boolean, "targetPartnerSearchNetwork": boolean } |
Campos | |
---|---|
targetGoogleSearch |
Si los anuncios se publicarán con los resultados de la búsqueda de google.com. |
targetSearchNetwork |
Si los anuncios se publicarán en sitios asociados en la Red de Búsqueda de Google (requiere que |
targetContentNetwork |
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. |
targetPartnerSearchNetwork |
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. |
DynamicSearchAdsSetting
Es la configuración para controlar los anuncios dinámicos de búsqueda (DSA).
Representación JSON |
---|
{ "domainName": string, "languageCode": string, "useSuppliedUrlsOnly": boolean } |
Campos | |
---|---|
domainName |
Obligatorio. El nombre de dominio de Internet que representa este parámetro de configuración, por ejemplo, "google.com" o “www.google.com”. |
languageCode |
Obligatorio. Es el código de idioma que especifica el idioma del dominio, por ejemplo, "en". |
useSuppliedUrlsOnly |
Si la campaña utiliza exclusivamente URL proporcionadas por el anunciante. |
ShoppingSetting
Es la configuración de las campañas de Shopping. Define el universo de los productos que puede promocionar la campaña y cómo interactúa esta campaña con otras campañas de Shopping.
Representación JSON |
---|
{ "feedLabel": string, "useVehicleInventory": boolean, "merchantId": string, "salesCountry": string, "campaignPriority": integer, "enableLocal": boolean } |
Campos | |
---|---|
feedLabel |
Etiqueta de feed de los productos que se incluirán en la campaña. Solo se puede establecer una etiqueta feedLabel o salesCountry. Si se usa en lugar de salesCountry, el campo feedLabel 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. |
useVehicleInventory |
Indica si se debe orientar al inventario de fichas de vehículos. |
merchantId |
Es el ID de la cuenta de Merchant Center. Este campo es obligatorio para las operaciones de creación. Este campo es inmutable para las campañas de Shopping. |
salesCountry |
País de venta de los productos que se incluirán en la campaña. |
campaignPriority |
Prioridad de la campaña. Las campañas con prioridades numéricamente más altas tienen prioridad sobre aquellas con prioridades más bajas. Este campo es obligatorio para las campañas de Shopping, con valores entre 0 y 2, inclusive. Este campo es opcional para las campañas de Shopping inteligentes, pero debe ser igual a 3 si se establece. |
enableLocal |
Indica si se deben incluir productos locales. |
GeoTargetTypeSetting
Representa un conjunto de parámetros de configuración relacionados con la segmentación geográfica de los anuncios.
Representación JSON |
---|
{ "positiveGeoTargetType": enum ( |
Campos | |
---|---|
positiveGeoTargetType |
Es la configuración que se utiliza para la segmentación geográfica positiva en esta campaña en particular. |
negativeGeoTargetType |
Es la configuración que se utiliza para la segmentación geográfica negativa en esta campaña en particular. |
PositiveGeoTargetType
Los posibles tipos positivos de segmentación geográfica.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
El valor es desconocido en esta versión. |
PRESENCE_OR_INTEREST |
Especifica que se activa un anuncio si el usuario se encuentra en las ubicaciones de segmentación del anunciante o muestra interés en ellas. |
SEARCH_INTEREST |
Especifica que se activa un anuncio si el usuario busca las ubicaciones de segmentación del anunciante. Esto solo puede utilizarse con campañas de Búsqueda y de Shopping estándares. |
PRESENCE |
Especifica que se activa un anuncio si el usuario se encuentra o suele estar en las ubicaciones de segmentación del anunciante. |
NegativeGeoTargetType
Los posibles tipos de segmentación geográfica negativa.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
El valor es desconocido en esta versión. |
PRESENCE_OR_INTEREST |
Especifica que un usuario no podrá ver el anuncio si se encuentra en las ubicaciones excluidas del anunciante o si muestra interés en ellas. |
PRESENCE |
Especifica que un usuario no podrá ver el anuncio si se encuentra en las ubicaciones excluidas del anunciante. |
FrequencyCapEntry
Este tipo no tiene campos.
Es una regla que especifica la cantidad máxima de veces que un anuncio (o algún conjunto de anuncios) se puede mostrar a un usuario durante un período determinado.
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.
Representación JSON |
---|
{ "conversionActions": [ string ] } |
Campos | |
---|---|
conversionActions[] |
Es el conjunto de acciones de conversión seleccionado para optimizar esta campaña. |
OptimizationGoalSetting
Es la configuración del objetivo de optimización de esta campaña, que incluye un conjunto de tipos de objetivos de optimización.
Representación JSON |
---|
{
"optimizationGoalTypes": [
enum ( |
Campos | |
---|---|
optimizationGoalTypes[] |
Es la lista de tipos de objetivos de optimización. |
OptimizationGoalType
El tipo de objetivo de optimización
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
Solo se usa como valor de retorno. Representa el valor desconocido en esta versión. |
CALL_CLICKS |
Optimizar los clics de llamada Las conversiones por clic de llamada corresponden a la cantidad de veces que las personas seleccionaron "Llamar" para comunicarse con una tienda después de ver un anuncio. |
DRIVING_DIRECTIONS |
Optimiza las rutas en auto. Las conversiones de ruta en auto son las veces que las personas seleccionaron "Cómo llegar" para ir a una tienda después de ver un anuncio. |
APP_PRE_REGISTRATION |
Optimiza el registro previo. Las conversiones de registro previo son la cantidad de registros previos que recibirán una notificación cuando se lance la app. |
TrackingSetting
Configuración a nivel de la campaña para la información de seguimiento.
Representación JSON |
---|
{ "trackingUrl": string } |
Campos | |
---|---|
trackingUrl |
La URL que se usa para el seguimiento dinámico. |
ManualCpa
Este tipo no tiene campos.
Es la estrategia de ofertas manuales que permite que el anunciante establezca la oferta por acción específica del anunciante.
ManualCpc
Ofertas manuales basadas en clics en las que el usuario paga por clic.
Representación JSON |
---|
{ "enhancedCpcEnabled": boolean } |
Campos | |
---|---|
enhancedCpcEnabled |
Si las ofertas deben mejorarse en función de los datos del Optimizador de conversiones. |
ManualCpm
Este tipo no tiene campos.
Ofertas manuales basadas en impresiones en las que el usuario paga por cada mil impresiones.
PercentCpc
Es una estrategia de oferta en la que las ofertas son una fracción del precio anunciado por algún producto o servicio.
Representación JSON |
---|
{ "cpcBidCeilingMicros": string, "enhancedCpcEnabled": boolean } |
Campos | |
---|---|
cpcBidCeilingMicros |
El límite de oferta máximo que se puede establecer con la estrategia de ofertas. Este es un campo opcional que ingresa el anunciante y que se especifica en microsegundos locales. Nota: Un valor cero se interpreta del mismo modo que si el valor de bid_roof no está definido. |
enhancedCpcEnabled |
Ajusta la oferta para cada subasta hacia arriba o hacia abajo, según la probabilidad de que se genere una conversión. Las ofertas individuales pueden exceder cpcBidCeilingMicros, pero el importe promedio de la oferta para una campaña no debería hacerlo. |
TargetCpm
Este tipo no tiene campos.
El CPM (costo por cada mil impresiones) objetivo es una estrategia de ofertas automáticas que establece ofertas para optimizar el rendimiento según el CPM objetivo que definas.
CampaignAsset
Es un vínculo entre una campaña y un recurso.
Representación JSON |
---|
{
"resourceName": string,
"status": enum ( |
Campos | |
---|---|
resourceName |
El nombre del recurso de campaña. Los nombres de los recursos de CampaignAsset tienen el siguiente formato:
|
status |
Estado del recurso de la campaña. |
campaign |
La campaña a la que está vinculado el recurso. |
asset |
El recurso que está vinculado a la campaña. |
CampaignAssetSet
CampaignAssetSet es la vinculación entre una campaña y un conjunto de recursos. Si agregas un CampaignAssetSet, se vincula un conjunto de recursos con una campaña.
Representación JSON |
---|
{
"resourceName": string,
"campaign": string,
"assetSet": string,
"status": enum ( |
Campos | |
---|---|
resourceName |
El nombre del recurso del conjunto de recursos de la campaña. Los nombres de los recursos del conjunto de recursos tienen el siguiente formato:
|
campaign |
La campaña a la que está vinculado este conjunto de recursos. |
assetSet |
Es el conjunto de recursos vinculado a la campaña. |
status |
El estado del recurso del conjunto de recursos de la campaña. Solo lectura. |
CampaignAudienceView
Una vista de público de la campaña Incluye datos de rendimiento de intereses y listas de remarketing para anuncios de la Red de Display y de YouTube, y listas de remarketing para anuncios de búsqueda (RLSA), agregados por campaña y criterio del público. Esta vista solo incluye los públicos adjuntos a nivel de la campaña.
Representación JSON |
---|
{ "resourceName": string } |
Campos | |
---|---|
resourceName |
El nombre del recurso de la vista de público de la campaña. Los nombres de los recursos de vista de público de la campaña tienen el siguiente formato:
|
CampaignCriterion
Un criterio de campaña.
Representación JSON |
---|
{ "resourceName": string, "displayName": string, "type": enum ( |
Campos | |
---|---|
resourceName |
El nombre del recurso del criterio de campaña. Los nombres de recursos de criterio de la campaña tienen el siguiente formato:
|
displayName |
El nombre visible del criterio. Este campo se ignora para las modificaciones. |
type |
El tipo del criterio. |
status |
El estado del criterio. |
lastModifiedTime |
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”. |
criterionId |
El ID del criterio. Este campo se ignora durante la modificación. |
bidModifier |
El modificador de las ofertas cuando coincide el criterio. El modificador debe estar en el rango de 0.1 a 10.0. La mayoría de los tipos de criterios de segmentación admiten modificadores. Usa 0 para inhabilitar un tipo de dispositivo. |
negative |
Indica si se debe orientar ( |
Campo de unión Se debe establecer exactamente uno. |
|
keyword |
Palabra clave. |
location |
Ubicación. |
device |
Dispositivo. |
ageRange |
Rango de edad. |
gender |
Género. |
userList |
Lista de usuarios |
language |
de HashiCorp. |
webpage |
Página web |
locationGroup |
Grupo por ubicación |
CampaignCriterionStatus
Son los estados posibles de un criterio de campaña.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especificó ningún valor. |
UNKNOWN |
En esta versión, se desconoce el valor recibido. Este es un valor de solo respuesta. |
ENABLED |
El criterio de campaña está habilitado. |
PAUSED |
El criterio de la campaña está detenido. |
REMOVED |
Se quitó el criterio de campaña. |
LanguageInfo
Un criterio de lenguaje.
Representación JSON |
---|
{ "languageConstant": string } |
Campos | |
---|---|
languageConstant |
El nombre del recurso de la constante de idioma. |
LocationGroupInfo
Es un radio alrededor de una lista de ubicaciones especificadas a través de un feed.
Representación JSON |
---|
{
"geoTargetConstants": [
string
],
"radiusUnits": enum ( |
Campos | |
---|---|
geoTargetConstants[] |
Constantes de segmentación geográfica que restringen el alcance del área geográfica dentro del feed Actualmente, solo se permite una constante de segmentación geográfica. |
radiusUnits |
Unidad del radio. Las millas y los metros son compatibles con las constantes de objetivos geográficos. Los conjuntos de elementos del feed son compatibles con las millas y los metros. Es obligatorio y se debe establecer en las operaciones CREATE. |
feedItemSets[] |
FeedItemSets cuyos FeedItems se orientan. Si se especifican varios IDs, se segmentan todos los artículos que aparecen en, al menos, un conjunto. Este campo no se puede utilizar con geoTargetConstants. Es opcional y solo se puede establecer en las operaciones CREATE. |
radius |
Es la distancia en unidades que especifica el radio alrededor de las ubicaciones de segmentación. Es obligatorio y se debe establecer en las operaciones CREATE. |
LocationGroupRadiusUnits
La unidad de distancia de radio en un grupo por ubicación (por ejemplo, MILES)
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
Se usa solo para el valor que se muestra. Representa el valor desconocido en esta versión. |
METERS |
Metros |
MILES |
Millas |
MILLI_MILES |
Millas de milisegundos |
CampaignLabel
Representa una relación entre una campaña y una etiqueta.
Representación JSON |
---|
{ "resourceName": string, "campaign": string, "label": string } |
Campos | |
---|---|
resourceName |
Nombre del recurso. Los nombres de los recursos de etiqueta de campaña tienen el siguiente formato: |
campaign |
La campaña a la que se adjuntó la etiqueta |
label |
La etiqueta asignada a la campaña. |
CartDataSalesView
Vista de ventas con datos del carrito
Representación JSON |
---|
{ "resourceName": string } |
Campos | |
---|---|
resourceName |
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: |
Público
El público es una opción de segmentación eficaz que te permite mezclar diferentes atributos de segmentos, como públicos afines y datos demográficos detallados, para crear públicos que representen secciones de tus segmentos objetivo.
Representación JSON |
---|
{ "resourceName": string, "id": string, "name": string, "description": string } |
Campos | |
---|---|
resourceName |
El nombre del recurso del público. Los nombres de los públicos tienen el siguiente formato:
|
id |
Es el ID del público. |
name |
Obligatorio. Es el nombre del público. Debe ser único para todos los públicos. Debe tener una longitud mínima de 1 y una máxima de 255. |
description |
Es la descripción de este público. |
ConversionAction
Una acción de conversión
Representación JSON |
---|
{ "resourceName": string, "creationTime": string, "status": enum ( |
Campos | |
---|---|
resourceName |
El nombre del recurso de la acción de conversión. Los nombres de los recursos de la acción de conversión tienen el siguiente formato:
|
creationTime |
Marca de tiempo de la creación de la actividad de Floodlight, con formato ISO 8601. |
status |
Es el estado de esta acción de conversión para la acumulación de eventos de conversión. |
type |
El tipo de esta acción de conversión. |
category |
Es la categoría de conversiones que se informa para esta acción de conversión. |
valueSettings |
Es la configuración relacionada con el valor de los eventos de conversión asociados a esta acción de conversión. |
attributionModelSettings |
Es la configuración relacionada con el modelo de atribución de esta acción de conversión. |
floodlightSettings |
Configuración de Floodlight para los tipos de conversión de Floodlight. |
id |
El ID de la acción de conversión. |
name |
Es el nombre de la acción de conversión. Este campo es obligatorio y no debe estar vacío cuando se crean acciones de conversión nuevas. |
primaryForGoal |
Si el bit mainForGoal de una acción de conversión es falso, esta acción de conversión no se puede ofertar para ninguna campaña, independientemente de su objetivo de conversión de clientes o de campaña. Sin embargo, los objetivos de conversión personalizados no respetan mainForGoal. Por lo tanto, si una campaña tiene un objetivo de conversión personalizado configurado con una primaryForGoal = falsa, esa acción de conversión aún es apta para oferta. Si no estableces la configuración predeterminada, primaryForGoal será verdadera. En la V9, primaryForGoal solo se puede establecer como false después de que se crea a través de una "update". la operación porque no se declaró como opcional. |
ownerCustomer |
Es el nombre del recurso del cliente propietario de la acción de conversión. Puede ser nulo si se trata de una acción de conversión definida por el sistema. |
includeInClientAccountConversionsMetric |
Si esta acción de conversión debe incluirse en la columna "clientAccountConversions" métrica |
includeInConversionsMetric |
Si esta acción de conversión debe incluirse en la columna "Conversiones" métrica |
clickThroughLookbackWindowDays |
Indica la cantidad máxima de días que pueden transcurrir entre una interacción (por ejemplo, un clic) y un evento de conversión. |
appId |
Es el ID de aplicación de una acción de conversión de aplicación. |
ConversionActionStatus
Son los posibles estados de una acción de conversión.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
Se usa solo para el valor que se muestra. Representa el valor desconocido en esta versión. |
ENABLED |
Se registrarán las conversiones. |
REMOVED |
No se registrarán las conversiones. |
HIDDEN |
No se registrarán las conversiones, y la acción de conversión no aparecerá en la IU. |
ConversionActionType
Tipos posibles de una acción de conversión.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
Se usa solo para el valor que se muestra. Representa el valor desconocido en esta versión. |
AD_CALL |
Conversiones que se producen cuando un usuario hace clic en la extensión de llamada de un anuncio. |
CLICK_TO_CALL |
Conversiones que se producen cuando un usuario en un dispositivo móvil hace clic en un número de teléfono. |
GOOGLE_PLAY_DOWNLOAD |
Conversiones que se producen cuando un usuario descarga una aplicación para dispositivos móviles desde Google Play Store. |
GOOGLE_PLAY_IN_APP_PURCHASE |
Conversiones que se producen cuando un usuario realiza una compra en una app mediante la facturación de Android. |
UPLOAD_CALLS |
Conversiones de llamadas a las que el anunciante hace un seguimiento y que se suben |
UPLOAD_CLICKS |
Conversiones de las que el anunciante hace un seguimiento y que se suben con clics atribuidos |
WEBPAGE |
Son las conversiones que se producen en una página web. |
WEBSITE_CALL |
Conversiones que se producen cuando un usuario llama a un número de teléfono generado de forma dinámica desde el sitio web de un anunciante. |
STORE_SALES_DIRECT_UPLOAD |
Es la conversión de ventas en la tienda basada en cargas de datos de comercios de origen o de terceros. Solo los clientes de la lista de entidades permitidas pueden usar los tipos de cargas directas de ventas en la tienda. |
STORE_SALES |
Son conversiones de ventas en la tienda basadas en cargas de datos de comercios de origen o de terceros, o en compras en la tienda con tarjetas de redes de pagos. Solo los clientes de la lista de entidades permitidas pueden usar los tipos de ventas en la tienda. Solo lectura. |
FIREBASE_ANDROID_FIRST_OPEN |
Conversiones de primer acceso de la aplicación para Android que se registran mediante Firebase |
FIREBASE_ANDROID_IN_APP_PURCHASE |
Conversiones por compras directas desde la aplicación para Android a las que se les hace un seguimiento mediante Firebase |
FIREBASE_ANDROID_CUSTOM |
Se hace un seguimiento de las conversiones personalizadas de la aplicación para Android mediante Firebase. |
FIREBASE_IOS_FIRST_OPEN |
Se hace un seguimiento de las conversiones de primer acceso de la aplicación para iOS a través de Firebase. |
FIREBASE_IOS_IN_APP_PURCHASE |
Las conversiones por compras directas desde la aplicación en la aplicación para iOS a través de Firebase |
FIREBASE_IOS_CUSTOM |
Se hace un seguimiento de las conversiones personalizadas de la aplicación para iOS mediante Firebase. |
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN |
Conversiones de primer acceso de aplicaciones para Android cuyo seguimiento se realiza mediante estadísticas de aplicaciones de terceros |
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE |
Las conversiones por compras directas desde la aplicación en la aplicación para Android a las que se les hace un seguimiento mediante estadísticas de aplicaciones de terceros |
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM |
Se hace un seguimiento de las conversiones personalizadas de las aplicaciones para Android mediante estadísticas de aplicaciones de terceros. |
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN |
Conversiones de primer acceso de aplicaciones para iOS con seguimiento mediante estadísticas de aplicaciones de terceros |
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE |
Las conversiones por compras directas desde la aplicación en aplicaciones para iOS a través de estadísticas de aplicaciones de terceros |
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM |
Se hace un seguimiento de las conversiones personalizadas de aplicaciones para iOS mediante estadísticas de aplicaciones de terceros. |
ANDROID_APP_PRE_REGISTRATION |
Conversiones que se producen cuando un usuario realiza el registro previo de una aplicación para dispositivos móviles en Google Play Store. Solo lectura. |
ANDROID_INSTALLS_ALL_OTHER_APPS |
Conversiones que realizan un seguimiento de todas las descargas de Google Play a las que no se realiza un seguimiento de un tipo específico de aplicación Solo lectura. |
FLOODLIGHT_ACTION |
Actividad de Floodlight que cuenta la cantidad de veces que los usuarios visitaron una página web específica después de ver uno de los anuncios de un anunciante o hacer clic en ellos. Solo lectura. |
FLOODLIGHT_TRANSACTION |
Actividad de Floodlight que hace un seguimiento de la cantidad de ventas realizadas o de artículos comprados. También puede obtener el valor total de cada venta. Solo lectura. |
GOOGLE_HOSTED |
Conversiones que realizan un seguimiento de las acciones locales en los productos y servicios de Google después de interactuar con un anuncio. Solo lectura. |
LEAD_FORM_SUBMIT |
Conversiones que se registran cuando un usuario envía un formulario de clientes potenciales Solo lectura. |
SALESFORCE |
Son las conversiones que provienen de Salesforce. Solo lectura. |
SEARCH_ADS_360 |
Conversiones importadas desde los datos de Floodlight de Search Ads 360. Solo lectura. |
SMART_CAMPAIGN_AD_CLICKS_TO_CALL |
Son las conversiones de llamada que se generan en los anuncios de las campañas inteligentes sin configurar el seguimiento de llamadas y con los criterios personalizados de las campañas inteligentes. Solo lectura. |
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL |
El usuario hace clic en un elemento de llamada dentro de Google Maps. Solo en la campaña inteligente. Solo lectura. |
SMART_CAMPAIGN_MAP_DIRECTIONS |
El usuario solicita instrucciones sobre cómo llegar a la ubicación de una empresa en Google Maps. Solo en la campaña inteligente. Solo lectura. |
SMART_CAMPAIGN_TRACKED_CALLS |
Son las conversiones de llamada que se generan en los anuncios de las campañas inteligentes con la configuración del seguimiento de llamadas y los criterios personalizados de la campaña inteligente. Solo lectura. |
STORE_VISITS |
Conversiones que se producen cuando un usuario visita la tienda minorista de un anunciante. Solo lectura. |
WEBPAGE_CODELESS |
Conversiones creadas a partir de eventos del sitio web (como envíos de formularios o cargas de páginas) que no usan fragmentos de evento codificados de forma individual. Solo lectura. |
UNIVERSAL_ANALYTICS_GOAL |
Conversiones que provienen de objetivos vinculados de Universal Analytics |
UNIVERSAL_ANALYTICS_TRANSACTION |
Conversiones que provienen de transacciones vinculadas de Universal Analytics. |
GOOGLE_ANALYTICS_4_CUSTOM |
Conversiones que provienen de conversiones de eventos personalizados vinculadas de Google Analytics 4. |
GOOGLE_ANALYTICS_4_PURCHASE |
Son las conversiones que provienen de las conversiones por compras vinculadas de Google Analytics 4. |
ConversionActionCategory
Es la categoría de conversiones asociadas con una acción de conversión.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
Se usa solo para el valor que se muestra. Representa el valor desconocido en esta versión. |
DEFAULT |
Categoría predeterminada. |
PAGE_VIEW |
Un usuario visita una página. |
PURCHASE |
Compra, ventas o "pedido realizado" evento. |
SIGNUP |
Acción del usuario de registro. |
LEAD |
Acción para generar clientes potenciales |
DOWNLOAD |
Acción de descarga de software (como para una aplicación) |
ADD_TO_CART |
Agregar artículos a un carrito o una bolsa de compras en el sitio de un anunciante |
BEGIN_CHECKOUT |
Ocurre cuando alguien inicia el proceso de confirmación de la compra en el sitio de un anunciante. |
SUBSCRIBE_PAID |
El inicio de una suscripción pagada de un producto o servicio. |
PHONE_CALL_LEAD |
Una llamada que indica interés en la oferta de un anunciante |
IMPORTED_LEAD |
Una conversión de cliente potencial importada de una fuente externa a Google Ads. |
SUBMIT_LEAD_FORM |
El envío de un formulario en el sitio de un anunciante en el que se indica el interés comercial. |
BOOK_APPOINTMENT |
Es una reserva de una cita con la empresa de un anunciante. |
REQUEST_QUOTE |
Una solicitud de cotización o estimación de precio. |
GET_DIRECTIONS |
Una búsqueda para la ubicación de la empresa de un anunciante con intención de visitar la tienda. |
OUTBOUND_CLICK |
Un clic en el sitio de un socio del anunciante. |
CONTACT |
Una llamada, un SMS, un correo electrónico, un chat o cualquier otro tipo de contacto con un anunciante |
ENGAGEMENT |
Un evento de participación en el sitio web, como un tiempo de sitio prolongado o un objetivo inteligente de Google Analytics (GA). Está destinado a usarse para las importaciones de objetivos de Oro de Google Analytics, Firebase y Google Analytics. |
STORE_VISIT |
Una visita a una tienda física. |
STORE_SALE |
Es una venta que se realiza en una tienda física. |
QUALIFIED_LEAD |
Es una conversión de cliente potencial importada de una fuente externa a Google Ads que el anunciante (equipo de marketing/ventas) calificó. En el recorrido del cliente potencial hasta la venta, los anunciantes obtienen clientes potenciales y, luego, se comunican con los consumidores para actuar en consecuencia. Si el consumidor está interesado y puede terminar comprando su producto, el anunciante marca esos clientes potenciales como "clientes potenciales calificados". |
CONVERTED_LEAD |
Una conversión de cliente potencial importada de una fuente externa a Google Ads, que luego completó una etapa elegida según lo que definió el anunciante que busca generar clientes potenciales. |
ValueSettings
Es la configuración relacionada con el valor de los eventos de conversión asociados a esta acción de conversión.
Representación JSON |
---|
{ "defaultValue": number, "defaultCurrencyCode": string, "alwaysUseDefaultValue": boolean } |
Campos | |
---|---|
defaultValue |
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. |
defaultCurrencyCode |
Es el código de moneda que se debe utilizar cuando los eventos de conversión para esta acción de conversión se envían con un código de moneda no válido o faltante, o cuando esta acción de conversión está configurada para utilizar siempre el valor predeterminado. |
alwaysUseDefaultValue |
Controla si se utilizan el valor y el código de moneda predeterminados en lugar del valor y el código de moneda especificados en los eventos de conversión para esta acción de conversión. |
AttributionModelSettings
Es la configuración relacionada con el modelo de atribución de esta acción de conversión.
Representación JSON |
---|
{ "attributionModel": enum ( |
Campos | |
---|---|
attributionModel |
Es el tipo de modelo de atribución de esta acción de conversión. |
dataDrivenModelStatus |
Es el estado del modelo de atribución basada en datos correspondiente a la acción de conversión. |
AttributionModel
Es el modelo de atribución que describe cómo distribuir el crédito de una conversión específica entre posiblemente muchas interacciones anteriores.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
Se usa solo para el valor que se muestra. Representa el valor desconocido en esta versión. |
EXTERNAL |
Utiliza la atribución externa. |
GOOGLE_ADS_LAST_CLICK |
Atribuye todo el crédito de una conversión a su último clic. |
GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK |
Atribuye todo el crédito de una conversión a su primer clic mediante la atribución de la Búsqueda de Google. |
GOOGLE_SEARCH_ATTRIBUTION_LINEAR |
Atribuye el crédito de una conversión de manera equitativa a todos sus clics mediante la atribución de la Búsqueda de Google. |
GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY |
Atribuye exponencialmente más crédito por una conversión a sus clics más recientes mediante la atribución de la Búsqueda de Google (la semivida es de 1 semana). |
GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED |
Atribuye el 40% del crédito de una conversión a su primer y último clic. El 20% restante se distribuye de manera uniforme entre todos los demás clics. Para ello, se utiliza la atribución de Búsqueda de Google. |
GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN |
Modelo flexible que utiliza el aprendizaje automático para determinar la distribución adecuada del crédito entre los clics mediante la atribución de la Búsqueda de Google. |
DataDrivenModelStatus
Enumera los estados del modelo basado en datos.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
Se usa solo para el valor que se muestra. Representa el valor desconocido en esta versión. |
AVAILABLE |
Hay un modelo basado en datos disponible. |
STALE |
El modelo basado en datos está inactivo. Hace al menos 7 días que no se actualiza. Todavía se está utilizando, pero caducará si no se actualiza durante 30 días. |
EXPIRED |
Venció el modelo basado en datos. No se actualiza durante al menos 30 días y no se puede usar. Por lo general, esto se debe a que no se registró la cantidad necesaria de eventos en un período reciente de 30 días. |
NEVER_GENERATED |
El modelo basado en datos nunca se generó. Por lo general, esto se debe a que nunca hubo la cantidad necesaria de eventos en un período de 30 días. |
FloodlightSettings
Configuración relacionada con una acción de conversión de Floodlight.
Representación JSON |
---|
{ "activityGroupTag": string, "activityTag": string, "activityId": string } |
Campos | |
---|---|
activityGroupTag |
Es la cadena que se usa para identificar un grupo de actividades de Floodlight cuando se informan las conversiones. |
activityTag |
Cadena que se usa para identificar una actividad de Floodlight cuando se informan las conversiones. |
activityId |
ID de la actividad de Floodlight en DoubleClick Campaign Manager (DCM). |
ConversionCustomVariable
Una variable personalizada de conversión. Consulta "Acerca de las métricas y dimensiones personalizadas de Floodlight en la nueva experiencia de Search Ads 360". en https://support.google.com/sa360/answer/13567857.
Representación JSON |
---|
{ "resourceName": string, "id": string, "name": string, "tag": string, "status": enum ( |
Campos | |
---|---|
resourceName |
Es el nombre del recurso de la variable personalizada de conversión. Los nombres de recursos de las variables personalizadas de conversión tienen el siguiente formato:
|
id |
Es el ID de la variable personalizada de conversión. |
name |
Obligatorio. Es el nombre de la variable personalizada de conversión. El nombre debe ser único. La longitud máxima del nombre es de 100 caracteres. No debe haber espacios adicionales antes ni después. |
tag |
Obligatorio. La etiqueta de la variable personalizada de conversión. La etiqueta debe ser única y contener una “u” carácter seguido directamente de un número menor que 100 o igual a 100. Por ejemplo: “u4”. |
status |
Es el estado de la variable personalizada de conversión para la acumulación del evento de conversión. |
ownerCustomer |
Es el nombre del recurso del cliente propietario de la variable personalizada de conversión. |
family |
Familia de la variable personalizada de conversión. |
cardinality |
Cardinalidad de la variable personalizada de conversión. |
floodlightConversionCustomVariableInfo |
Campos para las variables personalizadas de conversiones de Floodlight de Search Ads 360. |
customColumnIds[] |
Son los IDs de las columnas personalizadas que utilizan esta variable personalizada de conversión. |
ConversionCustomVariableStatus
Son los posibles estados de una variable personalizada de conversión.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
Se usa solo para el valor que se muestra. Representa el valor desconocido en esta versión. |
ACTIVATION_NEEDED |
La variable personalizada de conversión está pendiente de activación y no acumulará estadísticas hasta que se establezca como HABILITADA. Este estado no se puede usar en solicitudes CREATE y UPDATE. |
ENABLED |
La variable personalizada de conversión está habilitada y acumulará estadísticas. |
PAUSED |
La variable personalizada de conversión está detenida y no acumulará estadísticas hasta que se vuelva a establecer en HABILITADO. |
ConversionCustomVariableFamily
Familia de una variable personalizada de conversión.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
Se usa solo para el valor que se muestra. Representa el valor desconocido en esta versión. |
STANDARD |
Es la variable personalizada de conversión estándar. Los clientes deben activarla antes de usarla. |
FLOODLIGHT |
Es la variable personalizada de conversión importada desde una variable de Floodlight personalizada. |
ConversionCustomVariableCardinality
Cardinalidad de una variable personalizada de conversión.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
Se usa solo para el valor que se muestra. Representa el valor desconocido en esta versión. |
BELOW_ALL_LIMITS |
La cardinalidad de la variable personalizada de conversión es inferior a todos los límites. La variable se puede usar para la segmentación, y es posible que se acumulen estadísticas para valores nuevos si está habilitada. |
EXCEEDS_SEGMENTATION_LIMIT_BUT_NOT_STATS_LIMIT |
La variable personalizada de conversión tiene una cardinalidad que supera el límite de segmentación, pero no el límite de las estadísticas. Se inhabilitará la segmentación, pero se podrán acumular estadísticas para valores nuevos si la variable está habilitada. |
APPROACHES_STATS_LIMIT |
La variable personalizada de conversión excedió los límites de segmentación y está por alcanzar los límites de estadísticas (> 90%). Se inhabilitará la segmentación, pero se podrán acumular estadísticas para valores nuevos si la variable está habilitada. |
EXCEEDS_STATS_LIMIT |
La variable personalizada de conversión excedió los límites de segmentación y de estadísticas. Se inhabilitará la segmentación, y las estadísticas de las variables habilitadas solo se podrán acumular si los valores existentes ya no aumentan la cardinalidad de la variable. |
FloodlightConversionCustomVariableInfo
Información para las variables personalizadas de conversión de Floodlight de Search Ads 360.
Representación JSON |
---|
{ "floodlightVariableType": enum ( |
Campos | |
---|---|
floodlightVariableType |
Es el tipo de variable de Floodlight definido en Search Ads 360. |
floodlightVariableDataType |
Es el tipo de datos de la variable de Floodlight definido en Search Ads 360. |
FloodlightVariableType
Es el tipo de la variable de Floodlight, como se define en Search Ads 360. Consulte https://support.google.com/searchads/answer/4397154?hl=en para obtener más información.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
Se usa solo para el valor que se muestra. Representa el valor desconocido en esta versión. |
DIMENSION |
Tipo de variable de Floodlight de dimensión. |
METRIC |
Tipo de variable de Floodlight de métrica. |
UNSET |
No se estableció el tipo de variable de Floodlight. |
FloodlightVariableDataType
Es el tipo de datos de la variable de Floodlight, como se define en Search Ads 360. Consulte https://support.google.com/searchads/answer/4397154?hl=en para obtener más información.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
Se usa solo para el valor que se muestra. Representa el valor desconocido en esta versión. |
NUMBER |
Representa una variable de Floodlight de "Number" el tipo de letra. Esta variable puede asignarse a variables de Floodlight de tipos DIMENSION o METRIC. |
STRING |
Representa una variable de Floodlight de "String" el tipo de letra. Esta variable puede asignarse a variables de Floodlight del tipo DIMENSION. |
Cliente
Un cliente.
Representación JSON |
---|
{ "resourceName": string, "conversionTrackingSetting": { object ( |
Campos | |
---|---|
resourceName |
El nombre de recurso del cliente. Los nombres de los recursos del cliente tienen el siguiente formato:
|
conversionTrackingSetting |
Es la configuración del seguimiento de conversiones de un cliente. |
accountType |
Tipo de cuenta de motor, por ejemplo, Google Ads, Microsoft Advertising, Yahoo Japan, Baidu, Facebook, Engine seguimiento de motor, etcétera. |
doubleClickCampaignManagerSetting |
Configuración de DoubleClick Campaign Manager (DCM) para un cliente administrador. |
accountStatus |
Estado de la cuenta (por ejemplo, Habilitada, Detenida, Quitada, etcétera) |
lastModifiedTime |
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”. |
engineId |
ID de la cuenta de la cuenta de motor externa. |
status |
El estado del cliente. |
creationTime |
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 |
El ID del cliente. |
descriptiveName |
Nombre descriptivo no único y opcional del cliente. |
currencyCode |
La moneda en la que opera la cuenta. Se admite un subconjunto de códigos de moneda del estándar ISO 4217. |
timeZone |
El ID de la zona horaria local del cliente. |
trackingUrlTemplate |
La plantilla de URL para crear una URL de seguimiento a partir de parámetros. |
finalUrlSuffix |
La plantilla de URL para agregar parámetros a la URL final. |
autoTaggingEnabled |
Si el etiquetado automático está habilitado para el cliente |
manager |
Si el cliente es un administrador. |
ConversionTrackingSetting
Es una colección de parámetros de configuración para todo el cliente relacionados con el seguimiento de conversiones de Search Ads 360.
Representación JSON |
---|
{
"acceptedCustomerDataTerms": boolean,
"conversionTrackingStatus": enum ( |
Campos | |
---|---|
acceptedCustomerDataTerms |
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. |
conversionTrackingStatus |
Estado del seguimiento de conversiones. Indica si el cliente utiliza el seguimiento de conversiones y quién es el propietario del seguimiento de conversiones de este cliente. Si este cliente utiliza el seguimiento de conversiones de múltiples cuentas, el valor que se muestra variará según el |
enhancedConversionsForLeadsEnabled |
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. |
googleAdsConversionCustomer |
El nombre del recurso del cliente en el que se crean y administran las conversiones. Este campo es de solo lectura. |
conversionTrackingId |
El ID de seguimiento de conversiones utilizado para esta cuenta. Este ID no indica si el cliente utiliza el seguimiento de conversiones (conversionTrackingStatus sí lo hace. Este campo es de solo lectura. |
googleAdsCrossAccountConversionTrackingId |
El ID de seguimiento de conversiones del administrador del cliente. Se establece cuando el cliente habilita el seguimiento de conversiones y anula el parámetro conversionTrackingId. Este campo solo se puede administrar a través de la IU de Google Ads. Este campo es de solo lectura. |
crossAccountConversionTrackingId |
El ID de seguimiento de conversiones del administrador del cliente. Se establece cuando el cliente habilita el seguimiento de conversiones de múltiples cuentas y anula el valor de conversionTrackingId. |
ConversionTrackingStatus
Es el estado del seguimiento de conversiones del cliente.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
Se usa solo para el valor que se muestra. Representa el valor desconocido en esta versión. |
NOT_CONVERSION_TRACKED |
El cliente no utiliza ningún seguimiento de conversiones. |
CONVERSION_TRACKING_MANAGED_BY_SELF |
Este cliente crea y administra las acciones de conversión. |
CONVERSION_TRACKING_MANAGED_BY_THIS_MANAGER |
El administrador especificado en el login-customer-id de la solicitud crea y administra las acciones de conversión. |
CONVERSION_TRACKING_MANAGED_BY_ANOTHER_MANAGER |
Las acciones de conversión las crea y gestiona un administrador diferente del cliente o administrador especificado en el login-customer-id de la solicitud. |
AccountType
Tipos de cuenta de motor posibles.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
Se usa solo para el valor que se muestra. Representa el valor desconocido en esta versión. |
BAIDU |
cuenta de Baidu. |
ENGINE_TRACK |
cuenta de seguimiento de motor. |
FACEBOOK |
Cuenta de Facebook. |
FACEBOOK_GATEWAY |
Cuenta de Facebook administrada a través de la puerta de enlace. |
GOOGLE_ADS |
cuenta de Google Ads. |
MICROSOFT |
cuenta de Microsoft Advertising. |
SEARCH_ADS_360 |
Cuenta de administrador de Search Ads 360. |
YAHOO_JAPAN |
cuenta de Yahoo! Japan. |
DoubleClickCampaignManagerSetting
Configuración de DoubleClick Campaign Manager (DCM) para un cliente administrador.
Representación JSON |
---|
{ "advertiserId": string, "networkId": string, "timeZone": string } |
Campos | |
---|---|
advertiserId |
Es el ID del anunciante de Campaign Manager asociado con este cliente. |
networkId |
ID de la red de Campaign Manager asociada con este cliente. |
timeZone |
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. |
AccountStatus
Posibles estados de una cuenta.
Enumeraciones | |
---|---|
UNSPECIFIED |
Valor predeterminado |
UNKNOWN |
Valor desconocido. |
ENABLED |
La cuenta puede publicar anuncios. |
PAUSED |
El usuario desactiva la cuenta. |
SUSPENDED |
La cuenta se desactiva a través de un proceso interno. |
REMOVED |
La cuenta se desactiva irrevocablemente. |
DRAFT |
La cuenta aún está en proceso de configuración y aún no está HABILITADA. |
CustomerStatus
Posibles estados de un cliente.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
Se usa solo para el valor que se muestra. Representa el valor desconocido en esta versión. |
ENABLED |
Indica que una cuenta activa puede publicar anuncios. |
CANCELED |
Indica que una cuenta cancelada no puede publicar anuncios. Un usuario administrador puede reactivarla. |
SUSPENDED |
Indica que una cuenta suspendida no puede publicar anuncios. Solo el servicio de Atención al cliente de Google puede activarlo. |
CLOSED |
Indica que una cuenta cerrada no puede publicar anuncios. La cuenta de prueba también tendrá el estado CERRADA. El estado es permanente y no se puede volver a abrir. |
CustomerAsset
Un vínculo entre un cliente y un recurso.
Representación JSON |
---|
{
"resourceName": string,
"asset": string,
"status": enum ( |
Campos | |
---|---|
resourceName |
El nombre del recurso del cliente. Los nombres de los recursos CustomerAsset tienen el siguiente formato:
|
asset |
Obligatorio. El recurso que está vinculado al cliente. |
status |
Estado del recurso del cliente. |
CustomerAssetSet
CustomerAssetSet es la vinculación entre un cliente y un conjunto de recursos. Si se agrega un CustomerAssetSet, se vincula un conjunto de recursos con un cliente.
Representación JSON |
---|
{
"resourceName": string,
"assetSet": string,
"customer": string,
"status": enum ( |
Campos | |
---|---|
resourceName |
El nombre del recurso del conjunto de recursos del cliente. Los nombres de los recursos del conjunto de recursos tienen el siguiente formato:
|
assetSet |
Es el conjunto de recursos vinculado al cliente. |
customer |
El cliente al que está vinculado este conjunto de recursos. |
status |
Es el estado del recurso del conjunto de recursos del cliente. Solo lectura. |
AccessibleBiddingStrategy
Representa una vista de las estrategias de ofertas que pertenecen al cliente y que se comparten con él.
A diferencia de la estrategia de ofertas, este recurso incluye estrategias que pertenecen a los administradores del cliente y que se comparten con este, además de estrategias que son propiedad de este cliente. Este recurso no proporciona métricas y solo expone un subconjunto limitado de los atributos de BiddingStrategy.
Representación JSON |
---|
{ "resourceName": string, "id": string, "name": string, "type": enum ( |
Campos | |
---|---|
resourceName |
El nombre del recurso de la estrategia de oferta accesible. Los nombres de los recursos de AccessibleBiddingStrategy tienen el siguiente formato:
|
id |
El ID de la estrategia de ofertas. |
name |
El nombre de la estrategia de ofertas. |
type |
Es el tipo de estrategia de ofertas. |
ownerCustomerId |
El ID del cliente propietario de la estrategia de ofertas. |
ownerDescriptiveName |
descriptiveName del cliente propietario de la estrategia de ofertas. |
Campo de unión Solo se puede establecer una. |
|
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. |
maximizeConversions |
Una estrategia de ofertas automáticas que te ayudará a obtener la mayor cantidad posible de conversiones para tus campañas sin exceder tu presupuesto. |
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. |
targetImpressionShare |
Es una estrategia de ofertas que realiza optimizaciones automáticamente en función de un porcentaje determinado de impresiones. |
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. |
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.
Representación JSON |
---|
{ "targetRoas": number } |
Campos | |
---|---|
targetRoas |
Es la opción de retorno de la inversión publicitaria (ROAS) objetivo. Si se establece, la estrategia de ofertas maximizará los ingresos y, al mismo tiempo, promediará el retorno de la inversión publicitaria objetivo. Si el ROAS objetivo es alto, es posible que la estrategia de ofertas no pueda invertir todo el presupuesto. Si no se establece el ROAS objetivo, la estrategia de ofertas intentará alcanzar el ROAS más alto posible para el presupuesto. |
MaximizeConversions
Una estrategia de ofertas automáticas que te ayudará a obtener la mayor cantidad posible de conversiones para tus campañas sin exceder tu presupuesto.
Representación JSON |
---|
{ "targetCpa": string, "targetCpaMicros": string } |
Campos | |
---|---|
targetCpa |
La opción de costo por adquisición (CPA) objetivo. Es el importe promedio que deseas invertir por adquisición. |
targetCpaMicros |
La opción de costo por adquisición (CPA) objetivo. Es el importe promedio que deseas invertir por adquisición. |
TargetCpa
Es una estrategia de ofertas automáticas que establece ofertas para ayudarte a obtener la mayor cantidad posible de conversiones con el costo por adquisición (CPA) objetivo que estableciste.
Representación JSON |
---|
{ "targetCpaMicros": string } |
Campos | |
---|---|
targetCpaMicros |
Objetivo de CPA promedio. Este objetivo debe ser mayor o igual que la unidad facturable mínima según la moneda de la cuenta. |
TargetRoas
Es una estrategia de ofertas automáticas que te ayuda a maximizar los ingresos mientras obtienes un retorno de la inversión publicitaria (ROAS) objetivo específico.
Representación JSON |
---|
{ "targetRoas": number } |
Campos | |
---|---|
targetRoas |
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.
Representación JSON |
---|
{ "targetSpendMicros": string, "cpcBidCeilingMicros": string } |
Campos | |
---|---|
targetSpendMicros |
El objetivo de inversión en el que se maximizan los clics. Un ofertante de TargetSpend intentará gastar la menor cantidad de este valor o el importe de inversión de regulación natural. Si no se especifica, el presupuesto se utiliza como el objetivo de inversión. Este campo está obsoleto y ya no se debe usar. Consulte https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html para obtener más información. |
cpcBidCeilingMicros |
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. |
CustomerManagerLink
Representa la relación de vinculación entre el cliente y el administrador.
Representación JSON |
---|
{
"resourceName": string,
"status": enum ( |
Campos | |
---|---|
resourceName |
Nombre del recurso. Los nombres de los recursos de CustomerManagerLink tienen el siguiente formato: |
status |
Estado del vínculo entre el cliente y el administrador. |
managerCustomer |
El cliente administrador vinculado al cliente |
managerLinkId |
ID de la vinculación del administrador de clientes. Este campo es de solo lectura. |
startTime |
La marca de tiempo en la que se creó el vínculo CustomerManagerLink. La marca de tiempo se encuentra en la zona horaria del cliente y en el formato “dd-MM-aaaa HH:mm:ss”. |
ManagerLinkStatus
Son los posibles estados de una vinculación.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
Se usa solo para el valor que se muestra. Representa el valor desconocido en esta versión. |
ACTIVE |
Indica la relación en efecto actual. |
INACTIVE |
Indica una relación finalizada |
PENDING |
Indica que el administrador solicitó la relación, pero el cliente aún no las aceptó. |
REFUSED |
El administrador solicitó la relación, pero el cliente se negó. |
CANCELED |
Indica que el administrador solicitó la relación, pero la canceló. |
CustomerClient
Un vínculo entre un cliente determinado y un cliente cliente. CustomerClients solo existen para los clientes administradores. Se incluyen todos los clientes directos e indirectos, así como el propio administrador.
Representación JSON |
---|
{
"resourceName": string,
"appliedLabels": [
string
],
"status": enum ( |
Campos | |
---|---|
resourceName |
El nombre de recurso del cliente. Los nombres de los recursos CustomerClient tienen el siguiente formato: |
appliedLabels[] |
Los nombres de recursos de las etiquetas que son propiedad del cliente solicitante y que se aplican al cliente cliente. Los nombres de recursos de etiquetas tienen el siguiente formato:
|
status |
El estado del cliente. Solo lectura. |
clientCustomer |
El nombre de recurso del cliente-cliente vinculado al cliente determinado. Solo lectura. |
level |
Distancia entre un determinado cliente y un cliente. Para el vínculo propio, el valor del nivel será 0. Solo lectura. |
timeZone |
Representación de cadena del repositorio común de datos de configuración regional (CLDR) de la zona horaria del cliente, por ejemplo, America/Los_Angeles. Solo lectura. |
testAccount |
Identifica si el cliente es una cuenta de prueba. Solo lectura. |
manager |
Identifica si el cliente es un administrador. Solo lectura. |
descriptiveName |
Es un nombre descriptivo para el cliente. Solo lectura. |
currencyCode |
Es el código de moneda (por ejemplo, “USD”, “EUR”) del cliente. Solo lectura. |
id |
El ID de cliente. Solo lectura. |
DynamicSearchAdsSearchTermView
Una vista de los términos de búsqueda de los anuncios dinámicos de búsqueda
Representación JSON |
---|
{ "resourceName": string, "landingPage": string } |
Campos | |
---|---|
resourceName |
El nombre del recurso de la vista del término de búsqueda de los anuncios dinámicos de búsqueda. Los nombres de los recursos de vistas de términos de búsqueda de los anuncios dinámicos de búsqueda tienen el siguiente formato:
|
landingPage |
Es la URL de página de destino de la impresión que se seleccionó de forma dinámica. Este campo es de solo lectura. |
GenderView
Vista de género El recurso genderView refleja el estado de publicación efectivo, en lugar de los criterios que se agregaron. Un grupo de anuncios sin criterios de género se muestra de forma predeterminada para todos los géneros. Por lo tanto, todos los géneros aparecen en genderView con estadísticas.
Representación JSON |
---|
{ "resourceName": string } |
Campos | |
---|---|
resourceName |
El nombre del recurso de la vista de género. Los nombres de los recursos de vista de género tienen el siguiente formato:
|
GeoTargetConstant
Una constante de segmentación geográfica.
Representación JSON |
---|
{
"resourceName": string,
"status": enum ( |
Campos | |
---|---|
resourceName |
El nombre del recurso de la constante de orientación geográfica. Los nombres de recursos de constantes de segmentaciones geográficas tienen el siguiente formato:
|
status |
Estado constante de la segmentación geográfica. |
id |
ID de la constante de orientación geográfica. |
name |
Nombre en inglés de la constante de la segmentación geográfica. |
countryCode |
Es el código de país ISO-3166-1 alpha-2 que está asociado con el objetivo. |
targetType |
Tipo de objetivo constante de segmentación geográfica. |
canonicalName |
Es el nombre en inglés completamente calificado, que consta del nombre del objetivo, el de su elemento superior y su país. |
parentGeoTarget |
El nombre del recurso de la constante superior de orientación geográfica. Los nombres de recursos de constantes de segmentaciones geográficas tienen el siguiente formato:
|
GeoTargetConstantStatus
Los posibles estados de una constante de segmentación geográfica.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especificó ningún valor. |
UNKNOWN |
En esta versión, se desconoce el valor recibido. Este es un valor de solo respuesta. |
ENABLED |
La constante de orientación geográfica es válida. |
REMOVAL_PLANNED |
La constante de segmentación geográfica es obsoleta y se quitará. |
KeywordView
Una vista de palabras clave
Representación JSON |
---|
{ "resourceName": string } |
Campos | |
---|---|
resourceName |
El nombre del recurso de la vista de palabras clave. Los nombres de los recursos de vista de palabras clave tienen el siguiente formato:
|
Etiqueta
Una etiqueta.
Representación JSON |
---|
{ "resourceName": string, "status": enum ( |
Campos | |
---|---|
resourceName |
Nombre del recurso. Los nombres de recursos de etiquetas tienen el siguiente formato: |
status |
Estado de la etiqueta. Solo lectura. |
textLabel |
Un tipo de etiqueta que muestra texto sobre un fondo de color. |
id |
Es el ID de la etiqueta. Solo lectura. |
name |
El nombre de la etiqueta. Este campo es obligatorio y no debe estar vacío durante la creación de una etiqueta nueva. La longitud de esta cadena debe ser de entre 1 y 80, inclusive. |
LabelStatus
Posibles estados de una etiqueta.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
Se usa solo para el valor que se muestra. Representa el valor desconocido en esta versión. |
ENABLED |
La etiqueta está habilitada. |
REMOVED |
Se quitó la etiqueta. |
TextLabel
Un tipo de etiqueta que muestra texto sobre un fondo de color.
Representación JSON |
---|
{ "backgroundColor": string, "description": string } |
Campos | |
---|---|
backgroundColor |
Color de fondo de la etiqueta en formato hexadecimal. Esta cadena debe coincidir con la expresión regular '^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$'. Nota: Es posible que el color de fondo no sea visible para las cuentas de administrador. |
description |
Una descripción breve de la etiqueta. La longitud no debe superar los 200 caracteres. |
LanguageConstant
Un idioma.
Representación JSON |
---|
{ "resourceName": string, "id": string, "code": string, "name": string, "targetable": boolean } |
Campos | |
---|---|
resourceName |
El nombre del recurso de la constante de lenguaje. Los nombres de recursos de constantes de lenguaje tienen el siguiente formato:
|
id |
Es el ID de la constante de lenguaje. |
code |
El código de idioma, por ejemplo, "en_US", "en_AU", "es", "fr", etcétera |
name |
El nombre completo del idioma en inglés, por ejemplo, "inglés (EE.UU.)", "español", etcétera |
targetable |
Si el idioma se puede orientar. |
LocationView
Una vista de ubicación resume el rendimiento de las campañas en función de un criterio de ubicación.
Representación JSON |
---|
{ "resourceName": string } |
Campos | |
---|---|
resourceName |
El nombre del recurso de la vista de ubicación. Los nombres de los recursos de la vista de ubicación tienen el siguiente formato:
|
ProductBiddingCategoryConstant
Una categoría de ofertas de productos
Representación JSON |
---|
{ "resourceName": string, "level": enum ( |
Campos | |
---|---|
resourceName |
El nombre del recurso de la categoría de ofertas de productos. Los nombres de recursos de las categorías de ofertas de productos tienen el siguiente formato:
|
level |
Es el nivel de la categoría de ofertas de productos. |
status |
Es el estado de la categoría de ofertas de productos. |
id |
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. |
countryCode |
Es el código de país de dos letras mayúsculas de la categoría de ofertas de productos. |
productBiddingCategoryConstantParent |
El nombre del recurso de la categoría de ofertas del producto superior. |
languageCode |
Es el código de idioma de la categoría de ofertas de productos. |
localizedName |
Muestra el valor de la categoría de ofertas de productos localizada según languageCode. |
ProductBiddingCategoryLevel
Es una enumeración que describe el nivel de la categoría de ofertas de productos.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
Se usa solo para el valor que se muestra. Representa el valor desconocido en esta versión. |
LEVEL1 |
Nivel 1. |
LEVEL2 |
Nivel 2. |
LEVEL3 |
Nivel 3. |
LEVEL4 |
Nivel 4. |
LEVEL5 |
Nivel 5. |
ProductBiddingCategoryStatus
Es una enumeración que describe el estado de la categoría de ofertas de productos.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
Se usa solo para el valor que se muestra. Representa el valor desconocido en esta versión. |
ACTIVE |
La categoría está activa y se puede usar para establecer ofertas. |
OBSOLETE |
La categoría es obsoleta. Solo se usa para generar informes. |
ProductGroupView
Una vista de grupo de productos
Representación JSON |
---|
{ "resourceName": string } |
Campos | |
---|---|
resourceName |
El nombre del recurso de la vista del grupo de productos. Los nombres de recursos de la vista de grupos de productos tienen el siguiente formato:
|
ShoppingPerformanceView
Vista del rendimiento de Shopping. Proporciona estadísticas agregadas de las campañas de Shopping en varios niveles de dimensiones de producto. Los valores de las dimensiones del producto de Merchant Center, como marca, categoría, atributos personalizados, estado del producto y tipo de producto, reflejarán el estado de cada dimensión a partir de la fecha y hora en que se registró el evento correspondiente.
Representación JSON |
---|
{ "resourceName": string } |
Campos | |
---|---|
resourceName |
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: |
UserList
Una lista de usuarios Se trata de una lista de usuarios a los que se puede orientar un cliente.
Representación JSON |
---|
{
"resourceName": string,
"type": enum ( |
Campos | |
---|---|
resourceName |
El nombre del recurso de la lista de usuarios. Los nombres de los recursos de la lista de usuarios tienen el siguiente formato:
|
type |
Es el tipo de esta lista. Este campo es de solo lectura. |
id |
Es el ID de la lista de usuarios. |
name |
Es el nombre de esta lista de usuarios. Según su access_reason, el nombre de la lista de usuarios puede no ser único (por ejemplo, si access_reason=SHARED). |
UserListType
Enumeración que contiene posibles tipos de listas de usuarios.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
Se usa solo para el valor que se muestra. Representa el valor desconocido en esta versión. |
REMARKETING |
UserList representada como un conjunto de tipos de conversión. |
LOGICAL |
UserList representada como una combinación de otras listas de usuarios o intereses |
EXTERNAL_REMARKETING |
Lista de usuarios creada en la plataforma de Google Ad Manager. |
RULE_BASED |
UserList asociada con una regla. |
SIMILAR |
UserList con usuarios similares a los usuarios de otra UserList |
CRM_BASED |
Lista de usuarios con datos de origen de CRM que proporciona el anunciante en forma de correos electrónicos y otros formatos. |
WebpageView
Una vista de página web
Representación JSON |
---|
{ "resourceName": string } |
Campos | |
---|---|
resourceName |
El nombre del recurso de la vista de página web. Los nombres de los recursos de vista de página web tienen el siguiente formato:
|
Visitar
Una visita.
Representación JSON |
---|
{ "resourceName": string, "id": string, "criterionId": string, "merchantId": string, "adId": string, "clickId": string, "visitDateTime": string, "productId": string, "productChannel": enum ( |
Campos | |
---|---|
resourceName |
El nombre del recurso de la visita. Los nombres de los recursos de visitas tienen el siguiente formato:
|
id |
Es el ID de la visita. |
criterionId |
ID de palabra clave de Search Ads 360. El valor 0 indica que la palabra clave no tiene atribución. |
merchantId |
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. |
adId |
ID del anuncio Un valor de 0 indica que el anuncio no se atribuye. |
clickId |
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 |
visitDateTime |
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”. |
productId |
El ID del producto en el que se hizo clic. |
productChannel |
El canal de ventas del producto en el que se hizo clic: en línea o local. |
productLanguageCode |
El idioma (ISO-639-1) que se configuró para el feed de Merchant Center que contiene datos sobre el producto. |
productStoreId |
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. |
productCountryCode |
Indica el país (formato ISO-3166) registrado para el feed de inventario que contiene el producto en el que se hizo clic. |
assetId |
ID del recurso con el que se interactuó durante el evento de visita. |
assetFieldType |
Es el tipo de campo del recurso del evento de visita. |
ProductChannel
Es una enumeración que describe la localidad de la oferta de un producto.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
Se usa solo para el valor que se muestra. Representa el valor desconocido en esta versión. |
ONLINE |
El artículo se vende en línea. |
LOCAL |
El artículo se vende en tiendas locales. |
Conversión
Una conversión.
Representación JSON |
---|
{ "resourceName": string, "id": string, "criterionId": string, "merchantId": string, "adId": string, "clickId": string, "visitId": string, "advertiserConversionId": string, "productId": string, "productChannel": enum ( |
Campos | |
---|---|
resourceName |
El nombre del recurso de la conversión. Los nombres de los recursos de conversión tienen el siguiente formato:
|
id |
El ID de la conversión. |
criterionId |
ID de criterio de Search Ads 360. Un valor de 0 indica que el criterio no se atribuye. |
merchantId |
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. |
adId |
ID del anuncio Un valor de 0 indica que el anuncio no se atribuye. |
clickId |
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. |
visitId |
Indica el ID de visita de Search Ads 360 al que se atribuye la conversión. |
advertiserConversionId |
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, el valor es igual a la columna id o a la columna FloodlightOrderId, según las instrucciones de Floodlight del anunciante. |
productId |
El ID del producto en el que se hizo clic. |
productChannel |
El canal de ventas del producto en el que se hizo clic: en línea o local. |
productLanguageCode |
El idioma (ISO-639-1) que se configuró para el feed de Merchant Center que contiene datos sobre el producto. |
productStoreId |
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. |
productCountryCode |
Indica el país (formato ISO-3166) registrado para el feed de inventario que contiene el producto en el que se hizo clic. |
attributionType |
A qué se atribuye la conversión: visita o palabra clave+anuncio. |
conversionDateTime |
La marca de tiempo del evento de conversión. |
conversionLastModifiedDateTime |
Es la marca de tiempo de la última vez que se modificó la conversión. |
conversionVisitDateTime |
Es la marca de tiempo de la visita a la que se atribuye la conversión. |
conversionQuantity |
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. |
conversionRevenueMicros |
Los ingresos ajustados en micros para el evento de conversión. Siempre se mostrará en la moneda de la cuenta de entrega. |
floodlightOriginalRevenue |
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. |
floodlightOrderId |
Es el ID de pedido de Floodlight que proporciona el anunciante para la conversión. |
status |
El estado de la conversión, ya sea HABILITADA o QUITADA. |
assetId |
Es el ID del recurso con el que se interactuó durante el evento de conversión. |
assetFieldType |
Es el tipo de campo del recurso del evento de conversión. |
AttributionType
Tipo de atribución de conversiones en SearchAds360
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
Se usa solo para el valor que se muestra. Representa el valor desconocido en esta versión. |
VISIT |
La conversión se atribuye a una visita. |
CRITERION_AD |
La conversión se atribuye a un criterio y a un par de anuncios. |
ConversionStatus
Posibles estados de una conversión.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
Se usa solo para el valor que se muestra. Representa el valor desconocido en esta versión. |
ENABLED |
La conversión está habilitada. |
REMOVED |
Se quitó la conversión. |
Métricas
Datos de métricas.
Representación JSON |
---|
{ "allConversionsValueByConversionDate": number, "allConversionsByConversionDate": number, "conversionCustomMetrics": [ { object ( |
Campos | |
---|---|
allConversionsValueByConversionDate |
El valor de todas las conversiones. Cuando esta columna se selecciona con fecha, los valores en la columna Fecha se refieren a la fecha de conversión. Los detalles de las columnas by_conversion_date están disponibles en https://support.google.com/sa360/answer/9250611. |
allConversionsByConversionDate |
La cantidad total de conversiones. Esto incluye todas las conversiones, independientemente del valor de includeInConversionsMetric. Cuando esta columna se selecciona con fecha, los valores en la columna Fecha se refieren a la fecha de conversión. Los detalles de las columnas by_conversion_date están disponibles en https://support.google.com/sa360/answer/9250611. |
conversionCustomMetrics[] |
Las métricas personalizadas de conversiones. |
conversionsValueByConversionDate |
Es la suma del valor de conversiones aptas para ofertas según la fecha de conversión. Cuando esta columna se selecciona con fecha, los valores en la columna Fecha se refieren a la fecha de conversión. |
conversionsByConversionDate |
Es la suma de conversiones por fecha de conversión para los tipos de conversión aptos para ofertas. Puede ser fraccionario debido al modelado de atribución. Cuando esta columna se selecciona con fecha, los valores en la columna Fecha se refieren a la fecha de conversión. |
historicalCreativeQualityScore |
Es el nivel de calidad histórico de la creatividad. |
historicalLandingPageQualityScore |
La calidad de la experiencia histórica en la página de destino. |
historicalSearchPredictedCtr |
La tasa de clics (CTR) prevista de la búsqueda histórica. |
interactionEventTypes[] |
Los tipos de interacciones pagas y gratuitas. |
rawEventConversionMetrics[] |
Las métricas de conversión de eventos sin procesar |
absoluteTopImpressionPercentage |
El porcentaje de impresiones en la parte superior absoluta de la página de búsqueda es el porcentaje de tus impresiones de anuncios de búsqueda que se muestran en la posición más destacada de la Búsqueda. |
allConversionsFromInteractionsRate |
Todas las conversiones generadas a partir de interacciones (en lugar de las conversiones posimpresión) divididas por la cantidad de interacciones con el anuncio. |
allConversionsValue |
El valor de todas las conversiones. |
allConversions |
La cantidad total de conversiones. Esto incluye todas las conversiones, independientemente del valor de includeInConversionsMetric. |
allConversionsValuePerCost |
Es el valor de todas las conversiones dividido por el costo total de las interacciones con el anuncio (como los clics en los anuncios de texto o las vistas de los anuncios de video). |
allConversionsFromClickToCall |
La cantidad de veces que los usuarios hicieron clic en el botón "Llamar" para llamar a una tienda mientras hace clic en un anuncio o después de hacerlo. Este número no incluye si se conectaron las llamadas ni su duración. Esta métrica solo se aplica a los elementos del feed. |
allConversionsFromDirections |
La cantidad de veces que los usuarios hicieron clic en la opción "Cómo llegar" para navegar a una tienda después de hacer clic en un anuncio. Esta métrica solo se aplica a los elementos del feed. |
allConversionsFromInteractionsValuePerInteraction |
Es el valor de todas las conversiones generadas a partir de interacciones dividido por la cantidad total de interacciones. |
allConversionsFromMenu |
Indica la cantidad de veces que los usuarios hicieron clic en un vínculo para ver el menú de una tienda después de hacer clic en un anuncio. Esta métrica solo se aplica a los elementos del feed. |
allConversionsFromOrder |
Indica la cantidad de veces que las personas realizaron un pedido en una tienda después de hacer clic en un anuncio. Esta métrica solo se aplica a los elementos del feed. |
allConversionsFromOtherEngagement |
Indica la cantidad de conversiones (por ejemplo, publicar una opinión o guardar la ubicación de una tienda) que se produjeron después de que los usuarios hicieron clic en un anuncio. Esta métrica solo se aplica a los elementos del feed. |
allConversionsFromStoreVisit |
Es la cantidad estimada de veces que las personas visitaron una tienda después de hacer clic en un anuncio. Esta métrica solo se aplica a los elementos del feed. |
visits |
Clics que Search Ads 360 registró y reenvió de forma correcta a la página de destino de un anunciante. |
allConversionsFromStoreWebsite |
Es la cantidad de veces que se redireccionó a los usuarios a la URL de una tienda después de hacer clic en un anuncio. Esta métrica solo se aplica a los elementos del feed. |
averageCost |
Indica el importe promedio que pagas por cada interacción. Para obtener este importe, se divide el costo total de tus anuncios por la cantidad total de interacciones. |
averageCpc |
El costo total de todos los clics dividido por la cantidad total de clics recibidos. Esta métrica es un valor monetario y se muestra en la moneda del cliente de forma predeterminada. Consulta el parámetro metrics_currency en https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
averageCpm |
Costo por cada mil impresiones (CPM) promedio. Esta métrica es un valor monetario y se muestra en la moneda del cliente de forma predeterminada. Consulta el parámetro metrics_currency en https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
clicks |
La cantidad de clics. |
contentBudgetLostImpressionShare |
Es el porcentaje estimado de veces que tu anuncio podía publicarse en la Red de Display, pero no se mostró porque tu presupuesto era demasiado bajo. Nota: El porcentaje de impresiones perdidas del presupuesto de contenido se informa en el rango de 0 a 0.9. Cualquier valor superior a 0.9 se informa como 0.9001. |
contentImpressionShare |
Es la cantidad de impresiones que recibiste en la Red de Display dividida por la cantidad estimada de impresiones que podrías haber recibido. Nota: El porcentaje de impresiones de contenido se informa en un rango de 0.1 a 1. Cualquier valor inferior a 0.1 se informa como 0.0999. |
contentRankLostImpressionShare |
El porcentaje estimado de impresiones en la Red de Display que no recibieron tus anuncios debido a un ranking del anuncio bajo. Nota: El porcentaje de impresiones perdidas de clasificación del contenido se informa en un rango de 0 a 0.9. Cualquier valor superior a 0.9 se informa como 0.9001. |
conversionsFromInteractionsRate |
Conversiones promedio aptas para ofertas (provenientes de las interacciones) por interacción apta para la conversión. Muestra la frecuencia promedio con la que una interacción con el anuncio genera una conversión apta para ofertas. |
clientAccountConversionsValue |
El valor de las conversiones de la cuenta de cliente. Esto solo incluye las acciones de conversión que incluyen el atributo includeInClientAccountConversionsMetric establecido en verdadero. Si usas ofertas basadas en conversiones, tus estrategias de ofertas se optimizarán para estas conversiones. |
conversionsValuePerCost |
Es el valor de las conversiones aptas para ofertas dividido por el costo total de las interacciones aptas para las conversiones. |
conversionsFromInteractionsValuePerInteraction |
Es el valor de las conversiones generadas a partir de interacciones dividido por la cantidad de interacciones con el anuncio. Esto solo incluye las acciones de conversión con el atributo includeInConversionsMetric configurado como verdadero. Si usas ofertas basadas en conversiones, tus estrategias de ofertas se optimizarán para estas conversiones. |
clientAccountConversions |
La cantidad de conversiones de la cuenta de cliente. Esto solo incluye las acciones de conversión que incluyen el atributo includeInClientAccountConversionsMetric establecido en verdadero. Si usas ofertas basadas en conversiones, tus estrategias de ofertas se optimizarán para estas conversiones. |
costMicros |
La suma del costo por clic (CPC) y el costo por cada mil impresiones (CPM) durante este período. Esta métrica es un valor monetario y se muestra en la moneda del cliente de forma predeterminada. Consulta el parámetro metrics_currency en https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
costPerAllConversions |
Es el costo de las interacciones con anuncios dividido por todas las conversiones. |
costPerConversion |
Costo por conversión apta para ofertas promedio. |
costPerCurrentModelAttributedConversion |
Es el costo de las interacciones con anuncios dividido por las conversiones atribuidas del modelo actual. Esto solo incluye las acciones de conversión con el atributo includeInConversionsMetric configurado como verdadero. Si usas ofertas basadas en conversiones, tus estrategias de ofertas se optimizarán para estas conversiones. |
crossDeviceConversions |
Conversiones que se generan cuando un cliente hace clic en un anuncio en un dispositivo y, luego, genera una conversión en otro dispositivo o navegador. Las conversiones en dispositivos múltiples ya se incluyen en todas las conversiones. |
crossDeviceConversionsValue |
Es la suma del valor de las conversiones en dispositivos múltiples. |
ctr |
La cantidad de clics que recibe tu anuncio (clics) dividida por la cantidad de veces que se muestra tu anuncio (impresiones). |
conversions |
La cantidad de conversiones. Esto solo incluye las acciones de conversión con el atributo includeInConversionsMetric configurado como verdadero. Si usas ofertas basadas en conversiones, tus estrategias de ofertas se optimizarán para estas conversiones. |
conversionsValue |
Es la suma de los valores de conversión de las conversiones incluidas en el campo "conversiones". Esta métrica es útil solo si ingresó un valor para sus acciones de conversión. |
averageQualityScore |
Es el nivel de calidad promedio. |
historicalQualityScore |
El historial del nivel de calidad. |
impressions |
Recuento de la frecuencia con la que tu anuncio apareció en una página de resultados de búsqueda o en un sitio web en la Red de Google. |
interactionRate |
Es la frecuencia con la que los usuarios interactúan con su anuncio después de verlo. Es la cantidad de interacciones dividida por la cantidad de veces que se muestra su anuncio. |
interactions |
Es la cantidad de interacciones. Una interacción es la acción principal de un usuario asociada con el formato de un anuncio: los clics en los anuncios de texto y de Shopping, las vistas de los anuncios de video, etcétera. |
invalidClickRate |
Es el porcentaje de clics filtrados de la cantidad total de clics (clics filtrados y no filtrados) durante el período del informe. |
invalidClicks |
Es la cantidad de clics que Google considera ilegítimos y por los que no se le cobra. |
mobileFriendlyClicksPercentage |
Es el porcentaje de clics desde dispositivos móviles que dirigen a una página optimizada para dispositivos móviles. |
searchAbsoluteTopImpressionShare |
Es el porcentaje de impresiones de anuncios de Shopping o de búsqueda del cliente que se muestran en la posición más destacada de Shopping. Para obtener más información, consulta https://support.google.com/sa360/answer/9566729. Cualquier valor inferior a 0.1 se informa como 0.0999. |
searchBudgetLostAbsoluteTopImpressionShare |
Es la cifra que calcula la frecuencia con la que tu anuncio no se mostró en el primer lugar entre los anuncios en la parte superior de los resultados de la búsqueda debido a un presupuesto bajo. Nota: El porcentaje de impresiones perdidas en la parte superior absoluta de la página del presupuesto de búsqueda se informa en un rango de 0 a 0.9. Cualquier valor superior a 0.9 se informa como 0.9001. |
searchBudgetLostImpressionShare |
El porcentaje estimado de veces que tu anuncio era apto para mostrarse en la Red de Búsqueda, pero no lo hizo porque tu presupuesto era demasiado bajo. Nota: El porcentaje de impresiones perdidas del presupuesto de búsqueda se informa en un rango de 0 a 0.9. Cualquier valor superior a 0.9 se informa como 0.9001. |
searchBudgetLostTopImpressionShare |
Es la cifra que calcula la frecuencia con la que tu anuncio no se mostró junto a los principales resultados de la búsqueda orgánica debido a un presupuesto bajo. Nota: El porcentaje de impresiones perdidas en la parte superior de la página del presupuesto de búsqueda se informa en un rango de 0 a 0.9. Cualquier valor superior a 0.9 se informa como 0.9001. |
searchClickShare |
La cantidad de clics que recibió en la Red de Búsqueda dividida por la cantidad estimada de clics que podría haber recibido. Nota: El porcentaje de clics de búsqueda se informa en un rango de 0.1 a 1. Cualquier valor inferior a 0.1 se informa como 0.0999. |
searchExactMatchImpressionShare |
Es la cantidad de impresiones que recibió dividida por la cantidad estimada de impresiones que podría haber recibido en la Red de Búsqueda para los términos de búsqueda que coincidieron de manera exacta con sus palabras clave (o que eran variantes cercanas de su palabra clave), independientemente de sus tipos de concordancia de palabras clave. Nota: El porcentaje de impresiones de concordancia exacta de la búsqueda se informa en el rango de 0.1 a 1. Cualquier valor inferior a 0.1 se informa como 0.0999. |
searchImpressionShare |
Es la cantidad de impresiones que recibiste en la Red de Búsqueda dividida por la cantidad estimada de impresiones que podrías haber recibido. Nota: El porcentaje de impresiones de búsqueda se informa en un rango de 0.1 a 1. Cualquier valor inferior a 0.1 se informa como 0.0999. |
searchRankLostAbsoluteTopImpressionShare |
Es la cifra que calcula la frecuencia con la que tu anuncio no se mostró en el primer lugar entre los anuncios en la parte superior de la página en los resultados de la búsqueda debido a un ranking del anuncio bajo. Nota: El porcentaje de impresiones perdidas en la parte superior absoluta de la página de clasificación de búsqueda se informa en un rango de 0 a 0.9. Cualquier valor superior a 0.9 se informa como 0.9001. |
searchRankLostImpressionShare |
Es el porcentaje estimado de impresiones en la Red de Búsqueda que tus anuncios no recibieron debido a un ranking del anuncio bajo. Nota: El porcentaje de impresiones perdidas de la clasificación de búsqueda se informa en un rango de 0 a 0.9. Cualquier valor superior a 0.9 se informa como 0.9001. |
searchRankLostTopImpressionShare |
Es la cifra que calcula la frecuencia con la que tu anuncio no se mostró junto a los principales resultados de la búsqueda orgánica debido a un ranking del anuncio bajo. Nota: El porcentaje de impresiones perdidas en la parte superior de la página de clasificación de búsqueda se informa en un rango de 0 a 0.9. Cualquier valor superior a 0.9 se informa como 0.9001. |
searchTopImpressionShare |
Es la cantidad de impresiones que recibiste entre los anuncios de la parte superior de la página en comparación con la cantidad estimada de impresiones que podrías haber recibido entre esos anuncios. Nota: El porcentaje de impresiones en la parte superior de la página de búsqueda se informa en el rango de 0.1 a 1. Cualquier valor inferior a 0.1 se informa como 0.0999. Por lo general, los anuncios en la parte superior de la página aparecen arriba de los primeros resultados orgánicos, aunque es posible que, en determinadas búsquedas, se muestren debajo de esos resultados. |
topImpressionPercentage |
Es el porcentaje de tus impresiones de anuncios que se muestran junto a los principales resultados de la búsqueda orgánica. |
valuePerAllConversions |
Es el valor de todas las conversiones dividido por la cantidad total de conversiones. |
valuePerAllConversionsByConversionDate |
Es el valor de todas las conversiones dividido por la cantidad total de conversiones. Cuando esta columna se selecciona con fecha, los valores en la columna Fecha se refieren a la fecha de conversión. Los detalles de las columnas by_conversion_date están disponibles en https://support.google.com/sa360/answer/9250611. |
valuePerConversion |
Es el valor de las conversiones aptas para ofertas dividido por la cantidad de conversiones aptas para ofertas. Muestra cuánto vale, en promedio, cada una de las conversiones aptas para ofertas. |
valuePerConversionsByConversionDate |
Es el valor de conversiones aptas para ofertas dividido por la fecha de conversión por las conversiones aptas para ofertas por la fecha de conversión. Muestra cuánto vale, en promedio, cada una de las conversiones aptas para ofertas (por fecha de conversión). Cuando esta columna se selecciona con fecha, los valores en la columna Fecha se refieren a la fecha de conversión. |
clientAccountViewThroughConversions |
Es la cantidad total de conversiones posimpresión. Esto sucede cuando un cliente ve un anuncio con imágenes o rich media y, luego, completa una conversión en su sitio sin interactuar con otro anuncio (por ejemplo, si haces clic en él). |
clientAccountCrossSellCostOfGoodsSoldMicros |
El costo de bienes vendidos en forma cruzada (CBV) de la cuenta de cliente es el costo total de los productos vendidos como resultado de la publicidad de un producto diferente. Cómo funciona: Registras las conversiones con datos del carrito de las compras realizadas en tu sitio web. Si el anuncio con el que se interactuó antes de la compra tiene un producto asociado (consulta los anuncios de Shopping), este producto se considerará como el anunciado. Cualquier producto incluido en el pedido que realice el cliente es un producto vendido. Si estos productos no coinciden, se considerará una venta cruzada. El costo de bienes vendidos en forma cruzada es el costo total de los productos vendidos que no se anunciaron. Ejemplo: Un usuario hizo clic en el anuncio de Shopping de un sombrero y, luego, compró el mismo sombrero y una camisa. El sombrero tiene un valor de costo de bienes vendidos de USD 3 y la camisa tiene un valor de costo de bienes vendidos de USD 5. El costo de bienes vendidos en forma cruzada de este pedido es de USD 5. Esta métrica solo está disponible si registras conversiones con datos del carrito. Esta métrica es un valor monetario y se muestra en la moneda del cliente de forma predeterminada. Consulta el parámetro metrics_currency en https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
crossSellCostOfGoodsSoldMicros |
El costo de bienes vendidos en forma cruzada (CBV) es el costo total de los productos vendidos como resultado de la publicidad de un producto diferente. Cómo funciona: Registras las conversiones con datos del carrito de las compras realizadas en tu sitio web. Si el anuncio con el que se interactuó antes de la compra tiene un producto asociado (consulta los anuncios de Shopping), este producto se considerará como el anunciado. Cualquier producto incluido en el pedido que realice el cliente es un producto vendido. Si estos productos no coinciden, se considerará una venta cruzada. El costo de bienes vendidos en forma cruzada es el costo total de los productos vendidos que no se anunciaron. Ejemplo: Un usuario hizo clic en el anuncio de Shopping de un sombrero y, luego, compró el mismo sombrero y una camisa. El sombrero tiene un valor de costo de bienes vendidos de USD 3 y la camisa tiene un valor de costo de bienes vendidos de USD 5. El costo de bienes vendidos en forma cruzada de este pedido es de USD 5. Esta métrica solo está disponible si registras conversiones con datos del carrito. Esta métrica es un valor monetario y se muestra en la moneda del cliente de forma predeterminada. Consulta el parámetro metrics_currency en https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
clientAccountCrossSellGrossProfitMicros |
Las ganancias brutas por ventas cruzadas de la cuenta de cliente son las ganancias que obtuviste de los productos vendidos como resultado de la publicidad de un producto diferente, menos el costo de bienes vendidos (CBV). Cómo funciona: Registras las conversiones con datos del carrito de las compras realizadas en tu sitio web. Si el anuncio con el que se interactuó antes de la compra tiene un producto asociado (consulta los anuncios de Shopping), este producto se considerará como el anunciado. Cualquier producto incluido en la compra es un producto vendido. Si estos productos no coinciden, se considerará una venta cruzada. Las ganancias brutas por ventas cruzadas son los ingresos que obtuviste a partir de ventas cruzadas que se atribuyeron a tus anuncios menos el costo de los bienes vendidos. Ejemplo: Un usuario hizo clic en el anuncio de Shopping de un sombrero y, luego, compró el mismo sombrero y una camisa. La camisa cuesta USD 20 y tiene un valor de costo de bienes vendidos de USD 5. Las ganancias brutas por ventas cruzadas de este pedido son de USD 15 = USD 20 - USD 5. Esta métrica solo está disponible si registras conversiones con datos del carrito. Esta métrica es un valor monetario y se muestra en la moneda del cliente de forma predeterminada. Consulta el parámetro metrics_currency en https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
crossSellGrossProfitMicros |
Las ganancias brutas por ventas cruzadas son las ganancias que obtuviste de los productos vendidos como resultado de la publicidad de un producto diferente, menos el costo de bienes vendidos (CBV). Cómo funciona: Registras las conversiones con datos del carrito de las compras realizadas en tu sitio web. Si el anuncio con el que se interactuó antes de la compra tiene un producto asociado (consulta los anuncios de Shopping), este producto se considerará como el anunciado. Cualquier producto incluido en la compra es un producto vendido. Si estos productos no coinciden, se considerará una venta cruzada. Las ganancias brutas por ventas cruzadas son los ingresos que obtuviste a partir de ventas cruzadas que se atribuyeron a tus anuncios menos el costo de los bienes vendidos. Ejemplo: Un usuario hizo clic en el anuncio de Shopping de un sombrero y, luego, compró el mismo sombrero y una camisa. La camisa cuesta USD 20 y tiene un valor de costo de bienes vendidos de USD 5. Las ganancias brutas por ventas cruzadas de este pedido son de USD 15 = USD 20 - USD 5. Esta métrica solo está disponible si registras conversiones con datos del carrito. Esta métrica es un valor monetario y se muestra en la moneda del cliente de forma predeterminada. Consulta el parámetro metrics_currency en https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
clientAccountCrossSellRevenueMicros |
Los ingresos por ventas cruzadas de la cuenta de cliente corresponden al importe total que obtuviste por los productos vendidos como resultado de la publicidad de un producto diferente. Cómo funciona: Registras las conversiones con datos del carrito de las compras realizadas en tu sitio web. Si el anuncio con el que se interactuó antes de la compra tiene un producto asociado (consulta los anuncios de Shopping), este producto se considerará como el anunciado. Cualquier producto incluido en el pedido que realice el cliente es un producto vendido. Si estos productos no coinciden, se considerará una venta cruzada. Los ingresos por ventas cruzadas corresponden al valor total que obtuviste por la venta cruzada que se atribuyó a tus anuncios. Ejemplo: Un usuario hizo clic en el anuncio de Shopping de un sombrero y, luego, compró el mismo sombrero y una camisa. El sombrero cuesta USD 10 y la camisa, USD 20. Los ingresos por venta cruzada de este pedido son de USD 20. Esta métrica solo está disponible si registras conversiones con datos del carrito. Esta métrica es un valor monetario y se muestra en la moneda del cliente de forma predeterminada. Consulta el parámetro metrics_currency en https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
crossSellRevenueMicros |
Los ingresos por ventas cruzadas corresponden al importe total que obtuviste por los productos vendidos como resultado de la publicidad de un producto diferente. Cómo funciona: Registras las conversiones con datos del carrito de las compras realizadas en tu sitio web. Si el anuncio con el que se interactuó antes de la compra tiene un producto asociado (consulta los anuncios de Shopping), este producto se considerará como el anunciado. Cualquier producto incluido en el pedido que realice el cliente es un producto vendido. Si estos productos no coinciden, se considerará una venta cruzada. Los ingresos por ventas cruzadas corresponden al valor total que obtuviste por la venta cruzada que se atribuyó a tus anuncios. Ejemplo: Un usuario hizo clic en el anuncio de Shopping de un sombrero y, luego, compró el mismo sombrero y una camisa. El sombrero cuesta USD 10 y la camisa, USD 20. Los ingresos por venta cruzada de este pedido son de USD 20. Esta métrica solo está disponible si registras conversiones con datos del carrito. Esta métrica es un valor monetario y se muestra en la moneda del cliente de forma predeterminada. Consulta el parámetro metrics_currency en https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
clientAccountCrossSellUnitsSold |
Las unidades vendidas en forma cruzada de cuenta de cliente son la cantidad total de productos vendidos como resultado de la publicidad de un producto diferente. Cómo funciona: Registras las conversiones con datos del carrito de las compras realizadas en tu sitio web. Si el anuncio con el que se interactuó antes de la compra tiene un producto asociado (consulta los anuncios de Shopping), este producto se considerará como el anunciado. Cualquier producto incluido en el pedido que realice el cliente es un producto vendido. Si estos productos no coinciden, se considerará una venta cruzada. Las unidades vendidas en forma cruzada son la cantidad total de productos de venta cruzada de todos los pedidos atribuidos a tus anuncios. Ejemplo: Un usuario hizo clic en el anuncio de Shopping de un sombrero y, luego, compró el mismo sombrero, una camisa y una chaqueta. Las unidades vendidas en forma cruzada de este pedido son 2. Esta métrica solo está disponible si registras conversiones con datos del carrito. |
crossSellUnitsSold |
"Unidades vendidas en forma cruzada" es la cantidad total de productos vendidos como resultado de la publicidad de un producto diferente. Cómo funciona: Registras las conversiones con datos del carrito de las compras realizadas en tu sitio web. Si el anuncio con el que se interactuó antes de la compra tiene un producto asociado (consulta los anuncios de Shopping), este producto se considerará como el anunciado. Cualquier producto incluido en el pedido que realice el cliente es un producto vendido. Si estos productos no coinciden, se considerará una venta cruzada. Las unidades vendidas en forma cruzada son la cantidad total de productos de venta cruzada de todos los pedidos atribuidos a tus anuncios. Ejemplo: Un usuario hizo clic en el anuncio de Shopping de un sombrero y, luego, compró el mismo sombrero, una camisa y una chaqueta. Las unidades vendidas en forma cruzada de este pedido son 2. Esta métrica solo está disponible si registras conversiones con datos del carrito. |
clientAccountLeadCostOfGoodsSoldMicros |
El costo de bienes vendidos a clientes potenciales (CBV) de la cuenta de cliente es el costo total de los productos vendidos como resultado de la publicidad del mismo producto. Cómo funciona: Registras las conversiones con datos del carrito de las compras realizadas en tu sitio web. Si el anuncio con el que se interactuó tiene un producto asociado (consulte Anuncios de Shopping), este producto se considerará como el anunciado. Cualquier producto incluido en el pedido que realice el cliente es un producto vendido. Si los productos anunciados y vendidos coinciden, el costo de estos productos se registra en el costo de bienes vendidos a clientes potenciales. Ejemplo: Un usuario hizo clic en el anuncio de Shopping de un sombrero y, luego, compró el mismo sombrero y una camisa. El sombrero tiene un valor de costo de bienes vendidos de USD 3 y la camisa tiene un valor de costo de bienes vendidos de USD 5. El costo de bienes vendidos a clientes potenciales de este pedido es de USD 3. Esta métrica solo está disponible si registras conversiones con datos del carrito. Esta métrica es un valor monetario y se muestra en la moneda del cliente de forma predeterminada. Consulta el parámetro metrics_currency en https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
leadCostOfGoodsSoldMicros |
El costo de bienes vendidos a clientes potenciales (CBV) es el costo total de los productos vendidos como resultado de la publicidad del mismo producto. Cómo funciona: Registras las conversiones con datos del carrito de las compras realizadas en tu sitio web. Si el anuncio con el que se interactuó tiene un producto asociado (consulte Anuncios de Shopping), este producto se considerará como el anunciado. Cualquier producto incluido en el pedido que realice el cliente es un producto vendido. Si los productos anunciados y vendidos coinciden, el costo de estos productos se registra en el costo de bienes vendidos a clientes potenciales. Ejemplo: Un usuario hizo clic en el anuncio de Shopping de un sombrero y, luego, compró el mismo sombrero y una camisa. El sombrero tiene un valor de costo de bienes vendidos de USD 3 y la camisa tiene un valor de costo de bienes vendidos de USD 5. El costo de bienes vendidos a clientes potenciales de este pedido es de USD 3. Esta métrica solo está disponible si registras conversiones con datos del carrito. Esta métrica es un valor monetario y se muestra en la moneda del cliente de forma predeterminada. Consulta el parámetro metrics_currency en https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
clientAccountLeadGrossProfitMicros |
Las ganancias brutas por clientes potenciales de la cuenta de cliente son las ganancias que obtuviste de los productos vendidos como resultado de la publicidad del mismo producto, menos el costo de bienes vendidos (CBV). Cómo funciona: Registras las conversiones con datos del carrito de las compras realizadas en tu sitio web. Si el anuncio con el que se interactuó antes de la compra tiene un producto asociado (consulta los anuncios de Shopping), este producto se considerará como el anunciado. Cualquier producto incluido en el pedido que realice el cliente es un producto vendido. Si los productos anunciados y vendidos coinciden, los ingresos que obtuviste de esas ventas menos el costo de bienes vendidos son tus ganancias brutas por clientes potenciales. Ejemplo: Un usuario hizo clic en el anuncio de Shopping de un sombrero y, luego, compró el mismo sombrero y una camisa. El sombrero cuesta USD 10 y tiene un valor de costo de bienes vendidos de USD 3. Las ganancias brutas por clientes potenciales de este pedido son USD 7 = USD 10 - USD 3. Esta métrica solo está disponible si registras conversiones con datos del carrito. Esta métrica es un valor monetario y se muestra en la moneda del cliente de forma predeterminada. Consulta el parámetro metrics_currency en https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
leadGrossProfitMicros |
Las ganancias brutas por clientes potenciales son las ganancias que obtuviste de los productos vendidos como resultado de la publicidad del mismo producto, menos el costo de bienes vendidos (CBV). Cómo funciona: Registras las conversiones con datos del carrito de las compras realizadas en tu sitio web. Si el anuncio con el que se interactuó antes de la compra tiene un producto asociado (consulta los anuncios de Shopping), este producto se considerará como el anunciado. Cualquier producto incluido en el pedido que realice el cliente es un producto vendido. Si los productos anunciados y vendidos coinciden, los ingresos que obtuviste de esas ventas menos el costo de bienes vendidos son tus ganancias brutas por clientes potenciales. Ejemplo: Un usuario hizo clic en el anuncio de Shopping de un sombrero y, luego, compró el mismo sombrero y una camisa. El sombrero cuesta USD 10 y tiene un valor de costo de bienes vendidos de USD 3. Las ganancias brutas por clientes potenciales de este pedido son USD 7 = USD 10 - USD 3. Esta métrica solo está disponible si registras conversiones con datos del carrito. Esta métrica es un valor monetario y se muestra en la moneda del cliente de forma predeterminada. Consulta el parámetro metrics_currency en https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
clientAccountLeadRevenueMicros |
Los ingresos por clientes potenciales de la cuenta de cliente corresponden al importe total que obtuviste por los productos vendidos como resultado de la publicidad del mismo producto. Cómo funciona: Registras las conversiones con datos del carrito de las compras realizadas en tu sitio web. Si el anuncio con el que se interactuó antes de la compra tiene un producto asociado (consulta los anuncios de Shopping), este producto se considerará como el anunciado. Cualquier producto incluido en el pedido que realice el cliente es un producto vendido. Si los productos promocionados y vendidos coinciden, el valor total que obtuviste por las ventas de estos productos se muestra en los ingresos por clientes potenciales. Ejemplo: Un usuario hizo clic en el anuncio de Shopping de un sombrero y, luego, compró el mismo sombrero y una camisa. El sombrero cuesta USD 10 y la camisa, USD 20. Los ingresos por clientes potenciales de este pedido son de USD 10. Esta métrica solo está disponible si registras conversiones con datos del carrito. Esta métrica es un valor monetario y se muestra en la moneda del cliente de forma predeterminada. Consulta el parámetro metrics_currency en https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
leadRevenueMicros |
Los ingresos por clientes potenciales corresponden al importe total que obtuviste por los productos vendidos como resultado de la publicidad del mismo producto. Cómo funciona: Registras las conversiones con datos del carrito de las compras realizadas en tu sitio web. Si el anuncio con el que se interactuó antes de la compra tiene un producto asociado (consulta los anuncios de Shopping), este producto se considerará como el anunciado. Cualquier producto incluido en el pedido que realice el cliente es un producto vendido. Si los productos promocionados y vendidos coinciden, el valor total que obtuviste por las ventas de estos productos se muestra en los ingresos por clientes potenciales. Ejemplo: Un usuario hizo clic en el anuncio de Shopping de un sombrero y, luego, compró el mismo sombrero y una camisa. El sombrero cuesta USD 10 y la camisa, USD 20. Los ingresos por clientes potenciales de este pedido son de USD 10. Esta métrica solo está disponible si registras conversiones con datos del carrito. Esta métrica es un valor monetario y se muestra en la moneda del cliente de forma predeterminada. Consulta el parámetro metrics_currency en https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
clientAccountLeadUnitsSold |
Las unidades vendidas a clientes potenciales de la cuenta de cliente son la cantidad total de productos vendidos como resultado de la publicidad del mismo producto. Cómo funciona: Registras las conversiones con datos del carrito de las compras realizadas en tu sitio web. Si el anuncio con el que se interactuó antes de la compra tiene un producto asociado (consulta los anuncios de Shopping), este producto se considerará como el anunciado. Cualquier producto incluido en el pedido que realice el cliente es un producto vendido. Si los productos promocionados y vendidos coinciden, la cantidad total de estos productos vendidos se muestra en unidades vendidas a clientes potenciales. Ejemplo: Un usuario hizo clic en el anuncio de Shopping de un sombrero y, luego, compró el mismo sombrero, una camisa y una chaqueta. Las unidades vendidas a clientes potenciales en este pedido son 1. Esta métrica solo está disponible si registras conversiones con datos del carrito. |
leadUnitsSold |
Las unidades vendidas a clientes potenciales vendidas corresponden a la cantidad total de productos vendidos como resultado de la publicidad del mismo producto. Cómo funciona: Registras las conversiones con datos del carrito de las compras realizadas en tu sitio web. Si el anuncio con el que se interactuó antes de la compra tiene un producto asociado (consulta los anuncios de Shopping), este producto se considerará como el anunciado. Cualquier producto incluido en el pedido que realice el cliente es un producto vendido. Si los productos promocionados y vendidos coinciden, la cantidad total de estos productos vendidos se muestra en unidades vendidas a clientes potenciales. Ejemplo: Un usuario hizo clic en el anuncio de Shopping de un sombrero y, luego, compró el mismo sombrero, una camisa y una chaqueta. Las unidades vendidas a clientes potenciales en este pedido son 1. Esta métrica solo está disponible si registras conversiones con datos del carrito. |
Valor
Un contenedor de datos genérico
Representación JSON |
---|
{ // Union field |
Campos | |
---|---|
Campo de unión value . Un valor. Las direcciones (value ) solo pueden ser una de las siguientes opciones: |
|
booleanValue |
Un valor booleano. |
int64Value |
Es un valor int64. |
floatValue |
Un número de punto flotante. |
doubleValue |
Un valor doble. |
stringValue |
Una string. |
QualityScoreBucket
Enumeración que enumera los posibles intervalos del nivel de calidad.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
Se usa solo para el valor que se muestra. Representa el valor desconocido en esta versión. |
BELOW_AVERAGE |
La calidad de la creatividad es inferior al promedio. |
AVERAGE |
La calidad de la creatividad es promedio. |
ABOVE_AVERAGE |
La calidad de la creatividad es superior al promedio. |
InteractionEventType
Enumeración que describe los posibles tipos de interacciones pagas y gratuitas.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
Se usa solo para el valor que se muestra. Representa el valor desconocido en esta versión. |
CLICK |
Clic al sitio. En la mayoría de los casos, esta interacción se lleva a cabo en una ubicación externa, que suele ser la página de destino del anunciante. Este también es el InteractionEventType predeterminado para los eventos de clic. |
ENGAGEMENT |
La intención expresada del usuario de interactuar con el anuncio en el lugar. |
VIDEO_VIEW |
El usuario vio un anuncio de video. |
NONE |
El InteractionEventType predeterminado para los eventos de conversión de anuncios. Se utiliza cuando una fila de conversiones de anuncios NO indica que las interacciones gratuitas (por ejemplo, las conversiones de anuncios) deben “promocionarse”. y se informan como parte de las métricas básicas. Estas son, simplemente, otras conversiones (de anuncios). |
Segmentos
Campos de solo segmento.
Representación JSON |
---|
{ "adNetworkType": enum ( |
Campos | |
---|---|
adNetworkType |
Tipo de red del anuncio |
conversionActionCategory |
Categoría de acción de conversión. |
conversionCustomDimensions[] |
Son las dimensiones personalizadas de conversión. |
dayOfWeek |
El día de la semana, por ejemplo, MONDAY |
device |
Dispositivo al que se aplican las métricas. |
keyword |
Criterio de palabra clave. |
productChannel |
Canal del producto. |
productChannelExclusivity |
Exclusividad de canal del producto. |
productCondition |
Estado del producto. |
productSoldCondition |
Estado del producto vendido. |
rawEventConversionDimensions[] |
Las dimensiones de conversión de eventos sin procesar |
conversionAction |
El nombre del recurso de la acción de conversión. |
conversionActionName |
Nombre de la acción de conversión. |
date |
Fecha a la que se aplican las métricas. Formato dd-MM-aaaa, por ejemplo, 17-04-2018. |
geoTargetCity |
Nombre del recurso de la constante de segmentación geográfica que representa una ciudad. |
geoTargetCountry |
Nombre del recurso de la constante de segmentación geográfica que representa un país. |
geoTargetMetro |
Nombre del recurso de la constante de segmentación geográfica que representa un área metropolitana. |
geoTargetRegion |
Nombre del recurso de la constante de segmentación geográfica que representa una región. |
hour |
La hora del día como un número entre 0 y 23, ambos incluidos. |
month |
Mes, representado por la fecha del primer día de un mes Su formato es aaaa-MM-dd. |
productBiddingCategoryLevel1 |
Categoría de oferta (nivel 1) del producto. |
productBiddingCategoryLevel2 |
Categoría de oferta (nivel 2) del producto. |
productBiddingCategoryLevel3 |
Categoría de oferta (nivel 3) del producto. |
productBiddingCategoryLevel4 |
Categoría de oferta (nivel 4) del producto. |
productBiddingCategoryLevel5 |
Categoría de oferta (nivel 5) del producto. |
productBrand |
Es la marca del producto. |
productCountry |
Es el nombre del recurso de la constante de segmentación geográfica para el país de venta del producto. |
productCustomAttribute0 |
Atributo personalizado 0 del producto. |
productCustomAttribute1 |
Atributo personalizado 1 del producto. |
productCustomAttribute2 |
Atributo personalizado 2 del producto. |
productCustomAttribute3 |
Atributo personalizado 3 del producto. |
productCustomAttribute4 |
Atributo personalizado 4 del producto. |
productItemId |
Es el ID del artículo. |
productLanguage |
Nombre del recurso de la constante de idioma del idioma del producto. |
productSoldBiddingCategoryLevel1 |
Categoría de ofertas (nivel 1) del producto vendido. |
productSoldBiddingCategoryLevel2 |
Categoría de ofertas (nivel 2) del producto vendido. |
productSoldBiddingCategoryLevel3 |
Categoría de ofertas (nivel 3) del producto vendido. |
productSoldBiddingCategoryLevel4 |
Categoría de ofertas (nivel 4) del producto vendido. |
productSoldBiddingCategoryLevel5 |
Categoría de ofertas (nivel 5) del producto vendido. |
productSoldBrand |
La marca del producto vendido. |
productSoldCustomAttribute0 |
Atributo personalizado 0 del producto vendido. |
productSoldCustomAttribute1 |
Atributo personalizado 1 del producto vendido. |
productSoldCustomAttribute2 |
Atributo personalizado 2 del producto vendido. |
productSoldCustomAttribute3 |
Atributo personalizado 3 del producto vendido. |
productSoldCustomAttribute4 |
Atributo personalizado 4 del producto vendido. |
productSoldItemId |
El ID del artículo vendido. |
productSoldTitle |
El título del producto vendido. |
productSoldTypeL1 |
Tipo (nivel 1) del producto vendido. |
productSoldTypeL2 |
Tipo (nivel 2) del producto vendido. |
productSoldTypeL3 |
Tipo (nivel 3) del producto vendido. |
productSoldTypeL4 |
Tipo (nivel 4) del producto vendido. |
productSoldTypeL5 |
Tipo (nivel 5) del producto vendido. |
productStoreId |
Es el ID de tienda del producto. |
productTitle |
Título del producto. |
productTypeL1 |
Tipo de producto (nivel 1). |
productTypeL2 |
Tipo de producto (nivel 2) |
productTypeL3 |
Tipo de producto (nivel 3) |
productTypeL4 |
Tipo de producto (nivel 4). |
productTypeL5 |
Tipo de producto (nivel 5). |
quarter |
Trimestre representado por la fecha del primer día del trimestre Usa el año calendario para los trimestres. Por ejemplo, el segundo trimestre de 2018 comienza el 01-04-2018. Su formato es aaaa-MM-dd. |
week |
Es la semana, que se define de lunes a domingo y se representa por la fecha del lunes. Su formato es aaaa-MM-dd. |
year |
Año, con el formato aaaa. |
assetInteractionTarget |
Solo se utiliza con las métricas CustomerAsset, CampaignAsset y AdGroupAsset. Indica si las métricas de interacción ocurrieron en el recurso mismo o en un recurso o unidad de anuncios diferentes. Las interacciones (por ejemplo, clics) se registran en todas las partes del anuncio publicado (por ejemplo, el propio anuncio y otros componentes, como los vínculos a sitios) cuando se publican juntas. Cuando interactividadOnThisAsset es verdadera, significa que las interacciones están en este recurso específico, mientras que cuando engagementOnThisAsset es falsa, significa que las interacciones no están en este recurso específico, sino en otras partes del anuncio publicado con el que se publica este recurso. |
AdNetworkType
Enumera los tipos de red de Google Ads.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
El valor es desconocido en esta versión. |
SEARCH |
Búsqueda en Google |
SEARCH_PARTNERS |
Socios de búsqueda. |
CONTENT |
Red de Display |
YOUTUBE_SEARCH |
Búsqueda de YouTube. |
YOUTUBE_WATCH |
Videos de YouTube |
MIXED |
Varias redes. |
Palabra clave
Un segmento de criterio de palabra clave.
Representación JSON |
---|
{
"info": {
object ( |
Campos | |
---|---|
info |
Información de la palabra clave. |
adGroupCriterion |
Es el nombre del recurso de AdGroupCriterion. |
ProductChannelExclusivity
Es una enumeración que describe la disponibilidad de una oferta de producto.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
Se usa solo para el valor que se muestra. Representa el valor desconocido en esta versión. |
SINGLE_CHANNEL |
El artículo se vende a través de un solo canal, ya sea en las tiendas locales o en línea, como lo indica su ProductChannel. |
MULTI_CHANNEL |
Se hace coincidir el artículo con su equivalente en la tienda local o en línea, lo que indica que está disponible para la compra en ambos ShoppingProductChannels. |
ProductCondition
Es una enumeración que describe el estado de la oferta de un producto.
Enumeraciones | |
---|---|
UNSPECIFIED |
No se especifica. |
UNKNOWN |
Se usa solo para el valor que se muestra. Representa el valor desconocido en esta versión. |
OLD |
El estado del producto es antiguo. |
NEW |
El estado del producto es nuevo. |
REFURBISHED |
El estado del producto es reacondicionado. |
USED |
Se usa el estado del producto. |
AssetInteractionTarget
Un segmento AssetInteractionTarget.
Representación JSON |
---|
{ "asset": string, "interactionOnThisAsset": boolean } |
Campos | |
---|---|
asset |
El nombre del recurso del recurso. |
interactionOnThisAsset |
Solo se utiliza con las métricas CustomerAsset, CampaignAsset y AdGroupAsset. Indica si las métricas de interacción ocurrieron en el recurso mismo o en un recurso o unidad de anuncios diferentes. |