rocket_launch ASAPilot
ابدأ الآن

مصطلح

Apple Search Ads API

واجهة REST API الرسمية من آبل للإدارة البرمجية لإعلانات بحث آبل — CRUD للحملات، التقارير، إدارة الكلمات المفتاحية، تغييرات العروض. يستخدم OAuth 2.0 مع ES256 JWT للمصادقة.

أسماء أخرى：ASA API, Apple Search Ads Campaign Management API

ما هي Apple Search Ads API؟

Apple Search Ads API هي واجهة REST API الرسمية من آبل للإدارة البرمجية لإعلانات بحث آبل. هي سطح التكامل الذي تستخدمه كل أداة ASA شرعية من جهة خارجية — بما في ذلك ASAPilot.

القدرات:

  • إدارة الحملات — إنشاء، تحديث، إيقاف مؤقت، أرشفة
  • إدارة المجموعات الإعلانية — الكلمات المفتاحية، الإعلانات، العروض، تنقيحات الجمهور
  • عمليات الكلمات المفتاحية — إضافة، تعديل نوع المطابقة، تحديد العرض، إضافة سلبيات
  • التقارير — الإنفاق، النقرات، التثبيتات، معدل التحويل لكل كلمة مفتاحية/مجموعة/حملة
  • تقارير مصطلحات البحث — رؤية استعلامات المستخدم الفعلية التي شغلت النقرات
  • تعيين Custom Product Page — تعيين CPP للمجموعة الإعلانية

كيف تعمل المصادقة

Apple Search Ads API تستخدم OAuth 2.0 مع ES256 JWT:

  1. إنشاء مفتاح EC خاص في إعدادات حساب Apple Search Ads.
  2. تخزين المفتاح الخاص بأمان (هذا هو سرك).
  3. لإجراء مكالمة API، قم ببناء JWT موقع بالمفتاح الخاص. يتضمن JWT معرّف العميل، معرّف الفريق، معرّف المفتاح، وانتهاء صلاحية قصير (عادة 5-20 دقيقة).
  4. POST JWT إلى نقطة نهاية OAuth من آبل لتبادله بـ token وصول قصير الأجل.
  5. استخدم token الوصول في رأس Authorization: Bearer <token> لمكالمات API اللاحقة.

هذا التدفق أثقل عمداً من مفتاح API بسيط. تتعامل ASAPilot والأدوات الأخرى من جهات خارجية مع إنشاء JWT داخلياً — أنت فقط توفّر المفتاح أثناء الإعداد.

حدود المعدل

لا تنشر آبل أرقام حد معدل صارمة. السلوك الملاحظ (2026):

  • تنظيم ناعم عند ما يستمر >5 طلبات في الثانية
  • تحمل دفعي يصل إلى ~20-30 طلب/ثانية لنوافذ قصيرة
  • نقاط نهاية التقارير أكثر تساهلاً من نقاط نهاية الإطار

إذا وصلت إلى الحد، تعيد آبل 429 Too Many Requests مع تلميح Retry-After. يجب على تكاملات الإنتاج تنفيذ تراجع أسي.

لماذا تستخدم الأدوات من جهات خارجية API

لوحة Apple Search Ads جيدة للمهام أحادية الحساب، منخفضة التردد. تصبح API ضرورية عند:

  • إدارة 5+ حسابات في وقت واحد (تسجيل الدخول اليدوي غير ممكن تشغيلياً)
  • تشغيل الأتمتة (الملخصات اليومية، تنبيهات الشذوذ، عمليات التدقيق المتكررة)
  • بناء لوحات معلومات مخصصة (دمج الإيرادات، تحليل LTV، تحطيمات المجموعات)
  • العمليات المجمّعة (إضافة 200 كلمة مفتاحية سلبية في دفعة واحدة)

كيف يستخدم ASAPilot API

يتصل ASAPilot بحساب Apple Search Ads عبر OAuth 2.0 + ES256 JWT أثناء الإعداد (وقت متوسط <2 دقيقة). بعد الاتصال، ASAPilot:

  • يستطلع نقاط نهاية التقارير كل 5-15 دقيقة لسرعة الإنفاق وكشف الشذوذ
  • يقرأ حالة الحملة / المجموعة الإعلانية / الكلمة المفتاحية لتدقيق الحساب
  • لا يكتب على حسابك افتراضياً — وضع القراءة فقط هو الافتراضي؛ تتطلب الكتابات موافقة بشرية صريحة لكل توصية

راجع docs/connect-apple-search-ads لتدفق الإعداد الكامل.

مصطلحات ذات صلة