Migracja do etykiet pliku danych

Możesz użyć pola feedLabel do dodania etykiety do produktów i plików danych.

Etykiety plików danych mogą mieć ten format:

  • Wpisz ciąg znaków
  • Maksymalnie 20 znaków
  • Wielkie litery (A–Z)
  • Cyfry (0–9)
  • Myślniki (-)

feedLabel jest dostępna w tych materiałach:

Identyfikator REST

feedLabel zastępuje targetCountry w identyfikatorach REST w przypadku nowych produktów.

W przypadku nowych produktów identyfikator REST jest teraz tworzony jako online:language:feedLabel:offerId zamiast online:language:targetCountry:offerId. Nie spowoduje to zmiany identyfikatora REST istniejących produktów.

Pobieranie i wyświetlanie produktów

Pole feedLabel jest zawsze wypełnione w przypadku wszystkich zwróconych produktów.

Jeśli feedLabel jest prawidłowym kodem regionu CLDR, automatycznie wypełnimy pole targetCountry w celu zapewnienia zgodności. Jeśli feedLabel nie jest prawidłowym kodem ze standardowego repozytorium danych (Common Locale Data Repository, CLDR) związanym z ustawieniami regionalnymi, pozostawiamy pole targetCountry puste.

Te same zmiany dotyczą punktów końcowych productstatuses.

Pola dotyczące konkretnego kraju są puste w przypadku ofert z wartością feedLabel, która nie jest kodem regionu CLDR.

Wstawianie i aktualizowanie produktów

Aby wstawić nowe produkty, wymagana jest właściwość feedLabel lub targetCountry. Jeśli wstawiasz lub aktualizujesz produkty za pomocą atrybutów feedLabel i targetCountry, ich wartości muszą być zgodne.

Jeśli oba pola są puste lub ich wartości nie pasują do siebie, interfejs API zwraca błąd.

Więcej informacji znajdziesz w artykule Używanie etykiet plików danych do reklamowania produktów z określonych plików danych.

Kierowanie na kraj

Aby mieć pewność, że Twoje produkty są kierowane na odpowiednie kraje, wykonaj jedną z tych czynności:

Produkty

Pole targetCountry w przypadku products zostało wycofane. Zamiast tego użyj pola shipping, aby określić kraje docelowe.

Jeśli chcesz kierować reklamy na wiele krajów, możesz nadal używać symbolu shipping, aby dodawać kolejne kraje.

Więcej informacji znajdziesz w artykule Kierowanie reklam na wiele krajów.

Pliki danych

Możesz teraz sprawdzić, na które kraje datafeed kieruje reklamy w targets. Dotyczy to sytuacji, gdy w konfiguracji datafeedtarget zamiast country używasz feedLabel.

Dodaliśmy też pole targetCountries dla datafeeds, dzięki czemu możesz bezpośrednio skonfigurować kierowanie na datafeeds. Nadal możesz konfigurować kierowanie poza plikiem danych, np. ustawiając atrybut shipping zasobu produktów.

Konwersja z UK na GB

Obecnie zezwalamy na wartość UK w polu targetCountry, mimo że nie jest to prawidłowy kod kraju. Automatycznie przeliczamy UK na GB. Produkty z wartością UK w atrybucie targetCountry są przechowywane z wartością GB w identyfikatorze REST i offerId.

Jeśli ustawisz UK jako wartość feedLabel, nie zostanie ona automatycznie przekonwertowana na GB. UK i GB to różne ciągi znaków dla feedLabel, które utworzą różne oferty.

Jeśli wstawisz targetCountry o wartości UK, a my przekonwertujemy go na GB, musisz zaktualizować identyfikator REST produktu, aby zawierał GB zamiast UK, aby pobrać produkt za pomocą metody get.