إعداد ملف app-ads.txt لتطبيقك

كي تتمكّن خدمة AdMob من العثور على ملفّ app-ads.txt والتحقُّق منه:

• يجب أن يكون تطبيقك مسجّلاً في متجر Google Play أو Apple App Store.
• يجب أن تتضمَّن بطاقة بيانات متجر التطبيقات موقعًا إلكترونيًا للمطوّر، وذلك كما هو موضّح في هذه المقالة في الخطوة 1(أ).

في هذه المقالة:

• الخطوة 1: إنشاء موقع إلكتروني للمطوّر
• الخطوة 2: إنشاء ملفّ app-ads.txt
• الخطوة 3: نشر ملفّ app-ads.txt على الموقع الإلكتروني للمطوّر
• الخطوة 4: الانتظار إلى أن تزحف AdMob إلى ملفّ app-ads.txt وتتحقّق منه
• الخطوة 5: التأكّد من أنّه تمّ التحقق من ملف app-ads.txt في حسابك على AdMob

الخطوة 1: إنشاء موقع إلكتروني للمطوّر

تتيح مواقع المطورين الإلكترونية للمستخدِمين الاطّلاع على المزيد من المعلومات عن تطبيقاتك ومحتوى آخر. وهذه المواقع الإلكترونية هي الطريقة التي يحدّد من خلالها معيار app-ads.txt ملّاك التطبيقات. يجب ربط الموقع الإلكتروني للمطوّر ببطاقات بيانات متجرك في Google Play أو App Store حتى تتمكّن خدمة AdMob والمنصّات الإعلانية الأخرى من إثبات ملكية تطبيقك.

إذا لم يكن لديك حاليًا موقع إلكتروني تمّ إعداده لنشاطك التجاري المختصّ في تطوير التطبيقات، عليك إنشاء موقع إلكتروني قبل المشاركة في app-ads.txt. تتوفر العديد من خيارات استضافة الويب المجانية والمدفوعة.

بعد الإنشاء، عدِّل بيانات تطبيقك في متاجر التطبيقات لتضمين الموقع الإلكتروني للمطوّر في عنوان URL الذي يخصّ التواصل مع المطوّر. يمكنك اختياريًا نشر أي معلومات تسويق ودعم ذات صلة بتطبيقك على الموقع الإلكتروني.

ملاحظة: لا تحتاج إلى إدراج عنوان URL لملفّ app-ads.txt بالكامل في بطاقة بيانات متجر التطبيقات. تزحف AdMob إلى ملفّ app-ads.txt باستخدام جزء اسم المضيف (النطاق) من عنوان URL للموقع الإلكتروني. مزيد من المعلومات عن كيفية العثور على ملف app-ads.txt في الخطوة 3. 

الخطوة 1(أ): إضافة الموقع الإلكتروني للمطوّر في بطاقة بيانات متجر التطبيقات

لإضافة الموقع الإلكتروني لمطوّر البرامج الخاص بك في بطاقة بيانات متجر التطبيقات:

• بالنسبة إلى Google Play: أضف عنوان URL للموقع الإلكتروني في معلومات الاتصال في بطاقة بيانات تطبيقك:
  1. سجّل الدخول إلى Play Console.
  2. انتقِل إلى صفحة المطوِّر (حساب المطوِّر > صفحة المطوِّر).
  3. انتقِل إلى عنوان الموقع الإلكتروني.
  4. أضِف عنوان URL لموقع مطوّر البرامج الإلكتروني الخاص بك.
• بالنسبة إلى Apple App Store: أضِف الموقع الإلكتروني لمطوّر البرامج في حقل عنوان URL للتسويق في بطاقة بيانات المتجر. تحقّق مما إذا كان بإمكانك رؤية رابط "موقع المطوّر الإلكتروني" معروضًا في أسفل صفحة تطبيقك على iOS لتأكيد أنّك أضفت عنوان URL بنجاح.

إذا أضفت موقعًا إلكترونيًا للمطوّر أو عدَّلته في بطاقة بيانات تطبيقك على Google Play، يُرجى الانتظار لمدة تصل إلى 24 ساعة حتى تتمكّن خدمة AdMob من رصد هذه التغييرات.

الخطوة 2: إنشاء ملفّ app-ads.txt

عرض مثال لملف app-ads.txt:

# app-ads.txt example file:

greenadexchange.com, 12345, DIRECT, d75815a79

silverssp.com, 9675, RESELLER, 496211

blueadexchange.com, XF436, DIRECT

orangeexchange.com, 45678, RESELLER

silverssp.com, ABE679, RESELLER

