Azure Data Factory veya Synapse Analytics kullanarak Google Ads'den veri kopyalama

UYGULANANLAR: Azure Data Factory Azure Synapse Analytics

İpucu

Kuruluşlar için hepsi bir arada analiz çözümü olan Microsoft Fabric'te Data Factory'yi deneyin. Microsoft Fabric , veri taşımadan veri bilimine, gerçek zamanlı analize, iş zekasına ve raporlamaya kadar her şeyi kapsar. Yeni bir deneme sürümünü ücretsiz olarak başlatmayı öğrenin!

Bu makalede, Google Ads'den veri kopyalamak için Azure Data Factory veya Synapse Analytics işlem hattında Kopyalama Etkinliğinin nasıl kullanılacağı özetlenmiştir. Kopyalama etkinliğine genel bir genel bakış sunan kopyalama etkinliğine genel bakış makalesini oluşturur.

Önemli

Lütfen Google Ads sürücü sürümünüzü 18 Şubat 2024'den önce yükseltin. Aksi takdirde, eski sürücünün kullanımdan kaldırılması nedeniyle bağlantı bir hatayla başarısız olur.

Desteklenen özellikler

Bu Google Ads bağlayıcısı aşağıdaki özellikler için desteklenir:

Desteklenen özellikler	IR
Kopyalama etkinliği (kaynak/-)	(1) (2)
Arama etkinliği	(1) (2)

(1) Azure tümleştirme çalışma zamanı (2) Şirket içinde barındırılan tümleştirme çalışma zamanı

Kaynak/havuz olarak desteklenen veri depolarının listesi için Desteklenen veri depoları tablosuna bakın.

Hizmet, bağlantıyı etkinleştirmek için yerleşik bir sürücü sağlar, bu nedenle bu bağlayıcıyı kullanarak herhangi bir sürücüyü el ile yüklemeniz gerekmez.

Kullanmaya başlama

İşlem hattıyla Kopyalama etkinliği gerçekleştirmek için aşağıdaki araçlardan veya SDK'lardan birini kullanabilirsiniz:

• Veri Kopyalama aracı
• Azure portal
• .NET SDK'sı
• Python SDK'sı
• Azure PowerShell
• The REST API
• Azure Resource Manager şablonu

Kullanıcı arabirimini kullanarak Google Ads'e bağlı hizmet oluşturma

Azure portalı kullanıcı arabiriminde Google Ads'e bağlı bir hizmet oluşturmak için aşağıdaki adımları kullanın.

1. Azure Data Factory veya Synapse çalışma alanınızda Yönet sekmesine göz atın ve Bağlı Hizmetler'i seçin, ardından Yeni'ye tıklayın:

   Azure Data Factory

   

   Azure Synapse

   

2. Google Ads'i arayın ve Google Ads bağlayıcısını seçin.

   

3. Hizmet ayrıntılarını yapılandırın, bağlantıyı test edin ve yeni bağlı hizmeti oluşturun.

   

Bağlan veya yapılandırma ayrıntıları

Aşağıdaki bölümlerde, Google Ads bağlayıcısına özgü Data Factory varlıklarını tanımlamak için kullanılan özelliklerle ilgili ayrıntılar sağlanır.

Bağlı hizmet özellikleri

Google Ads bağlı hizmeti için aşağıdaki özellikler desteklenir:

