ما تحتاج إليه

يتصل SearchAds Manager بحساب Apple Ads من خلال واجهة API الخاصة به. تحتاج إلى حساب يتيح الوصول عبر API وبيانات الاعتماد التي يطلبها التطبيق. بيانات اعتماد App Store Connect وحدها ليست بيانات اعتماد لواجهة API الخاصة بـ Apple Ads.

جهّز الوصول عبر API

على Mac، افتح الإعدادات → الحساب لإعداد الحساب، وافتح «مفاتيح التوقيع» للوصول إلى زوج مفاتيحك. اتّبع دليل Apple لتسجيل المفتاح العام.

1. اطلب من أحد مسؤولي حسابك في Apple Ads منحك الدور المناسب للوصول عبر API.
2. اتبع دليل إعداد OAuth من Apple لتجهيز زوج المفاتيح ومعرّفات الحساب وتسجيل مفتاحك العام.
3. أدخل بيانات اعتماد API المطلوبة في SearchAds Manager. يُخزَّن المفتاح الخاص في سلسلة مفاتيح الجهاز.
4. اختر حسابك وراجع تقريرًا حديثًا للتأكد من الاتصال.

استخدم الأذونات المناسبة لعملك. يتطلب تعديل الحملات دورًا في الحساب يتيح هذه التغييرات.

التقارير والإدارة

بعد إدخال بيانات اعتماد API لـ Apple Ads، حدّد حسابك وافتح تقريرًا حديثًا لإحدى الحملات.

التقارير مجانية. يمكنك مراجعة الإنفاق ومرات الظهور والنقرات وعمليات التثبيت وتكلفة النقرة وتكلفة الاكتساب.

يتطلب إنشاء الحملات والمجموعات الإعلانية والإعلانات والكلمات المفتاحية أو تعديلها ترقية مدفوعة. تظهر خيارات الاشتراك والشراء مدى الحياة الحالية، حيثما تتوفر، في التطبيق وصفحته على App Store.

وصّل الأدوات المتوافقة على Mac

1. 1 Codex

   يرسل طلبًا إلى خادم MCP المحلي.

2. 2 SearchAds Manager

   يشغّل الخادم على جهاز Mac لديك ويعالج الطلب.

3. 3 Apple Ads

   يعيد بيانات الحساب أو ينفّذ إجراءً مصرّحًا به على الحملة.

أبقِ SearchAds Manager قيد التشغيل على جهاز Mac لديك. يتصل بـ Apple Ads باستخدام صلاحيات الوصول إلى API التي أعددتها في التطبيق.

يتيح خادم MCP المحلي الاختياري التقارير وإجراءات الحملات للأدوات المتوافقة على Mac. ابدأ بـنظرة عامة على خادم MCP ودليل الربط بـ Codex.

إذا تعذّر ربط حسابك

تأكد من أنك تستخدم بيانات اعتماد API الخاصة بـ Apple Ads، وأن مفتاحك العام مسجّل، وأن دور API الممنوح لك يتيح الوصول إلى الحساب المحدد. عند التواصل مع الدعم، أرفق رسالة الخطأ واذكر المنصة، لكن لا تُدرج المفاتيح الخاصة أو الأسرار في رسالتك.