إعداد الحساب

نقطة أساسية: يقدّم لك هذا المستند المعلومات والسياق اللازمَين لإجراء الإعداد الأولي لحسابك على Ads Data Hub. يفترض هذا الدليل أنّك مالك كلّ من حساب Ads Data Hub وحسابات المنصات الإعلانية من Google التي سيتم ربطها. إذا كنت تعمل مع مورّد Ads Data Hub، يُرجى التواصل معه لمعرفة المزيد عن عملية الدمج.

نظرة عامة على إعداد حساب Ads Data Hub

تقدّم هذه النظرة العامة ملخّصًا شاملاً للخطوات المطلوبة لإعداد حساب على Ads Data Hub:

1. تحديد بنية حسابك: اختَر بين حساب من مستوى واحد (يُنصح به لمعظم المؤسسات) أو حساب من مستويَين للبُنى المعقّدة التي تضمّ عدة معلنين.
2. إعداد مشاريعك على Google Cloud: يجب تحديد مشروع على Google Cloud ليكون مشروع المشرف، وتفعيل Ads Data Hub API‏ (adsdatahub.googleapis.com) وBigQuery API‏ (bigquery.googleapis.com)، وإنشاء مجموعة بيانات في BigQuery، ومنح حساب خدمة Ads Data Hub (وكيل خدمة لكل منتج ولكل مشروع على Google Cloud أو P4SA) الإذن بقراءة مجموعات بياناتك والكتابة فيها.
3. توفير إمكانية وصول المستخدمين: يمكنك منح أدوار وصول المستخدمين إلى المستخدمين في حسابك على Ads Data Hub وضبط أذونات "إدارة الهوية وإمكانية الوصول" في BigQuery.
4. ربط البيانات بحسابك على Ads Data Hub: اربط حساباتك على منصات Google الإعلانية من خلال ربط الحسابات في Ads Data Hub.

مسارات الإعداد: معالج إعداد الحساب والإعداد اليدوي

بالنسبة إلى Ads Data Hub لجهات التسويق، يتم الإعداد الأولي على أربع مراحل، مع مسارَين لضبط موارد Google Cloud (معالج الإعداد المطلوب أو الضبط اليدوي):

1. قبل الإنشاء (الخطوة 1: بنية الحساب): يمكنك التعاون مع ممثل عن Google لتحديد بنية حسابك (يُنصح باستخدام بنية من مستوى واحد لمعظم المؤسسات) وتوقيع اتفاقية العقد.
2. معالج إعداد الحساب (مطلوب، يرشدك خلال الخطوة 2): يُعدّ إكمال معالج إعداد الحساب من رسالة الترحيب الإلكترونية مطلوبًا لإنهاء إنشاء حسابك على Ads Data Hub (لا يمكن تخطّي المعالج). يرشدك هذا المعالج بشكل تسلسلي خلال عملية تسمية حسابك، وتحديد مشروع Google Cloud الإداري، وتفعيل واجهات برمجة التطبيقات، واختيار مجموعة بيانات BigQuery التلقائية، وتفعيل ميزة "مطابقة البيانات المقدَّمة من المستخدم" (UPDM) اختياريًا. (ملاحظة: لا يمكن إنشاء حسابات فرعية في إعداد حساب مزدوج المستوى باستخدام المعالج.)
3. مسار الإعداد اليدوي في Google Cloud (المرجع للخطوة 2 / الإعداد اليدوي): إذا لم يكن لدى المستخدم الذي يشغّل المعالج أذونات Google Cloud لضبط المشروع أو مجموعات بيانات BigQuery تلقائيًا داخل المعالج، يمكن لمشرف Cloud ضبط مشروع Google Cloud وواجهات برمجة التطبيقات ومجموعات بيانات BigQuery وأذونات حساب خدمة Ads Data Hub (P4SA) يدويًا مسبقًا باستخدام ضبط مشاريعك على Google Cloud، ثم اختيار تلك الموارد التي تم ضبطها مسبقًا في المعالج. يتم أيضًا استخدام الإعداد اليدوي للحسابات الفرعية في إعداد مزدوج المستوى أو عند إضافة مجموعات بيانات لاحقًا.
4. الإعداد بعد إكمال خطوات المعالج (الخطوتان 3 و4): بعد إكمال خطوات المعالج وتوفير حسابك، أكمِل توفير إمكانية وصول المستخدمين و ربط البيانات بحسابك على Ads Data Hub في واجهة مستخدم Ads Data Hub.