Özellik	Açıklama	Gerekli
Tür	Tür özelliği şu şekilde ayarlanmalıdır: GoogleAdWords	Yes
googleAdsApiVersion	Önerilen sürücü sürümünü seçtiğinizde kullandığınız Google Ads API sürümü. API sürüm bilgileri için bu makaleye başvurabilirsiniz.	Yes
clientCustomerID	Rapor verilerini getirmek istediğiniz Reklam hesabının müşteri kimliği.	Yes
loginCustomerID	Belirli bir müşterinin rapor verilerini getirmek istediğiniz Google Ads yöneticisi hesabının müşteri kimliği.	Hayır
developerToken	Reklam API'sine erişim vermek için kullandığınız yönetici hesabıyla ilişkili geliştirici belirteci. Güvenli bir şekilde depolamak için bu alanı SecureString olarak işaretlemeyi seçebilir veya parolayı Azure Key Vault'ta depolayabilir ve veri kopyalama gerçekleştirirken kopyalama etkinliğinin oradan çekmesine izin vekleyebilirsiniz. Key Vault'ta kimlik bilgilerini depolama bölümünden daha fazla bilgi edinebilirsiniz.	Yes
authenticationType	Kimlik doğrulaması için kullanılan OAuth 2.0 kimlik doğrulama mekanizması. İzin verilen değerler şunlardır: ServiceAuthentication, UserAuthentication. ServiceAuthentication yalnızca şirket içinde barındırılan IR'de kullanılabilir.	Yes
UserAuthentication için:
refreshToken	UserAuthentication için Ads'e erişim yetkisi vermek için Google'dan alınan yenileme belirteci. Güvenli bir şekilde depolamak için bu alanı SecureString olarak işaretlemeyi seçebilir veya parolayı Azure Key Vault'ta depolayabilir ve veri kopyalama gerçekleştirirken kopyalama etkinliğinin oradan çekmesine izin vekleyebilirsiniz. Key Vault'ta kimlik bilgilerini depolama bölümünden daha fazla bilgi edinebilirsiniz.	Hayır
clientId	Yenileme belirtecini almak için kullanılan Google uygulamasının istemci kimliği. Güvenli bir şekilde depolamak için bu alanı SecureString olarak işaretlemeyi seçebilir veya parolayı Azure Key Vault'ta depolayabilir ve veri kopyalama gerçekleştirirken kopyalama etkinliğinin oradan çekmesine izin vekleyebilirsiniz. Key Vault'ta kimlik bilgilerini depolama bölümünden daha fazla bilgi edinebilirsiniz.	Hayır
clientSecret	Yenileme belirtecini almak için kullanılan google uygulamasının istemci gizli dizisi. Güvenli bir şekilde depolamak için bu alanı SecureString olarak işaretlemeyi seçebilir veya parolayı Azure Key Vault'ta depolayabilir ve veri kopyalama gerçekleştirirken kopyalama etkinliğinin oradan çekmesine izin vekleyebilirsiniz. Key Vault'ta kimlik bilgilerini depolama bölümünden daha fazla bilgi edinebilirsiniz.	Hayır
ServiceAuthentication için:
e-posta	ServiceAuthentication için kullanılan ve yalnızca şirket içinde barındırılan IR'de kullanılabilen hizmet hesabı e-posta kimliği.	Hayır
privateKey	Önerilen sürücü sürümü için ServiceAuthentication için kullanılan ve yalnızca şirket içinde barındırılan IR'de kullanılabilen hizmet özel anahtarı. Güvenli bir şekilde depolamak için bu alanı SecureString olarak işaretlemeyi seçebilir veya parolayı Azure Key Vault'ta depolayabilir ve veri kopyalama gerçekleştirirken kopyalama etkinliğinin oradan çekmesine izin vekleyebilirsiniz. Key Vault'ta kimlik bilgilerini depolama bölümünden daha fazla bilgi edinebilirsiniz.	Hayır
Eski sürücü sürümünü kullanarak ServiceAuthentication için:
e-posta	ServiceAuthentication için kullanılan ve yalnızca şirket içinde barındırılan IR'de kullanılabilen hizmet hesabı e-posta kimliği.	Hayır
keyFilePath	Hizmet hesabı e-posta adresinin kimliğini doğrulamak için kullanılan ve yalnızca şirket içinde barındırılan IR'de kullanılabilen veya .json anahtar dosyasının tam yolu.p12.	Hayır
trustedCertPath	TLS üzerinden bağlanırken sunucuyu doğrulamak için güvenilen CA sertifikalarını içeren .pem dosyasının tam yolu. Bu özellik yalnızca şirket içinde barındırılan IR üzerinde TLS kullanılırken ayarlanabilir. Varsayılan değer, IR ile yüklenen cacerts.pem dosyasıdır.	Hayır
useSystemTrustStore	Sistem güven deposundan veya belirtilen PEM dosyasından CA sertifikası kullanılıp kullanılmayacağını belirtir. Varsayılan değer olarak yanlış kullanılır.	Hayır

