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

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

يُرجى الانتقال إلى مستندات واجهة سطر أوامر Firebase للتعرّف على كيفية تثبيت واجهة سطر الأوامر (CLI) أو التحديث إلى أحدث إصدار.

بدء مشروعك

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

firebase init

أثناء بدء المشروع، يُرجى اتّباع التعليمات الواردة في Firebase CLI:

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

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

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

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

    اضغط على مفتاح Enter لاختيار ملف شخصي تلقائي (عام).

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

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

في نهاية عملية الإعداد، تنشئ Firebase ملفَّين وتضيفهما إلى جذر directoryملفّات المشروع المحلي:

  • دليل 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) للتحقّق مما إذا كان إعداد إعادة التوجيه صحيحًا أم لا.

الموارد