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

Makale
05/13/2024

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.

Başlarken

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

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.

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
Google Ads'i arayın ve Google Ads bağlayıcısını seçin.
Hizmet ayrıntılarını yapılandırın, bağlantıyı test edin ve yeni bağlı hizmeti oluşturun.

Bağlayıcı 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:

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.
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ı.
Kaynak adı, burada belirtilen durumla tutarsız olmadığı sürece olduğu gibi bırakılabilir.
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:

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`

Önerilen ve eski sürücü sürümünü kullanan Google Ads arasındaki farklar

Aşağıdaki tabloda, önerilen ve eski sürücü sürümünü kullanan Google Ads arasındaki özellik farklılıkları gösterilmektedir.

Önerilen sürücü sürümü	Eski sürücü sürümü
Google Ads API sürümünün belirtilmesi desteklenir.	Google Ads API sürümünün belirtilmesi desteklenmez.
ServiceAuthentication iki özelliği destekler: •E-posta • privateKey	ServiceAuthentication dört özelliği destekler: •E-posta • keyFilePath • trustedCertPath • useSystemTrustStore
Veri kümesinde tablo seçme desteklenmez.	Veri kümesinde tablo seçmeyi ve kopyalama etkinliklerinde tabloyu sorgulamayı destekler.
Sorgu dili olarak GAQL söz dizimini destekler.	Sorgu dili olarak SQL söz dizimini destekler.
Çıkış sütun adları, Google Ads'de tanımlanan alan adlarında aynıdır.	Çıkış sütun adları, Google Ads'de tanımlanan alan adlarla eşleşmiyor.
Google Ads veri türlerinden hizmet tarafından dahili olarak kullanılan ara veri türlerine aşağıdaki eşlemeler kullanılır. float -> float int32 -> int int64 -> uzun	Google Ads veri türlerinden hizmet tarafından dahili olarak kullanılan ara veri türlerine aşağıdaki eşlemeler kullanılır. float -> dize int32 -> dize int64 -> dize

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:

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.

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:

İş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

İş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.

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.

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

Aracılığıyla paylaş

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

Desteklenen özellikler

Başlarken

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

Bağlayıcı yapılandırma ayrıntıları

Bağlı hizmet özellikleri

Veri kümesi özellikleri

Kopyalama etkinliğinin özellikleri

Kaynak olarak Google Ads

Arama etkinliği özellikleri

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

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

SQL'den GAQL'e geçiş

Sorgu deyimleri

Alan adı

Önerilen ve eski sürücü sürümünü kullanan Google Ads arasındaki farklar

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

Geri Bildirim

Ek kaynaklar

Aracılığıyla paylaş

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

Desteklenen özellikler

Başlarken

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

Bağlayıcı yapılandırma ayrıntıları

Bağlı hizmet özellikleri

Veri kümesi özellikleri

Kopyalama etkinliğinin özellikleri

Kaynak olarak Google Ads

Arama etkinliği özellikleri

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

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

SQL'den GAQL'e geçiş

Sorgu deyimleri

Alan adı

Önerilen ve eski sürücü sürümünü kullanan Google Ads arasındaki farklar

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

İlgili içerik

Geri Bildirim

Ek kaynaklar