ربط Apple App Store
أنشئ مفتاح API لـ App Store Connect بالدور الصحيح، وأضفه، واختر تطبيقاتك.
لا تستخدم Apple نافذة تسجيل دخول منبثقة للتقارير. تُنشئ مفتاح API في App Store Connect، وتنزّله مرة واحدة، وتلصق تفاصيله في Revenue Sensor. يُسمّى هذا المصدر في وحدة التحكم Apple IAP.
قبل أن تبدأ
- صلاحية Account Holder أو Admin في App Store Connect، لتتمكن من إنشاء المفاتيح.
- Vendor Number الخاص بك، من App Store Connect → Reports → Payments and Financial Reports. يظهر في أعلى اليسار، تحت اسم حسابك.
أنشئ مفتاح API
- 1
افتح صفحة مفاتيح Integrations
App Store Connect → Users and Access → Integrations → App Store Connect API.
- 2
أنشئ مفتاحاً
انقر على + بجانب Active وامنح المفتاح اسماً تتعرف عليه، مثل “Revenue Sensor”.
- 3
أعطه دور تقارير
تحت Access، اختر Sales أو Finance أو Admin. يستطيع كل منها قراءة تقارير Sales and Trends التي يستوردها Revenue Sensor. دور Admin هو الوحيد الذي يمنح أيضاً أرقام App Store Connect الدقيقة (انظر أدناه). المفتاح الذي لا يملك سوى صلاحية Developer أو App Manager لا يستطيع قراءة الإيرادات.
- 4
نزّل ملف .p8
تسمح لك Apple بتنزيل المفتاح الخاص مرة واحدة فقط. احفظه في مكان آمن قبل مغادرة الصفحة. إن فقدته، فأنشئ مفتاحاً جديداً واستخدم Key ID وملف .p8 الجديدين.
أكثر الأخطاء شيوعاً على الإطلاق
إن عادت الإيرادات فارغة، أو أظهر الحساب “Your API key needs the Sales role”، فدور المفتاح هو السبب في الغالب: امنحه دور Sales أو Finance في App Store Connect، ثم أعد الاتصال. وتحقق أيضاً من أن Vendor Number يخص حساب App Store Connect نفسه الذي يخصه المفتاح.
أضف بيانات اعتمادك
- Issuer ID: يظهر في أعلى صفحة مفاتيح App Store Connect API. وهو نفسه لكل المفاتيح.
- Key ID: يظهر في صف المفتاح الذي أنشأته.
- المفتاح الخاص: ملف .p8 الذي نزّلته. ارفعه أو اسحبه إلى الحقل. يُخزَّن مشفراً ولا يُعرض مرة أخرى أبداً.
- Vendor Number: من Payments and Financial Reports.
اختر تطبيقاتك
يُدرج Revenue Sensor التطبيقات المنشورة التي يستطيع المفتاح رؤيتها. اختر التطبيقات التي تريد تتبعها. لا تُزامَن إلا التطبيقات المختارة.
ما يُستورد
الإيرادات هي عدد الوحدات مضروباً في Developer Proceeds من تقرير ملخص المبيعات اليومي من Apple. العائدات هي ما تدفعه لك Apple، بعد عمولتها وأي ضريبة تحصّلها، لذا فإن Payout هو أساس الإيرادات الوحيد لهذا المصدر. يصل المبلغ المسترد كصف بوحدات سالبة، فيُطرح في اليوم الذي عالجته فيه Apple. تُستورد التنزيلات والمبالغ المستردة من التقرير نفسه.
تأخر التقارير
تنشر Apple تقرير مبيعات كل يوم بعد انتهائه، لذا لا يظهر اليوم الحالي أبداً بعد. قد تتغير الأيام الأخيرة قليلاً عندما تعيد Apple احتسابها، وتعيد كل مزامنة قراءة آخر 14 يوماً.