Megosztás a következőn keresztül:

Adatok másolása a Google Adsből az Azure Data Factory vagy a Synapse Analytics használatával

  • Cikk

A következőkre vonatkozik: Azure Data Factory Azure Synapse Analytics

Tipp.

Próbálja ki a Data Factoryt a Microsoft Fabricben, amely egy teljes körű elemzési megoldás a nagyvállalatok számára. A Microsoft Fabric az adattovábbítástól az adatelemzésig, a valós idejű elemzésig, az üzleti intelligenciáig és a jelentéskészítésig mindent lefed. Ismerje meg, hogyan indíthat új próbaverziót ingyenesen!

Ez a cikk azt ismerteti, hogyan használhatja a Másolási tevékenységet egy Azure Data Factory vagy Synapse Analytics-folyamatban az adatok Google Ads-adatok másolásához. A másolási tevékenység áttekintési cikkére épül, amely a másolási tevékenység általános áttekintését mutatja be.

Fontos

Kérjük, hogy 2024. február 18-ig frissítse a Google Ads-illesztőprogram verzióját. Ha nem, a kapcsolat egy hibával fog meghiúsulni az örökölt illesztőprogram elavulása miatt.

Támogatott képességek

Ez a Google Ads-összekötő a következő képességeket támogatja:

Támogatott képességek IR
Copy tevékenység (forrás/-) (1) (2)
Keresési tevékenység (1) (2)

(1) Azure-integrációs modul (2) Saját üzemeltetésű integrációs modul

A forrásként/fogadóként támogatott adattárak listáját a Támogatott adattárak táblában találja.

A szolgáltatás egy beépített illesztőprogramot biztosít a kapcsolat engedélyezéséhez, ezért nem kell manuálisan telepítenie egyetlen illesztőprogramot sem ezzel az összekötővel.

Első lépések

A Copy tevékenység folyamattal való végrehajtásához használja az alábbi eszközök vagy SDK-k egyikét:

Társított szolgáltatás létrehozása a Google Ads szolgáltatáshoz felhasználói felülettel

Az alábbi lépésekkel társított szolgáltatást hozhat létre a Google Ads szolgáltatáshoz az Azure Portal felhasználói felületén.

  1. Keresse meg az Azure Data Factory vagy a Synapse-munkaterület Kezelés lapját, és válassza a Társított szolgáltatások lehetőséget, majd kattintson az Új gombra:

  2. Keresse meg a Google Ads-et, és válassza ki a Google Ads-összekötőt.

    Képernyőkép a Google Ads-összekötőről.

  3. Konfigurálja a szolgáltatás részleteit, tesztelje a kapcsolatot, és hozza létre az új társított szolgáltatást.

    Képernyőkép a Google Ads társított szolgáltatáskonfigurációjáról.

Az összekötő konfigurációjának részletei

A következő szakaszok a Google Ads-összekötőre jellemző Data Factory-entitások meghatározásához használt tulajdonságok részleteit ismertetik.

Társított szolgáltatás tulajdonságai

A Google Ads társított szolgáltatása az alábbi tulajdonságokat támogatja:

