Schema della tabella dei prodotti Google Merchant Center
Panoramica
Quando i dati dei report di Google Merchant Center vengono trasferiti a BigQuery, il formato dei dati relativi ai prodotti e ai problemi dei 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 commerciante
individuale oppure
Products_AGGREGATOR_ID
se utilizzi un account
AMC.
Schema
La tabella Products_
ha il seguente schema:
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 |
ID REST dell'API Content del prodotto nel formato:
channel:content_language:feed_label:offer_id . Questa è la chiave primaria. |
online:en:AU:666840730 |
merchant_id |
INTEGER |
ID account commerciante. | 1234 |
aggregator_id |
INTEGER |
ID account aggregatore per gli account multi-cliente. | 12345 |
offer_id |
STRING |
L'ID del prodotto fornito dal commerciante. | tddy123uk |
title |
STRING |
Titolo dell'articolo. | TN2351 nero USB |
description |
STRING |
Descrizione dell'articolo. | La chiavetta 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 |
L'URL di una versione ottimizzata per il mobile della pagina di destinazione fornito dal commerciante. | https://www.example.com/tn2351-black-usb/6538811?skuId=1234 |
image_link |
STRING |
URL dell'immagine principale del prodotto fornito dal commerciante. | 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 per l'elemento. | it |
target_country |
STRING |
Attributo ritirato (sempre impostato 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 ogni 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 feed per l'articolo o - se non è stata fornita. |
US |
channel |
STRING |
Il canale dell'elemento, online o local . |
locale, online |
expiration_date |
TIMESTAMP |
Data e ora fornite dal commerciante in cui l'articolo deve scadere, come specificato al momento dell'inserimento. Se non viene fornito, il valore predefinito è null. | 2023-10-14 00:00:00 UTC |
google_expiration_date |
TIMESTAMP |
Data e ora in cui l'articolo scade su Google Shopping. Non impostare mai il valore null. | 2023-10-14 00:00:00 UTC |
adult |
BOOLEAN |
Impostato 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 fornito. | neonato, 3-12 mesi, 1-5 anni, bambini, adulti |
availability |
STRING |
Stato di disponibilità dell'articolo fornito dal commerciante. | disponibile, non disponibile |
availability_date |
TIMESTAMP |
Data e ora fornite dal commerciante in cui un prodotto pre-ordinato diventa disponibile per la consegna. NULL se non fornito. | 2023-10-14 00:00:00 UTC |
brand |
STRING |
Marca dell'articolo fornita dal commerciante. NULL se non fornito. | Nome brand |
google_brand_id |
STRING |
ID brand Google dell'articolo. | 12759524623914508053 |
color |
STRING |
Colore dell'articolo fornito dal commerciante. NULL se non fornito. | Argento, grigio, multicolore |
condition |
STRING |
Condizione o stato dell'articolo fornito dal commerciante. | nuovi, usati, ricondizionati |
custom_labels |
RECORD |
Etichette personalizzate fornite dal commerciante per il raggruppamento personalizzato degli articoli negli annunci Shopping. NULL se non 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 fornito. | unisex, maschile, femminile |
gtin |
STRING |
Il Global Trade Item Number (GTIN) dell'articolo fornito dal commerciante. NULL se non fornito. | 3234567890126 |
item_group_id |
STRING |
Identificatore condiviso fornito dal commerciante per tutte le varianti dello stesso prodotto. NULL se non fornito. | AB12345 |
material |
STRING |
Materiale fornito dal commerciante di cui è composto l'articolo. NULL se non fornito. | Pelle |
mpn |
STRING |
Codice parte produttore (MPN) dell'articolo fornito dal commerciante. Impostato su NULL se non fornito. | GO12345OOGLE |
pattern |
STRING |
Pattern fornito dal commerciante. NULL se non 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 |
Prezzo scontato dell'articolo fornito dal commerciante. | |
sale_price.value |
NUMERIC |
Il prezzo scontato dell'articolo. NULL se non fornito. | 19,99 |
sale_price.currency |
STRING |
La valuta del prezzo scontato. NULL se non fornito. | USD |
sale_price_effective_start_date |
TIMESTAMP |
Data e ora di inizio del periodo di offerta dell'articolo. | 2023-10-14 00:00:00 UTC |
sale_price_effective_end_date |
TIMESTAMP |
Data e ora di fine del periodo di offerta dell'articolo. | 2023-10-14 00:00:00 UTC |
google_product_category |
INTEGER |
L'ID della categoria prodotto Google dell'articolo. NULL se non fornito. | 2271 |
google_product_category_ids |
INTEGER, REPEATED |
Il percorso completo delle categorie di prodotto Google all'articolo, memorizzato come insieme di ID. NULL se non fornito. | |
google_product_category_path |
STRING |
Una versione leggibile del percorso completo. Vuoto se non 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 . Ciò corrisponde a "Annunci Shopping" e "Annunci di inventario locale" in Metodi di marketing di Merchant Center. |
Shopping |
destinations.status* |
STRING |
Attributo ritirato (sempre impostato 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 ogni 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 è stata disapprovata. | 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 approvato, invariato |
issues.resolution |
STRING |
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. altrimenti NULL. | link immagine |
issues.destination |
STRING |
La destinazione a cui si applica il problema. 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 raffiguri il prodotto |
issues.documentation |
STRING |
URL di una pagina web per aiutarci a risolvere il problema. | https://support.google.com/merchants/answer/6098288 |
issues.applicable_countries |
STRING, REPEATED |
Elenco dei codici di territorio CLDR in cui si verifica il problema. | CH |
Esempi di query
Questa sezione presenta esempi di query.
Statistiche sui prodotti e sui problemi relativi ai prodotti
La seguente query SQL di esempio fornisce il numero di prodotti, i prodotti con problemi e i 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, suddivisi per paese. La disapprovazione 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 non approvati
La seguente query SQL di esempio 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