Schema della tabella dei prodotti Google Merchant Center

Panoramica

Quando i dati dei report di Google Merchant Center vengono trasferiti in BigQuery, il formato dei dati di prodotto e dei problemi relativi ai prodotti corrisponde principalmente al formato dei campi pertinenti delle risorse Products e Productstatuses dell'API Content.

I dati vengono scritti in una tabella denominata Products_MERCHANT_ID se utilizzi un ID singolo Merchant o Products_AGGREGATOR_ID se utilizzi un account AMC.

Nota: i dati Products and product issues non sono disponibili immediatamente al primo richiede del report. Quando richiedi per la prima volta un trasferimento per un ID commerciante o aggregatore, potrebbe verificarsi un ritardo fino a un giorno prima che la tabella Products_ sia disponibile per l'esportazione.

Schema

La tabella Products_ ha lo schema seguente:

Colonna	Tipo di dati BigQuery	Descrizione	Dati di esempio
product_data_timestamp	TIMESTAMP	Timestamp dei dati di prodotto.	2023-09-14 11:49:50 UTC
product_id	STRING	L'ID REST dell'API Content del prodotto nel formato: channel:content_language:feed_label:offer_id. Questa è la chiave primaria.	online:it:AU:666840730
merchant_id	INTEGER	ID account commerciante.	1234
aggregator_id	INTEGER	ID account aggregatore per gli account multi-cliente.	12345
offer_id	STRING	ID del prodotto fornito dal commerciante.	tddy123uk
title	STRING	Titolo dell'articolo.	TN2351 USB nero
description	STRING	Descrizione dell'articolo.	La porta USB nera TN2351 ha ridefinito il modo in cui XJS può influire sulle esperienze LLCD.
link	STRING	URL della pagina di destinazione del prodotto fornito dal commerciante.	https://www.example.com/tn2351-black-usb/6538811?skuId=1234
mobile_link	STRING	URL di una versione ottimizzata per il mobile della pagina di destinazione fornita dal commerciante.	https://www.example.com/tn2351-black-usb/6538811?skuId=1234
image_link	STRING	Il commerciante ha fornito l'URL dell'immagine principale del prodotto.	https://www.example.com/tn2351-black-usb/6538811?skuId=1234
additional_image_links	STRING, REPEATED	Il commerciante ha fornito URL aggiuntivi di immagini dell'articolo.
content_language	STRING	Il codice lingua ISO 639-1 di due lettere dell'elemento.	it
target_country	STRING	Ritirato (impostato sempre su NULL) nell'ambito di una modifica volta a consentire la selezione di più paesi di destinazione per i prodotti. Utilizza invece i seguenti campi per leggere lo stato di ciascun paese di destinazione: destinations.approved_countries, destinations.pending_countries, destinations.disapproved_countries. Ora i problemi possono riguardare specifici paesi di destinazione e non necessariamente tutti, come indicato nel campo issues.applicable_countries.	null
feed_label	STRING	Il commerciante ha fornito l'etichetta del feed per l'articolo o - se non è stata fornita.	US
channel	STRING	Il canale dell'elemento, online o local.	locale, online
expiration_date	TIMESTAMP	Il commerciante ha fornito la data e l'ora di scadenza dell'articolo, come specificato al momento dell'inserimento. Se non viene fornito, il valore predefinito è null.	14-10-2023 00:00:00 UTC
google_expiration_date	TIMESTAMP	Data e ora di scadenza dell'articolo su Google Shopping. Non deve mai essere impostato su null.	14-10-2023 00:00:00 UTC
adult	BOOLEAN	Imposta su true se l'articolo è destinato agli adulti.	true, false
age_group	STRING	Fascia d'età di destinazione dell'articolo fornita dal commerciante. NULL se non viene fornito.	neonato, 3-12 mesi, 1-5 anni, bambini, adulti
availability	STRING	Lo stato di disponibilità dell'articolo fornito dal commerciante.	disponibile, non disponibile
availability_date	TIMESTAMP	Data e ora fornite dal commerciante quando un prodotto pre-ordinato diventa disponibile per la consegna. NULL se non viene fornito.	14-10-2023 00:00:00 UTC
brand	STRING	Marca dell'articolo fornita dal commerciante. NULL se non viene fornito.	Nome del brand
google_brand_id	STRING	ID brand Google dell'articolo.	12759524623914508053
color	STRING	Il commerciante ha fornito il colore dell'articolo. NULL se non viene fornito.	Argento, Grigio, Multicolore
condition	STRING	Condizione fornita dal commerciante o stato dell'articolo.	nuovo, usato, ricondizionato
custom_labels	RECORD	Il commerciante ha fornito etichette personalizzate per il raggruppamento personalizzato degli articoli negli annunci Shopping. NULL se non viene fornito.
custom_labels.label_0	STRING	Etichetta personalizzata 0.	la mia etichetta personalizzata
custom_labels.label_1	STRING	Etichetta personalizzata 1.	la mia etichetta personalizzata
custom_labels.label_2	STRING	Etichetta personalizzata 2.	la mia etichetta personalizzata
custom_labels.label_3	STRING	Etichetta personalizzata 3.	la mia etichetta personalizzata
custom_labels.label_4	STRING	Etichetta personalizzata 4.	la mia etichetta personalizzata
gender	STRING	Genere target dell'articolo fornito dal commerciante. NULL se non viene fornito.	unisex, maschile, femminile
gtin	STRING	Il codice Global Trade Item Number (GTIN) dell'articolo fornito dal commerciante. NULL se non viene fornito.	3234567890126
item_group_id	STRING	Identificatore condiviso fornito dal commerciante per tutte le varianti dello stesso prodotto. NULL se non viene fornito.	AB12345
material	STRING	Materiale fornito dal commerciante con cui è realizzato l'articolo. NULL se non viene fornito.	Pelle
mpn	STRING	Il codice parte produttore (MPN) fornito dal commerciante dell'articolo. Impostato su NULL se non viene fornito.	GO12345OOGLE
pattern	STRING	Pattern fornito dal commerciante. NULL se non viene fornito.	A righe
price	RECORD	Prezzo dell'articolo fornito dal commerciante.
price.value	NUMERIC	Il prezzo dell'articolo.	19,99
price.currency	STRING	La valuta del prezzo.	USD
sale_price	RECORD	Il commerciante ha fornito il prezzo scontato dell'articolo.
sale_price.value	NUMERIC	Il prezzo scontato dell'articolo. NULL se non viene fornito.	19,99
sale_price.currency	STRING	La valuta del prezzo scontato. NULL se non viene fornito.	USD
sale_price_effective_start_date	TIMESTAMP	Data e ora di inizio del periodo in cui l'articolo è in promozione.	14-10-2023 00:00:00 UTC
sale_price_effective_end_date	TIMESTAMP	Data e ora di fine del periodo in cui l'articolo è in saldo.	14-10-2023 00:00:00 UTC
google_product_category	INTEGER	L'ID categoria prodotto Google dell'articolo. NULL se non viene fornito.	2271
google_product_category_ids	INTEGER, REPEATED	Il percorso completo delle categorie di prodotto Google fino all'articolo, memorizzato come insieme di ID. NULL se non viene fornito.
google_product_category_path	STRING	Una versione leggibile del percorso completo. Vuoto se non viene fornito.	Abbigliamento e accessori > Abbigliamento > Abiti
product_type	STRING	Categoria dell'articolo fornita dal commerciante.	Casa > Donna > Abiti > Abiti lunghi
additional_product_types	STRING, REPEATED	Categorie aggiuntive dell'articolo.
promotion_ids	STRING, REPEATED	L'elenco degli ID promozione associati al prodotto.
destinations	RECORD, REPEATED	Le destinazioni previste per il prodotto.
destinations.name	STRING	Il nome della destinazione. È supportato solo Shopping. Corrisponde ai metodi di marketing "Annunci Shopping" e "Annunci di inventario locale" in Merchant Center.	Shopping
destinations.status*	STRING	Ritirato (impostato sempre su NULL) nell'ambito di una modifica volta a consentire la selezione di più paesi di destinazione per i prodotti. Utilizza invece i seguenti campi per leggere lo stato di ciascun paese di destinazione: destinations.approved_countries, destinations.pending_countries, destinations.disapproved_countries. Ora i problemi possono riguardare specifici paesi di destinazione e non necessariamente tutti, come indicato nel campo issues.applicable_countries.	NULL
destinations.approved_countries	STRING, REPEATED	Elenco dei codici di territorio CLDR in cui l'offerta è approvata.	US, CH
destinations.pending_countries	STRING, REPEATED	Elenco dei codici di territorio CLDR in cui l'offerta è in attesa.	US, CH
destinations.disapproved_countries	STRING, REPEATED	Elenco dei codici di territorio CLDR in cui l'offerta non è approvata.	US, CH
issues	RECORD, REPEATED	L'elenco dei problemi a livello di articolo associati al prodotto.
issues.code	STRING	Il codice di errore del problema.	image_too_generic
issues.servability	STRING	In che modo questo problema influisce sulla pubblicazione dell'offerta.	non approvate, non interessate
issues.resolution	STRING	Indica se il problema può essere risolto dal commerciante.	merchant_action, pending_processing
issues.attribute_name	STRING	Il nome dell'attributo, se il problema è causato da un singolo attributo. NULL altrimenti.	link immagine
issues.destination	STRING	La destinazione a cui si applica il problema. Deve essere sempre impostato su Shopping.	Shopping
issues.short_description	STRING	Breve descrizione del problema in inglese.	Immagine generica
issues.detailed_description	STRING	Descrizione dettagliata del problema in inglese.	Utilizza un'immagine che mostri il prodotto
issues.documentation	STRING	URL di una pagina web che possa aiutarci a risolvere il problema.	https://support.google.com/merchants/answer/6098288
issues.applicable_countries	STRING, REPEATED	Elenco dei codici di territorio CLDR a cui si applica il problema.	CH

Esempi di query

Statistiche relative a prodotti e problemi relativi ai prodotti

La seguente query di esempio SQL fornisce il numero di prodotti, prodotti con problemi e problemi per giorno.

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

Prodotti non approvati per gli annunci Shopping

La seguente query SQL di esempio fornisce il numero di prodotti non approvati per la visualizzazione negli annunci Shopping, separati per paese. La mancata approvazione può essere dovuta all'esclusione della destinazione o a un problema con il prodotto.

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

Prodotti con problemi di mancata approvazione

La seguente query di esempio SQL recupera il numero di prodotti con problemi non approvati, separati per paese.

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

Nota: questa query genera una chiave univoca utilizzando merchant_id e product_id. Questo passaggio è necessario solo se hai un account AMC. Quando utilizzi un account AMC, esiste la possibilità di product_idcollisioni in più subaccount

.