ربط Google

ربط Google جزءان. يُعدّ المسؤول التثبيت مرة واحدة في صفحة Google Ads API (واجهة Google Ads). ثم يربط كل شخص حسابه لدى Google في صفحة Google connection (ربط Google).

ويُستخدم تسجيل الدخول نفسه لـ تحليلات الموقع، إن فتحها المسؤول.

للمسؤول: إعداد التطبيق

تجمع ثلاثة أشياء من Google وتدخلها في Google Ads API:

• OAuth client id (معرّف عميل OAuth) و client secret (سرّ العميل) الخاص به، من مشروع في Google Cloud؛
• رمز المطوِّر (developer token)، من حساب إداري في Google Ads.

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

إنشاء عميل OAuth

1. افتح Google Ads API في صفحة الإدارة. تحت What to collect (ما تجمعه) تعرض الصفحة Redirect URI (عنوان إعادة التوجيه) لتثبيتك. انسخه.
2. في Google Cloud console، اختر مشروعًا أو أنشئ واحدًا، وفعّل له Google Ads API من APIs & Services ثم Library.
3. أعدّ OAuth consent screen (شاشة الموافقة) للمشروع إن طلبت Google ذلك.
4. تحت Credentials، أنشئ عميل OAuth من النوع Web application.
5. أضف عنوان إعادة التوجيه الذي نسخته إلى عناوين إعادة التوجيه المصرَّح بها للعميل، كما تعرضه الصفحة تمامًا.
6. انسخ client id و client secret.

عنوان إعادة التوجيه هو عنوان تثبيتك وبعده /oauth/google/callback. وفي التثبيت الجديد هو http://127.0.0.1:8765/oauth/google/callback.

عنوان إعادة التوجيه يجب أن يكون هذا الجهاز أو HTTPS

تقبل Google عنوان إعادة توجيه بـ HTTP غير مشفَّر للجهاز نفسه فقط. ولأي عنوان آخر يجب أن يبدأ بـ https://. إن قالت صفحة Google Ads API: "Google will reject this address"، فاضبط عنوانًا عامًا على HTTPS أولًا: انظر إعدادات الخادم. وإلى ذلك الحين لا يستطيع أحد ربط Google إلا من متصفح على جهاز الخادم نفسه.

ما دامت شاشة الموافقة في وضع الاختبار

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

الحصول على رمز المطوِّر

1. سجّل الدخول إلى الحساب الإداري في Google Ads.
2. افتح Google Ads API Center واحصل على رمز المطوِّر.

رمز المطوِّر الجديد له مستوى الوصول Test: يعمل مع الحسابات التجريبية في Google Ads فقط. وللوصول إلى الحسابات الحقيقية تتقدم إلى Google بطلب مستوى وصول أعلى. و Google هي التي تقرر، وصفحتها عن مستويات الوصول تقول ما يسمح به كل مستوى. قدّم الطلب بمشروع Google Cloud نفسه الذي فيه عميل OAuth.

لا تحتاج إلى انتظار الموافقة لتُتمّ الإعداد. إن ضغط أحد Test connection (اختبار الربط) والرمز ما زال بمستوى Test، قالت الصفحة إن الموافقة وحدها هي الناقصة.

إدخالها في Google Ads API

1. افتح Google Ads API.
2. تحت Credentials (بيانات الاعتماد)، املأ Developer token (رمز المطوِّر) و OAuth client id و OAuth client secret (سرّ عميل OAuth).
3. اضغط Save credentials (حفظ بيانات الاعتماد).

يعرض العنوان بعدها Set (مضبوط). والحقل الذي تتركه فارغًا يحتفظ بالمخزَّن، فتستطيع تغيير قيمة واحدة دون إعادة كتابة الأخريين.

تنبيه

إن غيّرت عميل OAuth لاحقًا، فعلى الجميع ربط Google من جديد. وتقول الصفحة ذلك عند الحفظ.

مفاتيح تضيف إذنًا

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

المفتاح	الصفحة	ما يطلبه تسجيل الدخول أيضًا
Allow uploading offline conversions to Google (السماح برفع التحويلات غير المتصلة إلى Google)	Safety limits (حدود الأمان)	إذن Data Manager
Allow Customer Match lists on Google (السماح بقوائم Customer Match على Google)	Safety limits	إذن Data Manager
Website analytics (تحليلات الموقع)	Google Ads API	Google Analytics و Search Console، للقراءة فقط

قبل أن تفتح واحدًا:

