Migracja do etykiet pliku danych

W polu feedLabel możesz dodać etykietę do produktów i plików danych.

Etykiety pliku danych mogą mieć taki format:

  • Wpisz ciąg znaków
  • Ma maksymalnie 20 znaków
  • Wielkie litery (A–Z)
  • Cyfry (0–9)
  • Kreski (-)

feedLabel jest dostępny w tych zasobach:

Identyfikator REST

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

Zamiast online:language:targetCountry:offerId identyfikator REST ma teraz postać online:language:feedLabel:offerId dla nowych produktów. Nie zmieni to identyfikatora REST Twoich dotychczasowych produktów.

Pobieranie i wyświetlanie produktów

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

Jeśli feedLabel jest prawidłowym kodem obszaru CLDR, automatycznie uzupełniamy pole targetCountry, aby zapewnić zgodność. Jeśli feedLabel nie jest prawidłowym kodem regionu CLDR, pole targetCountry pozostaw puste.

Te same zmiany mają zastosowanie do productstatuses punktów końcowych.

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

Wstaw i zaktualizuj produkty

Do wstawiania nowych produktów wymagana jest właściwość feedLabel lub targetCountry. Jeśli wstawisz lub zaktualizujesz produkty za pomocą atrybutów feedLabel i targetCountry, ich wartości muszą być takie same.

Jeśli oba pola są puste lub ich wartości się nie zgadzają, 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 produkty są kierowane na odpowiednie kraje, użyj jednej z tych opcji:

Produkty

Pole targetCountry dla elementu 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ć numeru shipping i dodawać kolejne kraje.

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

Pliki danych

Możesz teraz zobaczyć w targets kraje, na które kierujesz reklamy datafeed. Ma to zastosowanie, gdy w konfiguracji datafeedtarget używasz feedLabel zamiast country.

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

Konwersja z Wielkiej Brytanii na GB

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

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

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