مشاركة عبر

نسخ البيانات من إعلانات Google باستخدام Azure Data Factory أو Synapse Analytics

  • مقالة

ينطبق على: Azure Data Factory Azure Synapse Analytics

تلميح

جرب Data Factory في Microsoft Fabric، وهو حل تحليلي متكامل للمؤسسات. يغطي Microsoft Fabric كل شيء بدءا من حركة البيانات إلى علم البيانات والتحليلات في الوقت الحقيقي والمعلومات المهنية وإعداد التقارير. تعرف على كيفية بدء إصدار تجريبي جديد مجانا!

توضح هذه المقالة كيفية استخدام نشاط النسخ في Azure Data Factory أو مسار Synapse Analytics لنسخ البيانات من إعلانات Google. تعتمد هذه المقالة على مقالة نظرة عامة على نشاط النسخ التي تقدم نظرة عامة على نشاط النسخ.

هام

يرجى ترقية إصدار برنامج تشغيل إعلانات Google قبل 18 فبراير 2024. إذا لم يكن الأمر كما هو، فسيبدأ الاتصال في الفشل مع حدوث خطأ بسبب إهمال برنامج التشغيل القديم.

القدرات المدعومة

يتم دعم موصل إعلانات Google هذا للقدرات التالية:

القدرات المدعومة IR
نشاط النسخ (مصدر/-) (1) (2)
نشاط البحث (1) (2)

① وقت تشغيل تكامل Azure ② وقت تشغيل التكامل المستضاف ذاتيًا

للحصول على قائمة مخازن البيانات المعتمدة كمصادر ومواضع تلقي، راجع جدول مخازن البيانات المعتمدة.

توفر الخدمة برنامج تشغيل مضمناً لتمكين الاتصال، وبالتالي لا تحتاج إلى تثبيت أي برنامج تشغيل يدوياً باستخدام هذا الموصل.

الشروع في العمل

لتنفيذ نشاط النسخ باستخدام أحد المسارات، يمكنك استخدام إحدى الأدوات أو عدد تطوير البرامج التالية:

إنشاء خدمة مرتبطة بإعلانات Google باستخدام واجهة المستخدم

استخدم الخطوات التالية لإنشاء خدمة مرتبطة بإعلانات Google في واجهة مستخدم مدخل Microsoft Azure.

  1. استعرض للوصول إلى علامة التبويب "Manage" في مصنع بيانات Azure أو مساحة عمل Synapse، وحدد "Linked Services"، ثم انقر فوق "New":

  2. ابحث عن إعلانات Google وحدد موصل إعلانات Google.

    لقطة شاشة لموصل إعلانات Google.

  3. قم بتكوين تفاصيل الخدمة، واختبر الاتصال، وأنشئ الخدمة المرتبطة الجديدة.

    لقطة شاشة لتكوين الخدمة المرتبطة لإعلانات Google.

تفاصيل تكوين الموصل

توفر الأقسام التالية تفاصيل حول الخصائص المستخدمة لتعريف كيانات Data Factory الخاصة بموصل إعلانات Google.

خصائص الخدمة المرتبطة

يتم دعم الخصائص التالية لخدمة إعلانات Google المرتبطة:

