Informazioni di riferimento sul connettore Google Ads

Importante

Questa funzionalità è in versione beta. Gli amministratori dell'area di lavoro possono controllare l'accesso a questa funzionalità dalla pagina Anteprime . Vedere Gestire le anteprime di Azure Databricks.

Questa pagina fornisce informazioni di riferimento per il connettore Google Ads gestito in Lakeflow Connect, incluse le tabelle supportate, le definizioni di colonna e i tipi di dati.

Tabelle supportate

Il connettore Google Ads supporta i tipi di tabelle seguenti:

  • Tabelle delle risorse: dati di configurazione sull'account Google Ads, ad esempio campagne, gruppi di annunci e annunci. Queste tabelle vengono aggiornate completamente in ogni esecuzione della pipeline.
  • Tabelle dei report: metriche delle prestazioni, ad esempio impression, clic e conversioni. Queste tabelle supportano l'inserimento incrementale.

Tabelle delle risorse

Nome della tabella Description
customer Informazioni sugli account Google Ads.
campaign Configurazione e impostazioni della campagna.
campaign_budget Impostazioni del budget per le campagne.
campaign_criterion Criteri di destinazione per le campagne.
ad_group Configurazione del gruppo di annunci.
ad_group_criterion Criteri di destinazione per i gruppi di annunci.
ad Dettagli e impostazioni dei singoli annunci.

Tabelle del rapporto

Nome della tabella Description
customer_report Metriche delle prestazioni a livello di account.
campaign_report Metriche delle prestazioni a livello di campagna.
ad_group_report Metriche delle prestazioni a livello di gruppo di annunci.
ad_report Metriche delle prestazioni a livello di annuncio.
keyword_report Metriche delle prestazioni a livello di parola chiave.
search_query_report Cercare le metriche delle prestazioni a livello di query.

Convenzioni dei tipi di dati

Archiviazione dei soldi (micro)

Google Ads archivia i valori monetari in microunità per evitare problemi di arrotondamento. Un milione di micro è uguale a un'unità di valuta:

  • 1,000,000 micros = $1.00 USD
  • 5,500,000 micros = $5.50 USD

I campi con _micros suffisso contengono valori archiviati in micro. Dividere per 1.000.000 per convertire nella tua valuta.

Chiavi primarie

Le tabelle usano (Primary Key) la notazione per indicare le colonne che formano la chiave primaria. Le chiavi primarie composite sono indicate da più colonne contrassegnate come (Primary Key).

Schemi di tabella delle risorse

customer

Informazioni sugli account Google Ads.

colonna Tipo di dati Description
id long Chiave primaria. ID cliente dell'account.
resource_name string Nome della risorsa di Google Ads.
descriptive_name string Nome intuitivo per l'account Google Ads.
currency_code string Codice valuta per l'account.
time_zone string Fuso orario dell'account.
status string Stato dell'account.
manager boolean Indica se il cliente è un Responsabile Account (MCC).

campaign

Configurazione e impostazioni della campagna.

colonna Tipo di dati Description
id long Chiave primaria. ID campagna.
name string Nome campagna.
status string Stato della campagna.
advertising_channel_type string Tipo di canale pubblicitario.
start_date string Data di inizio della campagna.
end_date string Data di fine campagna.
campaign_budget string Budget associato della campagna.
bidding_strategy_type string Tipo di strategia di offerta.

campaign_budget

Impostazioni del budget per le campagne.

colonna Tipo di dati Description
id long Chiave primaria. ID budget.
resource_name string Nome della risorsa di Google Ads.
name string Nome budget.
amount_micros long Importo del budget in micros. Dividere per 1.000.000 per convertire in valuta.
delivery_method string Come Google spende il budget giornaliero (standard o accelerato).
period string Periodo di bilancio.
status string Stato del budget.

campaign_criterion

Criteri di destinazione per le campagne.

colonna Tipo di dati Description
campaign_id long Chiave primaria. ID campagna.
criterion_id long Chiave primaria. ID del criterio.
resource_name string Nome della risorsa di Google Ads.
type string Tipo di criterio.
status string Stato del criterio.
negative boolean Indica se questo criterio esclude un gruppo di destinatari.
bid_modifier double Valore del modificatore dell'offerta.

ad_group

Configurazione del gruppo di annunci.

colonna Tipo di dati Description
id long Chiave primaria. L'ID del gruppo di annunci.
name string Nome del gruppo di annunci.
status string Stato del gruppo di annunci.
campaign_id long ID associato alla campagna.
type string Tipo di gruppo di annunci.
cpc_bid_micros long Offerta costo per clic in micro-unità.
target_cpa_micros long Costo di destinazione per acquisizione in micros.

ad_group_criterion

Criteri di destinazione per i gruppi di annunci.

colonna Tipo di dati Description
criterion_id long Chiave primaria. ID criterio.
ad_group_id long Chiave primaria. ID del gruppo di annunci.
resource_name string Nome della risorsa di Google Ads.
status string Stato del criterio.
type string Tipo di criterio.
negative boolean Indica se questo criterio esclude un gruppo di destinatari.
keyword_match_type string Tipo di corrispondenza della parola chiave (esatto, frase, ampio).
keyword_text string Testo della parola chiave.

