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

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

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.

Támogatott képességek

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

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

• Az Adatok másolása eszköz
• Az Azure Portal
• A .NET SDK
• A Python SDK
• Azure PowerShell
• A REST API
• Az Azure Resource Manager-sablon

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:

   • Azure Data Factory
   • Azure Synapse

   

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

   

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

   

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:

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:

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.

Google Ads mint forrás

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:

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:

• Interaktív GAQL-lekérdezésszerkesztő
• GAQL-lekérdezés-érvényesítő

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:

Az ajánlott és az örökölt illesztőprogram-verziót használó Google Ads-hirdetések közötti különbségek

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.

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ó

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.