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

Authorized Sellers for Apps (plik app-ads.txt) to projekt IAB, który pomaga chronić zasoby reklamowe w aplikacjach przed oszustwami reklamowymi. Pliki app-ads.txt tworzysz, aby 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 (SSP), innych kupujących i dostawców zewnętrznych.

Korzystanie z pliku app-ads.txt nie jest obowiązkowe, ale zdecydowanie 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. Zawiera listę podmiotów upoważnionych do sprzedaży zasobów reklamowych tego wydawcy. Aby używać pliku app-ads.txt, wydawcy muszą mieć domenę internetową, w której mogą opublikować listę autoryzowanych sprzedawców, aby mogli ją zindeksować różni dostawcy technologii reklamowych. Istnieje wiele rozwiązań do hostowania domen, które umożliwiają dowolne hostowanie plików, w tym Firebase.

Wymagania wstępne

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

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

  2. Skopiuj ten fragment kodu i wklej go w pliku app-ads.txt. (Zastąp pub-00000000000000 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, do której masz uprawnienia dewelopera (np. https://example.com/app-ads.txt). Sprawdź, czy wpisana domena jest identyczna z domeną podaną w App Store.

  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 jeszcze projektu Firebase, utwórz nowy, postępując zgodnie z przewodnikiem dla programistów.

Jeśli aplikacje AdMob są już połączone z Firebase lub Twoja aplikacja korzysta z jednego 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 (menedżera pakietów Node). Jeśli jednak nie znasz Node.js, możesz użyć samodzielnego pliku binarnego.

Więcej informacji o instalowaniu wiersza poleceń Firebase lub aktualizowaniu go do najnowszej wersji znajdziesz w dokumentacji wiersza poleceń Firebase.

Inicjowanie projektu

Aby zainicjować projekt Firebase na komputerze lokalnym, uruchom podane niżej polecenie w katalogu głównym katalogu 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 następnie wybierz projekt z listy, który chcesz połączyć.

  3. Podaj katalog, który ma być używany jako publiczny katalog główny.

    Naciśnij Enter, aby wybrać domyślną (publiczną).

  4. Wybierz konfigurację witryny.

    Witryna, którą chcesz utworzyć, nie jest aplikacją jednostronicową, więc wybierz Nie.

Pod koniec inicjalizacji Firebase tworzy 2 pliki i dodaje je do katalogu głównego lokalnego katalogu projektu:

  • Katalog public zawierający pliki hostowane w Twojej witrynie.
  • Plik konfiguracji firebase.json zawierający konfigurację projektu.
  • Plik .firebaserc, który przechowuje alias projektu.

Publikowanie pliku app-ads.txt

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

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

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

    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 identyfikatorem projektu jest „superprojekt”, wpisz https://awesome-project.web.app/app-ads.txt na pasku adresu przeglądarki.

Dodawanie domeny lub jej poddomeny do informacji o aplikacji w Sklepie

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

Zaktualizuj marketingowy adres URL na stronie aplikacji 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 istniejącej witryny.

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

  1. Otwórz plik firebase.json w katalogu głównym lokalnego katalogu projektu.

  2. W sekcji obiektu hostującego dodaj obiekt przekierowań w ten sposób:

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

    Jeśli np. 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 na stronie, 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