Tulajdonság Leírás Kötelező
típus A típustulajdonságnak a következőnek kell lennie: GoogleAdWords Igen
googleAdsApiVersion Az ajánlott illesztőprogram-verzió kiválasztásakor használt Google Ads API-verzió. Ebben a cikkben az API verzióinformációiról olvashat. Igen
clientCustomerID Annak a Ads-fióknak az ügyfél-ügyfélazonosítója, amelyhez jelentésadatokat szeretne lekérni. Igen
loginCustomerID Annak a Google Ads-kezelői fióknak az ügyfélazonosítója, amelyen keresztül be szeretné kérni az adott ügyfél jelentésadatait. Nem
developerToken Az Ads API-hoz való hozzáférés biztosításához használt kezelői fiókhoz társított fejlesztői jogkivonat. Dönthet úgy, hogy biztonságosan tárolja a mezőt SecureStringként, vagy az Azure Key Vaultban tárolja a jelszót, és hagyja, hogy a másolási tevékenység onnan lekérje az adatmásolást – további információ a Key Vaultban tárolt hitelesítő adatok tárolásáról. Igen
authenticationType A hitelesítéshez használt OAuth 2.0 hitelesítési mechanizmus.
Az engedélyezett értékek a következők: ServiceAuthentication, UserAuthentication.
A ServiceAuthentication csak saját üzemeltetésű integrációs modulon használható.		 Igen
UserAuthentication esetén:
refreshToken A Google-tól a UserAuthentication hirdetésekhez való hozzáférés engedélyezéséhez beszerzett frissítési jogkivonat. Dönthet úgy, hogy biztonságosan tárolja a mezőt SecureStringként, vagy az Azure Key Vaultban tárolja a jelszót, és hagyja, hogy a másolási tevékenység onnan lekérje az adatmásolást – további információ a Key Vaultban tárolt hitelesítő adatok tárolásáról. Nem
clientId A frissítési jogkivonat beszerzéséhez használt Google-alkalmazás ügyfélazonosítója. Dönthet úgy, hogy biztonságosan tárolja a mezőt SecureStringként, vagy az Azure Key Vaultban tárolja a jelszót, és hagyja, hogy a másolási tevékenység onnan lekérje az adatmásolást – további információ a Key Vaultban tárolt hitelesítő adatok tárolásáról. Nem
clientSecret A frissítési jogkivonat beszerzéséhez használt Google-alkalmazás ügyféltitkára. Dönthet úgy, hogy biztonságosan tárolja a mezőt SecureStringként, vagy az Azure Key Vaultban tárolja a jelszót, és hagyja, hogy a másolási tevékenység onnan lekérje az adatmásolást – további információ a Key Vaultban tárolt hitelesítő adatok tárolásáról. Nem
ServiceAuthentication esetén:
e-mail A ServiceAuthentication szolgáltatásfiók e-mail-azonosítója, amely csak saját üzemeltetésű integrációs modulon használható. Nem
privateKey A ServiceAuthentication szolgáltatáshoz használt titkos kulcs az ajánlott illesztőprogram-verzióhoz, és csak saját üzemeltetésű integrációs modulon használható. Dönthet úgy, hogy biztonságosan tárolja a mezőt SecureStringként, vagy az Azure Key Vaultban tárolja a jelszót, és hagyja, hogy a másolási tevékenység onnan lekérje az adatmásolást – további információ a Key Vaultban tárolt hitelesítő adatok tárolásáról. Nem
ServiceAuthentication esetén az örökölt illesztőprogram-verzióval:
e-mail A ServiceAuthentication szolgáltatásfiók e-mail-azonosítója, amely csak saját üzemeltetésű integrációs modulon használható. Nem
keyFilePath A szolgáltatásfiók e-mail-címének hitelesítéséhez használt vagy .json kulcsfájl teljes elérési útja.p12, és csak saját üzemeltetésű integrációs modulon használható. Nem
trustedCertPath A megbízható hitelesítésszolgáltatói tanúsítványokat tartalmazó .pem fájl teljes elérési útja a kiszolgáló TLS-en keresztüli csatlakozáskor történő ellenőrzéséhez. Ez a tulajdonság csak akkor állítható be, ha tLS-t használ a saját üzemeltetésű integrációs modulon. Az alapértelmezett érték az integrációs modullal telepített cacerts.pem fájl. Nem
useSystemTrustStore Megadja, hogy a rendszer megbízhatósági tárolójából vagy egy megadott PEM-fájlból használjon-e ca-tanúsítványt. Az alapértelmezett érték: hamis. Nem

Példa:

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

Adathalmaz tulajdonságai

Az adathalmazok meghatározásához elérhető szakaszok és tulajdonságok teljes listáját az adathalmazokról szóló cikkben találja. Ez a szakasz a Google Ads-adatkészlet által támogatott tulajdonságok listáját tartalmazza.

Ha adatokat szeretne másolni a Google Ads-ből, állítsa az adathalmaz típustulajdonságát a GoogleAdWordsObject értékre. A következő tulajdonságok támogatottak:

Tulajdonság Leírás Kötelező
típus Az adathalmaz típustulajdonságának a következőnek kell lennie: GoogleAdWordsObject Igen
tableName A tábla neve. Adja meg ezt a tulajdonságot az örökölt illesztőprogram-verzió használatakor. Nem (ha "lekérdezés" van megadva a tevékenységforrásban)

Példa

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

Másolási tevékenység tulajdonságai

