Kopírování dat z Google Ads pomocí Služby Azure Data Factory nebo Synapse Analytics

Článek
05/13/2024

PLATÍ PRO: Azure Data Factory Azure Synapse Analytics

Tip

Vyzkoušejte si službu Data Factory v Microsoft Fabric, řešení pro analýzy typu all-in-one pro podniky. Microsoft Fabric zahrnuje všechno od přesunu dat až po datové vědy, analýzy v reálném čase, business intelligence a vytváření sestav. Přečtěte si, jak začít používat novou zkušební verzi zdarma.

Tento článek popisuje, jak pomocí aktivity kopírování v kanálu Azure Data Factory nebo Synapse Analytics kopírovat data z Google Ads. Vychází z článku s přehledem aktivity kopírování, který představuje obecný přehled aktivity kopírování.

Důležité

Prosím prosím upgradujte verzi ovladače Google Ads před 18. únorem 2024. Pokud ne, připojení začne selhávat s chybou kvůli vyřazení starší verze ovladače.

Podporované funkce

Tento konektor Google Ads je podporovaný pro následující funkce:

Podporované funkce	IR
aktivita Copy (zdroj/-)	(1) (2)
Aktivita Lookup	(1) (2)

(1) Prostředí Azure Integration Runtime (2) Místní prostředí Integration Runtime

Seznam úložišť dat podporovaných jako zdroje nebo jímky najdete v tabulce Podporované úložiště dat.

Služba poskytuje integrovaný ovladač, který umožňuje připojení, takže pomocí tohoto konektoru nemusíte ručně instalovat žádný ovladač.

Začínáme

K provedení aktivita Copy s kanálem můžete použít jeden z následujících nástrojů nebo sad SDK:

Vytvoření propojené služby pro Google Ads pomocí uživatelského rozhraní

Pomocí následujících kroků vytvořte propojenou službu pro Google Ads v uživatelském rozhraní webu Azure Portal.

Přejděte na kartu Správa v pracovním prostoru Azure Data Factory nebo Synapse a vyberte Propojené služby a pak klikněte na Nový:
- Azure Data Factory
- Azure Synapse
Vyhledejte Google Ads a vyberte konektor Google Ads.
Nakonfigurujte podrobnosti o službě, otestujte připojení a vytvořte novou propojenou službu.

Podrobnosti konfigurace konektoru

Následující části obsahují podrobnosti o vlastnostech, které slouží k definování entit služby Data Factory specifických pro konektor Google Ads.

Vlastnosti propojené služby

Propojené služby Google Ads podporují následující vlastnosti:

