لا تُعدّ الجهات الخارجية مستخدمين مباشرين لخدمة "إدارة إعلانات Google"، بمعنى أنّه قد لا يكون لديها شبكة خاصة بها على "إدارة إعلانات Google". بدلاً من ذلك، ينشئون خدمات أو عمليات دمج مع "مدير إعلانات Google" لعملائهم الذين يستخدمون "مدير إعلانات Google". يتناول هذا الدليل أساسيات عمليات التكامل مع جهات خارجية من خلال تقديم أفضل الممارسات والنصائح والحيل.
يفترض هذا الدليل أنّ لديك معرفة عملية بواجهة برمجة التطبيقات "إدارة إعلانات Google". إذا لم تكن على دراية بواجهة برمجة التطبيقات Ad Manager API، اطّلِع على مستندات بدء الاستخدام.
بدء العمل كجهة خارجية
لاستخدام واجهة برمجة التطبيقات في "مدير إعلانات Google" للوصول إلى شبكة أحد عملاء "مدير إعلانات Google"، ما عليك سوى اتّباع الإرشادات أدناه. لا يلزم الحصول على موافقة إضافية من Google، ولكن يُرجى العِلم أنّه من خلال الوصول إلى واجهة برمجة التطبيقات Ad Manager API و/أو استخدامها، أنت توافق على البنود والشروط الخاصة بها.
كيفية اختبار عملية التكامل مع "إدارة إعلانات Google" بصفتك جهة خارجية
بصفتك جهة خارجية، قد تتساءل عن كيفية اختبار عملية الدمج مع "مدير إعلانات Google" قبل تشغيلها على شبكات الإنتاج الخاصة بعملائك. ننصحك بإنشاء شبكة اختبار. ولا يشترط أن تكون عميلاً في "مدير إعلانات Google" لإجراء ذلك. يمكن لأي شخص لديه حساب Google إنشاء شبكة اختبار.
يُرجى العِلم، مع ذلك، بالاختلافات بين شبكات الاختبار والشبكات المباشرة. لا يمكن لشبكات الاختبار عرض الإعلانات. لن تتضمّن شبكات الاختبار بالضرورة جميع الميزات التي قد تتوفّر لعملائك على شبكاتهم المباشرة. إذا كنت بحاجة إلى إجراء اختبار باستخدام ميزات "مدير إعلانات Google" غير المتوفّرة على شبكتك الاختبارية، يمكنك شراء إذن الوصول إلى شبكة غير اختبارية من خلال أحد موفّري خدمات "مدير إعلانات Google".
بالإضافة إلى ذلك، يجب أن توضّح لعملائك الميزات التي يجب أن تتوفّر على شبكة الإنتاج لكي يعمل تطبيقك بشكل صحيح. يجب أن يتعامل تطبيقك مع الحالات التي قد لا تتوفّر فيها الميزات إما عن طريق رصد الاستثناءات والتعامل معها بشكل سليم أو الاحتفاظ بقائمة بالعملاء والميزات المتوفّرة أو غير المتوفّرة لكل منهم. يجب أن يتحمّل عميلك مسؤولية التواصل مع جهة الاتصال التي يتعامل معها في Google لإدارة الميزات على شبكته.
المصادقة: كيفية الوصول بشكل صحيح إلى شبكة "مدير إعلانات Google" الخاصة بأحد العملاء
لكي يتمكّن تطبيقك من الوصول إلى شبكة عميلك على "مدير إعلانات Google"، عليك إعداد سير عمل المصادقة بطريقة آمنة.
يتضمّن ذلك خطوتَين:
- أنشئ عنوان بريد إلكتروني لحساب Google ستستخدمه للوصول إلى شبكة عميلك.
- اطلب من العميل إضافة هذا الحساب كمستخدم إلى شبكة "إدارة الإعلانات".
في الخطوة 1، يمكنك إنشاء حساب Google منفصل لكل عميل أو حساب أساسي ستستخدمه لجميع العملاء. ويكون الخيار الأول أكثر أمانًا في حال اختراق أحد حساباتك. ويعني ذلك أنّه عليك تنفيذ الخطوة 1 مرة واحدة فقط.
بغض النظر عن الخطوة 1، عليك في الخطوة 2 أن تطلب من كل عميل جديد إضافة حساب Google المناسب الذي أنشأته له كمستخدم إلى شبكة "مدير إعلانات Google".
1. إنشاء حساب في Google
تتوفّر طرق مختلفة لإنشاء حساب على Google يمكن إضافته إلى شبكة "مدير الإعلانات".
الخيار 1: إنشاء حساب خدمة OAuth2، ما يؤدي إلى إنشاء عنوان بريد إلكتروني لحساب الخدمة يعمل كحساب Google. تعليمات إنشاء حساب خدمة جديد
الخيار 2: يمكنك إنشاء حساب Google عادي (حساب "Gmail") من خلال الاشتراك كمستخدم جديد. إذا كان لديك حساب Google، أكمل عملية الاشتراك هذه في نافذة التصفح المتخفي أو جلسة متصفّح جديدة. أو إذا كانت شركتك تستخدم Google Workspace، يمكنك إنشاء حساب Google في نطاق شركتك واستخدامه بدلاً من ذلك. لأغراض هذا الدليل، سنشير إلى كليهما باسم حساب Google "عادي".
2. اطلب من العميل إضافة حسابك على Google إلى شبكته
بعد الحصول على حساب Google للوصول إلى شبكة عميلك، اطلب منه إضافة الحساب كمستخدم جديد في شبكته على "مدير إعلانات Google".
إذا كنت ستزوّدهم بعنوان بريد إلكتروني خاص بحساب خدمة OAuth2، اطلب منهم إضافته إلى شبكتهم.
إذا كنت ستزوّدهم بحساب Google عادي، اطلب منهم إضافة حسابك كمستخدم إلى شبكتهم.
بغض النظر عن الطريقة التي تتّبعها، احرص على مناقشة الأدوار والأذونات التي يجب أن يتضمّنها حسابك مع عميلك، وذلك لكي يتمكّن تطبيقك من الوصول إلى البيانات التي يحتاج إليها على شبكة عميلك.
يمكنك الآن بدء طلب البيانات من واجهة برمجة التطبيقات إلى شبكة "مدير إعلانات Google" الخاصة بعميلك. احرص على ضبط عنوان SOAP لمعرِّف الشبكة على معرِّف شبكة العميل الذي يتم إرسال طلب البيانات من واجهة برمجة التطبيقات إليه. تتيح جميع مكتبات العملاء إعداد ذلك آليًا. على سبيل المثال، في مكتبة برامج Java الخاصة بعميل الإعلانات، يمكنك ضبط رمز الشبكة آليًا عند إنشاء مثيل DfpSession.
مواكبة آخر الأخبار حول واجهة برمجة التطبيقات
من المهم أن تكون على دراية بالإصدارات التي تم إيقافها أو إيقافها نهائيًا من واجهات برمجة التطبيقات، وموعد طرح الإصدارات الجديدة. لا تريد أن تفاجأ بإيقاف إصدار معيّن نهائيًا، ما قد يؤدي إلى حدوث مشاكل في تطبيقات العملاء. ولا يمكننا دائمًا التواصل مع الجهات الخارجية بشأن عمليات الإيقاف النهائي والإيقاف نهائيًا الوشيكة كما نفعل مع عملائنا. وبالتالي، تقع على عاتقك مسؤولية الاشتراك في إحدى قنواتنا الرئيسية الثلاث لتلقّي آخر الأخبار حول واجهة برمجة التطبيقات وتعديل إعدادات الإشعارات:
نوفّر أيضًا جدول إيقاف نهائي على موقعنا الإلكتروني المخصّص للمطوّرين، ويجب عليك متابعته بانتظام.