Kopiera data från Google Ads med Azure Data Factory eller Synapse Analytics
GÄLLER FÖR: Azure Data Factory
Azure Synapse Analytics
Dricks
Prova Data Factory i Microsoft Fabric, en allt-i-ett-analyslösning för företag. Microsoft Fabric omfattar allt från dataflytt till datavetenskap, realtidsanalys, business intelligence och rapportering. Lär dig hur du startar en ny utvärderingsversion kostnadsfritt!
Den här artikeln beskriver hur du använder kopieringsaktiviteten i en Azure Data Factory- eller Synapse Analytics-pipeline för att kopiera data från Google Ads. Den bygger på översiktsartikeln för kopieringsaktivitet som visar en allmän översikt över kopieringsaktiviteten.
Viktigt!
Uppgradera din Google Ads-drivrutinsversion före den 18 februari 2024. Annars misslyckas anslutningen med ett fel på grund av utfasningen av den äldre drivrutinen.
Funktioner som stöds
Den här Google Ads-anslutningsappen stöds för följande funktioner:
Funktioner som stöds | IR |
---|---|
Kopieringsaktivitet (källa/-) | (1) (2) |
Sökningsaktivitet | (1) (2) |
(1) Azure Integration Runtime (2) Lokalt installerad integrationskörning
En lista över datalager som stöds som källor/mottagare finns i tabellen Datalager som stöds.
Tjänsten tillhandahåller en inbyggd drivrutin för att aktivera anslutningen. Därför behöver du inte installera någon drivrutin manuellt med den här anslutningsappen.
Komma igång
Om du vill utföra kopieringsaktiviteten med en pipeline kan du använda något av följande verktyg eller SDK:er:
- Verktyget Kopiera data
- Azure-portalen
- The .NET SDK
- The Python SDK
- Azure PowerShell
- REST-API:et
- Azure Resource Manager-mallen
Skapa en länkad tjänst till Google Ads med hjälp av användargränssnittet
Använd följande steg för att skapa en länkad tjänst till Google Ads i azure-portalens användargränssnitt.
Bläddra till fliken Hantera i Din Azure Data Factory- eller Synapse-arbetsyta och välj Länkade tjänster och klicka sedan på Ny:
Sök efter Google Ads och välj Google Ads-anslutningsappen.
Konfigurera tjänstinformationen, testa anslutningen och skapa den nya länkade tjänsten.
Konfigurationsinformation för anslutningsprogram
Följande avsnitt innehåller information om egenskaper som används för att definiera Data Factory-entiteter som är specifika för Google Ads-anslutningsappen.
Länkade tjänstegenskaper
Följande egenskaper stöds för Google Ads länkade tjänst:
Property | Beskrivning | Obligatoriskt |
---|---|---|
type | Typegenskapen måste anges till: GoogleAdWords | Ja |
googleAdsApiVersion | Den Google Ads API-version som du använder när du väljer den rekommenderade drivrutinsversionen. Du kan läsa den här artikeln för API-versionsinformation. | Ja |
clientCustomerID | Kundkund-ID för det Ads-konto som du vill hämta rapportdata för. | Ja |
loginCustomerID | Kund-ID för Det Google Ads-chefkonto genom vilket du vill hämta rapportdata för en specifik kund. | Nej |
developerToken | Utvecklartoken som är associerad med det chefskonto som du använder för att bevilja åtkomst till Ads-API:et. Du kan välja att markera det här fältet som en SecureString för att lagra det på ett säkert sätt, eller lagra lösenord i Azure Key Vault och låta kopieringsaktiviteten hämtas därifrån när du utför datakopiering – läs mer från Store-autentiseringsuppgifter i Key Vault. | Ja |
authenticationType | OAuth 2.0-autentiseringsmekanismen som används för autentisering. Tillåtna värden är: ServiceAuthentication, UserAuthentication. ServiceAuthentication kan bara användas på lokalt installerad IR. |
Ja |
För UserAuthentication: | ||
refreshToken | Uppdateringstoken som hämtats från Google för auktorisering av åtkomst till Ads for UserAuthentication. Du kan välja att markera det här fältet som en SecureString för att lagra det på ett säkert sätt, eller lagra lösenord i Azure Key Vault och låta kopieringsaktiviteten hämtas därifrån när du utför datakopiering – läs mer från Store-autentiseringsuppgifter i Key Vault. | Nej |
clientId | Klient-ID:t för Google-programmet som användes för att hämta uppdateringstoken. Du kan välja att markera det här fältet som en SecureString för att lagra det på ett säkert sätt, eller lagra lösenord i Azure Key Vault och låta kopieringsaktiviteten hämtas därifrån när du utför datakopiering – läs mer från Store-autentiseringsuppgifter i Key Vault. | Nej |
clientSecret | Klienthemligheten för google-programmet som användes för att hämta uppdateringstoken. Du kan välja att markera det här fältet som en SecureString för att lagra det på ett säkert sätt, eller lagra lösenord i Azure Key Vault och låta kopieringsaktiviteten hämtas därifrån när du utför datakopiering – läs mer från Store-autentiseringsuppgifter i Key Vault. | Nej |
För ServiceAuthentication: | ||
E-post | E-post-ID för tjänstkontot som används för ServiceAuthentication och som endast kan användas på lokalt installerad IR. | Nej |
privateKey | Tjänstens privata nyckel som används för ServiceAuthentication för rekommenderad drivrutinsversion och som endast kan användas på lokalt installerad IR. Du kan välja att markera det här fältet som en SecureString för att lagra det på ett säkert sätt, eller lagra lösenord i Azure Key Vault och låta kopieringsaktiviteten hämtas därifrån när du utför datakopiering – läs mer från Store-autentiseringsuppgifter i Key Vault. | Nej |
För ServiceAuthentication med den äldre drivrutinsversionen: | ||
E-post | E-post-ID för tjänstkontot som används för ServiceAuthentication och som endast kan användas på lokalt installerad IR. | Nej |
keyFilePath | Den fullständiga sökvägen till .p12 eller .json nyckelfilen som används för att autentisera e-postadressen för tjänstkontot och som endast kan användas på lokalt installerad IR. |
Nej |
trustedCertPath | Den fullständiga sökvägen till .pem-filen som innehåller betrodda CA-certifikat för att verifiera servern när du ansluter via TLS. Den här egenskapen kan bara anges när du använder TLS på lokalt installerad IR. Standardvärdet är filen cacerts.pem som är installerad med IR. | Nej |
useSystemTrustStore | Anger om du vill använda ett CA-certifikat från systemförtroendearkivet eller från en angiven PEM-fil. Standardvärdet är "false". | Nej |
Exempel:
{
"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"
}
}
}
Egenskaper för datauppsättning
En fullständig lista över avsnitt och egenskaper som är tillgängliga för att definiera datauppsättningar finns i artikeln datauppsättningar . Det här avsnittet innehåller en lista över egenskaper som stöds av Google Ads-datauppsättning.
Om du vill kopiera data från Google Ads anger du datamängdens typegenskap till GoogleAdWordsObject. Följande egenskaper stöds:
Property | Beskrivning | Obligatoriskt |
---|---|---|
type | Typegenskapen för datamängden måste anges till: GoogleAdWordsObject | Ja |
tableName | Tabellens namn. Ange den här egenskapen när du använder den äldre drivrutinsversionen. | Nej (om "fråga" i aktivitetskällan har angetts) |
Exempel
{
"name": "GoogleAdsDataset",
"properties": {
"type": "GoogleAdWordsObject",
"typeProperties": {},
"schema": [],
"linkedServiceName": {
"referenceName": "<GoogleAds linked service name>",
"type": "LinkedServiceReference"
}
}
}
Kopiera egenskaper för aktivitet
En fullständig lista över avsnitt och egenskaper som är tillgängliga för att definiera aktiviteter finns i artikeln Pipelines . Det här avsnittet innehåller en lista över egenskaper som stöds av Google Ads-källa.
Google Ads som källa
Om du vill kopiera data från Google Ads anger du källtypen i kopieringsaktiviteten till GoogleAdWordsSource. Följande egenskaper stöds i avsnittet kopieringsaktivitetskälla:
Property | Beskrivning | Obligatoriskt |
---|---|---|
type | Typegenskapen för kopieringsaktivitetskällan måste anges till: GoogleAdWordsSource | Ja |
query | Använd GAQL-frågan för att läsa data. Exempel: SELECT campaign.id FROM campaign . |
Nej (om "tableName" i datauppsättningen har angetts) |
Exempel:
"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>"
}
}
}
]
Egenskaper för uppslagsaktivitet
Mer information om egenskaperna finns i Sökningsaktivitet.
Uppgradera Google Ads-drivrutinsversionen
Om du vill uppgradera google ads-drivrutinsversionen behöver du uppdatera din länkade tjänst och lära dig hur du migrerar från SQL till Google Ads Query Language (GAQL).
Uppdatera konfigurationen av den länkade tjänsten
På sidan Redigera länkad tjänst väljer du Rekommenderas under Drivrutinsversion och konfigurerar den länkade tjänsten genom att referera till egenskaper för länkad tjänst.
Migrera från SQL till GAQL
Konvertera dina frågeinstruktioner och fältnamn när du migrerar från SQL till GAQL.
Frågeinstruktioner
Om du använder SQL-fråga i kopieringsaktivitetskällan eller uppslagsaktiviteten som refererar till den äldre Länkade Google Ads-tjänsten måste du uppdatera dem till GAQL-frågan.
Till skillnad från SQL består frågan i GAQL av sex typer av satser:
SELECT
FROM
WHERE
ORDER BY
LIMIT
PARAMETERS
Gå till Google Ads Query Language Grammar för introduktionen av GAQL.
Ta följande SQL-instruktion som exempel:
SELECT *|FieldName FROM ResourceName WHERE FieldName Operator Value
Du kan följa riktlinjerna nedan för att konvertera SQL-instruktionen till motsvarande GAQL-instruktion:
- Om
*
(asterisk) används efterSELECT
-satsen måste du ange alla obligatoriska fält i stället för asterisken eftersom GAQL inte stöderSELECT *
. Gå till den här artikeln om du vill se alla valbara fält i den specifika resursen. - Om fältnamnet används efter
SELECT
-satsen måste du konvertera namnet till motsvarande fältnamn i GAQL eftersom de har olika namngivningskonventioner. Till exempel ska fältnamnetcampaign_id
i SQL-frågeutsatsen konverteras tillcampaign.id
i GAQL. Mer information om konvertering av fältnamn finns i Fältnamn . - Resursnamnet kan lämnas som det är om inte dess skiftläge är inkonsekvent med det som anges här.
WHERE
-satsen bör uppdateras enligt GAQL-grammatiken eftersom operatorerna som stöds av GAQL inte är konsekventa med SQL, och fältnamnet bör också konverteras enligt beskrivningen i den andra punkten.
Här är två mycket användbara verktyg som erbjuds av Google och de rekommenderas starkt när du skapar motsvarande GAQL-frågeinstruktioner:
Fältnamn
Fältnamnet som används i SQL är inte justerat med GAQL. Du måste också lära dig konverteringsreglerna från fältnamn i SQL till fältnamn i GAQL. Konverteringsregeln kan sammanfattas på följande sätt:
Om fältnamnet tillhör en resurs ändras understrecket (
_
) i SQL till punkt (.
) i GAQL. Och för orden mellan punkten ändras instruktionen camelCase-typ som används i SQL till fristående ord med tillagda understreck däremellan. Den första strängen av typen PascalCase i SQL ändras till motsvarande resursnamn i GAQL.Om fältnamnet tillhör segment eller mått ska prefixet
segments.
ellermetrics.
läggas till i GAQL följa samma regel som beskrivs i den första punkten för att konvertera namnet.
Här är de konkreta exemplen på fältnamnskonverteringen:
Kategori | Fältnamn i SQL | Fältnamn i GAQL |
---|---|---|
Resursfält | Campaign_startDate |
campaign.start_date |
Resursfält | Customer_conversionTrackingSetting_conversionTrackingStatus |
customer.conversion_tracking_setting.conversion_tracking_status |
Segment | DayOfWeek |
segments.day_of_week |
Mått | VideoViews |
metrics.video_views |
Skillnader mellan Google Ads med hjälp av den rekommenderade och äldre drivrutinsversionen
Tabellen nedan visar funktionsskillnaderna mellan Google Ads med hjälp av den rekommenderade och äldre drivrutinsversionen.
Rekommenderad drivrutinsversion | Äldre drivrutinsversion |
---|---|
Det finns stöd för att ange Google Ads API-version. | Det går inte att ange Google Ads API-version. |
ServiceAuthentication stöder två egenskaper: •E-post • privateKey |
ServiceAuthentication stöder fyra egenskaper: •E-post • keyFilePath • trustedCertPath • useSystemTrustStore |
Det går inte att välja en tabell i en datauppsättning. | Stöd för att välja en tabell i en datauppsättning och köra frågor mot tabellen i kopieringsaktiviteter. |
Stöd för GAQL-syntax som frågespråk. | Stöd för SQL-syntax som frågespråk. |
Utdatakolumnnamnen är samma som fältnamnen som definieras i Google Ads. | Namnen på utdatakolumnen matchar inte fältnamnen som definierats i Google Ads. |
Följande mappningar används från Google Ads-datatyper till mellanliggande datatyper som används av tjänsten internt. float -> float int32 –> int int64 -> long |
Följande mappningar används från Google Ads-datatyper till mellanliggande datatyper som används av tjänsten internt. float –> sträng int32 –> sträng int64 –> sträng |
Uppgradera Google AdWords-anslutningsprogrammet till Google Ads-anslutningsprogrammet
Uppgradera din länkade Google AdWords-tjänst till den senaste länkade Google Ads-tjänsten enligt stegen nedan:
Välj Rekommenderad som drivrutinsversion för att skapa en ny länkad Google Ads-tjänst och konfigurera den genom att referera till länkade tjänstegenskaper.
Uppdatera dina pipelines som refererar till den äldre Länkade Google AdWords-tjänsten. Med tanke på att den länkade Google Ads-tjänsten endast stöder användning av frågor för att kopiera data, så:
Om din pipeline hämtar data direkt från rapporten från Google AdWords letar du reda på motsvarande resursnamn för Google Ads i tabellen nedan och använder det här verktyget för att skapa frågan.
Google AdWords-rapport Google Ads-resurs ACCOUNT_PERFORMANCE_REPORT Kund 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 kampanj CAMPAIGN_SHARED_SET_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_FEED_ITEM_REPORT feed_item,feed_item_target PLACEHOLDER_REPORT feed_placeholder_view PLACEMENT_PERFORMANCE_REPORT managed_placement_view PRODUCT_PARTITION_REPORT product_group_view SEARCH_QUERY_PERFORMANCE_REPORT search_term_view SHARED_SET_CRITERIA_REPORT shared_criterion SHARED_SET_REPORT shared_set SHOPPING_PERFORMANCE_REPORT shopping_performance_view TOP_CONTENT_PERFORMANCE_REPORT Inte längre tillgängligt i Google Ads-API:et. URL_PERFORMANCE_REPORT detail_placement_view USER_AD_DISTANCE_REPORT distance_view VIDEO_PERFORMANCE_REPORT video Om pipelinen använder en fråga för att hämta data från Google AdWords använder du frågemigreringsverktyget för att översätta AWQL (AdWords Query Language) till GAQL (Google Ads Query Language).
Tänk på att det finns vissa begränsningar med den här uppgraderingen:
- Alla rapporttyper från AWQL stöds inte i GAQL.
- Alla AWQL-frågor översätts inte rent till GAQL-frågor.
Relaterat innehåll
En lista över datalager som stöds som källor och mottagare av kopieringsaktiviteten finns i datalager som stöds.