Tworzenie plików ads.txt i app-ads.txt w usłudze Ad Manager

Z tego artykułu dowiesz się, jak tworzyć pliki ads.txt i app-ads.txt oraz jak nimi zarządzać w usłudze Google Ad Manager. Plik ads.txt określa sprzedawców upoważnionych do sprzedaży zasobów reklamowych w witrynie. Plik app-ads.txt działa tak samo, ale w przypadku aplikacji.

Prawidłowe wdrożenie tych plików ma kluczowe znaczenie dla zapobiegania utracie przychodów z powodu błędów „Nieautoryzowany sprzedawca (Ads.txt)” lub „Nieautoryzowany sprzedawca w łańcuchu dostaw”, które mogą uniemożliwiać wydawanie środków na elementy zamówienia.

W usłudze Ad Manager możesz tworzyć pliki ads.txt/app-ads.txt na potrzeby swojej sieci. Ad Manager generuje treść pliku na podstawie informacji o sprzedawcach w Twojej sieci, weryfikuje jego składnię i umożliwia wyświetlanie listy sprzedawców, którzy są uprawnieni do sprzedaży Twoich zasobów reklamowych.

Jeśli chcesz utworzyć plik ads.txt dla witryny, przejdź do sekcji Krok 1. Utwórz plik ads.txt/app-ads.txt. Jeśli chcesz utworzyć plik app-ads.txt, musisz najpierw założyć witrynę dewelopera.

Warunek wstępny utworzenia pliku app-ads.txt: załóż witrynę dewelopera

Witryna dewelopera pozwala użytkownikom uzyskać więcej informacji o Twoich aplikacjach i innych treściach. Za jej pomocą standard app-ads.txt określa też, kto jest właścicielem aplikacji. Aby Ad Manager i inne platformy reklamowe mogły potwierdzić, że jesteś właścicielem aplikacji, Twoja witryna dewelopera musi być połączona ze stroną aplikacji w Google Play lub App Store.

Nie musisz przy tym podawać pełnego adresu URL pliku app-ads.txt na stronie aplikacji w sklepie.

Jeśli dodasz lub zaktualizujesz witrynę dewelopera na stronie aplikacji, wykrycie tych zmian przez Ad Managera będzie trwało:

Sklep	Czas do wykrycia zmian
Google Play	Do 24 godzin
Apple App Store	Do 7 dni

Aby dodać witrynę dewelopera na stronie aplikacji w sklepie:

Sklep Google Play

Dodaj adres URL witryny w informacjach kontaktowych na stronie aplikacji w sklepie:

1. Zaloguj się w Konsoli Play.
2. Wybierz aplikację.
3. W menu po lewej stronie kliknij Obecność w sklepie i Ustawienia sklepu.
4. Przewiń do sekcji Dane kontaktowe w informacjach o aplikacji.
5. Dodaj adres URL witryny dewelopera.

Apple App Store

Dodaj witrynę dewelopera w polu marketingowego adresu URL na stronie z informacjami o aplikacji.

Sklepy z aplikacjami na telewizory smart TV

W przypadku niektórych sklepów z aplikacjami na telewizory smart TV (CTV) powiązanie pliku app-ads.txt z aplikacją w portalu dla deweloperów danego sklepu może nie być możliwe, ponieważ sklep ten może być niedostępny w określonych regionach. Na przykład oferta sklepów z aplikacjami na telewizory Samsung TV jest ograniczona obecnie tylko do aplikacji na Stany Zjednoczone i nie obejmują aplikacji CTV w Europie. Ad Manager będzie współpracować z kupującymi, aby zapewnić, że stanu autoryzacji pliku app-ads.txt ni będzie wymuszany w przypadku platform CTV, które obecnie nie obsługują tego procesu.

Krok 1. Utwórz plik ads.txt/app-ads.txt w usłudze Ad Manager

Jeśli masz tę samą stronę z informacjami o aplikacji zarówno na urządzeniu mobilnym z Androidem, jak i na Androidzie TV, plik app-ads.txt zostanie zastosowany na obu platformach. Zaktualizuj odpowiednio plik app-ads.txt.

1. Zaloguj się w usłudze Google Ad Manager.

2. Kliknij kolejno Administracja i Zarządzanie plikami ads.txt.

   Aby można było wyświetlić tę stronę, z Twoją siecią Ad Managera musi być połączone co najmniej jedno konto Ad Exchange, a użytkownik musi mieć przypisaną rolę z włączonym uprawnieniem „Zarządzanie plikami ads.txt”.

