نسخ البيانات من إعلانات 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 ② وقت تشغيل التكامل المستضاف ذاتيًا

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

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

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

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

• أداة نسخ البيانات
• مدخل Azure
• The .NET SDK
• عدة تطوير برامج Python
• Azure PowerShell
• واجهة برمجة تطبيقات REST
• قالب Azure Resource Manager

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

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

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

   Azure Data Factory

   

   Azure Synapse

   

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

   

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

   

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

توفر الأقسام التالية تفاصيل حول الخصائص المستخدمة لتعريف كيانات 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 كمصدر

لنسخ البيانات من إعلانات 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 المقابلة:

• منشئ استعلام GAQL التفاعلي
• مدقق استعلام GAQL

اسم الحقل

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

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

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

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

Category	أسماء الحقول في 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 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.

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

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