بنية حسابك على Ads Data Hub

راجِع نوعَي بُنى الحسابات في القسمَين التاليَين. بعد تحديد البنية اللازمة لاحتياجات مؤسستك، يُرجى إبلاغ ممثل Google بذلك. إذا كنت تعتقد أنّ أيًا منهما لا يلبي احتياجات مؤسستك، يُرجى استشارة ممثل Google.

حساب بمستوى واحد

الحساب من مستوى واحد هو حساب على Ads Data Hub لا يتضمّن حسابات فرعية. وهي البنية المقترَحة والأكثر شيوعًا لمعظم العملاء. في هذا النوع من بنية الحساب، يتم ربط بيانات الأداء مع إعلانات مباشرةً بحسابك على Ads Data Hub، ويتم تحديد إمكانية الوصول إلى البيانات فقط من خلال أدوار وصول المستخدمين.

حساب مزدوج المستوى

إذا كنت بحاجة إلى أن يحاكي حسابك على Ads Data Hub بنية تنظيمية معقّدة، قد تحتاج إلى حساب مزدوج المستوى. في هذا النوع من بنية الحسابات، يحتوي حسابك على Ads Data Hub (يُشار إليه باسم الحساب الرئيسي) على حسابات فرعية متعددة (يُشار إليها باسم الحسابات الفرعية). يتم ربط بيانات الأداء مع إعلانات بالحسابات الفرعية، ويمكن تقييد وصول المستخدمين من خلال تعيينهم لحسابات فرعية معيّنة. العلاقة بين الحساب الرئيسي والحساب الفرعي غير قابلة للتغيير، ما يعني أنّه لا يمكن نقل الحسابات الفرعية إلى حساب رئيسي آخر. يتطلّب كل حساب على Ads Data Hub (وكل حساب فرعي) مشروعًا مميزًا على Google Cloud يتم تحديده على أنّه المشروع الإداري الوحيد لهذا الحساب على Ads Data Hub. يجب أن تكون هذه العلاقة فردية: لا يمكن لمشروع واحد على Google Cloud أن يكون مشروع المشرف لحسابات متعددة على Ads Data Hub.

يجب أن تكون مجموعات بيانات BigQuery في المنطقة نفسها التي يقع فيها حسابك على Ads Data Hub (US أو EU أو asia-northeast1 أو australia-southeast1). تكتسب جميع الحسابات الفرعية منطقتها من الحساب الرئيسي على Ads Data Hub.

ملاحظة مهمة: قد يحتاج المستخدمون في المؤسسات التي تغطي مناطق متعددة إلى إنشاء حسابات متعددة على Ads Data Hub خاصة بكل منطقة وتتوافق مع مناطق بيانات الأداء مع إعلانات ومجموعات البيانات. للالتزام باللوائح التنظيمية الخاصة بمنطقة معيّنة، لا يمكن لحساب Ads Data Hub في الولايات المتحدة استيراد البيانات أو تصديرها باستخدام مجموعة بيانات BigQuery في الاتحاد الأوروبي. تكتسب حسابات الأطفال منطقتها من حساب Ads Data Hub. ويصبح هذا الأمر مهمًا بشكل خاص عند العمل مع بيانات الطرف الأول في Ads Data Hub.

يقارن هذا الرسم البياني بين نوعَي بنية الحساب:

	فئة اشتراك واحدة	مستويان
