مبادرة "البائعون المعتمَدون للتطبيقات" (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

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

يمكنك الانتقال إلى مستندات Firebase 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" لإعادة توجيه الصفحة المقصودة إلى موقعك الإلكتروني الحالي.

ستستخدم خدمة Firebase Hosting الملف 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) للتأكّد من أنّ إعدادات إعادة التوجيه صحيحة.

الموارد