مبادرة "البائعون المعتمَدون للتطبيقات" (app-ads.txt)

تمثّل مبادرة "البائعون المعتمَدون للتطبيقات"، المعروفة أيضًا باسم app-ads.txt، إحدى مبادرات "مكتب الإعلانات التفاعلية" (IAB) تساعد على حماية المساحة الإعلانية المتوفرة في تطبيقك من الاحتيال الإعلاني. ويتعيّن عليك إنشاء ملفات app-ads.txt لتحديد الجهات المعتمَدة لبيع المساحة الإعلانية المتاحة. فمن خلال تحديد البائعين المعتمَدين، يمكنك الحصول على مبالغ إنفاق المعلنين التي كان من المحتمل أن تُنفق على المساحات الإعلانية في التطبيقات المزيفة.

تتوفّر ملفّات app-ads.txt للجميع ويمكن الزحف إليها عن طريق منصّات تبادل الإعلانات ووسطاء عرض إعلانات المورِّدين (SSP) والمشترين الآخرين والمورِّدين التابعين لجهات خارجية.

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

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

المتطلبات الأساسية

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

  1. إذا لم تكن قد أنشأت ملفًا نصيًا، أنشِئ ملفًا واحفظه باسم "app-ads.txt".

  2. انسخ مقتطف الرمز التالي وألصقه في ملف app-ads.txt. (استبدِل pub-00000000000000 برقم تعريف الناشر. يمكنك العثور على رقم تعريف الناشر في "وحدة تحكّم AdMob" > "الإعدادات").

    google.com, pub-00000000000000, DIRECT, f08c47fec0942fa0

  3. انشر ملف app-ads.txt في جذر الموقع الإلكتروني الخاص بالمطوّر (على سبيل المثال، https://example.com/app-ads.txt). تأكَّد من إدخال النطاق تمامًا كما هو مُدرَج على Google Play.

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

  5. يُرجى العودة إلى AdMob والتحقّق من حالة ملف app-ads.txt.

نشر ملف app-ads.txt باستخدام "استضافة Firebase"

إذا كان لديك موقع إلكتروني لا يسمح بتحميل ملف app-ads.txt على مستوى الجذر (على سبيل المثال، موقع إلكتروني تم إنشاؤه واستضافته بواسطة خدمة إنشاء المواقع الإلكترونية)، يمكنك استخدام ميزة "استضافة Firebase" لاستضافة ملف app-ads.txt.

تقدّم منصة Firebase طريقةً مجانية وسريعة وموثوق بها لاستضافة ملف app-ads.txt باستخدام نطاقك الخاص أو على النطاقات الفرعية المجانية لمشروع Firebase: web.app وfirebaseapp.com.

قبل البدء

يجب أن يكون لديك مشروع على Firebase لنشر ملف app-ads.txt باستخدام "استضافة Firebase". إذا لم يكن لديك مشروع Firebase، أنشئ مشروعًا جديدًا باتّباع دليل المطوِّر.

إذا سبق لك ربط تطبيقاتك التي تستخدم AdMob بمنصة Firebase أو كان تطبيقك يستخدم أحد منتجات Firebase (مثل "إحصاءات Google لبرنامج Firebase"، و"الإعداد عن بُعد"، وما إلى ذلك)، يمكنك استخدام مشروع Firebase الحالي.

تثبيت Firebase CLI

يمكنك تثبيت FirebaseCLI باستخدام npm (أداة إدارة حِزم Node). ومع ذلك، إذا لم تكن معتادًا على Node.js، يمكنك استخدام الملف الثنائي المستقل بدلاً من ذلك.

يمكنك الانتقال إلى مستندات Firebase CLI للتعرّف على كيفية تثبيت CLI أو التحديث إلى الإصدار الأخير.

إعداد مشروعك

لبدء مشروع Firebase على جهازك المحلي، نفِّذ الأمر التالي من جذر دليل مشروعك.

firebase init

أثناء إعداد المشروع، اتّبِع التعليمات التالية من موجه أوامر Firebase CLI:

  1. انقر لإعداد الاستضافة.

  2. اختَر مشروعًا على Firebase لربطه بدليل مشروعك على الجهاز.

    اختَر استخدام مشروع حالي، ثم اختَر مشروعًا من القائمة تريد ربطه.

  3. حدِّد دليلاً لاستخدامه كدليل جذري متاح للجميع.

    اضغط على Enter لاختيار الإعداد التلقائي (علني).

  4. اختَر إعدادًا لموقعك الإلكتروني.

    بما أنّ الموقع الإلكتروني الذي ستنشئه ليس تطبيقًا من صفحة واحدة، انقر على N.

في نهاية عملية الإعداد، ينشئ Firebase ملفَين ويضيفهما إلى جذر دليل مشروعك على الجهاز:

  • ‫public دليل يحتوي على ملفات مستضافة على موقعك الإلكتروني.
  • ملف إعداد firebase.json يعرض إعدادات مشروعك
  • ملف .firebaserc يخزّن الاسم المستعار لمشروعك.

نشر ملف app-ads.txt

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

  1. ضَع ملف app-ads.txt في الدليل public ضمن دليل المشروع على الجهاز.

  2. نفِّذ الأمر التالي من جذر دليل المشروع على الجهاز:

    firebase deploy --only hosting

  3. بعد اكتمال عملية النشر، انتقِل إلى عنوان URL التالي للتأكّد من نشر ملف app-ads.txt. ‫(PROJECT_ID هو رقم تعريف مشروعك على Firebase).

    https://PROJECT_ID.web.app/app-ads.txt

    مثال: إذا كان "awesome-project" هو رقم تعريف المشروع، أدخِل https://awesome-project.web.app/app-ads.txt في شريط العناوين في متصفّحك.

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

لكي يتم الزحف إلى ملف app-ads.txt، عليك إدراج النطاق أو النطاق الفرعي الذي تم إنشاؤه حديثًا في بطاقة بيانات تطبيقك على Google Play.

عدِّل الموقع الإلكتروني للمطوّر في بطاقة بيانات متجر التطبيقات على النحو التالي:

https://PROJECT_ID.web.app

ضبط إعدادات إعادة التوجيه (اختياري)

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

ستستخدم ميزة "استضافة Firebase"‏ public/index.html كصفحة مقصودة تلقائيًا عندما يزور أحد المستخدمين موقعك الإلكتروني. لإعادة توجيه المستخدمين إلى الموقع الإلكتروني الذي تريده (على سبيل المثال، صفحة تطبيقك على وسائل التواصل الاجتماعي)، اتّبِع الخطوات التالية:

  1. افتح ملف firebase.json الموجود في جذر دليل مشروعك على الجهاز.

  2. ضمن عنصر الاستضافة، أضِف عنصر عمليات إعادة التوجيه على النحو التالي:

    "hosting": {
  ...
  "redirects": [
    {
      "source": "/",
      "destination": "URL_TO_REDIRECT",
      "type": 301
    }
  ]
}

    على سبيل المثال، إذا كان عنوان URL للصفحة المقصودة هو https://www.example.com، ستكون إعدادات إعادة التوجيه على النحو التالي:

    "hosting": {
  ...
  "redirects": [
    {
      "source": "/",
      "destination": "https://www.example.com",
      "type": 301
    }
  ]
}

  3. شغِّل الأمر التالي لنشر التغييرات على موقعك الإلكتروني.

    firebase deploy --only hosting

  4. بعد اكتمال عملية النشر، انتقِل إلى موقعك الإلكتروني (https://PROJECT_ID.web.app) للتحقّق مما إذا كان إعداد إعادة التوجيه صحيحًا أم لا.

الموارد