لا تُعدّ الجهات الخارجية مستخدمين مباشرين لـ "مدير إعلانات Google"، بمعنى أنّه قد لا يكون لديها شبكة خاصة بها على "مدير إعلانات Google". بدلاً من ذلك، ينشئون خدمات أو عمليات دمج مع "مدير إعلانات Google" لعملائهم الذين يستخدمون "مدير إعلانات Google". يغطّي هذا الدليل أساسيات عمليات التكامل مع جهات خارجية من خلال تقديم أفضل الممارسات والنصائح والحيل.
يفترض هذا الدليل أنّ لديك معرفة عملية بواجهة برمجة التطبيقات Ad Manager API. إذا لم تكن على دراية بواجهة برمجة التطبيقات Ad Manager API، اطّلِع على مستندات البدء.
بدء العمل كجهة خارجية
لاستخدام واجهة برمجة التطبيقات في "إدارة الإعلانات" للوصول إلى شبكة أحد عملاء "إدارة الإعلانات"، ما عليك سوى اتّباع الإرشادات أدناه. لا يلزم الحصول على موافقة إضافية من Google، ولكن يُرجى العِلم أنّه من خلال الوصول إلى واجهة برمجة التطبيقات Ad Manager API و/أو استخدامها، أنت توافق على البنود والشروط الخاصة بها.
كيفية اختبار عملية تكامل "مدير إعلانات 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 عادي، اطلب منهم إضافة حسابك كمستخدم إلى شبكتهم.
بغض النظر عن المسار الذي تتّخذه، احرص على مناقشة الأدوار والأذونات التي يجب أن يتضمّنها حسابك مع عميلك، وذلك لكي يتمكّن تطبيقك من الوصول إلى البيانات التي يحتاجها على شبكة عميلك.
يمكنك الآن بدء طلب البيانات من واجهة برمجة التطبيقات إلى شبكة "إدارة الإعلانات" الخاصة بعميلك. احرص على ضبط عنوان SOAP networkCode على معرِّف شبكة العميل الذي يتم إرسال طلب البيانات من واجهة برمجة التطبيقات إليه. تتيح جميع مكتبات العملاء إمكانية ضبط ذلك آليًا. على سبيل المثال، في مكتبة برامج Java الخاصة بعميل الإعلانات، يمكنك ضبط رمز الشبكة آليًا عند إنشاء مثيل DfpSession.
مواكبة آخر الأخبار حول واجهة برمجة التطبيقات
من المهم أن تكون على دراية بالإصدارات التي تم إيقافها أو إيقافها نهائيًا من واجهات برمجة التطبيقات، وموعد طرح الإصدارات الجديدة. لا تريد أن تفاجأ بإيقاف إصدار معيّن نهائيًا، ما قد يؤدي إلى حدوث مشاكل في تطبيقات العملاء. ولا يمكننا دائمًا التواصل مع الجهات الخارجية بشأن عمليات الإيقاف النهائي أو الإيقاف نهائيًا الوشيكة، كما نفعل مع عملائنا. وبالتالي، تقع على عاتقك مسؤولية الاشتراك في إحدى قنواتنا الرئيسية الثلاث لتلقّي آخر الأخبار حول واجهة برمجة التطبيقات وتعديل إعدادات الإشعارات:
نوفّر أيضًا جدول إيقاف نهائي على موقعنا الإلكتروني المخصّص للمطوّرين، ويجب عليك متابعته بانتظام.