البائعون المعتمَدون للتطبيقات (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 &gt؛ الإعدادات.)

    google.com, pub-00000000000000, DIRECT, f08c47fec0942fa0

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

  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.js، يمكنك استخدام البرنامج الثنائي المستقل بدلاً من ذلك.

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

إعداد المشروع

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

firebase init

أثناء إعداد المشروع، من رسائل واجهة سطر الأوامر (CLI) في Firebase:

  1. اختَر إعداد الاستضافة.

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

    انقر على Use a existing project (استخدام مشروع حالي)، ثم اختَر مشروعًا من القائمة التي تريد ربطها.

  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 أو App Store

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

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

المراجع