Vlastnost	Popis	Povinní účastníci
type	Vlastnost typu musí být nastavená na: GoogleAdWords.	Ano
googleAdsApiVersion	Verze rozhraní API Google Ads, kterou používáte při výběru doporučené verze ovladače. Informace o verzi rozhraní API najdete v tomto článku .	Ano
clientCustomerID	ID zákazníka klienta účtu Ads, pro který chcete načíst data sestavy.	Ano
loginCustomerID	ID zákazníka účtu správce Google Ads, prostřednictvím kterého chcete načíst data sestavy konkrétního zákazníka.	No
developerToken	Token vývojáře přidružený k účtu správce, který používáte k udělení přístupu k rozhraní ADS API. Toto pole můžete označit jako securestring, abyste ho mohli bezpečně uložit, nebo uložit heslo ve službě Azure Key Vault a nechat aktivitu kopírování tam při kopírování dat načíst – přečtěte si další informace o přihlašovacích údajích k úložišti ve službě Key Vault.	Ano
authenticationType	Mechanismus ověřování OAuth 2.0 používaný k ověřování. Povolené hodnoty jsou: ServiceAuthentication, UserAuthentication. ServiceAuthentication se dá použít jenom v místním prostředí IR.	Ano
Pro userAuthentication:
refreshToken	Obnovovací token získaný společností Google pro autorizaci přístupu k reklamě pro ověřování uživatelů. Toto pole můžete označit jako securestring, abyste ho mohli bezpečně uložit, nebo uložit heslo ve službě Azure Key Vault a nechat aktivitu kopírování tam při kopírování dat načíst – přečtěte si další informace o přihlašovacích údajích k úložišti ve službě Key Vault.	No
clientId	ID klienta aplikace Google použité k získání obnovovacího tokenu. Toto pole můžete označit jako securestring, abyste ho mohli bezpečně uložit, nebo uložit heslo ve službě Azure Key Vault a nechat aktivitu kopírování tam při kopírování dat načíst – přečtěte si další informace o přihlašovacích údajích k úložišti ve službě Key Vault.	No
clientSecret	Tajný klíč klienta aplikace Google sloužící k získání obnovovacího tokenu. Toto pole můžete označit jako securestring, abyste ho mohli bezpečně uložit, nebo uložit heslo ve službě Azure Key Vault a nechat aktivitu kopírování tam při kopírování dat načíst – přečtěte si další informace o přihlašovacích údajích k úložišti ve službě Key Vault.	No
Pro ServiceAuthentication:
E-mail	ID e-mailu účtu služby, které se používá pro ServiceAuthentication a lze ho použít pouze v místním prostředí IR.	No
privateKey	Privátní klíč služby, který se používá pro ServiceAuthentication pro doporučenou verzi ovladače a dá se použít jenom v místním prostředí IR. Toto pole můžete označit jako securestring, abyste ho mohli bezpečně uložit, nebo uložit heslo ve službě Azure Key Vault a nechat aktivitu kopírování tam při kopírování dat načíst – přečtěte si další informace o přihlašovacích údajích k úložišti ve službě Key Vault.	No
Pro ServiceAuthentication* s použitím starší verze* ovladače:
E-mail	ID e-mailu účtu služby, které se používá pro ServiceAuthentication a lze ho použít pouze v místním prostředí IR.	No
keyFilePath	Úplná cesta k `.p12` souboru nebo `.json` souboru klíče, který se používá k ověření e-mailové adresy účtu služby a dá se použít jenom v místním prostředí IR.	No
trustedCertPath	Úplná cesta k souboru .pem obsahujícího důvěryhodné certifikáty certifikační autority pro ověření serveru při připojování přes protokol TLS. Tuto vlastnost lze nastavit pouze při použití protokolu TLS v místním prostředí IR. Výchozí hodnota je soubor cacerts.pem nainstalovaný s prostředím IR.	No
useSystemTrustStore	Určuje, jestli se má použít certifikát certifikační autority z úložiště důvěryhodnosti systému nebo ze zadaného souboru PEM. Výchozí hodnota je false.	No

Příklad:

{
    "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"
        }
    }
}

Vlastnosti datové sady

Úplný seznam oddílů a vlastností dostupných pro definování datových sad najdete v článku o datových sadách . Tato část obsahuje seznam vlastností podporovaných datovou sadou Google Ads.

Pokud chcete kopírovat data z Google Ads, nastavte vlastnost typu datové sady na GoogleAdWordsObject. Podporují se následující vlastnosti:

Vlastnost	Popis	Povinní účastníci
type	Vlastnost typu datové sady musí být nastavená na: GoogleAdWordsObject.	Ano
tableName	Název tabulky. Tuto vlastnost zadejte při použití starší verze ovladače.	Ne (pokud je zadán dotaz ve zdroji aktivity)

Příklad

{
    "name": "GoogleAdsDataset",
    "properties": {
        "type": "GoogleAdWordsObject",
        "typeProperties": {},
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<GoogleAds linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

Vlastnosti aktivity kopírování

Úplný seznam oddílů a vlastností dostupných pro definování aktivit najdete v článku Pipelines . Tato část obsahuje seznam vlastností podporovaných zdrojem Google Ads.

Google Ads jako zdroj

Pokud chcete kopírovat data z Google Ads, nastavte zdrojový typ v aktivitě kopírování na GoogleAdWordsSource. Ve zdrojové části aktivity kopírování jsou podporovány následující vlastnosti:

Vlastnost	Popis	Povinní účastníci
type	Vlastnost typu zdroje aktivity kopírování musí být nastavená na: GoogleAdWordsSource.	Ano
query	Ke čtení dat použijte dotaz GAQL. Například: `SELECT campaign.id FROM campaign`.	Ne (pokud je v datové sadě zadán název tabulky)

Příklad:

"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>"
            }
        }
    }
]

