Penjual Resmi untuk Aplikasi (app-ads.txt)

Penjual Resmi untuk Aplikasi, juga dikenal sebagai app-ads.txt, adalah inisiatif IAB yang membantu melindungi inventaris iklan aplikasi Anda dari penipuan iklan. Buat file app-ads.txt untuk mengidentifikasi siapa yang diizinkan untuk menjual inventaris Anda. Mengidentifikasi penjual resmi dapat membantu Anda menerima pembelanjaan pengiklan yang sebelumnya dapat mengurangi inventaris palsu dari aplikasi yang di-spoofing.

File app-ads.txt tersedia secara publik dan dapat di-crawl oleh bursa, platform sisi suplai (SSP), pembeli lain, dan vendor pihak ketiga.

Penggunaan app-ads.txt tidak wajib, tetapi sangat direkomendasikan, terutama jika Anda khawatir pihak lain dapat melakukan spoofing terhadap aplikasi Anda.

File app-ads.txt adalah file teks yang diposting oleh developer aplikasi di domain root situs developer aplikasinya. Tab ini berisi daftar entitas yang diizinkan untuk menjual inventaris penayang tersebut. Penggunaan file app-ads.txt mengharuskan penayang memiliki domain web untuk memublikasikan daftar penjual resmi mereka untuk berbagai vendor teknologi iklan yang akan di-crawl. Ada sejumlah solusi hosting domain yang memungkinkan hosting file arbitrer termasuk Firebase.

Prasyarat

Cara menyiapkan app-ads.txt untuk aplikasi Anda

  1. Jika Anda belum melakukannya, buat file teks dan simpan dengan nama "app-ads.txt".

  2. Salin dan tempel cuplikan kode berikut ke dalam file app-ads.txt Anda. (Ganti pub-00000000000000 dengan ID penayang Anda. ID penayang dapat ditemukan di konsol AdMob > Setelan.)

    google.com, pub-00000000000000, DIRECT, f08c47fec0942fa0
    
  3. Publikasikan app-ads.txt di root situs developer Anda (misalnya, https://example.com/app-ads.txt). Pastikan domain yang dimasukkan sama persis dengan yang tercantum di Google Play dan App Store.

  4. Tunggu setidaknya 24 jam agar AdMob meng-crawl dan memverifikasi file app-ads.txt Anda.

  5. Kembali ke AdMob dan periksa status app-ads.txt Anda.

Memublikasikan app-ads.txt dengan Firebase Hosting

Jika Anda memiliki situs yang melarang upload file app-ads.txt di tingkat root (misalnya, situs yang dibuat dan dihosting oleh layanan pembuatan situs), Anda dapat menggunakan Firebase Hosting untuk menghosting file app-ads.txt.

Firebase menawarkan cara gratis, cepat, dan andal untuk menghosting file app-ads.txt dengan domain kustom Anda sendiri atau di subdomain gratis project Firebase: web.app dan firebaseapp.com.

Sebelum memulai

Anda harus memiliki project Firebase untuk memublikasikan app-ads.txt dengan Firebase Hosting. Jika Anda tidak memiliki project Firebase, buat project baru dengan mengikuti panduan developer.

Jika Anda sudah menautkan aplikasi AdMob ke Firebase atau aplikasi Anda menggunakan salah satu produk Firebase (mis., Google Analytics for Firebase, Remote Config, dll.), Anda dapat menggunakan project Firebase yang ada.

Menginstal Firebase CLI

Anda dapat menginstal Firebase CLI menggunakan npm (Node Package Manager). Namun, jika tidak terbiasa dengan Node.js, Anda dapat menggunakan biner mandiri.

Buka dokumentasi Firebase CLI untuk mempelajari cara menginstal CLI atau mengupdatenya ke versi terbaru.

Menginisialisasi project

Untuk menginisialisasi project Firebase di mesin lokal, jalankan perintah berikut dari root direktori project Anda.

firebase init

Selama inisialisasi project, dari prompt Firebase CLI:

  1. Pilih untuk menyiapkan Hosting.

  2. Pilih project Firebase untuk dihubungkan ke direktori project lokal Anda.

    Pilih Use an existing project, lalu pilih project dari daftar yang ingin Anda hubungkan.

  3. Tentukan direktori yang akan digunakan sebagai direktori utama publik Anda.

    Tekan enter untuk memilih salah satu default (publik).

  4. Pilih konfigurasi untuk situs Anda.

    Karena situs yang akan Anda buat bukan aplikasi satu halaman, pilih N.

Di akhir inisialisasi, Firebase akan membuat dan menambahkan dua file ke root direktori project lokal Anda:

  • Direktori public yang berisi file yang dihosting di situs Anda.
  • File konfigurasi firebase.json yang mencantumkan konfigurasi project Anda.
  • File .firebaserc yang menyimpan alias project Anda.

Publikasikan app-ads.txt

Untuk memublikasikan app-ads.txt ke situs Anda:

  1. Masukkan file app-ads.txt ke dalam direktori public di direktori project lokal Anda.

  2. Jalankan perintah berikut dari root direktori project lokal Anda:

    firebase deploy --only hosting
  3. Setelah deployment selesai, buka URL berikut untuk memastikan app-ads.txt dipublikasikan. (PROJECT_ID adalah project ID Firebase Anda.)

    https://PROJECT_ID.web.app/app-ads.txt

    Contoh: Jika "awesome-project" adalah project ID, masukkan https://awesome-project.web.app/app-ads.txt di kolom URL browser Anda.

Tambahkan domain/subdomain ke listingan Play Store aplikasi Anda

Agar file app-ads.txt dapat di-crawl, Anda harus mencantumkan domain atau subdomain yang baru dibuat di listingan aplikasi Anda di Google Play atau App Store.

Perbarui URL Pemasaran di listingan app store sebagai berikut:

https://PROJECT_ID.web.app

Mengonfigurasi setelan pengalihan (opsional)

Jika sudah memiliki situs dan berencana menggunakan Firebase Hosting hanya untuk menghosting file app-ads.txt, Anda dapat mengonfigurasi Firebase Hosting untuk mengalihkan halaman landing ke situs yang ada.

Firebase Hosting akan menggunakan public/index.html sebagai halaman landing secara default saat pengguna mengunjungi situs Anda. Untuk mengalihkan pengguna ke situs yang diinginkan (misalnya, halaman media sosial aplikasi Anda):

  1. Buka file firebase.json yang terletak di root direktori project lokal Anda.

  2. Pada objek hosting, tambahkan objek pengalihan sebagai berikut:

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

    Misalnya, jika URL halaman landing adalah https://www.example.com, konfigurasi pengalihan adalah sebagai berikut:

    "hosting": {
      ...
      "redirects": [
        {
          "source": "/",
          "destination": "https://www.example.com",
          "type": 301
        }
      ]
    }
    
  3. Jalankan perintah berikut untuk men-deploy perubahan ke situs Anda.

    firebase deploy --only hosting
  4. Setelah deployment selesai, akses situs Anda (https://PROJECT_ID.web.app) untuk memeriksa apakah setelan pengalihan sudah benar atau belum.

Resource