google.com, pub-0000000000000000, DIRECT, f08047fec0942fa0

في المثال أعلاه:

• ‫google.com هو موقع تبادل إعلاني.
• ‫pub-0000000000000000 هو رقم تعريف الناشر / الحساب.
• ‫DIRECT هو نوع العلاقة.
• ‫f08047fec0942fa0 هو رقم تعريف هيئة إصدار الشهادات (مثل رقم تعريف Trustworthy Accountability Group).

 

ملاحظة: يجب أن يكون تنسيق ملف ads.txt على النحو المحدّد من "المختبَر التقني لمكتب الإعلانات التفاعلية" (IAB Tech Lab) حتى يتم التحقُّق منه. إذا كنت بحاجة إلى مساعدة إضافية، راجع مواصفات مبادرة "البائعون المعتمَدون للتطبيقات" التي يقدّمها "المختبَر التقني لمكتب الإعلانات التفاعلية" (IAB Tech Lab).

الخطوة 2 أ: إضافة مقتطف الرمز المخصص إلى ملف app-ads.txt

يوفر AdMob مقتطف رمز مخصص يسهّل عملية إعداد ملف app-ads.txt. يتضمن مقتطف الرمز المخصص الرقم التعريفي للناشر. 

يجب تضمين الرقم التعريفي للناشر وتنسيقه بشكل صحيح ليتمّ التحقُّق من ملفّ app-ads.txt.

للحصول على مقتطف الرمز المخصّص، والذي يتضمَّن الرقم التعريفي للناشر:

1. سجِّل الدخول إلى حسابك على AdMob على https://admob.google.com.
2. انقر على التطبيقات في الشريط الجانبي.
3. انقر على جميع التطبيقات.
4. انقر على علامة التبويب ملف app-ads.txt.
5. انقر على كيفية إعداد ملف app-ads.txt. 
6. انقر على  بجانب مقتطف الرمز المراد نسخه.
7. الصق مقتطف الرمز في ملف app-ads.txt. 

الخطوة 2(ب): (اختياري) إضافة أرقام التعريف الأخرى للبائع المعتمَد إلى ملفّ app-ads.txt

إذا كنت تستخدم شبكة إعلانات أخرى، تذكّر إضافة هذه الشبكة إلى ملفّ app-ads.txt. ويسمح ذلك للبائع التابع لجهة خارجية بالعثور على ملف app-ads.txt والتحقق منه أيضًا. تواصل مع شبكة الإعلانات للحصول على معلومات app-ads.txt. 

الخطوة 3: نشر ملفّ app-ads.txt على الموقع الإلكتروني للمطوّر

يبحث زاحف AdMob app-ads.txt عن ملف app-ads.txt استنادًا إلى الموقع الإلكتروني لمطور البرامج في بطاقة بيانات المتجر في تطبيقك. وفقًا لمواصفات app-ads.txt، تبحث برامج الزحف عن الملفّات في أنماط عناوين URL التالية:

• https://<<hostname>>/app-ads.txt
• http://<<hostname>>/app-ads.txt

يتم استخراج اسم المضيف من الموقع الإلكتروني لمطوّر التطبيق. هذا هو نطاق الموقع الإلكتروني أو (في حالات معينة) نطاق فرعي، كما هو موضح أدناه.

يعرِض الجدول التالي أمثلة عامّة عن المكان الذي سيبحث فيه زاحف AdMob عن ملفّ app-ads.txt الذي يخصّ عناوين URL للمواقع الإلكترونية المتخلّفة التي تخصّ المطوّرين.

إذا كان الموقع الإلكتروني لمطوّر البرامج هو:	يظهر الزاحف بالترتيب التالي:
https://example.com/game	https://example.com/app-ads.txt http://example.com/app-ads.txt
http://help.example.com/game	https://help.example.com/app-ads.txt http://help.example.com/app-ads.txt https://example.com/app-ads.txt http://example.com/app-ads.txt

 

تتضمَّن مواصفات app-ads.txt قواعد محدّدة بشأن النطاقات الفرعية. وتعمل برامج الزحف على فحص ما يصل إلى مستوى نطاق فرعي واحد من الموقع الإلكتروني للمطوّر عند إنشاء عنوان URL لملفّ app-ads.txt.

على سبيل المثال:

إذا كان الموقع الإلكتروني لمطوّر البرامج هو:	يظهر الزاحف بالترتيب التالي:
http://support.help.example.com/game	https://help.example.com/app-ads.txt http://help.example.com/app-ads.txt https://example.com/app-ads.txt http://example.com/app-ads.txt ملاحظة: يكون "help.example.com" في مستوى النطاق الفرعي الأوّل ويتمّ استخدامه للزحف، بينما يكون "support.help.example.com" في مستوى النطاق الفرعي الثاني ولا يُستخدم للزحف.

 