حالات الاستخدام المعتادة	المعلنون	الوكالات المعلِنون الذين لديهم بنية تنظيمية معقّدة
مثال على مخطّط بياني	عرض الصورة	عرض الصورة
ربط البيانات
يفترض هذا الإجراء أنّ صاحب حساب Ads Data Hub هو أيضًا صاحب حساب المنصة الإعلانية.
يتم ربط حسابات منصات إعلانات Google مباشرةً بحسابك على Ads Data Hub.
يتم إنشاء حسابات فرعية تمثّل معلنين معيّنين ضمن حسابك على Ads Data Hub.
يتم ربط حسابات إعلانات Google بالمنصات الإعلانية بحساباتك الفرعية على Ads Data Hub باستخدام بيانات الأداء مع إعلانات من أرقام التعريف. يمكن ربط معرّف منصة إعلانية واحد بكل معرّف بيانات أداء مع إعلانات.
إدارة المستخدمين
إدارة بسيطة للمستخدمين تتم إدارة المستخدمين مباشرةً في حسابك على Ads Data Hub. ويمكن للمستخدمين الذين لديهم إذن الوصول إلى هذا الحساب الوصول إلى جميع بيانات الإعلانات المرتبطة بالحساب.
إدارة دقيقة للمستخدمين يمكن للمستخدمين الذين تم توفيرهم مباشرةً في حسابك على Ads Data Hub الوصول إلى جميع بيانات الأداء مع إعلانات المرتبطة بجميع الحسابات الفرعية. يمكن للمستخدمين الذين تم توفيرهم في حساب فرعي معيّن الوصول إلى جميع بيانات الأداء مع إعلانات المرتبطة بهذا الحساب الفرعي. ولا يمكنهم الوصول إلى البيانات من حسابات الأطفال الأخرى.
متطلبات السحابة الإلكترونية
يتطلّب ذلك مشروعًا إداريًا واحدًا على Google Cloud لحسابك على Ads Data Hub (علاقة فردية).
يتطلّب ذلك مشروعًا إداريًا واحدًا على Google Cloud لحسابك على Ads Data Hub، بالإضافة إلى مشروع واحد مميّز على Google Cloud لكل حساب فرعي (كل منهما في علاقة فردية).
يمكن استيراد البيانات من مناطق سحابية متعدّدة إلى حساب Ads Data Hub نفسه.
دمج البيانات
يمكن دمج البيانات من حسابات منصات إعلانية مختلفة مرتبطة بالحساب نفسه (أو الحساب الفرعي نفسه) في طلب البحث نفسه. لا يمكن دمج البيانات في حسابات فرعية مختلفة في طلب البحث نفسه.

إنشاء حسابك على Ads Data Hub

يمكنك التواصل مع ممثل عن Google للحصول على المساعدة في الوصول إلى Ads Data Hub. يتحقّق ممثل عن Google من استيفائك المعايير العادية ويؤكّد ذلك، ثم يبدأ في إبرام اتفاقية عقد. بعد توقيع العقد، ستتلقّى إشعارًا عبر البريد الإلكتروني يطلب منك الانتقال إلى معالج إعداد الحساب، ويمكنك بعد ذلك إكمال عملية إنشاء الحساب.

معالج إعداد الحساب

يجب إكمال معالج إعداد الحساب من رسالة الترحيب الإلكترونية لإنهاء إنشاء حسابك على Ads Data Hub (لا يمكن تخطّي المعالج). يرشدك المعالج خلال مهام الإعداد الأولية.

ملاحظة: لا يمكن استخدام المعالج لإنشاء حسابات فرعية في إعداد حساب مزدوج المستوى.

تشغيل معالج إعداد الحساب

يرشدك معالج الإعداد بشكل تسلسلي خلال خطوات الإعداد الرئيسية:

1. تسمية حسابك على Ads Data Hub
2. تحديد مشروع Google Cloud الخاص بالمشرف
3. اختيار مجموعة بيانات BigQuery التلقائية
4. (اختياري) تفعيل ميزة "مطابقة البيانات المقدَّمة من المستخدم"

في أي مرحلة من مراحل المعالج، يمكنك إضافة مستخدم للمساعدة في الإعداد (خاصةً إذا كنت بحاجة إلى مساعدة من زميل لديه أذونات Google Cloud IAM) أو استخدام رمز المساعدة للوصول إلى المراجع التالية:

• نظرة عامة على إعداد الحساب
• معلومات مشروع على السحابة الإلكترونية من Google Cloud
• معلومات مجموعة بيانات BigQuery
• نهج الخصوصية
• التواصل مع فريق الدعم

إضافة مستخدم للمساعدة في عملية الإعداد

