Migracja do etykiet pliku danych

Chcielibyśmy przedstawić wersję beta Merchant API. To nowa wersja Content API for Shopping i przyszłość.

Aby dowiedzieć się, jak interfejs Merchant API może ulepszyć integrację i pomóc kształtować przyszłość, zapoznaj się z artykułem Ogłoszenie wersji beta interfejsu Merchant API.

Za pomocą pola feedLabel możesz dodać etykietę do produktów i plików danych.

Etykiety pliku danych mogą mieć ten format:

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

Narzędzie feedLabel jest dostępne w tych zasobach:

• products
• datafeeds
• datafeedstatuses

Identyfikator REST

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

Dla nowych produktów identyfikator REST zamiast online:language:targetCountry:offerId ma teraz postać online:language:feedLabel:offerId. Nie zmieni to identyfikatora REST istniejących produktów.

Pobierz i wyświetlaj produkty

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

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

Ostrzeżenie: uzupełnianie wartości targetCountry nie umożliwia wyświetlania Twoich produktów w podanym kraju. Sprawdź, czy wszystkie kraje, na które chcesz kierować reklamy, są podane w polu shipping.

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

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

Wstawianie i aktualizowanie produktów

Do wstawienia nowych produktów wymagana jest właściwość feedLabel lub targetCountry. Jeśli umieszczasz lub aktualizujesz 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 nie są zgodne, interfejs API zwróci 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 kierujesz swoje produkty na właściwe kraje, skorzystaj z jednego z poniższych rozwiązań:

• shipping zasobu products
• targetCountries zasobu datafeeds

Produkty

Pole targetCountry dla typu products zostało wycofane. Zamiast tego do określania krajów docelowych użyj pola shipping.

Jeśli chcesz kierować reklamy na wiele krajów, możesz nadal dodawać kolejne kraje za pomocą opcji shipping.

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

Pliki danych

W targets możesz teraz zobaczyć, na które kraje jest kierowana jasna datafeed. Ma to zastosowanie, gdy w konfiguracji datafeedtarget używasz parametru feedLabel zamiast country.

W przypadku elementu datafeeds dodaliśmy też pole targetCountries, dzięki czemu możesz skonfigurować kierowanie bezpośrednio na tę kategorię danych (datafeeds). Nadal możesz konfigurować kierowanie poza plikiem danych, np. ustawiając atrybut shipping zasobu „produkty”.

Konwersja z Wielkiej Brytanii na GB

Obecnie w polu targetCountry dopuszczamy wartość UK, mimo że nie jest to prawidłowy kod kraju. Automatycznie konwertujemy UK na GB. Produkty, których targetCountry ma wartość UK, są przechowywane za pomocą atrybutu 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 w przypadku feedLabel i tworzą różne oferty.

Jeśli wstawisz targetCountry właściwoś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.