فروشندگان مجاز برنامه‌ها (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 CLI را بااستفاده از 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) دسترسی پیدا کنید تا بررسی کنید تنظیم هدایت مجدد درست است یا نه.

منابع