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

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

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

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

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

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

قبل از اینکه شروع کنی

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

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

نصب رابط خط فرمان فایربیس

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

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

پروژه خود را اولیه کنید

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

firebase init

در طول مقداردهی اولیه پروژه، از دستورات Firebase CLI:

  1. برای تنظیم میزبانی (Hosting) انتخاب کنید.

  2. یک پروژه Firebase را برای اتصال به دایرکتوری پروژه محلی خود انتخاب کنید.

    گزینه «استفاده از یک پروژه موجود» را انتخاب کنید، سپس پروژه‌ای را از لیست که می‌خواهید به آن متصل شوید، انتخاب کنید.

  3. یک دایرکتوری را برای استفاده به عنوان دایرکتوری ریشه عمومی خود مشخص کنید.

    برای انتخاب پیش‌فرض (عمومی) اینتر را فشار دهید.

  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 فهرست کنید.

وب‌سایت توسعه‌دهنده را در فهرست اپ استور به صورت زیر به‌روزرسانی کنید:

https://PROJECT_ID.web.app

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

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

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

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

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

    "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 ) دسترسی پیدا کنید تا بررسی کنید که آیا تنظیمات تغییر مسیر صحیح است یا خیر.

منابع