الخاصية الوصف مطلوب
النوع يجب ضبط خاصية النوع على GoogleAdWords ‏‏نعم‬
googleAdsApiVersion إصدار واجهة برمجة تطبيقات إعلانات Google الذي تستخدمه عند تحديد إصدار برنامج التشغيل الموصى به. يمكنك الرجوع إلى هذه المقالة للحصول على معلومات إصدار واجهة برمجة التطبيقات. ‏‏نعم‬
clientCustomerID معرف عميل العميل لحساب الإعلانات الذي تريد إحضار بيانات التقرير له. ‏‏نعم‬
loginCustomerID معرف العميل لحساب مدير إعلانات Google الذي تريد من خلاله إحضار بيانات التقرير لعميل معين. لا
developerToken الرمز المميز للمطور المرتبط بحساب المدير الذي تستخدمه لمنح حق الوصول إلى واجهة برمجة تطبيقات الإعلانات. يمكنك اختيار وضع علامة على هذا الحقل كـ SecureString لتخزينه بشكل آمن في الخدمة، أو تخزين كلمة المرور في Azure Key Vault والسماح لنشاط نسخ الخدمة بالسحب من هناك عند إجراء نسخة البيانات - تعرف على المزيد من بيانات اعتماد Store في Key Vault. ‏‏نعم‬
نوع المصادقة آلية مصادقة OAuth 2.0 المستخدَمة للمصادقة.
القيم المسموح بها هي: ServiceAuthentication، UserAuthentication.
لا يمكن استخدام خدمة المصادقة إلا وقت تشغيل التكامل المستضاف ذاتيًا.		 ‏‏نعم‬
بالنسبة إلى UserAuthentication:
refreshToken رمز التحديث المميز الذي تم الحصول عليه من Google لتخويل الوصول إلى إعلانات UserAuthentication. يمكنك اختيار وضع علامة على هذا الحقل كـ SecureString لتخزينه بشكل آمن في الخدمة، أو تخزين كلمة المرور في Azure Key Vault والسماح لنشاط نسخ الخدمة بالسحب من هناك عند إجراء نسخة البيانات - تعرف على المزيد من بيانات اعتماد Store في Key Vault. لا
clientId معرف العميل لتطبيق Google المستخدَم للحصول على رمز التحديث المميز. يمكنك اختيار وضع علامة على هذا الحقل كـ SecureString لتخزينه بشكل آمن في الخدمة، أو تخزين كلمة المرور في Azure Key Vault والسماح لنشاط نسخ الخدمة بالسحب من هناك عند إجراء نسخة البيانات - تعرف على المزيد من بيانات اعتماد Store في Key Vault. لا
clientSecret معرف العميل لتطبيق Google المستخدَم للحصول على رمز التحديث المميز. يمكنك اختيار وضع علامة على هذا الحقل كـ SecureString لتخزينه بشكل آمن في الخدمة، أو تخزين كلمة المرور في Azure Key Vault والسماح لنشاط نسخ الخدمة بالسحب من هناك عند إجراء نسخة البيانات - تعرف على المزيد من بيانات اعتماد Store في Key Vault. لا
بالنسبة إلى ServiceAuthentication:
email معرف البريد الإلكتروني لحساب الخدمة المستخدَم لمصادقة الخدمة ولا يمكن استخدامه إلا على وقت تشغيل التكامل المستضاف ذاتيًا. لا
privateKey المفتاح الخاص للخدمة المستخدم ل ServiceAuthentication لإصدار برنامج التشغيل الموصى به ويمكن استخدامه فقط على وقت تشغيل التكامل المستضاف ذاتيا. يمكنك اختيار وضع علامة على هذا الحقل كـ SecureString لتخزينه بشكل آمن في الخدمة، أو تخزين كلمة المرور في Azure Key Vault والسماح لنشاط نسخ الخدمة بالسحب من هناك عند إجراء نسخة البيانات - تعرف على المزيد من بيانات اعتماد Store في Key Vault. لا
بالنسبة إلى ServiceAuthentication باستخدام إصدار برنامج التشغيل القديم:
email معرف البريد الإلكتروني لحساب الخدمة المستخدَم لمصادقة الخدمة ولا يمكن استخدامه إلا على وقت تشغيل التكامل المستضاف ذاتيًا. لا
keyFilePath المسار الكامل إلى ملف المفتاح .p12 أو .json الذي يستخدم لمصادقة عنوان البريد الإلكتروني لحساب الخدمة ويمكن استخدامه فقط على وقت تشغيل التكامل المستضاف ذاتيًا. لا
trustedCertPath المسار الكامل لملف .pem الذي يحتوي على شهادات CA موثوق بها للتحقق من الملقم عند الاتصال عبر TLS. يمكن تعيين هذه الخاصية فقط عند استخدام TLS على وقت تشغيل التكامل المستضاف ذاتيًا. القيمة الافتراضية هي ملف cacerts.pem المثبت مع وقت تشغيل التكامل. لا
useSystemTrustStore تحديد ما إذا كنت تريد استخدام شهادة CA من مخزن الثقة بالنظام أو من ملف PEM محدد. القيمة الافتراضية هي false. لا

مثال:

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

خصائص مجموعة البيانات

للحصول على قائمة كاملة بالأقسام والخصائص المتوفرة لتعريف مجموعات البيانات، راجع مقالة مجموعات البيانات. يوفر هذا القسم قائمة بالخصائص التي تدعمها مجموعة بيانات إعلانات Google.

لنسخ البيانات من إعلانات Google، قم بتعيين خاصية نوع مجموعة البيانات إلى GoogleAdWordsObject. تدعم الخصائص التالية:

الخاصية الوصف مطلوب
النوع يجب ضبط خاصية نوع مجموعة البيانات على: GoogleAdWordsObject ‏‏نعم‬
اسم الجدول ضع اسمًا للجدول. حدد هذه الخاصية عند استخدام إصدار برنامج التشغيل القديم. لا (إذا تم تحديد "الاستعلام" في مصدر النشاط)

مثال

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

انسخ خصائص النشاط

