كيفية ربط App Store Connect بـ AdMate

يحتوي App Store Connect على عدة أنواع من البيانات: بيانات التطبيقات الوصفية، والمراجعات، والتحليلات، والمبيعات، والعائدات المقدّرة، والتقارير المالية النهائية. يمكن لـ AdMate جمعها في التطبيق نفسه الذي تستخدمه لـ AdMob وRevenueCat، لكن يجب أن يملك الاتصال المعرّفات والأذونات الصحيحة.

يستخدم الإعداد مفتاح API من App Store Connect. تعامل مع المفتاح الخاص ككلمة مرور: استورده فقط في شاشة بيانات الاعتماد ولا ترفقه أبدًا بطلب دعم.

AdMate

كل إيراداتك في لوحة تحكم واحدة

تابع AdMob وAdSense وRevenueCat وApp Store Connect عبر حسابات متعددة مع فلاتر حسب التطبيق والمنصة والبلد

راقب الإيرادات والنقرات وeCPM والاشتراكات وعمليات التثبيت والمدفوعات من iPhone وiPad وMac وApple Watch

ما الذي تحتاجه من App Store Connect

جهّز القيم التي تعرضها Apple في قسم المستخدمون والوصول لمفتاح API:

Key ID، الذي يحدد مفتاح API؛
Issuer ID، الذي يحدد الجهة المُصدِرة لواجهة App Store Connect البرمجية؛
محتوى المفتاح الخاص .p8 أو ملفه؛
اسمًا مستعارًا واضحًا للحساب في AdMate؛
رقم المورّد عندما يتطلبه تقرير المبيعات أو التقرير المالي المطلوب.

يحدد الدور المسند إلى المفتاح ما تُرجعه Apple. فالمفتاح القادر على عرض التطبيقات قد لا يملك صلاحية الوصول إلى بيانات المبيعات أو البيانات المالية. استخدم أضيق دور مناسب، لكن تأكد من أنه يغطي التقارير التي تنوي قراءتها فعلًا.

تسمح Apple عادةً بتنزيل ملف المفتاح الخاص مرة واحدة فقط. احفظ النسخة الأصلية بأمان خارج مستودع الشيفرة وخارج لقطات الشاشة. إذا فُقد الملف أو انكشف، فألغِ المفتاح وأنشئ مفتاحًا بديلًا بدلًا من أن تطلب من شخص آخر إرساله عبر الدردشة.

أضف الحساب في AdMate

افتح الإعدادات وإدارة الحسابات.
اختر إضافة حساب App Store Connect.
أدخل اسم عرض يسهل التعرف عليه.
أضف Key ID وIssuer ID تمامًا كما تقدّمهما Apple.
استورد المفتاح الخاص أو الصقه من خلال شاشة بيانات الاعتماد.
أضف رقم المورّد عندما تحتاج إليه التقارير المالية أو تقارير المبيعات.
احفظ الحساب واترك AdMate يتحقق من بيانات الاعتماد.
افتح ملخص الحساب وتأكد من ظهور التطبيقات المتوقعة.

تجنّب تعديل سطر البداية أو النهاية في مفتاح .p8 يدويًا. فالنص الزائد أو فواصل الأسطر المفقودة أو مفتاح من جهة إصدار أخرى ستمنع إنشاء الرمز المميز.

تحقق من كل نوع من البيانات على حدة

لا يثبت ملخص أخضر واحد أن كل نقاط الوصول في App Store Connect متاحة. افحص الأقسام التي تنوي استخدامها:

التطبيقات والبيانات الوصفية

تأكد من ظهور التطبيقات والأيقونات المتوقعة. قد يشير غياب تطبيق إلى أن المفتاح يخص مؤسسة مزوّد أخرى أو أن دوره مقيّد.

المراجعات

افتح عرض المراجعات وافحص تطبيقًا تعرفه. المراجعات بيانات تختلف حسب المتجر والمنطقة؛ وقد تعني الحالة الفارغة الصالحة ببساطة عدم وجود مراجعات مطابقة.

التحليلات

اختر فترة مكتملة وراعِ موعد إتاحة Apple للتقارير. فبعض تقارير التحليلات ليست فورية ولها درجة تفصيل وتأخير خاصان بها.

المبيعات والعائدات

ضع تسمية منفصلة لمبيعات العملاء وعائدات المطوّر. فهما ليستا القيمة نفسها، ولا ينبغي الخلط بين أيٍّ منهما ودفعة بنكية.

التقارير المالية

تستخدم التقارير المالية فترات Apple المغلقة وقد تتطلب رقم المورّد والدور الصحيحين. استخدمها للمطابقة بدلًا من توقّع ظهور اليوم الحالي.

معالجة مشكلات الاتصال

مفتاح أو توقيع غير صالح

أعد التحقق من Key ID وIssuer ID والمفتاح الخاص كمجموعة واحدة. فحتى المفتاح الصالح يفشل إذا اقترن بجهة إصدار خاطئة. وإذا كان هناك احتمال لانكشافه، فألغه قبل متابعة الاختبار.

تُحمّل التطبيقات لكن التقارير المالية لا تظهر

تحقق من دور مفتاح API ورقم المورّد والفترة المالية المطلوبة. فالوصول إلى البيانات الوصفية لا يضمن الوصول إلى البيانات المالية.

لا تعرض التحليلات أي بيانات

استخدم نطاقًا تاريخيًا مدعومًا، وتحقق من أن التقرير أصبح متاحًا، وتأكد من أن التطبيق المحدد قد أنتج المقياس المطلوب.

تظهر تطبيقات مؤسسة أخرى

أزل الحساب وأضف المفتاح الخاص بالمزوّد الصحيح. لا تدمج إجماليات مؤسستين لمجرد أن تطبيقاتهما تتبع أسلوب التسمية نفسه للحزم.

حسابات App Store Connect متعددة

يدعم AdMate أكثر من حساب واحد. استخدم أسماء مستعارة تحدد المؤسسة، لا الشخص الذي أنشأ المفتاح. عند تدوير مفتاح، استبدله في الحساب الصحيح واختبر التطبيقات والتحليلات والبيانات المالية كلًا على حدة.

للمقارنة مع تحليلات الاشتراكات، اقرأ لماذا تختلف إجماليات App Store Connect وRevenueCat.

الأسئلة الشائعة

هل يحتاج AdMate إلى كلمة مرور Apple ID الخاصة بي؟

لا. يستخدم الاتصال مفتاح API من App Store Connect والجهة المُصدِرة والمعرّفات المرتبطة بهما. لا تُدخل كلمة مرور Apple ID ولا تشاركها أبدًا لهذا الإعداد.

لماذا تُحمّل التطبيقات بينما لا تظهر العائدات؟

قد يملك المفتاح أذونات كافية لبيانات التطبيقات الوصفية دون أذونات المبيعات أو البيانات المالية، أو قد يكون رقم المورّد وفترة التقرير مفقودين.

هل يمكنني إعادة استخدام مفتاح واحد على عدة أجهزة تعمل بـ AdMate؟

من الناحية التقنية قد تعمل بيانات الاعتماد نفسها، لكن كل نسخة إضافية تزيد خطر الانكشاف. اتبع سياسة إدارة المفاتيح في مؤسستك، وألغِ المفاتيح من الأجهزة التي لم يعد ينبغي لها الوصول.

هل تقديرات App Store Connect قيم محاسبية نهائية؟

لا. استخدم التقارير المالية المغلقة والمدفوعات الفعلية لأغراض المحاسبة.