• على كل من ربط حسابه من قبل أن يعيد الربط. الربط السابق لا يحمل الإذن الجديد. يفتح كل شخص Google connection ويضغط Reconnect Google (إعادة ربط Google) ويقبل الإذن. وتظل أدوات Google Ads تعمل لديه في الأثناء؛ ولا يرفض إلا الأدوات التي تحتاج إلى الإذن الجديد.
• فعّل الواجهة في مشروع Cloud أولًا. لمفتاحَي الرفع هي Data Manager API، في مشروع عميل OAuth. ولتحليلات الموقع، انظر ربط تحليلات الموقع.
• مفتاحا الرفع يرسلان سجلات عملاء إلى Google. اقرأ بيانات الاتصال قبل أن تفتح واحدًا.

صفحة الحدود والمفاتيح تسرد كل مفتاح.

للجميع: ربط حسابك

تربط حسابك أنت لدى Google. ثم يعمل المساعد الذكي على حسابات Google Ads التي يصل إليها ذلك الحساب، ويُسجَّل كل تغيير باسم المستخدم الخاص بك.

الربط

1. افتح Google connection.
2. اضغط Connect Google (ربط Google).
3. سجّل الدخول لدى Google بالحساب الذي له وصول إلى حساباتك في Google Ads.
4. تعرض Google ما يطلبه الخادم. اترك المربعات معلَّمة وتابع.
5. تعيدك Google إلى صفحة تقول: "Google account connected". ارجع إلى صفحة الإدارة.

تعرض الحالة الآن Connected (مربوط). و Google تُبقي هذا الربط قائمًا من تلقاء نفسها: لا تاريخ ينتهي فيه.

إن كان الزر معطَّلًا

لم يُدخل المسؤول بيانات Google بعد. وتقول الصفحة ذلك.

تحقق مما تصل إليه

اضغط Test connection. تجيب الصفحة "Working" مع عدد الحسابات، وتسرد كل حساب: اسمه ومعرّفه وعملته ومنطقته الزمنية، وهل هو حساب إداري أم حساب إعلاني عادي.

إن قالت: "The connection works, but this login reaches no accounts"، فقد سجّلت الدخول بحساب Google لا وصول له إلى أي حساب في Google Ads. اربط بالحساب الصحيح، أو اطلب دعوة ذلك الحساب في Google Ads.

وتستطيع أيضًا أن تسأل المساعد الذكي:

ما حسابات Google Ads التي تراها؟

فيسرد الحسابات نفسها.

العمل عبر حساب إداري

إن كنت تصل إلى حساباتك عبر حساب إداري (MCC):

1. في Google connection، تحت Manager account (الحساب الإداري)، اكتب معرّفه المكوَّن من 10 أرقام في Manager account id، مثل 123-456-7890.
2. اضغط Save manager id (حفظ معرّف الحساب الإداري).

اترك الحقل فارغًا لتستخدم كل حساب يصل إليه حسابك مباشرة.

فتح حساب مباشرة من نشاطك

الصفوف في سجل النشاط ترتبط بالحساب في Google Ads. والرابط يعمل كما هو، لكن Google تسألك في الطريق أي حساب دخول وأي حساب إعلاني تقصد. لتتجاوز السؤالين:

1. افتح أحد تلك الروابط ودع Google تُتمّ التحميل.
2. انسخ العنوان من شريط العنوان في متصفحك.
3. في Google connection، تحت Opening an account directly (فتح حساب مباشرة)، الصقه في An address from the Google Ads interface (عنوان من موقع Google Ads).
4. اضغط Remember this account (تذكّر هذا الحساب).

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

إعادة الربط وقطع الربط

اضغط Reconnect Google حين تقول الصفحة إن التثبيت صار يطلب من Google إذنًا لم يكن في ربطك. وهي تسمّي الإذن. اقبله حين تسألك Google.

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

حين يُرفض تسجيل الدخول

ما تراه	ما تفعله
"Google will refuse the redirect address" في Google connection	ليس للخادم عنوان عام على HTTPS. اطلب من المسؤول ضبطه، أو اربط من متصفح على جهاز الخادم نفسه.
"Google Ads was not among the permissions granted"	أزلت علامة مربع لدى Google. ابدأ من جديد واترك المربعات معلَّمة.
"Google did not return a refresh token"	أزل وصول هذا التطبيق في myaccount.google.com/permissions، ثم اربط من جديد.
"The sign-in link expired. Start again."	اضغط Connect Google من جديد وأتمّ تسجيل الدخول دفعة واحدة.
Test connection يقول إن رمز المطوِّر بمستوى Test	الإعداد يعمل. على المسؤول أن يتقدم إلى Google بطلب مستوى وصول أعلى.

ولأنواع الرفض الأخرى، انظر حل المشكلات.