A tevékenységek meghatározásához elérhető szakaszok és tulajdonságok teljes listáját a Folyamatok című cikkben találja. Ez a szakasz a Google Ads-forrás által támogatott tulajdonságok listáját tartalmazza.

Ha adatokat szeretne másolni a Google Ads-ből, állítsa be a forrástípust a másolási tevékenységben a GoogleAdWordsSource-ra. A másolási tevékenység forrás szakaszában a következő tulajdonságok támogatottak:

Tulajdonság Leírás Kötelező
típus A másolási tevékenység forrásának típustulajdonságának a következőnek kell lennie: GoogleAdWordsSource Igen
Lekérdezés Az adatok olvasásához használja a GAQL-lekérdezést. Például: SELECT campaign.id FROM campaign Nem (ha "tableName" van megadva az adathalmazban)

Példa:

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

Keresési tevékenység tulajdonságai

A tulajdonságok részleteinek megismeréséhez tekintse meg a keresési tevékenységet.

A Google Ads illesztőprogram-verziójának frissítése

A Google Ads-illesztőprogram verziójának frissítéséhez frissítenie kell a társított szolgáltatást, és meg kell tudnia, hogyan migrálhat az SQL-ből a Google Ads lekérdezési nyelvre (GAQL).

A társított szolgáltatás konfigurációjának frissítése

A Csatolt szolgáltatás szerkesztése lapon válassza az Ajánlott lehetőséget az Illesztőprogram verzió alatt, és konfigurálja a társított szolgáltatást a csatolt szolgáltatás tulajdonságaira hivatkozva.

Migrálás SQL-ről GAQL-be

Konvertálja a lekérdezési utasításokat és mezőneveket az SQL-ből GAQL-re való migráláskor.

Lekérdezési utasítások

Ha SQL-lekérdezést használ a másolási tevékenység forrásában vagy az örökölt Google Ads társított szolgáltatásra hivatkozó keresési tevékenységben, frissítenie kell őket a GAQL-lekérdezésre.

Az SQL-rel ellentétben a GAQL-lekérdezés hatféle záradékból áll:

  • SELECT
  • FROM
  • WHERE
  • ORDER BY
  • LIMIT
  • PARAMETERS

A GAQL bevezetéséhez nyissa meg a Google Ads lekérdezési nyelvhelyességi nyelvhelyességi elemét.

Példaként tekintse meg a következő SQL-utasítást:

SELECT *|FieldName FROM ResourceName WHERE FieldName Operator Value

Az alábbi útmutatást követve konvertálhatja az SQL-utasítást a megfelelő GAQL-utasítássá:

  1. Ha * a SELECT záradék után (csillag) van használva, akkor meg kell adnia az összes szükséges mezőt a csillag helyett, mivel a GAQL nem támogatja SELECT *. Ebben a cikkben megtekintheti az adott erőforrás összes kijelölhető mezőjét.
  2. Ha a mezőnevet a SELECT záradék után használja, akkor át kell alakítania a nevet a megfelelő mezőnévre a GAQL-ben, mivel különböző elnevezési konvenciók vannak. Az SQL-lekérdezési utasítás mezőnevét campaign_id például GAQL formátumban kell konvertálni campaign.id . A mezőnév konvertálásáról további információt a Mezőnév című témakörben talál.
  3. Az erőforrás neve megmaradhat, ha az esete nem összhangban van az itt megadottakkal.
  4. WHERE a záradékot a GAQL-nyelvhelyességnek megfelelően kell frissíteni, mivel a GAQL által támogatott operátorok nem összhangban vannak az SQL-sel, és a mezőnevet is a második pontban leírtak szerint kell konvertálni.

Íme két nagyon hasznos eszköz, amelyet a Google kínál, és erősen ajánlott a megfelelő GAQL lekérdezési utasítások létrehozásakor:

Mezőnév

Az SQL-ben használt mezőnév nem igazodik a GAQL-hez. Azt is meg kell tanulnia, hogyan alakíthatja át a szabályokat az SQL mezőneveitől a GAQL mezőneveiig. A konverziós szabály a következőképpen foglalható össze:

  • Ha a mezőnév egy erőforráshoz tartozik, az SQL aláhúzása () pontra (_.) változik a GAQL-ben. A pont közötti szavak esetében az SQL-ben használt CamelCase típusú utasítás különálló szavakra változik, és aláhúzásjeleket adnak egymáshoz. Az SQL PascalCase típusú első sztringje a GAQL megfelelő erőforrásnevére változik.

  • Ha a mezőnév szegmensekhez vagy metrikákhoz tartozik, az előtagot segments. vagy metrics. a GAQL-ben kell hozzáadni, akkor a név konvertálásához kövesse az első pontban leírt szabályt.

