فروشندگان مجاز برنامه‌ها (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 و App Store فهرست شده است وارد شده باشد.

  4. حداقل ۲۴ ساعت صبر کنید تا AdMob فایل app-ads.txt شما را بخزد و درستی‌سنجی کند.

  5. به AdMob برگردید و وضعیت app-ads.txt خود را بررسی کنید.

انتشار app-ads.txt با میزبانی Firebase

اگر وب‌سایتی دارید که اجازه بارگذاری فایل app-ads.txt را در سطح ریشه نمی‌دهد (مثلاً سایتی که توسط سرویس تولید سایت ساخته و میزبانی می‌شود)، می‌توانید از Firebase Hosting برای میزبانی فایل app-ads.txt خود استفاده کنید.

Firebase روشی رایگان، سریع، و مطمئن برای میزبانی فایل app-ads.txt با دامنه سفارشی خودتان یا در زیردامنه‌های رایگان پروژه Firebase ارائه می‌دهد: web.app و firebaseapp.com.

قبل‌از شروع

برای انتشار app-ads.txt با «میزبانی Firebase»، باید پروژه Firebase داشته باشید. اگر پروژه Firebase ندارید، با دنبال کردن راهنمای توسعه‌دهندگان پروژه جدیدی ایجاد کنید.

اگر قبلاً برنامه‌های AdMob خود را به Firebase پیوند داده‌اید یا برنامه شما از یکی از محصولات Firebase (مانند Google Analytics برای Firebase، پیکربندی از راه دور و غیره) استفاده می‌کند، می‌توانید از پروژه Firebase موجود استفاده کنید.

نصب کردن «واسط خط فرمان Firebase»

می‌توانید واسط خط فرمان Firebase را بااستفاده از npm (مدیر بسته Node) نصب کنید. بااین‌حال، اگر با Node.js آشنا نیستید، می‌توانید به‌جای آن از باینری مستقل استفاده کنید.

برای آشنایی با نحوه نصب واسط خط فرمان یا به‌روزرسانی به جدیدترین نسخه آن، به اسناد واسط خط فرمان Firebase مراجعه کنید.

مقداردهی اولیه پروژه

برای مقداردهی اولیه پروژه Firebase در ماشین محلی، فرمان زیر را از ریشه فهرست راهنمای پروژه اجرا کنید.

firebase init

درطول مقداردهی اولیه پروژه، از پیام‌واره‌های «واسط خط فرمان Firebase»:

  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. پس‌از تکمیل استقرار، به نشانی وب زیر بروید تا مطمئن شوید 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 فهرست کنید.

نشانی وب بازاریابی را در فهرستگان فروشگاه برنامه به‌صورت زیر به‌روز کنید:

https://PROJECT_ID.web.app

پیکربندی تنظیمات تغییر مسیر (اختیاری)

اگر وب‌سایت موجودی دارید و قصد دارید از «میزبانی Firebase» فقط برای میزبانی فایل app-ads.txt خود استفاده کنید، می‌توانید «میزبانی Firebase» را پیکربندی کنید تا صفحه مقصد را به وب‌سایت موجودتان هدایت کند.

وقتی کاربری از سایتتان بازدید می‌کند، «میزبانی Firebase» به‌طور پیش‌فرض از public/index.html به‌عنوان صفحه مقصد استفاده می‌کند. برای هدایت کاربران به وب‌سایت موردنظرتان (برای مثال، صفحه رسانه‌های اجتماعی برنامه‌تان):

  1. فایل firebase.json را که در ریشه دایرکتوری پروژه محلی‌تان قرار دارد باز کنید.

  2. در زیر شیء میزبانی، شیء هدایت کردن‌ها را به‌صورت زیر اضافه کنید:

    "hosting": {
      ...
      "redirects": [
        {
          "source": "/",
          "destination": "URL_TO_REDIRECT",
          "type": 301
        }
      ]
    }
    

    برای مثال، اگر نشانی وب صفحه مقصد 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) دسترسی پیدا کنید تا بررسی کنید تنظیمات تغییرمسیر درست است یا نه.

منابع