Vlastnosti aktivity vyhledávání

Podrobnosti o vlastnostech najdete v aktivitě Vyhledávání.

Upgrade verze ovladače Google Ads

Pokud chcete upgradovat verzi ovladače Google Ads, musíte aktualizovat propojenou službu a zjistit, jak migrovat z SQL na Google Ads Query Language (GAQL).

Aktualizace konfigurace propojené služby

Na stránce Upravit propojenou službu vyberte Doporučené v části Verze ovladače a nakonfigurujte propojenou službu odkazem na vlastnosti propojené služby.

Migrace z SQL na GAQL

Při migraci z SQL na GAQL převeďte příkazy dotazu a názvy polí.

Příkazy dotazů

Pokud používáte dotaz SQL ve zdroji aktivity kopírování nebo vyhledávací aktivitu odkazující na starší propojenou službu Google Ads, musíte je aktualizovat na dotaz GAQL.

Na rozdíl od SQL se dotaz v GAQL skládá ze šesti druhů klauzulí:

SELECT
FROM
WHERE
ORDER BY
LIMIT
PARAMETERS

Přejděte na Google Ads Query Language Grammar for the introduction of GAQL.

Jako příklad použijte následující příkaz SQL:

SELECT *|FieldName FROM ResourceName WHERE FieldName Operator Value

Postupujte podle následujících pokynů a převeďte příkaz SQL na odpovídající příkaz GAQL:

Pokud * se po SELECT klauzuli použije (hvězdička), musíte místo hvězdičky zadat všechna požadovaná pole, protože GAQL nepodporuje SELECT *. V tomto článku najdete všechna pole, která se dají vybrat v konkrétním zdroji.
Pokud se název pole použije za SELECT klauzulí, musíte název převést na odpovídající název pole v GAQL, protože mají různé konvence pojmenování. Například název campaign_id pole v příkazu dotazu SQL by se měl v GAQL převést na campaign.id . Další podrobnosti o převodu názvů polí najdete v části Název pole.
Název prostředku je možné ponechat tak, jak je tomu, pokud jeho případ není nekonzistentní s tím, co je zde zadáno.
WHERE klauzule by měla být aktualizována podle gramatiky GAQL, protože operátory podporované jazykem GAQL nejsou konzistentní s JAZYKem SQL a název pole by se měl také převést, jak je popsáno v druhém bodě.

Tady jsou dva velmi užitečné nástroje, které nabízí Google a jsou vysoce doporučené při vytváření odpovídajících příkazů dotazů GAQL:

Název pole

Název pole použitý v SQL není zarovnaný s GAQL. Musíte se také naučit pravidla převodu z názvů polí v SQL na názvy polí v GAQL. Pravidlo převodu lze shrnout takto:

Pokud název pole patří do prostředku, podtržítko (_) v SQL se změní na tečku (.) v GAQL. A u slov mezi tečkou se příkaz typu camelCase použitý v SQL změní na samostatná slova s přidanými podtržítky mezi. První řetězec typu PascalCase v SQL se změní na odpovídající název prostředku v GAQL.
Pokud název pole patří do segmentů nebo metrik, předpona segments. nebo metrics. by se měla přidat do GAQL, postupujte podle stejného pravidla, jak je popsáno v prvním bodě, a převeďte název.

Tady jsou konkrétní příklady převodu názvu pole:

Kategorie	Názvy polí v SQL	Názvy polí v GAQL
Pole zdroje	`Campaign_startDate`	`campaign.start_date`
Pole zdroje	`Customer_conversionTrackingSetting_conversionTrackingStatus`	`customer.conversion_tracking_setting.conversion_tracking_status`
Segments	`DayOfWeek`	`segments.day_of_week`
Metriky	`VideoViews`	`metrics.video_views`

Rozdíly mezi Google Ads používající doporučenou a starší verzí ovladače

Následující tabulka ukazuje rozdíly mezi funkcemi mezi Google Ads pomocí doporučené a starší verze ovladače.

