Autoryzowani sprzedawcy dla aplikacji (plik app-ads.txt)

Authorized Sellers for Apps, czyli app-ads.txt, to projekt IAB, który pomaga chronić zasoby reklamowe w aplikacjach przed oszustwami reklamowymi. Pliki app-ads.txt tworzysz, by określać, kto jest upoważniony do sprzedaży Twoich zasobów reklamowych. Identyfikacja autoryzowanych sprzedawców może Ci pomóc w utrzymaniu środków od reklamodawców, które w przeciwnym razie mogłyby trafiać do twórców sfałszowanych zasobów w aplikacjach udających Twoje oprogramowanie.

Pliki app-ads.txt są dostępne publicznie i możliwe do indeksowania przez giełdy reklam, platformy dostawców reklam, innych kupujących i dostawców zewnętrznych.

Korzystanie z pliku app-ads.txt nie jest obowiązkowe, ale bardzo zalecane, zwłaszcza wtedy, gdy obawiasz się, że inne osoby mogą publikować aplikacje udające Twoje oprogramowanie.

Plik app-ads.txt to plik tekstowy, który deweloper aplikacji publikuje w domenie głównej witryny dewelopera aplikacji. Zawiera listę podmiotów upoważnionych do sprzedaży zasobów reklamowych tego wydawcy. Aby korzystać z pliku app-ads.txt, wydawcy muszą mieć domenę internetową, w której opublikują listę autoryzowanych sprzedawców, aby różni dostawcy technologii reklamowych mogli ją przeszukiwać. Istnieje wiele rozwiązań hostingu domen, które umożliwiają dowolne hostowanie plików, w tym Firebase.

Wymagania wstępne