إذا كنت بحاجة إلى مساعدة من شخص آخر في مؤسستك لإكمال عملية الإعداد، مثل مشرف Google Cloud لديه أذونات "إدارة الهوية وإمكانية الوصول" لتفعيل واجهات برمجة التطبيقات أو ضبط مجموعات بيانات BigQuery، يمكنك إضافة مستخدمين في أي مرحلة من مراحل المعالج من خلال النقر على رمز إضافة مستخدم.

عند إضافة مستخدم، سيُطلب منك إدخال عنوان بريده الإلكتروني وملاحظة. يؤدي النقر على حفظ إلى إرسال دعوة عبر البريد الإلكتروني تتضمّن ملاحظتك ورابطًا للانضمام إلى عملية الإعداد. تتم إضافة المستخدم تلقائيًا كـ مستخدم مميز في حسابك على Ads Data Hub.

ملاحظات:

• يجب أن يكون هذا الشخص من مؤسستك ويمكنه الوصول إلى حسابك على Ads Data Hub بعد اكتمال عملية الإعداد.
• يجب ربط عناوين البريد الإلكتروني بحساب Google صالح.
• يتم منح المستخدمين الذين تمت إضافتهم في هذه المرحلة دور المستخدم المميّز. مزيد من المعلومات عن أدوار المستخدمين
• يمكن إزالة المستخدمين بعد اكتمال المعالج.

الخطوة 1: تسمية حسابك على Ads Data Hub

أدخِل اسمًا لحسابك على Ads Data Hub. تحتوي جميع الحسابات على رقم تعريف فريد مكوّن من 9 أرقام، ولكن يمكن أن يساعد هذا الاسم في تحديد الحساب. يجب أن يكون الاسم فريدًا ووصفيًا حتى يتمكن المستخدمون الجدد من تحديد الحساب.

ملاحظة: لا تستخدِم معلومات شخصية في أسماء الحسابات.

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

الخطوة 2: تحديد مشروع المشرف

لأغراض إدارية، يتم ضبط حسابك على Ads Data Hub باستخدام مشروع واحد محدّد على Google Cloud ليكون مشروع المشرف. هذه العلاقة هي علاقة فردية فقط: لا يمكن أن يكون مشروع Google Cloud واحد هو مشروع المشرف لحسابات Ads Data Hub متعددة (أو حسابات فرعية)، ولا يمكن تغيير التصنيف بعد إرساله.

إذا سبق لمشرف Google Cloud تفعيل واجهات برمجة التطبيقات المطلوبة يدويًا وضبط الأذونات مسبقًا وفقًا لإعداد مشاريع Google Cloud، يمكنك اختيار هذا المشروع الذي تم ضبطه مسبقًا خلال هذه الخطوة.

ملاحظات:

• يُرجى التواصل مع ممثل عن Google إذا كنت بحاجة إلى مساعدة في ضبط مشروعك على Google Cloud.
• لا يمكنك تحديد مشروع مشرف مختلف أو تعديل منطقة Cloud بعد إرسال هذا الاختيار الأولي. لهذا السبب، من الضروري أن تحدّد مشروعًا دائمًا على Google Cloud كمشروع مشرف. مزيد من المعلومات
• يجب أن تكون مجموعات بيانات BigQuery للإدخال والإخراج في موقع BigQuery الجغرافي (US أو EU أو asia-northeast1 أو australia-southeast1) الذي يتطابق مع منطقة حسابك على Ads Data Hub. يُرجى العِلم أنّ الموقع الجغرافي لعرض الإعلانات واستهداف الجمهور منفصل عن موقع مجموعة بيانات BigQuery. مزيد من المعلومات
• اختَر مشروعًا متاحًا. يجب أن يكون هذا المشروع دائمًا، حيث لا يمكن تغييره بمجرد اكتمال هذه الخطوة. يُرجى العِلم أنّه يجب أن يكون لديك إذن محرِّر في مشروع Google Cloud المحدّد.
• يتم تطبيق تفعيل واجهة برمجة التطبيقات وأذونات حساب خدمة Ads Data Hub‏ (P4SA) التي تم منحها خلال هذه الخطوة مباشرةً على مشروعك المحدّد على Google Cloud.
• بالنقر على التالي، أنت توافق على تفعيل Ads Data Hub API. لا يمكنك تغيير هذه الإعدادات بعد الانتقال إلى الخطوة التالية.

