Pianificare i trasferimenti da Google Merchant Center

Anteprima

Questo prodotto è soggetto ai "Termini delle offerte pre-GA" nella sezione Termini di servizio generali dei Termini specifici dei servizi. I prodotti pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

Nota: per ricevere assistenza o fornire feedback sui trasferimenti da Google Merchant Center con BigQuery Data Transfer Service, contatta [e-mail].

Prima di iniziare

Prima di creare un trasferimento da Google Merchant Center:

• Verifica di aver completato tutte le azioni necessarie per abilitare BigQuery Data Transfer Service.
• Crea un set di dati BigQuery per archiviare i dati di Google Merchant Center.
  • Per la regione del set di dati, supportiamo l'utilizzo dell'opzione predefinita "Più regioni" negli Stati Uniti o nell'UE.
  • Se vuoi creare un set di dati in una regione specifica, il trasferimento dei dati di Merchant Center è supportato solo nelle seguenti regioni:
  • us-east4 (Northern Virginia),
  • asia-northeast1 (Tokyo),
  • asia-southeast1 (Singapore),
  • australia-southeast1 (Sydney),
  • europe-north1 (Finland),
  • europe-west2 (London),
  • europe-west6 (Zurich).
• Se intendi configurare le notifiche di esecuzione del trasferimento per Pub/Sub, devi disporre delle autorizzazioni pubsub.topics.setIamPolicy. Le autorizzazioni Pub/Sub non sono necessarie se configuri solo le notifiche via email. Per ulteriori informazioni, consulta Notifiche di esecuzione di BigQuery Data Transfer Service.

Autorizzazioni obbligatorie

Assicurati che la persona che crea il trasferimento disponga delle seguenti autorizzazioni obbligatorie:

• BigQuery:

  • bigquery.transfers.update autorizzazioni per creare il trasferimento
  • Entrambe le autorizzazioni bigquery.datasets.get e bigquery.datasets.update sul set di dati di destinazione

  Il ruolo IAM predefinito di bigquery.admin include le autorizzazioni bigquery.transfers.update, bigquery.datasets.update e bigquery.datasets.get. Per ulteriori informazioni sui ruoli IAM in BigQuery Data Transfer Service, consulta Controllo dell'accesso.

• Google Merchant Center

  • Accesso standard all'account Google Merchant Center utilizzato nella configurazione di trasferimento. Per verificare l'accesso, fai clic sulla sezione Utenti nell'interfaccia utente di Google Merchant Center.

  • Per accedere ai dati sulla competitività del prezzo e sui prodotti più venduti, devi soddisfare i requisiti di idoneità per le analisi di mercato.

Configurare un trasferimento da Google Merchant Center

Per configurare un trasferimento di dati per i report di Google Merchant Center devi:

• ID commerciante o ID account multi-cliente: si tratta dell'ID commerciante visualizzato nell'UI di Google Merchant Center.

Per creare un trasferimento di dati per i report di Google Merchant Center:

Console

1. Vai alla pagina BigQuery nella console Google Cloud.

   Vai alla pagina di BigQuery

2. Fai clic su Trasferimenti di dati.

3. Fai clic su Crea trasferimento.

4. Nella pagina Crea trasferimento:

   • Nella sezione Tipo di origine, per Origine, scegli Google Merchant Center.

   • Nella sezione Nome configurazione trasferimento, in Nome visualizzato, inserisci un nome per il trasferimento, ad esempio My Transfer. Il nome del trasferimento può essere qualsiasi valore che ti consenta di identificare il trasferimento, se in seguito dovrai modificarlo.

     

   • Nella sezione Opzioni di pianificazione:

     • Seleziona Frequenza di ripetizione. Se selezioni Ore, Giorni, Settimane o Mesi, devi specificare anche una frequenza. Puoi anche selezionare Personalizzata per specificare una frequenza di ripetizione personalizzata. Se selezioni On demand, questo trasferimento verrà eseguito quando attivi manualmente il trasferimento.

     • Se applicabile, seleziona Inizia ora o Inizia all'ora impostata e fornisci una data di inizio e un'ora di esecuzione.

     • In Data di inizio e ora di esecuzione, inserisci la data e l'ora di inizio del trasferimento. Questo valore deve essere successivo di almeno 24 ore rispetto all'ora UTC attuale. Se hai scelto Inizia ora, questa opzione è disattivata.

       

       Se lasci le opzioni di pianificazione impostate su Inizia ora, la prima esecuzione di trasferimento verrà avviata immediatamente e l'operazione non andrà a buon fine e verrà visualizzato il seguente messaggio di errore: No data to transfer found for the Merchant account. If you have just created this transfer, you may need to wait for up to a day before the data of your Merchant account are prepared and available for the transfer. La successiva esecuzione pianificata dovrebbe essere eseguita correttamente. Se i dati del tuo account commerciante sono stati preparati per la stessa data nel fuso orario UTC, puoi configurare un backfill per l'esecuzione di oggi.

   • Nella sezione Impostazioni destinazione, per Set di dati di destinazione, scegli il set di dati creato per archiviare i dati.

     

   • Nella sezione Dettagli origine dati, in ID commerciante, inserisci il tuo ID commerciante o l'ID AMC.

     Seleziona i report che vuoi trasferire. Per ulteriori dettagli, consulta Report supportati.

     

   • Nel menu Account di servizio, seleziona un account di servizio dagli account di servizio associati al tuo progetto Google Cloud. Puoi associare un account di servizio al trasferimento anziché utilizzare le tue credenziali utente. Per ulteriori informazioni sull'utilizzo di account di servizio con trasferimenti di dati, vedi Utilizzare account di servizio.

     • Se hai eseguito l'accesso con un'identità federata, sarà necessario un account di servizio per creare un trasferimento. Se hai eseguito l'accesso con un Account Google, un account di servizio per il trasferimento è facoltativo.
     • L'account di servizio deve disporre delle autorizzazioni richieste.

   • (Facoltativo) Nella sezione Opzioni di notifica:

     • Fai clic sul pulsante di attivazione/disattivazione per abilitare le notifiche via email. Quando abiliti questa opzione, l'amministratore dei trasferimenti riceve una notifica via email quando un trasferimento non va a buon fine.
     • In Seleziona un argomento Pub/Sub, scegli il nome dell'argomento o fai clic su Crea un argomento. Questa opzione consente di configurare le notifiche di Pub/Sub per il trasferimento.

