Aracılığıyla paylaş


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.

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.

  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:

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

    Google Ads bağlayıcısının ekran görüntüsü.

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

    Google Ads için bağlı hizmet yapılandırmasının ekran görüntüsü.

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.

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:

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

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:

  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.

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