للحصول على قائمة كاملة بالأقسام والخصائص المتوفرة لتعريف الأنشطة، راجع مقالة التدفقات. يوفر هذا القسم قائمة بالخصائص التي يدعمها مصدر إعلانات Google.

لنسخ البيانات من إعلانات Google، قم بتعيين نوع المصدر في نشاط النسخ إلى GoogleAdWordsSource. تُدعم الخصائص التالية في قسم مصدر نشاط النسخ:

الخاصية الوصف مطلوب
النوع يجب ضبط خاصية النوع لمصدر نشاط النسخ إلى: GoogleAdWordsSource ‏‏نعم‬
استعلام استخدم استعلام GAQL لقراءة البيانات. على سبيل المثال: SELECT campaign.id FROM campaign. لا (إذا تم تحديد "tableName" في مجموعة البيانات)

مثال:

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

بحث عن خصائص النشاط

لمعرفة تفاصيل حول الخصائص، تحقق من نشاط البحث.

ترقية إصدار برنامج تشغيل إعلانات Google

لترقية إصدار برنامج تشغيل إعلانات Google، تحتاج إلى تحديث خدمتك المرتبطة وتعلم كيفية الترحيل من SQL إلى لغة استعلام إعلانات Google (GAQL).

تحديث تكوين الخدمة المرتبطة

في صفحة تحرير الخدمة المرتبطة، حدد مستحسن ضمن إصدار برنامج التشغيل وقم بتكوين الخدمة المرتبطة بالإشارة إلى خصائص الخدمة المرتبطة.

الترحيل من SQL إلى GAQL

تحويل عبارات الاستعلام وأسماء الحقول عند الترحيل من SQL إلى GAQL.

عبارات الاستعلام

إذا كنت تستخدم استعلام SQL في مصدر نشاط النسخ أو نشاط البحث الذي يشير إلى خدمة إعلانات Google المرتبطة القديمة، فستحتاج إلى تحديثها إلى استعلام GAQL.

على النقيض من SQL، يتكون الاستعلام في GAQL من ستة أنواع من العبارات:

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

انتقل إلى Google Ads Query Language Grammar لإدخال GAQL.

خذ عبارة SQL التالية كمثال:

SELECT *|FieldName FROM ResourceName WHERE FieldName Operator Value

يمكنك اتباع الإرشادات أدناه لتحويل عبارة SQL إلى عبارة GAQL المقابلة:

  1. إذا * تم استخدام (علامة النجمة) بعد العبارة SELECT ، فأنت بحاجة إلى تحديد جميع الحقول المطلوبة بدلا من العلامة النجمية حيث لا يدعم SELECT *GAQL . انتقل إلى هذه المقالة للاطلاع على كافة الحقول القابلة للتحديد في المورد المحدد.
  2. إذا تم استخدام اسم الحقل بعد العبارة SELECT ، فأنت بحاجة إلى تحويل الاسم إلى اسم الحقل المقابل في GAQL لأن لديهم اصطلاحات تسمية مختلفة. على سبيل المثال، يجب تحويل اسم campaign_id الحقل في عبارة استعلام SQL إلى campaign.id في GAQL. راجع اسم الحقل لمزيد من التفاصيل حول تحويل اسم الحقل.
  3. يمكن ترك اسم المورد كما هو إلا إذا كانت حالته غير متسقة مع ما هو محدد هنا.
  4. WHERE يجب تحديث عبارة وفقا لقواعد GAQL لأن عوامل التشغيل التي يدعمها GAQL غير متسقة مع SQL، ويجب أيضا تحويل اسم الحقل كما هو موضح في النقطة الثانية.

فيما يلي أداتان مفيدتان جدا تقدمها Google ويوصى بهما بشدة عند إنشاء عبارات استعلام GAQL المقابلة:

اسم الحقل

اسم الحقل المستخدم في SQL غير متوافق مع GAQL. تحتاج أيضا إلى معرفة قواعد التحويل من أسماء الحقول في SQL إلى أسماء الحقول في GAQL. يمكن تلخيص قاعدة التحويل على النحو التالي:

  • إذا كان اسم الحقل ينتمي إلى مورد، تغيير التسطير السفلي (_) في SQL إلى نقطة (.) في GAQL. وبالنسبة للكلمات بين النقطة، سيتم تغيير عبارة نوع camelCase المستخدمة في SQL إلى كلمات مستقلة مع إضافة تسطير أسفل السطر بينهما. سيتم تغيير السلسلة الأولى من النوع PascalCase في SQL إلى اسم المورد المقابل في GAQL.

  • إذا كان اسم الحقل ينتمي إلى مقاطع أو مقاييس، فإن البادئة segments. أو metrics. يجب إضافتها في GAQL، فاتبع نفس القاعدة كما هو موضح في النقطة الأولى لتحويل الاسم.

