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
aktiviteten Kopiera (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 aktiviteten Kopiera med en pipeline kan du använda något av följande verktyg eller SDK:er:

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.

  1. 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:

  2. Sök efter Google Ads och välj Google Ads-anslutningsappen.

    Screenshot of the Google Ads connector.

  3. Konfigurera tjänstinformationen, testa anslutningen och skapa den nya länkade tjänsten.

    Screenshot of linked service configuration for Google Ads.

Anslut eller konfigurationsinformation

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.

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

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:

  1. Om * (asterisk) används efter SELECT -satsen måste du ange alla obligatoriska fält i stället för asterisken eftersom GAQL inte stöder SELECT *. Gå till den här artikeln om du vill se alla valbara fält i den specifika resursen.
  2. 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ältnamnet campaign_id i SQL-frågeutsatsen konverteras till campaign.id i GAQL. Mer information om konvertering av fältnamn finns i Fältnamn .
  3. Resursnamnet kan lämnas som det är om inte dess skiftläge är inkonsekvent med det som anges här.
  4. 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. eller metrics. 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

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:

  1. 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.

  2. 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å:

    1. 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
    2. 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).

  3. Tänk på att det finns vissa begränsningar med den här uppgraderingen:

    1. Alla rapporttyper från AWQL stöds inte i GAQL.
    2. Alla AWQL-frågor översätts inte rent till GAQL-frågor.

En lista över datalager som stöds som källor och mottagare av kopieringsaktiviteten finns i datalager som stöds.