Konfigurowanie pliku app-ads.txt pod kątem aplikacji

  1. Jeśli nie masz jeszcze utworzonego pliku tekstowego, utwórz go i zapisz pod nazwą „app-ads.txt”.

  2. Skopiuj ten fragment kodu i wklej go w pliku app-ads.txt. (Zastąp pub-00000000000000 swoim identyfikatorem wydawcy. Identyfikator wydawcy znajdziesz w konsoli AdMob > Ustawienia).

    google.com, pub-00000000000000, DIRECT, f08c47fec0942fa0

  3. Opublikuj plik app-ads.txt w domenie głównej swojej witryny dewelopera (np.https://example.com/app-ads.txt). Sprawdź, czy wpisana domena jest identyczna z domeną podaną w sklepie Google Play.

  4. Indeksowanie i weryfikacja pliku app-ads.txt w AdMob może potrwać co najmniej 24 godziny.

  5. Wróć do AdMob i sprawdź stan pliku app-ads.txt.

Publikowanie pliku app-ads.txt za pomocą Hostingu Firebase

Jeśli masz witrynę (np. utworzoną i przechowywaną na serwerze usługi generowania witryn), która nie zezwala na przesłanie pliku app-ads.txt na poziomie głównym, do hostowania tego pliku możesz użyć Hostingu Firebase.

Firebase to bezpłatny, szybki i niezawodny sposób hostowania pliku app-ads.txt we własnej domenie niestandardowej lub w bezpłatnych subdomenach projektu Firebase: web.app i firebaseapp.com.

Zanim zaczniesz

Aby opublikować plik app-ads.txt za pomocą Hostingu Firebase, musisz mieć projekt Firebase. Jeśli nie masz projektu Firebase, utwórz nowy, korzystając z przewodnika dla deweloperów.

Jeśli aplikacje w AdMob zostały już połączone z Firebase lub aplikacja korzysta z jednej z usług Firebase (np. Google Analytics dla Firebase, Zdalna konfiguracja itp.), możesz użyć istniejącego projektu Firebase.

Instalowanie wiersza poleceń Firebase

Wiersz poleceń Firebase możesz zainstalować za pomocą npm (Node Package Manager). Jeśli jednak nie znasz Node.js, możesz zamiast tego użyć samodzielnego pliku binarnego.

Aby dowiedzieć się, jak zainstalować wiersz poleceń lub zaktualizować go do najnowszej wersji, zapoznaj się z dokumentacją wiersza poleceń Firebase.

Inicjowanie projektu

Aby zainicjować projekt Firebase na komputerze lokalnym, uruchom to polecenie w katalogu głównym projektu.

firebase init

Podczas inicjowania projektu w wierszu poleceń Firebase:

  1. Wybierz, aby skonfigurować hosting.

  2. Wybierz projekt Firebase, który chcesz połączyć z lokalnym katalogiem projektu.

    Kliknij Użyj istniejącego projektu, a potem wybierz z listy projekt, który chcesz połączyć.

  3. Określ katalog, który ma być głównym katalogiem publicznym.

    Naciśnij Enter, aby wybrać domyślny (publiczny).

  4. Wybierz konfigurację witryny.

    Ponieważ witryna, którą chcesz utworzyć, nie jest aplikacją jednostronicową, wybierz N.

Po zakończeniu inicjowania Firebase tworzy i dodaje 2 pliki do katalogu głównego lokalnego projektu:

  • public katalog zawierający pliki hostowane w Twojej witrynie.
  • firebase.json plik konfiguracji, który zawiera konfigurację projektu;
  • Plik .firebaserc, w którym jest przechowywany alias projektu.

Publikowanie pliku app-ads.txt

Aby opublikować plik app-ads.txt w swojej witrynie:

  1. Umieść plik app-ads.txt w katalogu public w katalogu projektu lokalnego.

  2. Uruchom to polecenie w katalogu głównym projektu lokalnego:

    firebase deploy --only hosting

  3. Po zakończeniu wdrażania otwórz ten adres URL, aby sprawdzić, czy plik app-ads.txt został opublikowany. (PROJECT_ID to identyfikator Twojego projektu Firebase).

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

    Przykład: jeśli identyfikator projektu to „awesome-project”, wpisz https://awesome-project.web.app/app-ads.txt na pasku adresu przeglądarki.

Dodawanie domeny lub subdomeny do informacji o aplikacji

Aby Twój plik app-ads.txt mógł zostać zindeksowany, musisz podać nowo utworzoną domenę lub subdomenę w informacjach o aplikacji w Google Play.

Zaktualizuj witrynę dewelopera w informacjach o aplikacji w sklepie z aplikacjami w ten sposób:

https://PROJECT_ID.web.app

Konfigurowanie ustawień przekierowania (opcjonalnie)

Jeśli masz już witrynę i planujesz używać Hostingu Firebase tylko do hostowania pliku app-ads.txt, możesz skonfigurować Hosting Firebase tak, aby przekierowywał stronę docelową do Twojej dotychczasowej witryny.

Gdy użytkownik odwiedzi Twoją witrynę, Hosting Firebase domyślnie użyje strony public/index.html jako strony docelowej. Aby przekierować użytkowników do wybranej witryny (np. strony aplikacji w mediach społecznościowych):

  1. Otwórz plik firebase.json znajdujący się w katalogu głównym lokalnego projektu.

  2. W obiekcie hostingu dodaj obiekt przekierowań w ten sposób:

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

    Jeśli na przykład adres URL strony docelowej to https://www.example.com, konfiguracja przekierowania będzie wyglądać tak:

    "hosting": {
  ...
  "redirects": [
    {
      "source": "/",
      "destination": "https://www.example.com",
      "type": 301
    }
  ]
}

  3. Aby wdrożyć zmiany w witrynie, uruchom to polecenie.

    firebase deploy --only hosting

  4. Po zakończeniu wdrażania otwórz witrynę (https://PROJECT_ID.web.app), aby sprawdzić, czy ustawienie przekierowania jest prawidłowe.

Zasoby