للحصول على مساعدة في هذه الخطوة أو إذا واجهت خطأ، يمكنك إضافة مستخدم للمساعدة أو الاطّلاع على المقالات التالية:

• نظرة عامة على إعداد الحساب
• نظرة عامة على مشروع المشرف
• منطقة BigQuery Cloud
• تفعيل واجهة برمجة التطبيقات في مشروع المشرف

الخطوة 3: اختيار مجموعة بيانات BigQuery تلقائية

مجموعات بيانات BigQuery هي المكان الذي تتم فيه كتابة نتائج Ads Data Hub، وهي أحد الأماكن التي يمكنك فيها تحليل بياناتك بشكل أكبر. في هذه الخطوة، عليك:

تحديد مجموعة بيانات الناتج: يجب أن يكون لديك أذونات تعديل كافية لاختيار مجموعة بيانات الناتج بنجاح أو يمكنك إضافة مستخدم مشرف في BigQuery للمساعدة.

تحديد مجموعة بيانات الدعم (اختياري): لتفعيل ميزة تحديد المشاكل وحلّها المتقدّمة من فريق دعم Ads Data Hub، يمكنك إعداد مجموعة بيانات الدعم. مزيد من المعلومات

ملاحظات:

• للسماح لفريق دعم Ads Data Hub بتحديد المشاكل في طلب البحث وحلّها، عليك كتابة ناتج طلب البحث في مجموعة بيانات جديدة مخصّصة لتحديد المشاكل وحلّها ومنح فريق الدعم إذن الوصول إلى مجموعة البيانات من خلال دور "مُشاهد البيانات في BigQuery" (roles/bigquery.dataViewer). يتيح ذلك للفريق الاطّلاع على نتائج طلب البحث، بدون منحه إذن الوصول إلى أي بيانات أخرى في مشروعك على Google Cloud. ويمكنك إبطال إذن الوصول في أي وقت. مزيد من المعلومات
• يتم تطبيق إنشاء مجموعة البيانات والأذونات على مستوى مجموعة البيانات الممنوحة خلال هذه الخطوة مباشرةً على مشروع BigQuery.

للحصول على مساعدة في هذه الخطوة أو إذا واجهت خطأ، يمكنك إضافة مستخدم للمساعدة أو الاطّلاع على المقالات التالية:

• نظرة عامة على مجموعة بيانات BigQuery
• أذونات BigQuery
• تغيير إذن الوصول إلى BigQuery للاطّلاع على التغييرات

الخطوة 4 (اختيارية): تفعيل ميزة "مطابقة البيانات المقدَّمة من المستخدم"

لكي تتمكّن ميزة "مطابقة البيانات المقدَّمة من المستخدم" من قراءة بيانات الطرف الأول ومطابقتها وكتابة النتائج في مشروعك على Google Cloud، عليك منح حساب خدمة Ads Data Hub‏ (P4SA) إذن الوصول إلى مشروعك على Google Cloud. للحصول على مساعدة في هذه الخطوة، أو إذا واجهت خطأ، يُرجى الاطّلاع على المقالات التالية:

• مطابقة البيانات المقدَّمة من المستخدم
• أذونات BigQuery
• بنود الخدمة

بعد إكمال المعالج

بعد إكمال المعالج، ستتلقّى رسالة تفيد بأنّ عملية الإعداد قد اكتملت. يجب الانتظار لمدة تتراوح بين يوم واحد وثلاثة أيام حتى تكتمل عملية الإعداد. ستصلك بعد ذلك رسالة متابعة لإعلامك بأنّ حسابك أصبح متاحًا. إذا كانت عملية الإعداد في انتظار المراجعة لأكثر من خمسة أيام عمل، أو إذا تلقّيت رسالة تنبّهك إلى مشاكل في إعداد حسابك، يمكنك التواصل مع فريق الدعم. بعد أن يصبح حسابك متاحًا، انتقِل إلى منح المستخدمين إذن الوصول وربط البيانات بحسابك على Ads Data Hub.

ضبط مشاريعك على السحابة الإلكترونية على Google Cloud (الضبط اليدوي)