فيما يلي الأمثلة الملموسة لتحويل اسم الحقل:

الفئة أسماء الحقول في SQL أسماء الحقول في GAQL
حقول الموارد Campaign_startDate campaign.start_date
حقول الموارد Customer_conversionTrackingSetting_conversionTrackingStatus customer.conversion_tracking_setting.conversion_tracking_status
Segments DayOfWeek segments.day_of_week
المقاييس VideoViews metrics.video_views

يعرض الجدول أدناه اختلافات الميزات بين إعلانات Google باستخدام إصدار برنامج التشغيل الموصى به وإصدار برنامج التشغيل القديم.

إصدار برنامج التشغيل الموصى به إصدار برنامج التشغيل القديم
يتم دعم تحديد إصدار واجهة برمجة تطبيقات إعلانات Google. تحديد إصدار واجهة برمجة تطبيقات إعلانات Google غير مدعوم.
يدعم ServiceAuthentication خاصيتين:
  •البريد الإلكتروني
  • مفتاح خاص		 يدعم ServiceAuthentication أربع خصائص:
  •البريد الإلكتروني
  • keyFilePath
  • مسارCertPath موثوق به
  • useSystemTrustStore
تحديد جدول في مجموعة بيانات غير معتمد. دعم تحديد جدول في مجموعة بيانات والاستعلام عن الجدول في أنشطة النسخ.
دعم بناء جملة GAQL كلغة الاستعلام. دعم بناء جملة SQL كلغة الاستعلام.
أسماء أعمدة الإخراج هي نفسها أسماء الحقول المعرفة في إعلانات Google. لا تتطابق أسماء أعمدة الإخراج مع أسماء الحقول المعرفة في إعلانات Google.
يتم استخدام التعيينات التالية من أنواع بيانات إعلانات Google إلى أنواع البيانات المؤقتة التي تستخدمها الخدمة داخليا.

float -> float
int32 -> int
int64 -> طويل		 يتم استخدام التعيينات التالية من أنواع بيانات إعلانات Google إلى أنواع البيانات المؤقتة التي تستخدمها الخدمة داخليا.

float -> سلسلة
int32 -> سلسلة
int64 -> سلسلة

ترقية موصل Google AdWords إلى موصل إعلانات Google

قم بترقية خدمة Google AdWords المرتبطة إلى أحدث خدمة مرتبطة ب إعلانات Google باتباع الخطوات التالية:

  1. حدد مستحسن كإصدار برنامج تشغيل لإنشاء خدمة جديدة مرتبطة ب إعلانات Google وتكوينها بالإشارة إلى خصائص الخدمة المرتبطة.

  2. قم بتحديث المسارات الخاصة بك التي تشير إلى خدمة Google AdWords المرتبطة القديمة. بالنظر إلى أن خدمة إعلانات Google المرتبطة تدعم فقط استخدام الاستعلام لنسخ البيانات، لذلك:

    1. إذا كانت البنية الأساسية لبرنامج ربط العمليات التجارية الخاصة بك تقوم باسترداد البيانات مباشرة من تقرير Google AdWords، فابحث عن اسم المورد المقابل لإعلانات Google في الجدول أدناه واستخدم هذه الأداة لإنشاء الاستعلام.

      تقرير Google AdWords مورد إعلانات Google
      ACCOUNT_PERFORMANCE_REPORT زبون
      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 حملة
      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 تسمية
      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 لم يعد متوفرا في واجهة برمجة تطبيقات إعلانات Google.
      URL_PERFORMANCE_REPORT detail_placement_view
      USER_AD_DISTANCE_REPORT distance_view
      VIDEO_PERFORMANCE_REPORT video

    2. إذا كانت البنية الأساسية لبرنامج ربط العمليات التجارية تستخدم الاستعلام لاسترداد البيانات من Google AdWords، فاستخدم أداة Query Migration لترجمة AWQL (لغة استعلام AdWords) إلى GAQL (لغة استعلام إعلانات Google).

  3. يجب أن تدرك أن هناك بعض القيود مع هذه الترقية:

    1. لا يتم دعم جميع أنواع التقارير من AWQL في GAQL.
    2. لا تتم ترجمة جميع استعلامات AWQL بشكل نظيف إلى استعلامات GAQL.

المحتوى ذو الصلة

للحصول على قائمة بمخازن البيانات المدعومة من نشاط النسخ كمصادر ومواضع تلقي، راجع مخازن البيانات المدعومة.