Błąd Adgora ads.txt w Shopify: przyczyny i naprawa

Definicja: co ten błąd oznacza w Shopify

„Błędy Adgora ads.txt w sklepie Shopify” oraz podobny błąd ads.txt Shopify oznaczają, że Adgora sprawdziła Twój sklep i nie mogła odczytać pliku ads.txt w oczekiwany sposób. Zwykle wskazuje to na jedną z czterech rzeczy: plik jest brakujący, plik jest zablokowany, plik znajduje się na niewłaściwym hoście albo linia sprzedawcy Adgora nie jest widoczna w pliku.

Brzmi technicznie, ale sam problem jest prosty. Adgora chce znaleźć zwykły plik tekstowy w publicznym katalogu głównym sklepu, a jeśli Shopify serwuje tam coś innego, weryfikacja się nie udaje. Wystarczy brak jednej linii.

Można traktować ads.txt jak krótkie publiczne oświadczenie. Jedna linia może mieć większe znaczenie niż długa edycja motywu. Jeśli crawler nie potrafi dopasować domeny sklepu i oczekiwanego wpisu Adgora, platforma może oznaczyć sklep, nawet jeśli sam storefront wygląda dla klientów normalnie.

Dlatego ten błąd może wydawać się dziwny. Strona główna się ładuje, produkty się ładują, a checkout działa, a mimo to Adgora nadal oznacza sklep. Problem leży w ścieżce pliku, hoście albo dokładnym tekście.

Shopify ads.txt: jak Shopify obsługuje ten plik

Shopify obsługuje Shopify ads.txt przez własny mechanizm na poziomie sklepu, a nie przez stronę w motywie czy wpis na blogu. To ważne, bo plik tekstowy w edytorze motywu to nie to samo co publiczny plik ads.txt w katalogu głównym sklepu.

W praktyce Shopify oczekuje, że plik ads.txt będzie dostępny w katalogu głównym domeny, skąd crawlery mogą pobrać go bezpośrednio. Strona taka jak /pages/ads-txt się nie liczy, podobnie jak fragment ukryty w theme liquid, chyba że Shopify rzeczywiście publikuje plik we właściwej publicznej lokalizacji.

To rozróżnienie co tydzień sprawia ludziom kłopot. Właściciel sklepu może wkleić linię Adgora do motywu, zapisać zmiany i uznać, że sprawa jest załatwiona. Nie jest.

Shopify zwraca też uwagę na to, który host jest główny. Jeśli sklep używa własnej domeny, plik nadal musi poprawnie działać na hoście, który sprawdza Adgora, a nie tylko na adresie testowym albo alternatywnej wersji storefrontu.

Jedna drobna różnica może zmienić wynik. Jeśli plik w katalogu głównym istnieje na www, a Adgora sprawdza domenę bez www, albo odwrotnie, crawler może w ogóle nie zobaczyć linii.

Najczęstsze przyczyny błędów Adgora ads.txt w Shopify

Kilka decyzji związanych z konfiguracją Shopify wywołuje ten sam błąd. Najczęstsza to niedopasowanie domeny: sklep nie wskazuje jeszcze w pełni na domenę główną, więc Adgora sprawdza jeden host, a Shopify serwuje plik na innym.

Problemy powodują też zdublowane hosty storefrontu. Sklep może działać pod własną domeną, wersją www, a czasem także pod adresem nadanym przez Shopify podczas konfiguracji, ale tylko jeden z tych adresów powinien być hostem kanonicznym. Jeśli Adgora sprawdzi niewłaściwy, może zgłosić brak pliku ads.txt, mimo że plik istnieje gdzie indziej.

Konflikty z plikami tworzonymi przez aplikacje to kolejna przyczyna. Niektóre aplikacje lub skrypty próbują tworzyć albo nadpisywać pliki serwisu, co może zastąpić konfigurację Shopify ads.txt. Plik, który w południe wyglądał poprawnie, po południu może zniknąć.

Znaczenie ma też zachowanie przekierowań. Jeśli żądanie do /ads.txt trafia na stronę, która dziwnie przekierowuje, zwraca miękki błąd albo odsyła crawlera z dala od prawdziwego katalogu głównego sklepu, Adgora może nie zaakceptować wyniku. To nie jest problem motywu; to problem hosta i odpowiedzi serwera.

Jest też prosty przypadek niepełnej linii. Linia relacji sprzedawcy Adgora może być brakująca, niepełna albo skopiowana z błędnym identyfikatorem. Jeden znak niezgodności może wystarczyć.

Sklepy, które są w trakcie migracji, są szczególnie narażone. Podczas przenoszenia domeny stary host może nadal odpowiadać na zapytania, podczas gdy nowy host jest już aktywny dla klientów, a taki podział może zmylić sprawdzanie pliku przez Adgora.

Jak naprawić ads.txt w Shopify: najkrótsza bezpieczna ścieżka

Aby naprawić ads.txt w Shopify, zacznij od domeny głównej. Otwórz ustawienia sklepu i potwierdź, który host jest kanoniczny, bo plik musi działać tam, gdzie Adgora rzeczywiście szuka.

Następnie sprawdź, czy to Shopify publikuje plik. Nie polegaj na fragmencie motywu, stronie bloga ani ukrytym bloku treści. Plik powinien być dostępny jako tekstowy plik na poziomie katalogu głównego, a nie jako zwykła strona WWW.

Później sprawdź samą linię Adgora. Linia powinna znajdować się w publicznym pliku dokładnie tak, jak wymaga tego format, i tylko na właściwym hoście. Jeśli sklep używa własnej domeny, przetestuj zarówno wersję bez www, jak i z www, żeby wiedzieć, która z nich wskazuje na plik.