A mezőnév konvertálásának konkrét példái a következők:

Kategória Mezőnevek az SQL-ben Mezőnevek a GAQL-ben
Erőforrásmezők Campaign_startDate campaign.start_date
Erőforrásmezők Customer_conversionTrackingSetting_conversionTrackingStatus customer.conversion_tracking_setting.conversion_tracking_status
Szegmensek DayOfWeek segments.day_of_week
Mérőszámok VideoViews metrics.video_views

Az alábbi táblázat az ajánlott és az örökölt illesztőprogram-verziót használó Google Ads funkcióbeli különbségeit mutatja be.

Ajánlott illesztőprogram-verzió Örökölt illesztőprogram-verzió
A Google Ads API-verzió megadása támogatott. A Google Ads API-verzió megadása nem támogatott.
A ServiceAuthentication két tulajdonságot támogat:
  •E-mail
  • privateKey		 A ServiceAuthentication négy tulajdonságot támogat:
  •E-mail
  • keyFilePath
  • trustedCertPath
  • useSystemTrustStore
Az adatkészletek tábláinak kijelölése nem támogatott. Az adathalmazban lévő tábla kiválasztásának és a tábla másolási tevékenységekben való lekérdezésének támogatása.
A GAQL szintaxis támogatása lekérdezési nyelvként. Az SQL-szintaxis támogatása lekérdezési nyelvként.
A kimeneti oszlopnevek megegyeznek a Google Ads-ben definiált mezőnevekkel. A kimeneti oszlopnevek nem egyeznek a Google Ads-ben definiált mezőnevekkel.
A Google Ads-adattípusoktól a szolgáltatás által belsőleg használt köztes adattípusokig az alábbi leképezéseket használjuk.

lebegőpontos -> lebegőpontos
int32 –> int
int64 -> hosszú		 A Google Ads-adattípusoktól a szolgáltatás által belsőleg használt köztes adattípusokig az alábbi leképezéseket használjuk.

lebegőpontos –> sztring
int32 –> sztring
int64 –> sztring

A Google AdWords-összekötő frissítése Google Ads-összekötőre

Frissítse Google AdWords társított szolgáltatását a legújabb Google Ads társított szolgáltatásra az alábbi lépéseket követve:

  1. Válassza az Ajánlott illesztőprogram verziót egy új Google Ads társított szolgáltatás létrehozásához és konfigurálásához a társított szolgáltatás tulajdonságaira hivatkozva.

  2. Frissítse az örökölt Google AdWords társított szolgáltatásra hivatkozó folyamatokat. Figyelembe véve, hogy a Google Ads társított szolgáltatás csak a lekérdezések használatát támogatja az adatok másolásához, így:

    1. Ha a folyamat közvetlenül adatokat kérdez le a Google AdWords jelentéséből, keresse meg a Google Ads megfelelő erőforrásnevét az alábbi táblázatban, és használja ezt az eszközt a lekérdezés létrehozásához.

      Google AdWords-jelentés Google Ads-erőforrás
      ACCOUNT_PERFORMANCE_REPORT ügyfél
      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 kampány
      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 A Google Ads API-ban már nem érhető el.
      URL_PERFORMANCE_REPORT detail_placement_view
      USER_AD_DISTANCE_REPORT distance_view
      VIDEO_PERFORMANCE_REPORT videó

    2. Ha a folyamat lekérdezéssel kéri le az adatokat a Google AdWordsből, a Lekérdezési migrálás eszközzel lefordíthatja az AWQL-t (AdWords lekérdezési nyelv) GAQL-re (Google Ads lekérdezési nyelv).

  3. Vegye figyelembe, hogy a frissítés bizonyos korlátozásokkal jár:

    1. Nem minden AWQL-jelentéstípus támogatott a GAQL-ben.
    2. A rendszer nem minden AWQL-lekérdezést fordít le tisztán GAQL-lekérdezésekre.

Kapcsolódó tartalom

A másolási tevékenység által forrásként és fogadóként támogatott adattárak listáját a támogatott adattárakban találja.