5. Fai clic su Salva.

bq

Inserisci il comando bq mk e fornisci il flag di creazione del trasferimento --transfer_config. Sono necessari anche i seguenti flag:

• --data_source
• --target_dataset
• --display_name
• --params

Puoi anche fornire il flag --project_id per specificare un progetto specifico. Se --project_id non è specificato, viene utilizzato il progetto predefinito.

bq mk \
--transfer_config \
--project_id=project_id \
--target_dataset=dataset \
--display_name=name \
--params='parameters' \
--data_source=data_source
--service_account_name=service_account_name

Dove:

• project_id è l'ID progetto.
• dataset è il set di dati di destinazione per la configurazione del trasferimento.
• name è il nome visualizzato della configurazione di trasferimento. Il nome del trasferimento può essere qualsiasi valore che ti consenta di identificare il trasferimento, qualora dovessi modificarlo in un secondo momento.
• parameters contiene i parametri per la configurazione di trasferimento creata in formato JSON. Ad esempio: --params='{"param":"param_value"}'.
  • Per i trasferimenti da Google Merchant Center, devi fornire il parametro merchant_id.
  • Il parametro export_products consente di specificare se trasferire i dati sui problemi relativi ai prodotti e ai prodotti. Questo parametro è incluso per impostazione predefinita, anche se non specifichi il parametro export_products. Google consiglia di includere questo parametro in modo esplicito e di impostarlo su "true".
  • Il parametro export_regional_inventories consente di specificare se trasferire i dati degli inventari regionali.
  • Il parametro export_local_inventories consente di specificare se trasferire i dati degli inventari locali.
  • Il parametro export_price_competitiveness consente di specificare se trasferire i dati sulla competitività del prezzo.
  • Il parametro export_price_insights consente di specificare se trasferire i dati degli insight sul prezzo.
  • Il parametro export_best_sellers_v2 consente di specificare se trasferire i dati sui prodotti più venduti.
  • Il parametro export_performance consente di specificare se trasferire i dati sulle prestazioni del prodotto.
• data_source è l'origine dati: merchant_center.
• service_account_name è il nome dell'account di servizio utilizzato per autenticare il trasferimento. L'account di servizio deve essere di proprietà dello stesso project_id utilizzato per creare il trasferimento e deve avere tutte le autorizzazioni richieste.

Attenzione: non puoi configurare le notifiche utilizzando lo strumento a riga di comando.

Ad esempio, il seguente comando crea un trasferimento da Google Merchant Center denominato My Transfer utilizzando l'ID commerciante 1234 e il set di dati di destinazione mydataset. Il trasferimento viene creato nel progetto predefinito.

bq mk \
--transfer_config \
--target_dataset=mydataset \
--display_name='My Transfer' \
--params='{"merchant_id":"1234","export_products":"true","export_regional_inventories":"true","export_local_inventories":"true","export_price_benchmarks":"true","export_best_sellers":"true"}' \
--data_source=merchant_center

La prima volta che esegui il comando, viene visualizzato un messaggio simile al seguente:

[URL omitted] Please copy and paste the above URL into your web browser and follow the instructions to retrieve an authentication code.

Segui le istruzioni nel messaggio e incolla il codice di autenticazione nella riga di comando.

Attenzione: quando crei un trasferimento da Google Merchant Center utilizzando lo strumento a riga di comando, la configurazione del trasferimento viene impostata utilizzando i valori predefiniti per Pianifica (ogni 24 ore, al momento della creazione). La prima esecuzione di trasferimento inizierà immediatamente e non andrà a buon fine con il seguente messaggio di errore: "Nessun dato da trasferire trovato per l'account commerciante.

Se hai appena creato questo trasferimento, potrebbe essere necessario attendere fino a un giorno prima che i dati del tuo account commerciante siano preparati e disponibili per il trasferimento.La successiva esecuzione pianificata dovrebbe andare a buon fine. Se i dati del tuo account commerciante sono stati preparati per la stessa data nel fuso orario UTC, puoi configurare un backfill per l'esecuzione di oggi.

API

Utilizza il metodo projects.locations.transferConfigs.create e fornisci un'istanza della risorsa TransferConfig.

Risolvere i problemi di configurazione del trasferimento da Google Merchant Center

Se riscontri problemi durante la configurazione del trasferimento, consulta Problemi di trasferimento da Google Merchant Center nella sezione Risoluzione dei problemi di configurazione del trasferimento di BigQuery Data Transfer Service.