Esquema da tabela de produtos do Google Merchant Center

Quando os dados de relatórios do Google Merchant Center são transferidos para o BigQuery, o formato dos dados de produtos e de problemas com produtos corresponde principalmente ao formato dos campos pertinentes dos recursos de products e productstatuses da API Content.

Os dados são gravados em uma tabela chamada Products_MERCHANT_ID se você estiver usando um ID do comerciante individual ou Products_AGGREGATOR_ID se você estiver usando uma conta da MCA.

Esquema

A tabela Products_ tem o seguinte esquema:

Coluna Tipo de dados BigQuery Descrição Dados de exemplo
product_data_timestamp TIMESTAMP Carimbo de data/hora dos dados do produto 2023-09-14 11:49:50 UTC
product_id STRING ID REST da API Content do produto no formato: channel:content_language:feed_label:offer_id. Essa é a chave primária. online:en:AU:666840730
merchant_id INTEGER ID da conta do comerciante 1234
aggregator_id INTEGER ID da conta do agregador para contas de múltiplos clientes 12345
offer_id STRING ID do produto fornecido pelo comerciante. tddy123uk
title STRING Título do item. TN2351 USB preto
description STRING Descrição do item O TN2351 USB preto redefiniu como o XJS pode afetar as experiências de LLCD.
link STRING URL da página de destino fornecido pelo comerciante do produto. https://www.example.com/tn2351-black-usb/6538811?skuId=1234
mobile_link STRING O comerciante informou o URL de uma versão otimizada para dispositivos móveis da página de destino. https://www.example.com/tn2351-black-usb/6538811?skuId=1234
image_link STRING URL da imagem principal do produto fornecido pelo comerciante. https://www.example.com/tn2351-black-usb/6538811?skuId=1234
additional_image_links STRING, REPEATED O comerciante forneceu URLs adicionais de imagens do item.
content_language STRING O código de idioma ISO 639-1 do item. en
target_country STRING Descontinuado (sempre definido como NULL) como parte de uma mudança que permite que os produtos segmentem vários países. Em vez disso, use os seguintes campos para ler o status de cada país de destino: destinations.approved_countries, destinations.pending_countries, destinations.disapproved_countries. Agora é possível aplicar problemas a determinados países de destino, conforme indicado no campo issues.applicable_countries. null
feed_label STRING O comerciante forneceu o rótulo do feed para o item ou -, se não foi fornecido. EUA
channel STRING O canal do item, online ou local. local, on-line
expiration_date TIMESTAMP Data e hora fornecidas pelo comerciante em que o item deve expirar, conforme especificado no inserção. Será definido como nulo se não for fornecido. 14-10-2023 00:00:00 UTC
google_expiration_date TIMESTAMP Data e hora em que o item expira no Google Shopping Nunca definido como nulo. 14-10-2023 00:00:00 UTC
adult BOOLEAN Definido como "true" se o item for voltado a adultos verdadeiro, falso
age_group STRING O comerciante informou a faixa etária do público-alvo do item. NULL se não for informado. recém-nascido, bebê, criança pequena, crianças, adulto
availability STRING Status de disponibilidade do item fornecido pelo comerciante. em estoque, esgotado
availability_date TIMESTAMP Data e hora fornecidas pelo comerciante de disponibilização de um produto comprado na pré-venda para entrega. NULL se não for informado. 14-10-2023 00:00:00 UTC
brand STRING Marca do item informada pelo comerciante. NULL se não for informado. Nome da marca
google_brand_id STRING ID da marca do Google do item. 12759524623914508053
color STRING Cor do item informada pelo comerciante. NULL se não for informado. Prata, cinza, multi
condition STRING Condição ou estado do item fornecido pelo comerciante. novo, usado, recondicionado
custom_labels RECORD O comerciante forneceu rótulos personalizados para o agrupamento personalizado de itens nos anúncios do Shopping. NULL se não for informado.
custom_labels.label_0 STRING Rótulo personalizado 0 meu rótulo personalizado
custom_labels.label_1 STRING Rótulo personalizado 1 meu rótulo personalizado
custom_labels.label_2 STRING Rótulo personalizado 2 meu rótulo personalizado
custom_labels.label_3 STRING Rótulo personalizado 3 meu rótulo personalizado
custom_labels.label_4 STRING Rótulo personalizado 4 meu rótulo personalizado
gender STRING O atributo gênero da segmentação do item foi fornecido pelo comerciante. NULL se não for informado. unissex, masculino, feminino
gtin STRING O Número global do item comercial (GTIN) fornecido pelo comerciante do item. NULL se não for informado. 3234567890126
item_group_id STRING O comerciante forneceu o identificador compartilhado para todas as variantes do mesmo produto. NULL se não for informado. AB12345
material STRING Material de que o item é feito, informado pelo comerciante. NULL se não for informado. Couro
mpn STRING O comerciante forneceu o Número de peça do fabricante (MPN) do item. Defina como NULL se não for informado. GO12345OOGLE
pattern STRING pattern fornecido pelo comerciante. NULL se não for informado. Listrado
price RECORD O comerciante informou o preço do item.
price.value NUMERIC O preço do item 19,99
price.currency STRING A moeda do preço USD
sale_price RECORD Preço promocional do item informado pelo comerciante.
sale_price.value NUMERIC O preço de venda do item. NULL se não for informado. 19,99
sale_price.currency STRING A moeda do preço de venda. NULL se não for informado. USD
sale_price_effective_start_date TIMESTAMP Data e hora de início das vendas do item. 14-10-2023 00:00:00 UTC
sale_price_effective_end_date TIMESTAMP Data e hora de término das vendas do item. 14-10-2023 00:00:00 UTC
google_product_category INTEGER O código da categoria Google do produto do item. NULL se não for informado. 2271
google_product_category_ids INTEGER, REPEATED O caminho completo das categorias Google do produto para o item, armazenado como um conjunto de códigos. NULL se não for informado.
google_product_category_path STRING Uma versão legível por humanos do caminho completo. Vai ficar vazio se não for informado. Apparel & Accessories > Clothing > Dresses [Vestuário e acessórios > Roupas > Vestidos]
product_type STRING Categoria do item informada pelo comerciante Página inicial > Mulheres > Vestidos > Vestidos longos
additional_product_types STRING, REPEATED Categorias extras do item
promotion_ids STRING, REPEATED A lista de IDs da promoção associados ao produto.
destinations RECORD, REPEATED Os destinos pretendidos do produto.
destinations.name STRING O nome do destino. Somente Shopping é aceito. Corresponde aos métodos de marketing "Anúncios do Shopping" e "Anúncios de inventário local" no Merchant Center. Shopping
destinations.status STRING Descontinuado (sempre definido como NULL) como parte de uma mudança que permite que os produtos segmentem vários países. Em vez disso, use os seguintes campos para ler o status de cada país de destino: destinations.approved_countries, destinations.pending_countries, destinations.disapproved_countries. Agora é possível aplicar problemas a determinados países de destino, conforme indicado no campo issues.applicable_countries. NULL
destinations.approved_countries STRING, REPEATED Lista de códigos de território CLDR em que a oferta foi aprovada. EUA, CH
destinations.pending_countries STRING, REPEATED Lista de códigos de território CLDR em que a oferta está pendente. EUA, CH
destinations.disapproved_countries STRING, REPEATED Lista de códigos de território CLDR em que a oferta foi reprovada. EUA, CH
issues RECORD, REPEATED A lista de problemas do item associada ao produto.
issues.code STRING O código de erro do problema. image_too_generic
issues.servability STRING Como esse problema afeta a veiculação da oferta. reprovado, não afetado
issues.resolution STRING Se o problema pode ser resolvido pelo comerciante. merchant_action, pending_processing
issues.attribute_name STRING O nome do atributo, se o problema for causado por um único atributo Caso contrário, nulo. Link da imagem
issues.destination STRING O destino a que o problema se aplica. Sempre defina como Shopping. Shopping
issues.short_description STRING Descrição resumida do problema em inglês. Imagem genérica
issues.detailed_description STRING Descrição detalhada do problema em inglês. Use uma imagem que mostre o produto
issues.documentation STRING URL de uma página da web para ajudar a resolver esse problema. https://support.google.com/merchants/answer/6098288
issues.applicable_countries STRING, REPEATED Lista de códigos de território CLDR em que o problema se aplica. CH

Exemplos de consultas

Estatísticas de produtos e problemas relacionados

A amostra de consulta SQL a seguir fornece o número de produtos, produtos com problemas e os problemas por dia.

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

Produtos reprovados para os anúncios do Shopping

A amostra de consulta SQL a seguir fornece o número de produtos que não foram aprovados para serem exibidos nos anúncios do Shopping, separados por país. A reprovação pode acontecer porque o destino foi excluído ou devido a um problema com o produto.

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

Produtos com problemas reprovados

A amostra de consulta SQL a seguir recupera o número de produtos com problemas reprovados, 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