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

اختيار النظام الأساسي: Android iOS

تمثّل مبادرة "البائعون المعتمَدون للتطبيقات"، المعروفة أيضًا باسم 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). تأكَّد من إدخال النطاق تمامًا كما هو مُدرَج في 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

يمكنك تثبيت 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، عليك إدراج النطاق أو النطاق الفرعي الذي تم إنشاؤه حديثًا في بطاقة بيانات تطبيقك على App Store.

عدِّل عنوان URL الخاص بالتسويق في بطاقة بيانات المتجر باتّباع الخطوات التالية:

https://PROJECT_ID.web.app

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

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

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

الموارد