rocket_launch ASAPilot
ابدأ الآن

مصطلح

Ad Services API

واجهة API لإسناد إعلانات بحث آبل من الطرف الأول من آبل. يؤكد أي تثبيتات تطبيق جاءت من حملات ASA، ويعيد معرّفات الحملة والمجموعة الإعلانية والكلمة المفتاحية دون معرّفات المستخدم.

أسماء أخرى：AdServices framework, AdAttributionKit (ذو صلة)

ما هي Ad Services API؟

Ad Services API (تم تقديمها في iOS 14.3، استبدلت إطار iAd الأقدم) هي واجهة API الإسناد من الطرف الأول من آبل لتثبيتات Apple Search Ads تحديداً.

عندما ينقر مستخدم على إعلان ASA ثم يثبّت تطبيقك، تعرف آبل الرابط قطعياً لأن كل من سطح الإعلان ومتجر التطبيقات يديرهما آبل. تتيح Ad Services API لتطبيقك طلب بيانات الإسناد هذه دون كشف IDFA أو أي معرّف على مستوى المستخدم.

كيف تعمل

  1. يثبت المستخدم تطبيقك عبر نقرة إعلان ASA.
  2. يستدعي التطبيق AdServices.attributionToken() ضمن الجلسة الأولى.
  3. يقوم التطبيق بـ POST للرمز إلى نقطة نهاية إسناد آبل: POST https://api-adservices.apple.com/api/v1/
  4. تعيد آبل JSON payload مع تفاصيل الإسناد: 
    {
  "attribution": true,
  "campaignId": 12345678,
  "adGroupId": 87654321,
  "keywordId": 11223344,
  "creativeSetId": null,
  "orgId": 99887766,
  "countryOrRegion": "US",
  "clickDate": "2026-05-20T14:23:11Z",
  "conversionDate": "2026-05-20T14:24:42Z",
  "iad-purchase-date": "2026-05-20T14:24:42Z"
}
  5. تدمج خلفيتك هذا مع البيانات على مستوى المستخدم لحساب الإيرادات المنسوبة، LTV، إلخ.

إذا كان "attribution": false، فالتثبيت ليس من ASA — يمكن أن يكون عضوياً، من قناة مدفوعة أخرى، أو من استعلام بحث لم يطابق أياً من حملاتك.

ما تخبرك الاستجابة

الحقلالمعنى
campaignIdمعرّف حملة ASA — انضم لقائمة حملاتك
adGroupIdمعرّف مجموعة إعلانية ASA — انضم لقائمة مجموعاتك الإعلانية
keywordIdالكلمة المفتاحية التي شغلت النقرة (null لـ Search Match)
creativeSetIdمتغير الإبداع (نادراً ما يُستخدم منذ استبدل CPPs مجموعات الإبداع)
orgIdمعرّف org Apple Search Ads الخاص بك
countryOrRegionالمتجر حيث حدث التثبيت
clickDateمتى حدثت النقرة
conversionDateمتى حدث التثبيت

المقارنة مع SKAdNetwork

الجانبAd Services APISKAdNetwork
النطاقASA فقطجميع شبكات الإعلانات
الكموندقائقساعات إلى أيام (3 نوافذ ردود في SKAN 4.0)
التحبيبحملة + مجموعة إعلانية + كلمة مفتاحيةعلى مستوى الحملة + قيمة التحويل
القطعيةقطعيةمجمّعة، تحافظ على الخصوصية
معرّف المستخدملا شيءلا شيء (عن قصد)
مستويات عدم الكشف الجماعيلانعم (تقمع البيانات منخفضة الحجم)
الأفضل لـتحسين خاص بـ ASAإسناد عبر الشبكة عبر MMP

كيف يستخدم ASAPilot Ad Services API

يقرأ ASAPilot أداء حملة Apple Search Ads عبر Apple Search Ads API (لبيانات الحملة والإنفاق) ويدمج هذا مع بيانات الإسناد من الخلفية لديك المصدّرة من Ad Services API.

تقوم بإعداد تكامل Ad Services API في تطبيقك (عمل خلفية لمرة واحدة). يقوم ASAPilot بعد ذلك بدمج أحداث الإسناد مع إنفاق ASA لحساب CPI و CPA و ROAS لكل حملة / مجموعة إعلانية / كلمة مفتاحية — دون الحاجة إلى MMP.

مزالق التنفيذ الشائعة

  • يجب جلب الرمز في الجلسة الأولى. إذا تعطل تطبيقك أو ألغى المستخدم التثبيت قبل طلب الرمز، تفقد هذا الإسناد.
  • صلاحية الرمز قصيرة. تنتهي صلاحية الرموز بسرعة؛ بادلها مع نقطة نهاية آبل بسرعة.
  • الرجوع قبل iOS 14.3. إذا كنت تدعم iOS أقدم، تحتاج إطار iAd القديم بجانب Ad Services. معظم التطبيقات أسقطت iOS <15 بحلول 2026.
  • attribution: false ليس دائماً “عضوي”. بعض التثبيتات غير ASA تأتي من انطباعات Today Tab، توصيات البحث، أو إبداعات أقدم حيث لم يتم إنشاء الرمز.

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