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

اختيار المنصة: Android (إصدار تجريبي) جديد 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). تأكّد من إدخال النطاق تمامًا كما هو مُدرَج في Google Play.

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

  5. ارجع إلى AdMob وافحص حالة ملف app-ads.txt status.

نشر ملف 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 الحالي.

تثبيت Firebase CLI

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

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

إعداد مشروعك

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

firebase init

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

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

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

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

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

    اضغط على مفتاح الإدخال لاختيار دليل تلقائي (public).

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

الموارد