ما هو HilltopAds MCP؟
يُعد خادم MCP (Model Context Protocol) موصلًا رسميًا من HilltopAds لعملاء الذكاء الاصطناعي. بمجرد إتمام الاتصال، سيتمكن الذكاء الاصطناعي من الوصول إلى بيانات حسابك، ومع موافقتك، يمكنه أيضًا إجراء تغييرات مثل إنشاء الحملات الإعلانية أو تحديثها عبر قناة آمنة ومخصصة، دون الحاجة إلى نسخ الأرقام أو البيانات ولصقها يدويًا.
لن تتم مشاركة اسم المستخدم أو كلمة المرور الخاصة بك مع عميل الذكاء الاصطناعي. تتم عملية التفويض باستخدام مفتاح API تقوم بإنشائه بنفسك من داخل حسابك.
يوفر الموصل إمكانية الوصول إلى حسابك في HilltopAds من خلال مجموعة من العمليات (Tools). يختار الذكاء الاصطناعي الأداة المناسبة لطلبك، ثم ينفذها ويحوّل النتيجة إلى صيغة سهلة القراءة، مثل جدول أو ملخص أو حتى رسم بياني.
ماذا يمكنك أن تفعل باستخدامه؟
تنقسم الأدوات إلى نوعين:
أدوات القراءة (Read Operations): تسترجع البيانات مثل الرصيد، والمخزون الإعلاني (Inventory)، والإحصائيات، وتفاصيل حملة معينة، أو قوائم مصادر الترافيك الخاصة بها.
أدوات التنفيذ (Action Operations): تُجري تغييرات على حسابك، مثل إنشاء الحملات أو تعديلها، وتشغيلها أو إيقافها، وتحديث عروض الأسعار (Bids)، وعناوين URL المقصودة (Destination URLs)، وإدارة قوائم المصادر السوداء والبيضاء (Blacklists & Whitelists).
تعتمد الأدوات المتاحة لك على نوع حسابك، سواء كنت معلنًا (Advertiser) أو ناشرًا (Publisher) أو كليهما. حاليًا، يدعم الموصل 27 عملية، منها 23 للمعلنين و4 للناشرين.
لا يتم تنفيذ أي من أدوات التنفيذ إلا بعد موافقتك الصريحة. كما تعرض تطبيقات الذكاء الاصطناعي الأدوات على أنها للقراءة فقط أو للكتابة/الحذف، وتطلب تأكيدك قبل إجراء أي تغيير.
أدوات الحساب والتقارير
الأداة | الوظيفة |
| عرض الرصيد الحالي لحساب المعلن. |
| عرض حملاتك والإعلانات المرتبطة بها. |
| عرض الإحصائيات مع إمكانية التصفية أو التجميع حسب التاريخ أو المنطقة الإعلانية (Zone) أو الدولة (GEO) أو الحملة أو نظام التشغيل أو الساعة أو مصدر الترافيك. |
| عرض التفاصيل الكاملة لحملة معينة باستخدام معرّفها (Campaign ID). |
أدوات إدارة الحملات
ملاحظة: في الأمثلة الواردة لاحقًا في هذا الدليل، يقوم المساعد بإنشاء الحملات في حالة غير مفعّلة (Inactive) حتى تتمكن من مراجعتها قبل بدء الإنفاق. هذا مجرد إعداد افتراضي اختاره المساعد، وليس قاعدة ثابتة. إذا كنت تريد إنشاء الحملة كـ غير مفعّلة أو إطلاقها مباشرةً، فاذكر ذلك صراحةً في طلبك.
الأداة | الوظيفة |
| إنشاء حملة جديدة. |
| تحديث إعدادات حملة بشكل جزئي. |
| تشغيل حملة تمت الموافقة عليها. |
| إيقاف حملة نشطة. |
| نقل حملة إلى الأرشيف. |
| استعادة حملة من الأرشيف. |
| تعديل عرض السعر (Bid) الخاص بالدول غير المحددة (Wildcard GEO). |
| تغيير عنوان URL المقصود لحملة Popunder. |
| استبدال نطاق (Domain) في جميع إعلانات حساب المعلن. |
أدوات القائمة السوداء للمصادر (Source Blacklist)
الأداة | الوظيفة |
| عرض القائمة السوداء لمصادر الترافيك الخاصة بحملة معينة. |
| إضافة مصادر إلى القائمة السوداء. |
| إزالة مصادر من القائمة السوداء. |
| حذف جميع عناصر القائمة السوداء الخاصة بالحملة. |
| استبدال القائمة السوداء بالكامل وتحويل الحملة إلى وضع BLACKLIST. |
أدوات القائمة البيضاء للمصادر (Source Whitelist)
الأداة | الوظيفة |
advertiser_get_whitelist | عرض القائمة البيضاء لمصادر الترافيك الخاصة بحملة معينة. |
| إضافة مصادر إلى القائمة البيضاء. |
| إزالة مصادر من القائمة البيضاء. |
| حذف جميع عناصر القائمة البيضاء الخاصة بالحملة. |
| استبدال القائمة البيضاء بالكامل وتحويل الحملة إلى وضع WHITELIST. |