3. Wybierz, czy chcesz utworzyć plik na potrzeby witryny internetowej czy aplikacji.
   • Na potrzeby witryny: kliknij kartę Plik ads.txt dla witryny, a potem kliknij Utwórz plik ads.txt.
   • Na potrzeby aplikacji: kliknij kartę Plik app-ads.txt, a potem kliknij Utwórz plik ads.txt.
4. W oknie dialogowym przejrzyj tekst automatycznie wygenerowany przez Google.
   
   Każdy z wierszy przedstawia oddzielne konto sprzedawcy, które można uprawnić do sprzedaży zasobów reklamowych. Aby pominąć sprzedawcę i usunąć jego uprawnienie, w oknie dialogowym usuń wiersz zawierający jego dane.
   Dowiedz się więcej o weryfikowaniu składni plików ads.txt/app-ads.txt.
   Nasz generator plików ads.txt/app-ads.txt dostarcza tylko informacje o kontach sprzedawców współpracujących z Google. Jeśli współpracujesz z innymi platformami SSP lub giełdami, musisz samodzielnie dodać informacje o kontach sprzedawców z tych platform, by zapytania o te domeny były uznawane za uprawnione. Pamiętaj, aby podać ich domenę, swój identyfikator sprzedawcy/wydawcy oraz typ relacji (DIRECT lub RESELLER).

   Domyślnie automatycznie wygenerowane wiersze mogą zawierać wartość „DIRECT” w polu numer 3. Wskazuje ona na bezpośrednią relację z tym kontem sprzedawcy. Jeśli nie masz ani nie obsługujesz domeny, zmień tę wartość na „RESELLER”. Jeśli dla tego samego identyfikatora sprzedawcy istnieją sprzeczne wpisy (np. jeden oznaczony jako „DIRECT”, a drugi jako „RESELLER”), możesz bezpiecznie usunąć wiersz „RESELLER”, jeśli jesteś bezpośrednim właścicielem zasobów reklamowych i masz bezpośrednią relację z tym sprzedawcą.

Krok 2. Opublikuj plik ads.txt/app-ads.txt w swojej witrynie

5. Kliknij jeden z tych przycisków:
   • Skopiuj tekst do schowka, by skopiować tekst i wkleić go w pliku ads.txt/app-ads.txt.
   • Pobierz plik ads.txt, aby pobrać go jako nowy plik tekstowy (.txt).
6. Wyślij plik do swojego webmastera, by przesłał go do Twojej domeny głównej (np. https://example.com/ads.txt lub https://example.com/app-ads.txt).

Krok 3. Sprawdź, czy plik ads.txt/app-ads.txt jest zweryfikowany

7. Po 24 godzinach sprawdź, czy plik ads.txt/app-ads.txt może być indeksowany.
8. Sprawdzaj regularnie stan autoryzacji swoich domen.

Twoim obowiązkiem jest dbanie o poprawność i aktualność pliku ads.txt/app-ads.txt. My umożliwiamy weryfikację składni, ale nie możemy zapobiec przesłaniu pliku, który jest błędnie sformatowany lub zawiera niepowiązane konta.

Rozwiązywanie najczęstszych problemów

• Błędy związane z nieautoryzowanym sprzedawcą: jeśli elementy zamówienia nie generują wydatków z powodu błędów „Nieautoryzowany sprzedawca (Ads.txt)” lub „Nieautoryzowany sprzedawca w łańcuchu dostaw”, sprawdź, czy w pliku ads.txt/app-ads.txt prawidłowo zadeklarowano wszystkich autoryzowanych sprzedawców wraz z ich domeną, Twoim identyfikatorem sprzedawcy/wydawcy dla tego sprzedawcy i prawidłowym typem relacji (DIRECT lub RESELLER).
• Niekompletny łańcuch dostaw: jeśli pytania o stawkę są odfiltrowywane z powodu niekompletnego łańcucha dostaw, upewnij się, że obiekt łańcucha dostaw w pytaniu o stawkę jest kompletny i wskazuje na kompletność: 1. Specyfikacja inventorypartnerdomain w pytaniu o stawkę powinna być zadeklarowana i zgodna z wpisem w pliku ads.txt.
• Plik sellers.json: chociaż nie jest on bezpośrednio częścią pliku ads.txt, upewnij się, że plik sellers.json (w razie potrzeby często zarządzany przez giełdy, z którymi współpracujesz) jest prawidłowo skonfigurowany i dostępny, ponieważ uzupełnia plik ads.txt w zakresie przejrzystości.

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