Copiare dati da Google Ads usando Azure Data Factory o Synapse Analytics
SI APPLICA A: Azure Data Factory Azure Synapse Analytics
Suggerimento
Provare Data Factory in Microsoft Fabric, una soluzione di analisi completa per le aziende. Microsoft Fabric copre tutti gli elementi, dallo spostamento dei dati all'analisi scientifica dei dati, all'analisi in tempo reale, alla business intelligence e alla creazione di report. Scopri come avviare gratuitamente una nuova versione di valutazione .
Questo articolo illustra come usare l'attività di copia in una pipeline di Azure Data Factory o Synapse Analytics per copiare dati da Google Ads. Si basa sull'articolo di panoramica dell'attività di copia che presenta una panoramica generale sull'attività di copia.
Importante
Aggiorna la versione del driver google Ads prima del 18 febbraio 2024. In caso contrario, la connessione verrà avviata con un errore a causa della deprecazione del driver legacy.
Funzionalità supportate
Questo connettore Google Ads è supportato per le funzionalità seguenti:
Funzionalità supportate | IR |
---|---|
attività Copy (source/-) | (1) (2) |
Attività Lookup | (1) (2) |
(1) Runtime di integrazione di Azure (2) Runtime di integrazione self-hosted
Per un elenco degli archivi dati supportati come origini/sink, vedere la tabella Archivi dati supportati.
Il servizio fornisce un driver predefinito per abilitare la connettività, pertanto non è necessario installare manualmente alcun driver usando questo connettore.
Attività iniziali
Per eseguire l'attività di copia con una pipeline, è possibile usare uno degli strumenti o SDK seguenti:
- Strumento Copia dati
- Il portale di Azure
- .NET SDK
- The Python SDK
- Azure PowerShell
- The REST API
- Modello di Azure Resource Manager
Creare un servizio collegato a Google Ads usando l'interfaccia utente
Seguire questa procedura per creare un servizio collegato a Google Ads nell'interfaccia utente di portale di Azure.
Passare alla scheda Gestisci nell'area di lavoro di Azure Data Factory o Synapse e selezionare Servizi collegati, quindi fare clic su Nuovo:
Cercare Google Ads e selezionare il connettore Google Ads.
Configurare i dettagli del servizio, testare la connessione e creare il nuovo servizio collegato.
Dettagli di configurazione di Connessione or
Le sezioni seguenti forniscono informazioni dettagliate sulle proprietà usate per definire entità di Data Factory specifiche del connettore Google Ads.
Proprietà del servizio collegato
Per il servizio collegato Google Ads sono supportate le proprietà seguenti:
Proprietà | Descrizione | Obbligatorio |
---|---|---|
type | La proprietà tipo deve essere impostata su GoogleAdWords | Sì |
googleAdsApiVersion | Versione dell'API Google Ads usata quando si seleziona la versione consigliata del driver. È possibile fare riferimento a questo articolo per informazioni sulla versione dell'API. | Sì |
clientCustomerID | ID cliente client dell'account Ads per cui vuoi recuperare i dati del report. | Sì |
loginCustomerID | ID cliente dell'account di Google Ads Manager tramite il quale vuoi recuperare i dati del report di un cliente specifico. | No |
developerToken | Token dello sviluppatore associato all'account manager usato per concedere l'accesso all'API Ads. È possibile scegliere di contrassegnare questo campo come SecureString per archiviarlo in modo sicuro o archiviare la password in Azure Key Vault e consentire all'attività di copia di eseguire il pull da questa posizione durante l'esecuzione della copia dei dati. Per altre informazioni, vedere Archiviare le credenziali in Key Vault. | Sì |
authenticationType | Meccanismo di autenticazione OAuth 2.0 usato per l'autenticazione. I valori consentiti sono: ServiceAuthentication, UserAuthentication. È possibile usare ServiceAuthentication solo su runtime di integrazione self-hosted. |
Sì |
Per UserAuthentication: | ||
refreshToken | Token di aggiornamento ottenuto da Google per autorizzare l'accesso ad Ads for UserAuthentication. È possibile scegliere di contrassegnare questo campo come SecureString per archiviarlo in modo sicuro o archiviare la password in Azure Key Vault e consentire all'attività di copia di eseguire il pull da questa posizione durante l'esecuzione della copia dei dati. Per altre informazioni, vedere Archiviare le credenziali in Key Vault. | No |
clientId | ID client dell'applicazione Google usato per acquisire il token di aggiornamento. È possibile scegliere di contrassegnare questo campo come SecureString per archiviarlo in modo sicuro o archiviare la password in Azure Key Vault e consentire all'attività di copia di eseguire il pull da questa posizione durante l'esecuzione della copia dei dati. Per altre informazioni, vedere Archiviare le credenziali in Key Vault. | No |
clientSecret | Il segreto client dell'applicazione google usata per acquisire il token di aggiornamento. È possibile scegliere di contrassegnare questo campo come SecureString per archiviarlo in modo sicuro o archiviare la password in Azure Key Vault e consentire all'attività di copia di eseguire il pull da questa posizione durante l'esecuzione della copia dei dati. Per altre informazioni, vedere Archiviare le credenziali in Key Vault. | No |
Per ServiceAuthentication: | ||
posta elettronica | ID di posta elettronica dell'account del servizio usato per ServiceAuthentication. Può essere usato solo su runtime di integrazione self-hosted. | No |
privateKey | La chiave privata del servizio usata per ServiceAuthentication per la versione consigliata del driver e può essere usata solo nel runtime di integrazione self-hosted. È possibile scegliere di contrassegnare questo campo come SecureString per archiviarlo in modo sicuro o archiviare la password in Azure Key Vault e consentire all'attività di copia di eseguire il pull da questa posizione durante l'esecuzione della copia dei dati. Per altre informazioni, vedere Archiviare le credenziali in Key Vault. | No |
Per ServiceAuthentication usando la versione del driver legacy: | ||
posta elettronica | ID di posta elettronica dell'account del servizio usato per ServiceAuthentication. Può essere usato solo su runtime di integrazione self-hosted. | No |
keyFilePath | Percorso completo del .p12 file di chiave o .json usato per autenticare l'indirizzo di posta elettronica dell'account del servizio e può essere usato solo nel runtime di integrazione self-hosted. |
No |
trustedCertPath | Percorso completo del file con estensione pem contenente certificati CA attendibili per verificare il server durante la connessione tramite TLS. Questa proprietà può essere impostata solo quando si usa TLS in runtime di integrazione self-hosted. Il valore predefinito è il file cacerts.pem installato con il runtime di integrazione. | No |
useSystemTrustStore | Specifica se usare o meno un certificato della CA dall'archivio di scopi consentiti o da un file .pem specificato. Il valore predefinito è false. | No |
Esempio:
{
"name": "GoogleAdsLinkedService",
"properties": {
"type": "GoogleAdWords",
"typeProperties": {
"clientCustomerID": "<clientCustomerID>",
"loginCustomerID": "<loginCustomerID>",
"developerToken": {
"type": "SecureString",
"value": "<developerToken>"
},
"authenticationType": "UserAuthentication",
"refreshToken": {
"type": "SecureString",
"value": "<refreshToken>"
},
"clientId": {
"type": "SecureString",
"value": "<clientId>"
},
"clientSecret": {
"type": "SecureString",
"value": "<clientSecret>"
},
"googleAdsApiVersion": "v14"
}
}
}
Proprietà del set di dati
Per un elenco completo delle sezioni e delle proprietà disponibili per la definizione di set di dati, vedere l'articolo sui set di dati. Questa sezione fornisce un elenco delle proprietà supportate dal set di dati di Google Ads.
Per copiare dati da Google Ads, impostare la proprietà type del set di dati su GoogleAdWordsObject. Sono supportate le proprietà seguenti:
Proprietà | Descrizione | Obbligatorio |
---|---|---|
type | La proprietà type del set di dati deve essere impostata su: GoogleAdWordsObject | Sì |
tableName | Nome della tabella. Specificare questa proprietà quando si usa la versione del driver legacy. | No (se nell'origine dell'attività è specificato "query") |
Esempio
{
"name": "GoogleAdsDataset",
"properties": {
"type": "GoogleAdWordsObject",
"typeProperties": {},
"schema": [],
"linkedServiceName": {
"referenceName": "<GoogleAds linked service name>",
"type": "LinkedServiceReference"
}
}
}
Proprietà dell'attività di copia
Per un elenco completo delle sezioni e delle proprietà disponibili per la definizione delle attività, vedere l'articolo sulle pipeline. Questa sezione fornisce un elenco delle proprietà supportate dall'origine Google Ads.
Google Ads come origine
Per copiare dati da Google Ads, impostare il tipo di origine nell'attività di copia su GoogleAdWordsSource. Nella sezione origine dell'attività di copia sono supportate le proprietà seguenti:
Proprietà | Descrizione | Obbligatorio |
---|---|---|
type | La proprietà tipo dell'origine dell'attività di copia deve essere impostata su: GoogleADWordsSource | Sì |
query | Usare la query GAQL per leggere i dati. Ad esempio: SELECT campaign.id FROM campaign . |
No (se nel set di dati è specificato "tableName") |
Esempio:
"activities":[
{
"name": "CopyFromGoogleAds",
"type": "Copy",
"inputs": [
{
"referenceName": "<GoogleAds input dataset name>",
"type": "DatasetReference"
}
],
"outputs": [
{
"referenceName": "<output dataset name>",
"type": "DatasetReference"
}
],
"typeProperties": {
"source": {
"type": "GoogleAdWordsSource",
"query": "SELECT campaign.id FROM campaign"
},
"sink": {
"type": "<sink type>"
}
}
}
]
Proprietà dell'attività Lookup
Per altre informazioni sulle proprietà, vedere Attività Lookup.
Aggiornare la versione del driver Google Ads
Per aggiornare la versione del driver Google Ads, è necessario aggiornare il servizio collegato e imparare a eseguire la migrazione da SQL a Google Ads Query Language (GAQL).
Aggiornare la configurazione del servizio collegato
Nella pagina Modifica servizio collegato selezionare Consigliato in Versione driver e configurare il servizio collegato facendo riferimento alle proprietà del servizio collegato.
Eseguire la migrazione da SQL a GAQL
Convertire le istruzioni di query e i nomi dei campi durante la migrazione da SQL a GAQL.
Istruzioni di query
Se si usa una query SQL nell'origine dell'attività di copia o nell'attività di ricerca che fa riferimento al servizio collegato Google Ads legacy, è necessario aggiornarli alla query GAQL.
A differenza di SQL, la query in GAQL è costituita da sei tipi di clausole:
SELECT
FROM
WHERE
ORDER BY
LIMIT
PARAMETERS
Passare a Grammatica del linguaggio di query di Google Ads per l'introduzione di GAQL.
Si prenda l'istruzione SQL seguente come esempio:
SELECT *|FieldName FROM ResourceName WHERE FieldName Operator Value
È possibile seguire le indicazioni seguenti per convertire l'istruzione SQL nell'istruzione GAQL corrispondente:
- Se
*
(asterisco) viene usato dopo laSELECT
clausola , è necessario specificare tutti i campi obbligatori al posto dell'asterisco perché GAQL non supportaSELECT *
. Passare a questo articolo per visualizzare tutti i campi selezionabili nella risorsa specifica. - Se il nome del campo viene usato dopo la
SELECT
clausola , è necessario convertire il nome nel nome del campo corrispondente in GAQL in quanto hanno convenzioni di denominazione diverse. Ad esempio, il nomecampaign_id
del campo nell'istruzione query SQL deve essere convertitocampaign.id
in in GAQL. Per altri dettagli sulla conversione del nome del campo, vedere Nome campo . - Il nome della risorsa può essere lasciato così com'è, a meno che il relativo caso non sia coerente con quanto specificato qui.
WHERE
la clausola deve essere aggiornata in base alla grammatica GAQL perché gli operatori supportati da GAQL non sono coerenti con SQL e anche il nome del campo deve essere convertito come descritto nel secondo punto.
Ecco due strumenti molto utili offerti da Google e sono altamente consigliati quando si compilano le istruzioni di query GAQL corrispondenti:
Nome del campo
Il nome del campo usato in SQL non è allineato a GAQL. È anche necessario apprendere le regole di conversione dai nomi dei campi in SQL ai nomi di campo in GAQL. La regola di conversione può essere riepilogata nel modo seguente:
Se il nome del campo appartiene a una risorsa, il carattere di sottolineatura (
_
) in SQL verrà modificato in punto (.
) in GAQL. E per le parole tra il punto, l'istruzione di tipo camelCase usata in SQL verrà modificata in parole autonome con caratteri di sottolineatura aggiunti tra. La prima stringa di tipo PascalCase in SQL verrà modificata nel nome della risorsa corrispondente in GAQL.Se il nome del campo appartiene a segmenti o metriche, il prefisso
segments.
ometrics.
deve essere aggiunto in GAQL, seguire la stessa regola descritta nel primo punto per convertire il nome.
Ecco gli esempi concreti della conversione del nome del campo:
Category | Nomi di campo in SQL | Nomi di campo in GAQL |
---|---|---|
Campi della risorsa | Campaign_startDate |
campaign.start_date |
Campi della risorsa | Customer_conversionTrackingSetting_conversionTrackingStatus |
customer.conversion_tracking_setting.conversion_tracking_status |
Segments | DayOfWeek |
segments.day_of_week |
Metrica | VideoViews |
metrics.video_views |
Aggiornare il connettore Google AdWords al connettore Google Ads
Aggiornare il servizio collegato Google AdWords al servizio collegato Google Ads più recente seguendo questa procedura:
Selezionare Consigliato come versione del driver per creare un nuovo servizio collegato Google Ads e configurarlo facendo riferimento alle proprietà del servizio collegato.
Aggiornare le pipeline che fanno riferimento al servizio collegato Google AdWords legacy. Considerando che il servizio collegato Google Ads supporta solo l'uso della query per copiare i dati, quindi:
Se la pipeline recupera direttamente i dati dal report di Google AdWords, trovare il nome della risorsa corrispondente di Google Ads nella tabella seguente e usare questo strumento per compilare la query.
Report google AdWords Risorsa Google Ads ACCOUNT_PERFORMANCE_REPORT Cliente AD_PERFORMANCE_REPORT ad_group_ad ADGROUP_PERFORMANCE_REPORT ad_group AGE_RANGE_PERFORMANCE_REPORT age_range_view AUDIENCE_PERFORMANCE_REPORT campaign_audience_view,ad_group_audience_view AUTOMATIC_PLACEMENTS_PERFORMANCE_REPORT group_placement_view BID_GOAL_PERFORMANCE_REPORT bidding_strategy BUDGET_PERFORMANCE_REPORT campaign_budget CALL_METRICS_CALL_DETAILS_REPORT call_view CAMPAIGN_AD_SCHEDULE_TARGET_REPORT ad_schedule_view CAMPAIGN_CRITERIA_REPORT campaign_criterion CAMPAIGN_PERFORMANCE_REPORT Campagna CAMPAIGN_SHARED_edizione StandardT_REPORT campaign_shared_set CAMPAIGN_LOCATION_TARGET_REPORT location_view CLICK_PERFORMANCE_REPORT click_view DISPLAY_KEYWORD_PERFORMANCE_REPORT display_keyword_view DISPLAY_TOPICS_PERFORMANCE_REPORT topic_view GENDER_PERFORMANCE_REPORT gender_view GEO_PERFORMANCE_REPORT geographic_view,user_location_view KEYWORDLESS_QUERY_REPORT dynamic_search_ads_search_term_view KEYWORDS_PERFORMANCE_REPORT keyword_view LABEL_REPORT label LANDING_PAGE_REPORT landing_page_view,expanded_landing_page_view PAID_ORGANIC_QUERY_REPORT paid_organic_search_term_view PARENTAL_STATUS_PERFORMANCE_REPORT parental_status_view PLACEHOLDER_Fedizione EnterpriseD_ITEM_REPORT feed_item,feed_item_target PLACEHOLDER_REPORT feed_placeholder_view PLACEMENT_PERFORMANCE_REPORT managed_placement_view PRODUCT_PARTITION_REPORT product_group_view edizione StandardARCH_QUERY_PERFORMANCE_REPORT search_term_view SHARED_edizione StandardT_CRITERIA_REPORT shared_criterion SHARED_edizione StandardT_REPORT shared_set SHOPPING_PERFORMANCE_REPORT shopping_performance_view TOP_CONTENT_PERFORMANCE_REPORT Non più disponibile nell'API Google Ads. URL_PERFORMANCE_REPORT detail_placement_view U edizione StandardR_AD_DISTANCE_REPORT distance_view VIDEO_PERFORMANCE_REPORT video Se la pipeline usa query per recuperare i dati da Google AdWords, usa lo strumento Di migrazione query per tradurre AWQL (AdWords Query Language) in GAQL (Google Ads Query Language).
Tenere presente che esistono alcune limitazioni con questo aggiornamento:
- Non tutti i tipi di report di AWQL sono supportati in GAQL.
- Non tutte le query AWQL vengono convertite correttamente in query GAQL.
Contenuto correlato
Per un elenco degli archivi dati supportati come origini e sink dall'attività di copia, vedere archivi dati supportati.