Dettagli e impostazioni dei singoli annunci. Questa tabella corrisponde all'API ad_group_ad Google Ads.

colonna Tipo di dati Description
id long Chiave primaria. ID annuncio.
ad_group_id long Chiave primaria. ID gruppo annuncio.
status string Stato dell'annuncio.
ad_type string Tipo di annuncio.
final_urls array<string> URL della pagina di destinazione dopo aver fatto clic sull'annuncio.
policy_summary_approval_status string Indica se l'annuncio è approvato in criteri di Google Ads (APPROVATO o DISAPPROVED).
policy_summary_review_status string Indica se Google ha completato la revisione dell'annuncio (REVIEW_IN_PROGRESS o REVIEWED).

Schemi di tabella del report

customer_report

Metriche delle prestazioni a livello di account.

colonna Tipo di dati Description
customer_id long Chiave primaria. ID cliente dell'account.
date string Chiave primaria. Data in formato AAAA-MM-DD.
device string Chiave primaria. Tipo di dispositivo.
ad_network_type string Chiave primaria. Tipo di rete degli annunci.
impressions long Numero di impressioni.
clicks long Numero di clic.
cost_micros long Costo in micro. Dividere per 1.000.000 per convertire in valuta.
conversions double Numero di conversioni.
conversions_value double Valore di conversione totale.
ctr double Frequenza di clic.
average_cpc double Costo medio per clic.

campaign_report

Metriche delle prestazioni a livello di campagna.

colonna Tipo di dati Description
customer_id long Chiave primaria. ID cliente dell'account.
id long Chiave primaria. ID campagna.
date string Chiave primaria. Data in formato AAAA-MM-DD.
device string Chiave primaria. Tipo di dispositivo.
ad_network_type string Chiave primaria. Tipo di rete degli annunci.
campaign_name string Nome campagna.
campaign_status string Stato della campagna.
impressions long Numero di impressioni.
clicks long Numero di clic.
cost_micros long Costo in micro.
conversions double Numero di conversioni.

ad_group_report

Metriche delle prestazioni a livello di gruppo di annunci.

colonna Tipo di dati Description
customer_id long Chiave primaria. ID cliente dell'account.
id long Chiave primaria. ID gruppo annuncio.
date string Chiave primaria. Data in formato AAAA-MM-DD.
device string Chiave primaria. Tipo di dispositivo.
ad_network_type string Chiave primaria. Tipo di rete degli annunci.
ad_group_name string Nome del gruppo di annunci.
ad_group_status string Stato del gruppo di annunci.
campaign_id long ID associato alla campagna.
impressions long Numero di impressioni.
clicks long Numero di clic.
cost_micros long Costo in micro.

keyword_report

Metriche delle prestazioni a livello di parola chiave.

colonna Tipo di dati Description
customer_id long Chiave primaria. ID cliente dell'account.
date string Chiave primaria. Data in formato AAAA-MM-DD.
ad_group_criterion_criterion_id long Chiave primaria. ID criterio.
ad_group_id long Chiave primaria. ID gruppo annuncio.
device string Chiave primaria. Tipo di dispositivo.
ad_network_type string Chiave primaria. Tipo di rete degli annunci.
keyword_text string Testo della parola chiave.
keyword_match_type string Tipo di corrispondenza della parola chiave.
impressions long Numero di impressioni.
clicks long Numero di clic.
cost_micros long Costo in micro.

ad_report

Metriche delle prestazioni a livello di annuncio.

colonna Tipo di dati Description
customer_id long Chiave primaria. ID cliente dell'account.
date string Chiave primaria. Data in formato AAAA-MM-DD.
ad_id long Chiave primaria. ID annuncio.
ad_group_id long Chiave primaria. ID gruppo annuncio.
device string Chiave primaria. Tipo di dispositivo.
ad_network_type string Chiave primaria. Tipo di rete degli annunci.
campaign_id long ID associato alla campagna.
impressions long Numero di impressioni.
clicks long Numero di clic.
cost_micros long Costo in micro.
conversions double Numero di conversioni.

search_query_report

Cercare le metriche delle prestazioni a livello di query.

colonna Tipo di dati Description
customer_id long Chiave primaria. ID cliente dell'account.
date string Chiave primaria. Data in formato AAAA-MM-DD.
resource_name string Chiave primaria. Nome della risorsa di Google Ads.
search_term string Termine di ricerca dell'utente.
search_term_match_type string Corrispondenza della parola chiave con il termine di ricerca.
ad_group_id long ID gruppo di annunci associato.
campaign_id long ID associato alla campagna.
impressions long Numero di impressioni.
clicks long Numero di clic.

Inserimento incrementale

Le tabelle di report supportano l'inserimento incrementale con una finestra di lookback configurabile. Il connettore usa la date colonna come colonna cursore per tenere traccia degli aggiornamenti incrementali.

Per altre informazioni sull'inserimento incrementale e sulle finestre di lookback, vedere Concetti relativi al connettore Google Ads.

  • Last updated on