Następnie ponownie opublikuj lub jeszcze raz sprawdź storefront. Czasem aktualizacja działa od razu; czasem crawler potrzebuje czasu, żeby ponownie odwiedzić plik. Świeże crawlowanie może usunąć nieaktualne ostrzeżenie.

Jeśli błąd pozostaje po czystej weryfikacji, sprawdź aktywną odpowiedź dla pliku. Kod 200 sam w sobie nie wystarczy, jeśli treść jest błędna albo host nie jest tym, którego oczekuje Adgora.

Oto praktyczna sekwencja w jednym miejscu:

1. Potwierdź domenę główną.
2. Otwórz aktywny adres /ads.txt.
3. Sprawdź, czy plik serwuje Shopify.
4. Zweryfikuj linię Adgora.
5. Sprawdź ponownie po aktualizacji storefrontu.

Gdzie umieścić linię Adgora w sklepie Shopify

Linia Adgora, czyli wpis Adgora ads.txt Shopify, należy do publicznego pliku ads.txt w katalogu głównym domeny. To jedyne miejsce, które ma znaczenie przy weryfikacji przez crawler.

Nie umieszczaj jej wyłącznie w kodzie motywu. Nie umieszczaj jej tylko na stronie, w pozycji menu ani we wpisie blogowym. Wyszukiwarki mogą indeksować takie strony, ale walidacja ads.txt dotyczy konkretnej ścieżki pliku, a nie ogólnej treści witryny.

Jeśli sklep używa domeny bez www jako głównej, przetestuj najpierw dokładnie tę domenę. Jeśli kanoniczna jest wersja z www, przetestuj ją najpierw. Niedopasowanie między tymi dwiema wersjami może wywołać fałszywy alarm.

Dobrym nawykiem jest otwarcie pliku w przeglądarce i dokładne sprawdzenie paska adresu. Adres powinien zawierać aktywny host sklepu i /ads.txt, nic więcej. Jeden dodatkowy redirect może zafałszować wynik.

W sklepach z wieloma językami lub regionami plik ads.txt powinien pozostać na głównym hoście, który sprawdza Adgora. Francuska strona docelowa albo alternatywny podkatalog rynku nie zastępują pliku głównego.

Krótka uwaga: wielu sprzedawców ufa edytorowi motywu zbyt mocno. Motyw służy do wyglądu storefrontu. ads.txt to sprawdzenie pliku.

Przykładowe wpisy ads.txt dla sklepów Shopify

Oto prosty przykład tego, jak może wyglądać poprawny wpis Shopify ads.txt dla Adgora:

Traktuj ten przykład wyłącznie jako wzór, a nie gotową odpowiedź. Dokładna wartość wydawcy lub sprzedawcy Adgora musi zgadzać się z danymi konta.

Innym częstym błędem jest zapisanie linii bez właściwych separatorów. Brak przecinka albo uszkodzony identyfikator mogą sprawić, że wpis stanie się nieczytelny, nawet jeśli dla oka wygląda prawie dobrze.

Przykład złego formatu: linia wklejona jako zwykły tekst w akapicie na stronie głównej. To jest treść, a nie ads.txt.

Przykład złego hosta: plik istnieje na shop-name.myshopify.com, ale sklep korzysta już z własnej domeny. Adgora może sprawdzać własną domenę i nie znaleźć tam niczego.

Jeśli chcesz szerszego spojrzenia na formaty reklam wokół takiej konfiguracji, przewodnik reklamy krypto dla sklepów e-commerce pokazuje, jak ruch sklepu i sprawdzanie plików często spotykają się w tym samym punkcie operacyjnym.

Pojęcia powiązane i co sprawdzić dalej

ads.txt to publiczny plik tekstowy z listą autoryzowanych sprzedawców. To nie jest strona, nie baner i nie ukryta notatka w motywie.

Domena główna to główny host, którego Shopify używa dla sklepu. Jeśli jest ustawiona błędnie, sprawdzanie pliku może wskazywać niewłaściwe miejsce.

Host kanoniczny to wersja domeny, która powinna odpowiadać najpierw na żądanie. W sklepie Shopify może to być domena bez www albo z www, ale nie obie jednocześnie jako konkurencyjni liderzy.

Linia relacji sprzedawcy to dokładny wpis, którego oczekuje Adgora w pliku. Jeśli tej linii brakuje albo jest źle sformatowana, błąd może się utrzymywać nawet wtedy, gdy plik jest publiczny.

Crawler to bot, który pobiera plik. Nie interesują go ustawienia motywu; interesuje go adres URL, odpowiedź i tekst, który może odczytać.

Nadpisanie storefrontu zachodzi wtedy, gdy aplikacja, narzędzie synchronizacji albo krok wdrożeniowy zastępuje plik po jego naprawie. Dlatego problem może wrócić po udanej aktualizacji.

Jeśli plik jest poprawny w przeglądarce, ale Adgora nadal zgłasza problem po jednej ponownej weryfikacji, zbierz dwie rzeczy: zrzut ekranu aktywnej strony /ads.txt oraz dokładny adres URL, który testowałeś. Następnie skontaktuj się z pomocą techniczną i przekaż te informacje. Im bardziej precyzyjne dowody, tym szybsza weryfikacja.

Końcowa kontrola powinna zająć mniej niż 5 minut. Otwórz aktywny plik, potwierdź host, przeczytaj linię Adgora i przetestuj ponownie po każdej zmianie w Shopify. Jeśli plik się przesunie, błąd może przesunąć się razem z nim.

W zespołach, które prowadzą też reklamy w innych formatach, operacyjna strona ruchu sklepu jest opisana w przewodniku po opcjach targetowania w sieci reklam krypto, co przydaje się, gdy plik jest już stabilny, a sklep wrócił do normalnych kontroli.