Örnek:

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

Veri kümesi özellikleri

Veri kümelerini tanımlamak için kullanılabilen bölümlerin ve özelliklerin tam listesi için veri kümeleri makalesine bakın. Bu bölümde, Google Ads veri kümesi tarafından desteklenen özelliklerin listesi sağlanır.

Google Ads'den veri kopyalamak için veri kümesinin tür özelliğini GoogleAdWordsObject olarak ayarlayın. Aşağıdaki özellikler desteklenir:

Özellik	Açıklama	Gerekli
Tür	Veri kümesinin type özelliği şu şekilde ayarlanmalıdır: GoogleAdWordsObject	Yes
tableName	Tablonun adı. Eski sürücü sürümünü kullanırken bu özelliği belirtin.	Hayır (etkinlik kaynağında "sorgu" belirtilirse)

Örnek

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

Kopyalama etkinliğinin özellikleri

Etkinlikleri tanımlamak için kullanılabilen bölümlerin ve özelliklerin tam listesi için İşlem hatları makalesine bakın. Bu bölümde, Google Ads kaynağı tarafından desteklenen özelliklerin listesi sağlanır.

Kaynak olarak Google Ads

Google Ads'den veri kopyalamak için kopyalama etkinliğindeki kaynak türünü GoogleAdWordsSource olarak ayarlayın. Kopyalama etkinliği kaynağı bölümünde aşağıdaki özellikler desteklenir:

Özellik	Açıklama	Gerekli
Tür	Kopyalama etkinliği kaynağının type özelliği şu şekilde ayarlanmalıdır: GoogleAdWordsSource	Yes
query	Verileri okumak için GAQL sorgusunu kullanın. Örneğin: SELECT campaign.id FROM campaign.	Hayır (veri kümesinde "tableName" belirtilirse)

Örnek:

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

Arama etkinliği özellikleri

Özellikler hakkında ayrıntılı bilgi edinmek için Arama etkinliği'ne bakın.

Google Ads sürücü sürümünü yükseltme

Google Ads sürücü sürümünüzü yükseltmek için bağlı hizmetinizi güncelleştirmeniz ve SQL'den Google Ads Sorgu Dili'ne (GAQL) nasıl geçiş yapılacağını öğrenmeniz gerekir.

Bağlı hizmet yapılandırmasını güncelleştirme

Bağlı hizmeti düzenle sayfasında, Sürücü sürümü altında Önerilen'i seçin ve Bağlı hizmet özellikleri'ne başvurarak bağlı hizmeti yapılandırın.

SQL'den GAQL'e geçiş

SQL'den GAQL'e geçiş yaparken sorgu deyimlerinizi ve alan adlarınızı dönüştürün.

Sorgu deyimleri

Kopyalama etkinliği kaynağında veya eski Google Ads bağlı hizmetine başvuran arama etkinliğinde SQL sorgusu kullanıyorsanız, bunları GAQL sorgusuna güncelleştirmeniz gerekir.

SQL'in aksine, GAQL'deki sorgu altı tür yan tümceden oluşur:

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

GAQL'in tanıtımı için Google Ads Sorgu Dili Dil Bilgisi'ne gidin.

Örnek olarak aşağıdaki SQL deyimini alın:

SELECT *|FieldName FROM ResourceName WHERE FieldName Operator Value

SQL deyimini ilgili GAQL deyimine dönüştürmek için aşağıdaki yönergeleri izleyebilirsiniz:

1. Yan tümceden SELECT sonra (yıldız işareti) kullanılıyorsa * , GAQL desteklemediğinden SELECT *yıldız işareti yerine tüm gerekli alanları belirtmeniz gerekir. Belirli bir kaynaktaki tüm seçilebilir alanları görmek için bu makaleye gidin.
2. Alan adı yan tümceden SELECT sonra kullanılıyorsa, farklı adlandırma kurallarına sahip oldukları için adı GAQL'de karşılık gelen alan adına dönüştürmeniz gerekir. Örneğin, SQL sorgu deyimindeki alan adı campaign_id GAQL'de olarak campaign.id dönüştürülmelidir. Alan adı dönüştürme hakkında daha fazla bilgi için bkz. Alan adı.
3. Kaynak adı, burada belirtilen durumla tutarsız olmadığı sürece olduğu gibi bırakılabilir.
4. WHERE yan tümcesi , GAQL tarafından desteklenen işleçler SQL ile tutarlı olmadığından GAQL dil bilgisine göre güncelleştirilmelidir ve alan adı da ikinci noktada açıklandığı gibi dönüştürülmelidir.