ملاحظة: إذا سبق لك إكمال معالج إعداد الحساب، سيحدّد المعالج تلقائيًا مشروع المشرف، ويفعّل واجهات برمجة التطبيقات المطلوبة، ويضبط مجموعة بيانات BigQuery التلقائية وأذونات حساب الخدمة. ما عليك سوى اتّباع الخطوات اليدوية في الأقسام التالية إذا كان مشرف Google Cloud يضبط الموارد مسبقًا قبل تشغيل المعالج، أو إذا كنت تنشئ حسابات فرعية في إعداد مزدوج المستوى، أو إذا كنت بحاجة إلى إضافة مجموعات بيانات إضافية أو تغيير الأذونات لاحقًا.

يحتوي مشروعك على Google Cloud على نتائج Ads Data Hub وأي بيانات طرف أول تستخدمها لكتابة عمليات دمج بيانات الطرف الأول. بالإضافة إلى ذلك، تُعدّ مشاريع Google Cloud الأساس الذي تستند إليه الفوترة واستخدام خدمات Google Cloud.

مزيد من المعلومات عن آلية عمل Ads Data Hub مع BigQuery

كيفية إنشاء مشروع على Google Cloud

تحديد مشروع مشرف

لأغراض إدارية، يتم إنشاء حسابك على Ads Data Hub في البداية باستخدام مشروع معيّن على Google Cloud، يُعرف باسم مشروع المشرف. بعد ضبط هذا الإعداد، لا يمكن تغيير تصنيف مشروع المشرف هذا. هذه العلاقة هي علاقة واحد لواحد بشكل صارم: لا يمكن تحديد مشروع واحد على Google Cloud كمشروع مشرف لحسابات متعدّدة على Ads Data Hub (أو حسابات فرعية).

بشكل منفصل عن مشروع المشرف المحدّد، يمكن لحسابك على Ads Data Hub قراءة بيانات الإدخال من مجموعات بيانات BigQuery وكتابة نتائج الإخراج إليها في أي عدد من مشاريع Google Cloud. يتم التحكّم في الوصول إلى مجموعات البيانات هذه من خلال منح حساب خدمة Ads Data Hub (وكيل خدمة لكل منتج ولكل مشروع في Google Cloud، أو P4SA) أذونات BigQuery المناسبة في مجموعات البيانات أو مشاريع Google Cloud اللازمة، والتي يمكن تعديلها في أي وقت.

لن تتمكّن من تحديد مشروع مشرف مختلف بعد إجراء اختيارك الأولي. قد يؤدي تغيير المشروع الإداري إلى تعطُّل حسابك على Ads Data Hub. لذلك، من المهم تحديد مشروع دائم على Google Cloud ليكون مشروع المشرف عند إعداد حسابك. يمكن أن يؤدي إيقاف Ads Data Hub API من مشروع المشرف أو حذف مشروع المشرف إلى فقدان البيانات وحدوث مشاكل في الوصول إلى حسابك على Ads Data Hub. بالإضافة إلى ذلك، توقَّع أي تغييرات قادمة في مؤسستك (مثل اصطلاحات التسمية) قد تتطلب تغيير مشروع المشرف.

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

ملاحظة: يمكنك حماية مشروع المشرف من الحذف غير المقصود من خلال وضعه ضمن حجز. مزيد من المعلومات

أمثلة على إعدادات مشاريع Google Cloud

يمكن لمعظم المستخدمين استخدام مشروع واحد (الإعداد التلقائي) يعالج جميع الوظائف. ويشمل ذلك بيانات الإدخال والإخراج. هذا هو الإعداد المقترَح، لأنّ تقديم المزيد من المشاريع يؤدي إلى زيادة التعقيد والأعباء. ومع ذلك، إذا لم يكن إعداد المشروع الواحد يلبي احتياجاتك، يمكنك العمل مع ممثل عن Google لتحديد البنية الأنسب لك.

الإعداد التلقائي، وهو مشروع واحد يُستخدَم لجميع الوظائف:

مشروع إدخال منفصل ومشروع مشرف للإدارة والإخراج:

تفعيل واجهة برمجة التطبيقات في مشروع المشرف

