Pianificare i trasferimenti di 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 di Google Merchant Center con BigQuery Data Transfer Service, contatta [e-mail].

Prima di iniziare

Prima di creare un trasferimento di dati di 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 dei trasferimenti 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 dei dati disponga delle seguenti autorizzazioni obbligatorie:

• BigQuery:

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

  Il ruolo IAM predefinito bigquery.admin include le autorizzazioni bigquery.transfers.update, bigquery.datasets.update e bigquery.datasets.get. Per saperne di più 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 del trasferimento. Puoi verificare l'accesso facendo clic sulla sezione Utenti nell'interfaccia utente di Google Merchant Center.

  • Per accedere ai dati sulla competitività dei prezzi e sui prodotti più venduti, devi soddisfare i requisiti di idoneità per Market Insights.

Configurare un trasferimento di Google Merchant Center

La configurazione di un trasferimento di dati per i report di Google Merchant Center richiede quanto segue:

• ID commerciante o ID account multicliente: si tratta dell'ID commerciante mostrato nella UI di Google Merchant Center.

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

Console

1. Vai alla pagina Trasferimenti dati nella console Google Cloud.

   Vai a Trasferimenti dati

2. Fai clic su Crea trasferimento.

3. Nella pagina Crea trasferimento:

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

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

     

   • Nella sezione Opzioni di programmazione:

     • Seleziona una Frequenza di ripetizione. Se selezioni Ore, Giorni, Settimane o Mesi, devi anche specificare una frequenza. Puoi anche selezionare Personalizzata per specificare una frequenza di ripetizione personalizzata. Se selezioni On demand, questo trasferimento di dati viene 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 all'ora UTC corrente di almeno 24 ore. Se hai scelto Inizia ora, questa opzione è disabilitata.

       

       Se lasci le opzioni di pianificazione impostate su Avvia ora, la prima esecuzione del trasferimento dei dati inizierà immediatamente e non andrà a buon fine con 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 vengono preparati nella stessa data in ora UTC, puoi configurare un backfill per l'esecuzione di oggi.

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

     

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

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

     

   • Nel menu Account di servizio, seleziona un account di servizio tra quelli associati al tuo progetto Google Cloud. Puoi associare un account di servizio al trasferimento dei dati anziché utilizzare le credenziali utente. Per ulteriori informazioni sull'utilizzo degli account di servizio con i trasferimenti di dati, consulta Utilizzare gli account di servizio.

     • Se hai eseguito l'accesso con un'identità federata, è necessario un account di servizio per creare un trasferimento di dati. 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 attivare le notifiche via email. Se attivi questa opzione, l'amministratore dei trasferimenti riceve una notifica via email quando un'esecuzione del 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 configura le notifiche di esecuzione di Pub/Sub per il trasferimento.

4. Fai clic su Salva.

bq

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

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

Puoi anche fornire il flag --project_id per specificare un determinato progetto. 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 se devi modificarlo in un secondo momento.
• parameters contiene i parametri per la configurazione del trasferimento creata in formato JSON. Ad esempio: --params='{"param":"param_value"}'.
  • Per i trasferimenti di dati di Google Merchant Center, devi fornire il parametro merchant_id.
  • Il parametro export_products specifica se trasferire i dati di prodotto e dei problemi relativi ai prodotti. Questo parametro è incluso per impostazione predefinita, anche se non specifichi il parametro export_products. Google consiglia di includere questo parametro esplicitamente e di impostarlo su "true".
  • Il parametro export_regional_inventories specifica se trasferire i dati degli inventari regionali.
  • Il parametro export_local_inventories specifica se trasferire i dati degli inventari locali.
  • Il parametro export_price_competitiveness specifica se trasferire i dati sulla competitività del prezzo.
  • Il parametro export_price_insights specifica se trasferire i dati degli approfondimenti sui prezzi.
  • Il parametro export_best_sellers_v2 specifica se trasferire o meno i dati dei best seller.
  • Il parametro export_performance specifica se trasferire i dati sul rendimento del prodotto.
• data_source è l'origine dati - merchant_center.
• service_account_name è il nome dell'account di servizio utilizzato per autenticare il trasferimento dei dati. L'account di servizio deve essere di proprietà dello stesso project_id utilizzato per creare il trasferimento e deve disporre di 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 di dati di Google Merchant Center chiamato My Transfer utilizzando l'ID commerciante 1234 e il set di dati di destinazione mydataset. Il trasferimento dei dati 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, ricevi 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 di dati di 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 del trasferimento verrà avviata immediatamente e non andrà a buon fine con il seguente messaggio di errore: "Nessun dato da trasferire per l'account commerciante

.

Se hai appena creato questo trasferimento di dati, potrebbe essere necessario attendere fino a un giorno prima che i dati del tuo account commerciante vengano preparati e resi disponibili per il trasferimento.La successiva esecuzione pianificata dovrebbe essere eseguita correttamente. Se i dati del tuo account Merchant vengono preparati nella stessa data in ora 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 di Google Merchant Center

Se hai problemi a configurare il trasferimento dei dati, consulta Problemi di trasferimento di Google Merchant Center in Risolvere i problemi di configurazione del trasferimento di BigQuery Data Transfer Service.