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