قبل إنشاء حساب على Ads Data Hub، عليك تفعيل Ads Data Hub API (اسم الخدمة: adsdatahub.googleapis.com، "واجهة برمجة تطبيقات لتنفيذ طلبات البحث في Ads Data Hub") و BigQuery API (اسم الخدمة: bigquery.googleapis.com، "منصة بيانات تتيح للعملاء إنشاء البيانات وإدارتها ومشاركتها والبحث فيها") في مشروع المشرف.

يجب أن يكون لدى المستخدم الذي يفعّل واجهات برمجة التطبيقات إذن serviceusage.services.enable ضمن مشروع المشرف. قد يكون هذا المستخدم من خارج مؤسستك.

كيفية تفعيل Ads Data Hub API

إنشاء مجموعة بيانات في BigQuery

مجموعات بيانات BigQuery هي المكان الذي تتم فيه كتابة نتائج Ads Data Hub، وهي أحد الأماكن التي يمكنك فيها تحليل بياناتك بشكل أكبر.

أثناء إنشاء الحساب، يتم إدخال مجموعة بيانات تلقائية في إعدادات حسابك على Ads Data Hub. مجموعة البيانات هذه هي المكان الذي تتم فيه كتابة النتائج إذا لم تحدد مجموعة بيانات أثناء تنفيذ الاستعلام.

يتكوّن معرّف مجموعة البيانات من اسم مشروع الناتج التلقائي واسم مجموعة البيانات، أي: projectName.datasetName.

ملاحظة: يمكنك استخدام أي مجموعة بيانات في مشروع الإخراج التلقائي لإخراجك بدون الحاجة إلى إعادة ضبط حسابك على Ads Data Hub، ولكن يجب أن يكون لدى مجموعة البيانات إذن تعديل لحساب خدمة Ads Data Hub‏ (P4SA). إذا كنت تخطّط لاستخدام عناصر التحكّم في خدمة سحابة VPC، يجب أن تكون أي مجموعة بيانات تستخدمها ضمن محيط الخدمة.

كيفية إنشاء مجموعات بيانات في BigQuery

ملاحظة: تتطلّب BigQuery أن تكون مجموعات البيانات ومهام طلبات البحث في الموقع نفسه (يُرجى الاطّلاع على مواقع مجموعات بيانات Cloud BigQuery). ينفّذ BigQuery عمليات الحوسبة في الموقع نفسه الذي تتوفّر فيه البيانات لتحسين أداء طلبات البحث والتخلّص من وقت الاستجابة في الشبكة على مستوى المناطق المختلفة.

يجب أن تكون مجموعات بيانات BigQuery للإدخال والإخراج في الموقع الجغرافي الذي يتطابق مع منطقة حسابك على Ads Data Hub:

• الحسابات في الولايات المتحدة: حدِّد المنطقة المتعدّدة US.
• حسابات الاتحاد الأوروبي: حدِّد المنطقة المتعدّدة EU.
• حسابات منطقة آسيا والمحيط الهادئ: حدِّد asia-northeast1 (طوكيو) أو australia-southeast1 (سيدني)، بما يتطابق مع حسابك.

تتعذّر المهام إذا لم يتطابق الموقع الجغرافي لمجموعة البيانات مع منطقة حسابك (على سبيل المثال، تحديد us-east1 لحساب في المنطقة المتعدّدة في الولايات المتحدة أو تحديد US لحساب في asia-northeast1).

إنّ الموقع الجغرافي لعرض الإعلانات واستهداف الجمهور منفصل تمامًا عن الموقع الجغرافي لبيانات BigQuery المستخدَمة عند تنفيذ طلبات البحث في Ads Data Hub. بغض النظر عن مكان عرض إعلاناتك أو مكان إقامة الجمهور المستهدف على مستوى العالم، يجب أن تظل مجموعات بيانات BigQuery للإدخال والإخراج في الموقع الجغرافي الذي يتطابق مع منطقة حسابك على Ads Data Hub.

منح الإذن لحساب خدمة Ads Data Hub

لكي يتمكّن Ads Data Hub من قراءة البيانات وكتابة النتائج، عليك منح حساب خدمة Ads Data Hub‏ (P4SA) إذن الوصول إلى مجموعات بيانات BigQuery ذات الصلة:

