Esquema de la tabla de productos de Google Merchant Center
Cuando tus datos de informes de Google Merchant Center se transfieren a BigQuery, el formato de los datos de productos y problemas con los productos corresponde, en su mayoría, al formato de los campos relevantes de los recursos products y productstatuses de Content API.
Los datos se escriben en una tabla llamada
Products_MERCHANT_ID si usas un ID del comerciante
individual, o
Products_AGGREGATOR_ID si usas una cuenta
de MCA.
Esquema
La tabla Products_ tiene el siguiente esquema:
| Columna | Tipo de datos de BigQuery | Descripción | Datos de ejemplo |
|---|---|---|---|
product_data_timestamp |
TIMESTAMP |
Marca de tiempo de los datos del producto. | 2023-09-14 11:49:50 UTC |
product_id |
STRING |
El ID de REST de Content API del producto en el formato: channel:content_language:feed_label:offer_id. Esta es la clave primaria. |
online:en:AU:666840730 |
merchant_id |
INTEGER |
ID de cuenta de Merchant | 1234 |
aggregator_id |
INTEGER |
ID de cuenta de agregador para cuentas de varios clientes | 12345 |
offer_id |
STRING |
Es el ID del producto que proporcionó el comercio. | tddy123uk |
title |
STRING |
Título del artículo | TN2351 USB negro |
description |
STRING |
Descripción del artículo | El TN2351 USB negro redefinió la forma en que XJS puede influir en las experiencias de LLCD. |
link |
STRING |
Es la URL de la página de destino del producto que proporcionó el comercio. | https://www.example.com/tn2351-black-usb/6538811?skuId=1234 |
mobile_link |
STRING |
Es la URL de una versión optimizada para dispositivos móviles de la página de destino que proporciona el comercio. | https://www.example.com/tn2351-black-usb/6538811?skuId=1234 |
image_link |
STRING |
Es la URL de la imagen principal del producto que proporcionó el comercio. | https://www.example.com/tn2351-black-usb/6538811?skuId=1234 |
additional_image_links |
STRING, REPEATED |
URLs adicionales de imágenes del artículo que proporcionó el comercio | |
content_language |
STRING |
El código de lenguaje ISO 639-1 de dos letras del artículo. | en |
target_country |
STRING |
Obsoleto (siempre se establece en NULL) como parte de un cambio para permitir que los productos se segmenten para varios países. En su lugar, usa los siguientes campos para leer el estado de cada país de segmentación: destinations.approved_countries, destinations.pending_countries, destinations.disapproved_countries. Los problemas ahora se pueden aplicar a determinados países objetivo y no a otros, como se indica en el campo issues.applicable_countries. |
null |
feed_label |
STRING |
La etiqueta del feed que proporcionó el comercio para el artículo, o - si no se proporciona. |
EE.UU. |
channel |
STRING |
El canal del elemento, ya sea online o local. |
local, en línea |
expiration_date |
TIMESTAMP |
Es la fecha y hora proporcionadas por el comercio en las que el artículo debe caducar, como se especifica cuando se inserta. Configúralo como nulo si no se proporciona. | 2023-10-14 00:00:00 UTC |
google_expiration_date |
TIMESTAMP |
Fecha y hora en la que el artículo caduca en Google Shopping. Nunca se establece como nulo. | 2023-10-14 00:00:00 UTC |
adult |
BOOLEAN |
Se configura como verdadero si el artículo está dirigido a adultos. | true, false |
age_group |
STRING |
Grupo de edad objetivo del artículo que proporcionó el comercio Es NULL si no se proporciona. | recién nacido, 3-12 meses, 1-5 años, niños, adultos |
availability |
STRING |
Estado de disponibilidad del artículo que proporcionó el comercio | en stock, agotado |
availability_date |
TIMESTAMP |
La fecha y hora proporcionadas por el comercio en que un producto pedido por adelantado estará disponible para la entrega. Es NULL si no se proporciona. | 2023-10-14 00:00:00 UTC |
brand |
STRING |
Marca del artículo que proporcionó el comercio Es NULL si no se proporciona. | Nombre de la marca |
google_brand_id |
STRING |
Es el ID de marca de Google del artículo. | 12759524623914508053 |
color |
STRING |
Color del artículo que proporcionó el comercio Es NULL si no se proporciona. | Plateado, gris, multicolor |
condition |
STRING |
Condición o estado del artículo que proporcionó el comercio | nuevo, usado, reacondicionado |
custom_labels |
RECORD |
Son las etiquetas personalizadas que proporciona el comercio para agrupar artículos de forma personalizada en los anuncios de Shopping. Es NULL si no se proporciona. | |
custom_labels.label_0 |
STRING |
Etiqueta personalizada 0. | mi etiqueta personalizada |
custom_labels.label_1 |
STRING |
Etiqueta personalizada 1 | mi etiqueta personalizada |
custom_labels.label_2 |
STRING |
Etiqueta personalizada 2 | mi etiqueta personalizada |
custom_labels.label_3 |
STRING |
Etiqueta personalizada 3 | mi etiqueta personalizada |
custom_labels.label_4 |
STRING |
Etiqueta personalizada 4 | mi etiqueta personalizada |
gender |
STRING |
Género objetivo del artículo que proporcionó el comercio Es NULL si no se proporciona. | unisex, male, female |
gtin |
STRING |
Es el código comercial global de artículo (GTIN) que proporcionó el comercio. Es NULL si no se proporciona. | 3234567890126 |
item_group_id |
STRING |
Es el identificador compartido que proporciona el comercio para todas las variantes del mismo producto. Es NULL si no se proporciona. | AB12345 |
material |
STRING |
Material del que está hecho el artículo, según lo proporcionó el comercio Es NULL si no se proporciona. | Cuero |
mpn |
STRING |
Es el número de pieza del fabricante (MPN) del artículo que proporcionó el comercio. Se establece en NULL si no se proporciona. | GO12345OOGLE |
pattern |
STRING |
Diseño proporcionado por el comercio. Es NULL si no se proporciona. | A rayas |
price |
RECORD |
Precio del artículo que proporcionó el comercio | |
price.value |
NUMERIC |
El precio del artículo. | 19.99 |
price.currency |
STRING |
La moneda del precio. | USD |
sale_price |
RECORD |
El precio de oferta del artículo que proporcionó el comercio | |
sale_price.value |
NUMERIC |
El precio de oferta del artículo. Es NULL si no se proporciona. | 19.99 |
sale_price.currency |
STRING |
La moneda del precio de oferta. Es NULL si no se proporciona. | USD |
sale_price_effective_start_date |
TIMESTAMP |
Fecha y hora de inicio cuando el artículo está en oferta. | 2023-10-14 00:00:00 UTC |
sale_price_effective_end_date |
TIMESTAMP |
Fecha y hora de finalización cuando el artículo está en oferta. | 2023-10-14 00:00:00 UTC |
google_product_category |
INTEGER |
El ID de la categoría de producto de Google del artículo. Es NULL si no se proporciona. | 2271 |
google_product_category_ids |
INTEGER, REPEATED |
La ruta completa de categorías de productos de Google al artículo, almacenada como un conjunto de IDs. Es NULL si no se proporciona. | |
google_product_category_path |
STRING |
Una versión legible por humanos de la ruta completa. Está vacío si no se proporciona. | Ropa y accesorios > Prendas de vestir > Vestidos |
product_type |
STRING |
Categoría del artículo que proporcionó el comercio | Hogar > Mujer > Vestidos > Maxivestidos |
additional_product_types |
STRING, REPEATED |
Categorías adicionales del artículo. | |
promotion_ids |
STRING, REPEATED |
Es la lista de IDs de promoción asociados con el producto. | |
destinations |
RECORD, REPEATED |
Los destinos objetivos para el producto. | |
destinations.name |
STRING |
Es el nombre del destino. Solo se admite Shopping. Esto corresponde a los métodos de marketing "Anuncios de Shopping" y "Anuncios del inventario local" en Merchant Center. |
Shopping |
destinations.status |
STRING |
Obsoleto (siempre se establece en NULL) como parte de un cambio para permitir que los productos se segmenten para varios países. En su lugar, usa los siguientes campos para leer el estado de cada país de segmentación: destinations.approved_countries, destinations.pending_countries, destinations.disapproved_countries. Los problemas ahora se pueden aplicar a determinados países objetivo y no a otros, como se indica en el campo issues.applicable_countries. |
NULL |
destinations.approved_countries |
STRING, REPEATED |
Lista de códigos de territorio de CLDR en los que se aprueba la oferta. | US, CH |
destinations.pending_countries |
STRING, REPEATED |
Lista de códigos de territorio de CLDR en los que está pendiente la oferta. | US, CH |
destinations.disapproved_countries |
STRING, REPEATED |
Lista de códigos de territorio de CLDR en los que se rechazó la oferta. | US, CH |
issues |
RECORD, REPEATED |
La lista de problemas a nivel artículo asociados con el producto. | |
issues.code |
STRING |
El código de error del problema. | image_too_generic |
issues.servability |
STRING |
Cómo afecta este problema a la publicación de la oferta, | rechazado, no afectado |
issues.resolution |
STRING |
Si el comercio puede resolver el problema. | merchant_action, pending_processing |
issues.attribute_name |
STRING |
El nombre del atributo, si el problema se debe a un solo atributo. De lo contrario, es NULL. | vínculo de imagen |
issues.destination |
STRING |
El destino al que se aplica el problema. Siempre se establece en Shopping. |
Shopping |
issues.short_description |
STRING |
Descripción breve del problema en inglés. | Imagen genérica |
issues.detailed_description |
STRING |
Descripción detallada del problema en inglés. | Usa una imagen que muestre el producto |
issues.documentation |
STRING |
URL de una página web para ayudar a resolver este problema | https://support.google.com/merchants/answer/6098288 |
issues.applicable_countries |
STRING, REPEATED |
Lista de códigos de territorio de CLDR en los que se aplica el problema. | CH |
Ejemplos de consultas
Estadísticas de los productos y sus problemas
La siguiente consulta de muestra en SQL proporciona la cantidad de productos, productos con problemas y problemas por día.
SELECT _PARTITIONDATE AS date, COUNT(*) AS num_products, COUNTIF(ARRAY_LENGTH(issues) > 0) AS num_products_with_issues, SUM(ARRAY_LENGTH(issues)) AS num_issues FROM dataset.Products_merchant_id WHERE _PARTITIONDATE >= 'YYYY-MM-DD' GROUP BY date ORDER BY date DESC
Productos rechazados para anuncios de Shopping
La siguiente consulta de muestra en SQL proporciona la cantidad de productos que no están aprobados para mostrarse en los anuncios de Shopping, separados por país. El rechazo puede ser el resultado de que el destino se excluye o debido a un problema con el producto.
SELECT _PARTITIONDATE AS date, disapproved_country, COUNT(*) AS num_products FROM dataset.Products_merchant_id, UNNEST(destinations) AS destination, UNNEST(disapproved_countries) AS disapproved_country WHERE _PARTITIONDATE >= 'YYYY-MM-DD' GROUP BY date, disapproved_country ORDER BY date DESC
Productos con problemas rechazados
La siguiente consulta de muestra en SQL recupera la cantidad de productos con problemas rechazados, separados por país.
SELECT _PARTITIONDATE AS date, applicable_country, COUNT(DISTINCT CONCAT(CAST(merchant_id AS STRING), ':', product_id)) AS num_distinct_products FROM dataset.Products_merchant_id, UNNEST(issues) AS issue, UNNEST(issue.applicable_countries) as applicable_country WHERE _PARTITIONDATE >= 'YYYY-MM-DD' AND issue.servability = 'disapproved' GROUP BY date, applicable_country ORDER BY date DESC