Kopiera data från Google Ads med Azure Data Factory eller Synapse Analytics

GÄLLER FÖR: Azure Data Factory Azure Synapse Analytics

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.

Funktioner som stöds

Den här Google Ads-anslutningsappen stöds för följande funktioner:

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

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:

   • Azure Data Factory
   • Azure Synapse

   

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

   

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

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:

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:

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:

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:

• Interaktiv GAQL-frågebyggare
• GAQL-frågeverifierare

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:

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.

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.

Relaterat innehåll

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