• مجموعات بيانات المخرجات: امنح دور محرِّر بيانات BigQuery (roles/bigquery.dataEditor) للسماح لمنصة Ads Data Hub بكتابة نتائج طلبات البحث في مجموعة بياناتك.
• مجموعات بيانات الإدخال (بيانات الطرف الأول): امنح دور عارض بيانات BigQuery (roles/bigquery.dataViewer) للسماح لخدمة Ads Data Hub بقراءة بيانات الطرف الأول لعمليات الربط.

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

• مستوى مجموعة البيانات (يُنصح به): في وحدة تحكّم BigQuery، اختَر مجموعة البيانات، ثم انقر على مشاركة > إدارة الأذونات، وأضِف حساب الخدمة الرئيسي.
• على مستوى المشروع: أضِف حساب الخدمة الرئيسي في صفحة "إدارة الهوية وإمكانية الوصول" (IAM) في وحدة تحكّم Google Cloud.

يمكنك العثور على عنوان البريد الإلكتروني (الرئيسي) لحساب خدمة Ads Data Hub‏ (P4SA) ضمن الإعدادات > التفاصيل > حساب الخدمة في حسابك على Ads Data Hub.

توفير إذن وصول المستخدمين

ملاحظة: يجب إكمال هذه الخطوة بعد إكمال معالج إعداد الحساب وتلقّي تأكيد بأنّ حسابك على Ads Data Hub متاح.

سيحتاج المستخدمون إلى إذن بالوصول إلى كلّ من Ads Data Hub وBigQuery. في Ads Data Hub، سيكتبون طلبات البحث وينفّذونها، وفي BigQuery، سيعملون على النتائج التي تم الحصول عليها من Ads Data Hub.

تتم إضافة المستخدمين إلى حسابك على Ads Data Hub ضمن الإعدادات > المستخدمون ويتم منحهم إذن وصول مستند إلى الأدوار (مثل مستخدم مميز أو محلّل أو إذن بالقراءة فقط) لكتابة طلبات البحث وتنفيذها. في Google Cloud، تتحكّم أدوار إدارة الهوية وإمكانية الوصول (IAM) في BigQuery (مثل roles/bigquery.dataViewer وroles/bigquery.user) في المستخدمين الذين يمكنهم عرض جداول النتائج الناتجة وطلب البحث عنها في BigQuery.

مزيد من المعلومات عن الوصول المستند إلى الأدوار في Ads Data Hub مزيد من المعلومات عن التحكّم في الوصول إلى BigQuery

ربط البيانات بحسابك على Ads Data Hub

ملاحظة: يجب إكمال هذه الخطوة بعد توفير حسابك على Ads Data Hub وإتاحته بعد إكمال معالج إعداد الحساب.

لإتاحة بيانات الإعلانات لطلب البحث في Ads Data Hub، عليك الربط من الحساب المرتبط بمنتج "إعلانات Google" الذي يستخدمه فريقك.

تتألف عملية ربط الحساب من خطوتَين:

1. بدء طلب ربط الحساب: يتم بدء طلب ربط الحساب من منصة Google الإعلانية التي يستخدمها فريقك (مثل "إعلانات Google" أو "مساحة العرض والفيديو 360" أو "مدير الحملة 360" أو YouTube Reserve).
2. الموافقة على طلب ربط الحساب: تتم الموافقة على طلب ربط الحساب في حسابك على Ads Data Hub، إما في واجهة مستخدم Ads Data Hub ضمن الإعدادات > الحسابات المرتبطة أو آليًا باستخدام واجهة برمجة التطبيقات CustomerService.BatchApproveAdsDataLinks.

عند إنشاء حساب جديد على Ads Data Hub، تتم تلقائيًا تعبئة البيانات السابقة لمدة تصل إلى 21 يومًا لأي رقم تعريف عميل مرتبط بهذا الحساب خلال أول 7 أيام من إنشائه. تتيح لك هذه الميزة البدء في تنفيذ طلبات البحث وعرض النتائج الفعلية في غضون يوم أو يومين، بدون انتظار تراكم البيانات اليومية لاستيفاء الحد الأدنى للتجميع والخصوصية.

مزيد من المعلومات عن ربط الحسابات في Ads Data Hub