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