Google tarafından sunulan ve ilgili GAQL sorgu deyimlerini oluştururken kesinlikle önerilen iki kullanışlı araç aşağıdadır:

• Etkileşimli GAQL sorgu oluşturucusu
• GAQL sorgu doğrulayıcı

Alan adı

SQL'de kullanılan alan adı GAQL ile uyumlu değil. Ayrıca SQL'deki alan adlarından GAQL'deki alan adlarına dönüştürme kurallarını da öğrenmeniz gerekir. Dönüştürme kuralı aşağıdaki gibi özetlenebilir:

• Alan adı bir kaynağa aitse, SQL'deki alt çizgi (_), GAQL'de nokta (.) olarak değiştirilir. Nokta arasındaki sözcükler için, SQL'de kullanılan camelCase tür deyimi, arasına alt çizgi eklenmiş tek başına sözcükler olarak değiştirilir. SQL'deki PascalCase türündeki ilk dize, GAQL'de karşılık gelen kaynak adıyla değiştirilir.

• Alan adı segmentlere veya ölçümlere aitse, ön ek segments. veya metrics. GAQL'e eklenmelidir, ardından adı dönüştürmek için ilk noktada açıklandığı gibi aynı kuralı izleyin.

Alan adı dönüştürme işleminin somut örnekleri aşağıda verilmiştir:

Kategori	SQL'de alan adları	GAQL'de alan adları
Kaynak alanları	Campaign_startDate	campaign.start_date
Kaynak alanları	Customer_conversionTrackingSetting_conversionTrackingStatus	customer.conversion_tracking_setting.conversion_tracking_status
Segmentler	DayOfWeek	segments.day_of_week
Ölçümler	VideoViews	metrics.video_views

Google AdWords bağlayıcısını Google Ads bağlayıcısına yükseltme

Aşağıdaki adımları izleyerek Google AdWords bağlı hizmetinizi en son Google Ads bağlı hizmetine yükseltin:

1. Yeni bir Google Ads bağlı hizmeti oluşturmak ve Bağlı hizmet özelliklerine başvurarak bunu yapılandırmak için Sürücü sürümü olarak önerilen'i seçin.

2. Eski Google AdWords bağlı hizmetine başvuran işlem hatlarınızı güncelleştirin. Google Ads bağlı hizmetinin yalnızca verileri kopyalamak için sorgu kullanmayı desteklediğini göz önünde bulundurarak:

   1. İşlem hattınız doğrudan Google AdWords raporundan veri almaktaysa, aşağıdaki tabloda Google Ads'in ilgili kaynak adını bulun ve sorguyu oluşturmak için bu aracı kullanın.

      Google AdWords raporu	Google Ads kaynağı
      ACCOUNT_PERFORMANCE_REPORT	müşteri
      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	kampanya
      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	etiket
      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	Artık Google Ads API'sinde kullanılamaz.
      URL_PERFORMANCE_REPORT	detail_placement_view
      USER_AD_DISTANCE_REPORT	distance_view
      VIDEO_PERFORMANCE_REPORT	video

   2. İşlem hattı, Google AdWords'ten veri almak için sorgu kullanıyorsa Sorgu Geçişi aracını kullanarak AWQL'yi (AdWords Sorgu Dili) GAQL'e (Google Ads Sorgu Dili) çevirin.

3. Bu yükseltmeyle ilgili bazı sınırlamalar olduğunu unutmayın:

   1. GAQL'de AWQL'deki tüm rapor türleri desteklenmez.
   2. Tüm AWQL sorguları GAQL sorgularına temiz bir şekilde çevrilmemiştir.

İlgili içerik

Kopyalama etkinliği tarafından kaynak ve havuz olarak desteklenen veri depolarının listesi için bkz . desteklenen veri depoları.