Doporučená verze ovladače	Starší verze ovladače
Zadání verze rozhraní API Google Ads je podporováno.	Zadání verze rozhraní API Google Ads se nepodporuje.
ServiceAuthentication podporuje dvě vlastnosti: •E-mail • privateKey	ServiceAuthentication podporuje čtyři vlastnosti: •E-mail • keyFilePath • trustedCertPath • useSystemTrustStore
Výběr tabulky v datové sadě se nepodporuje.	Podpora výběru tabulky v datové sadě a dotazování tabulky v aktivitách kopírování
Podpora syntaxe GAQL jako dotazovacího jazyka	Podpora syntaxe SQL jako dotazovacího jazyka
Názvy výstupních sloupců jsou stejné jako názvy polí definovaných v Google Ads.	Názvy výstupních sloupců neodpovídají názvům polí definovaným v Google Ads.
Následující mapování se používají z datových typů Google Ads k dočasným datovým typům používaným službou interně. float –> float int32 -> int int64 -> dlouhý	Následující mapování se používají z datových typů Google Ads k dočasným datovým typům používaným službou interně. float –> řetězec int32 –> řetězec int64 –> řetězec

Upgrade konektoru Google AdWords na konektor Google Ads

Upgradujte propojenou službu Google AdWords na nejnovější propojenou službu Google Ads pomocí následujícího postupu:

Výběrem možnosti Doporučeno jako verze ovladače vytvořte novou propojenou službu Google Ads a nakonfigurujte ji podle vlastností propojené služby.

Aktualizujte kanály, které odkazují na starší propojenou službu Google AdWords. Vzhledem k tomu, že propojená služba Google Ads podporuje pouze kopírování dat pomocí dotazu, takže:

Pokud váš kanál přímo načítá data ze sestavy Google AdWords, najděte odpovídající název prostředku Google Ads v tabulce níže a pomocí tohoto nástroje sestavte dotaz.

Sestava Google AdWords	Prostředek Google Ads
ACCOUNT_PERFORMANCE_REPORT	Zákazník
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	campaign
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	popisek
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	V rozhraní GOOGLE Ads API už není k dispozici.
URL_PERFORMANCE_REPORT	detail_placement_view
USER_AD_DISTANCE_REPORT	distance_view
VIDEO_PERFORMANCE_REPORT	video

Pokud kanál používá dotaz k načtení dat z Google AdWords, použijte nástroj Pro migraci dotazů k překladu AWQL (AdWords Query Language) do GAQL (Google Ads Query Language).

Mějte na paměti, že při tomto upgradu existují určitá omezení:
1. V GAQL se nepodporují všechny typy sestav z AWQL.
2. Ne všechny dotazy AWQL se čistě překládají na dotazy GAQL.

Seznam úložišť dat podporovaných jako zdroje a jímky aktivitou kopírování najdete v podporovaných úložištích dat.

Sdílet prostřednictvím

Kopírování dat z Google Ads pomocí Služby Azure Data Factory nebo Synapse Analytics

Podporované funkce

Začínáme

Vytvoření propojené služby pro Google Ads pomocí uživatelského rozhraní

Podrobnosti konfigurace konektoru

Vlastnosti propojené služby

Vlastnosti datové sady

Vlastnosti aktivity kopírování

Google Ads jako zdroj

Vlastnosti aktivity vyhledávání

Upgrade verze ovladače Google Ads

Aktualizace konfigurace propojené služby

Migrace z SQL na GAQL

Příkazy dotazů

Název pole

Rozdíly mezi Google Ads používající doporučenou a starší verzí ovladače

Upgrade konektoru Google AdWords na konektor Google Ads

Váš názor

Další materiály

Sdílet prostřednictvím

Kopírování dat z Google Ads pomocí Služby Azure Data Factory nebo Synapse Analytics

Podporované funkce

Začínáme

Vytvoření propojené služby pro Google Ads pomocí uživatelského rozhraní

Podrobnosti konfigurace konektoru

Vlastnosti propojené služby

Vlastnosti datové sady

Vlastnosti aktivity kopírování

Google Ads jako zdroj

Vlastnosti aktivity vyhledávání

Upgrade verze ovladače Google Ads

Aktualizace konfigurace propojené služby

Migrace z SQL na GAQL

Příkazy dotazů

Název pole

Rozdíly mezi Google Ads používající doporučenou a starší verzí ovladače

Upgrade konektoru Google AdWords na konektor Google Ads

Související obsah

Váš názor

Další materiály