تَستبعد المواصفات النطاقَين الفرعيَين "www.‎" و"m.‎" كمواقع تبحث برامج الزحف فيها عن الملفّات.

إذا كان الموقع الإلكتروني لمطوّر البرامج هو:	يظهر الزاحف بالترتيب التالي:
https://www.example.com/game	https://example.com/app-ads.txt http://example.com/app-ads.txt
https://m.example.com/game	https://example.com/app-ads.txt http://example.com/app-ads.txt

 

قد يُعيد خادم الويب توجيه الزاحف إلى ملفّ app-ads.txt مُستضاف في مكان آخر (بما في ذلك النطاق الفرعي "www.‎").

إذا كان الزاحف يبحث عن ملف هنا:	يمكن أن تشمل وجهات اختبار إعادة التوجيه، على سبيل المثال لا الحصر:
https://example.com/app-ads.txt	النطاق الفرعي "www.‎" لموقعك الإلكتروني: https://www.example.com/app-ads.txt نطاق فرعي آخر ودليل فرعي آخر: https://static.example.com/files/app-ads.txt نطاق فرعي أو دليل فرعي أو اسم ملفّ آخر: https://static.example.com/files/app-ads-1.txt نطاق آخر، بما في ذلك نطاقات فرعية متعدّدة: https://www.cdn.files.example.com/app-ads.txt

للتحقق مما إذا كنت قد نشرت ملفك بشكل صحيح، تأكَّد من أنّك تستطيع رؤية محتوى ملفك عند الدخول إلى عنوان URL لملف app-ads.txt في متصفح الويب. إذا تمكّنتَ من رؤية الملفّ في متصفّح الويب، من المحتمل أن تعثر برامج الزحف عليه بنجاح.

يمكنك عرض تفاصيل محاولات AdMob للزحف إلى ملفّ app-ads.txt في حسابك على AdMob.

الخطوة 4: الانتظار إلى أن تزحف AdMob إلى ملفّ app-ads.txt وتتحقّق منه

قد يستغرق AdMob ما يصل إلى 24 ساعة للزحف إلى ملفات app-ads.txt والتحقق منها. تفحص خدمة AdMob بشكل دوري أحدث ملفّ، ولكن يمكنك أيضًا أن تطلب من AdMob الزحف إلى تطبيقك للحصول على استجابة أسرع:

1. سجِّل الدخول إلى حسابك على AdMob على https://admob.google.com.
2. انقر على التطبيقات في الشريط الجانبي.
3. انقر على جميع التطبيقات.
4. انقر على علامة التبويب ملف app-ads.txt.

5. في صفّ التطبيق الذي تريد الاطّلاع على تفاصيله، انقر لتوسيع . يؤدّي هذا إلى فتح تفاصيل إضافية وخيار طلب AdMob للزحف إلى تطبيقك.

   

6. انقر على البحث عن تحديثات. عندما تطلب من خدمة AdMob الزحف إلى ملفّ app-ads.txt، فإنّ الخدمة ستُعدِّل من حالة جميع التطبيقات التي تشترك في ملفّ app-ads.txt نفسه.
   • في بعض الحالات، قد لا يكون الزرّ "البحث عن تعديلات" متاحًا. تجدر الإشارة إلى أنّ AdMob تزحف بشكل دوري إلى آخر ملفّ بحثًا عن التعديلات.

قد يستغرق AdMob ما يصل إلى 24 ساعة للزحف إلى ملفات app-ads.txt والتحقق منها. انتظر لمدّة 24 ساعة على الأقلّ إلى أن يتمّ تعديل حالة ملفّ app-ads.txt.

إذا كنت قد أضفتَ موقعًا إلكترونيًا للمطوّر أو عدَّلت بطاقة بيانات تطبيقك على Google Play، عليك الانتظار لمدّة تصل إلى 24 ساعة إلى أن تتمكّن AdMob من رصد هذه التغييرات.

الخطوة 5: التأكّد من أنّه تمّ التحقق من ملف app-ads.txt في حسابك على AdMob

يمكنك عرض حالة ملف app-ads.txt وتفاصيله لجميع تطبيقاتك في حسابك على AdMob.

إذا لم يتمّ العثور على ملفّك أو التحقُّق منه، راجع المعلومات المقدَّمة في حسابك على AdMob أو تعرّف على مزيد من المعلومات عن تحديد مشاكل app-ads.txt وحلّها.