Czym jest API reklamy produktowej Amazon?

Będąc uczestnikiem programu Partnerzy Amazon musisz mieć łatwy dostęp do istotnych informacji na temat produktów sprzedawanych w serwisie Amazon.

Czytając ten artykuł:

• Dowiesz się, czym jest API reklamy produktowej Amazon – wyjaśnimy to na przykładzie
• Uzyskasz podstawowe informacje na temat działania API reklamy produktowej – Operacji Grup odpowiedzi i Węzłów przeglądania
• Poznasz funkcje API reklamy produktowej
• Dowiesz się, jak uzyskać dostęp do swoich danych uwierzytelniających
• Dowiesz się, w jaki sposób złożyć żądanie za pomocą funkcji Scratchpad API reklamy produktowej

API reklamy produktowej to proste w użyciu i skuteczne narzędzie, za pomocą którego można uzyskać dostęp do danych na temat produktów sprzedanych za pośrednictwem serwisu Amazon. Za jego pomocą możesz sprawdzić dostępność i ceny produktu, recenzje klientów, recenzje sprzedawców i wiele więcej.

API reklamy produktowej pozwala Ci także znajdować konkretne produkty i wyświetlać recenzje klientów na swojej stronie; poza tym ułatwia Ci dostęp do ostatnich promocji produktów i wiele więcej.

Mówiąc najprościej, API reklamy produktowej jest Twoim kluczem do dostępu do rozległych baz danych serwisu Amazon, dzięki któremu możesz udostępniać i promować odpowiednie produkty, i zarabiać więcej na swoich wysiłkach związanych z marketingiem atrakcyjnym w ramach programu Amazon.

Zanim jednak z niego skorzystasz, musisz zrozumieć, czym jest, dlaczego go potrzebujesz i jak go używać.

Czym jest API reklamy produktowej Amazon?

API reklamy produktowej Amazon to darmowe narzędzie dostępne dla partnerów Amazon. Pomaga ono wyszukiwać, znajdować, wyświetlać i udostępniać konkretne produkty dostępne w serwisie Amazon oraz kierować do nich ruch.

Narzędzie to pomaga afiliacyjnym stronom, aplikacjom i blogom w przyjazny dla użytkownika sposób radzić sobie z ogromem produktów dostępnych w serwisie Amazon.

Dlaczego warto korzystać z API reklamy produktowej – przykład

Wyobraź sobie że jesteś właścicielem strony poświęconej pieczeniu o nazwie EatCake.com, na której entuzjastyczni użytkownicy dzielą się przepisami, dyskutują i polecają sobie najlepsze narzędzia i akcesoria do pieczenia.

Być może kilku tych swoich użytkowników po przeczytaniu rekomendacji i sugestii innych użytkowników przejdzie na stronę Amazon.de polecanych przez nich narzędzi i kupi je.

Jeśli ten ruch płynie z Twojej strony do serwisu Amazon, możesz go monetyzować – jeśli Twoi czytelnicy kupują produkty rekomendowane na Twojej stronie, Amazon zapłaci Ci prowizję. Jednak, aby tak się stało musisz dodać na swojej stronie odpowiednie linki.

Problem polega na tym, że Twoja strona jest bardzo popularna i każdego dnia użytkownicy omawiają na niej tuziny produktów, a Tobie trudno kontrolować, jakie z nich dokładnie zostały wspomniane.
W takich właśnie sytuacjach z pomocą przychodzi Ci API reklamy produktowej.

Podstawowe informacje na temat działania API reklamy produktowej

Podstawowe zadania, jakie możesz zlecić swojemu API to tzw. operacje. Oto kilka przykładów:

• ItemSearch – wyszukiwanie konkretnego produktu lub grup produktów w oparciu o parametry takie jak kategoria, producent, nazwa, cena minimalna i td. Ta funkcja może prowadzić do wykazania jednego lub więcej produktów.
• ItemLookup – wyszukiwanie konkretnego produktu z wykorzystaniem identyfikatora takiego jak na przykład numer ISBN (dla książek) lub numer ASIN (Amazon Standard Identification Number, czyli wyjątkowy kod przypisywany wszystkim produktom w sklepie). Ta funkcja prowadzi do wykazania jednego produktu
• SimilarityLookup – wyszukiwanie produktów podobnych do tego, który wspomniałeś w poleceniu dla API.
• CartCreate – tworzenie zdalnego koszyka zakupów w serwisie Amazon.
• CartAdd – dodawanie konkretnych przedmiotów do zdalnego koszyka zakupów.

Grupy odpowiedzi – możesz dostosowywać informacje, które chcesz uwzględnić w danej. Umożliwia to skrócenie czasu żądania połączenia przy jednoczesnym zmniejszeniu używanej przepustowości. Musisz jednak pamiętać, że grupy odpowiedzi, których możesz użyć, zależą od operacji, którą zawarłeś w API. Nie wszystkie grupy odpowiedzi są dostępne dla wszystkich operacji.

Oto kilka często wybieranych grup odpowiedzi:

• Small (mała) – ta grupa wykazuje najbardziej podstawowe informacje na temat produktu takie jak numer ASIN, grupa i nazwa produktu.
• Reviews (Recenzje) – ta grupa wykazuje adres URL iFrame z recenzjami klientów na temat poszukiwanego produktu.
• OfferSummary (Podsumowanie oferty) – ta grupa wykazuje najniższą cenę produktu dla każdego stanu produktu (nowego, używanego, odnowionego i dla przedmiotów kolekcjonerskich).
• ItemAttributes – ta grupa wykazuje wszystkie atrybuty konkretnego produktu, a ich konkretna liczba zależy od produktu. Na przykład smartfon będzie miał inny zestaw atrybutów niż książka. Niemniej niektóre atrybuty, takie jak cena katalogowa lub nazwa, są wspólne dla wszystkich produktów.

Węzły przeglądania – z tej metody serwis Amazon korzysta, aby klasyfikować i grupować produkty. Jak można się domyślić, węzeł może mieć dzieci, które z kolei mogą mieć własne dzieci i tak dalej.

Jeśli nie chcesz zbytnio konkretyzować wyszukiwania produktów, możesz określić tylko podstawowe węzły, jako wartość indeksu wyszukiwania. Jeśli wolisz jednak zawęzić obszar wyszukiwania, wówczas zamiast określać podstawowy węzeł, możesz sprecyzować węzeł dziecka albo wręcz wnuka.

Na przykład: zamiast wybrać “książki”, możesz zdecydować się na “książki autorów hinduskich”. Wówczas “książki” stanowią podstawowy węzeł, “literatura piękna” węzeł dziecka, a “książki autorów hinduskich” węzeł wnuka. Listę wszystkich węzłów wyszukiwania i odpowiadających im numerów identyfikacyjnych możesz znaleźć tutaj.

Funkcje API reklamy produktowej

Możesz skonfigurować dla swojej witryny skrypt, który będzie uruchamiany za każdym razem, gdy zostanie wymienione narzędzie do pieczenia. Gdy w witrynie pojawią się odpowiednie słowa kluczowe, wystarczy wywołać API wyszukiwania.

Wywołanie API musi zawierać następujące informacje:

• Musisz określić sklep Amazon (Amazon.co.uk, Amazon.com, Amazon.de, etc.), w którym chcesz szukać produktu. Może możesz wysłać żądanie reklamy produktowej do jakikolwiek lokalizacji, na jakimkolwiek rynku, na którym jesteś zarejestrowany jako partner Amazon. Najrozsądniej będzie, jeśli to żądanie będzie dotyczyło rynku, na którym kupuje większość Twoich klientów. Na przykład: jeśli większość Twoich czytelników mieszka w Niemczech, rozsądnie będzie określić ustawienia regionalne jako Amazon.de
• AWSAccessKeyId – to klucz dostępu, jaki generujesz, aby wywołać API I wydać konkretne żądanie.
• AssociateTag – Wszyscy partnerzy Amazon muszą mieć swój indywidualny tag. Użytkownicy którzy przechodzą na stronę serwisu Amazon z Twojej strony będą oznaczeni tym tagiem. Amazon korzysta z tego oznaczenia, aby zakwalifikować pochodzenie ruchu i wypłacić Ci odpowiednią prowizję.
• Słowa kluczowe (Keywords) odnoszą się do słów kluczowych opisujących produkty, których szukasz.
• Operacja (Operation) – to, co API planuje zrobić, na przykład ItemSearch, dodawanie do koszyka zakupów, wyszukiwanie za pomocą węzłów (BrowseNodeLookup) i tak dalej.
• ResponseGroup, czyli Grupa odpowiedzi odnosi się to do szczegółów, które chcesz pobrać na temat konkretnych produktów. Domyślną jest opcja Duża (Large), która mówi serwisowi Amazon, aby zawarł wszystkie szczegóły dotyczące produktu. Aby skrócić czas połączenia i wykorzystanie przepustowości warto rozważyć jej optymalizację.
• SearchIndex – określa kategorię, pod którą chcesz szukać produktów i pomaga odfiltrowywać nieistotne wyniki
• Timestamp – oznacza moment uruchomienia API reklamy produktowej.
• Signature – to klucz skrótu, który otrzymujesz po wydaniu żądania API. Służy on do sprawdzania poprawności.
  Pokazanie odpowiednich linków produktowych ułatwi Twoim użytkownikom szybkie odnalezienie produktu w serwisie Amazon. Gdy Twój użytkownik po kliknięciu na link produktowy zakupi produkt, Ty dostaniesz prowizję!

Pokazanie odpowiednich linków produktowych ułatwi Twoim użytkownikom szybkie odnalezienie produktu w serwisie Amazon. Gdy Twój użytkownik po kliknięciu na link produktowy zakupi produkt, Ty dostaniesz prowizję!

Uzyskiwanie dostępu do danych uwierzytelniających

Aby złożyć żądanie API reklamy produktowej potrzebujesz następujących trzech elementów:

• klucza dostępu (Access key)
• tajnego klucza (Secret key)
• Twojego partnerskiego numeru identyfikacyjnego (Affiliate ID)

Oto kroki, które pomogą Ci zacząć:

1. Zapisz się do konta partnerzy Amazon (jeśli jeszcze tego nie zrobiłeś). Zostaniesz poproszony o wprowadzenie kilku szczegółów dotyczących Twojej strony, bloga lub aplikacji oraz informacji o produktach, które promujesz. Następnym krokiem będzie weryfikacja Twojego numeru telefonu. Gdy to zrobisz, otrzymasz Twój wyjątkowy partnerski numer identyfikacyjny (Affiliate ID).

2. Po zalogowaniu do konta partnera Amazon kliknij na Narzędzia i wybierz API reklamy produktowej, a następnie wybierz Dołącz.

3. Po dołączeniu kliknij Pobierz dane uwierzytelniające. Zobaczysz swój Klucz dostępu i Tajny klucz. Możesz je skopiować lub pobrać. Będziesz ich potrzebować do składania żądań API reklamy produktowej.

4. Aby usunąć istniejące dane uwierzytelniające i stworzyć nową parę kliknij na Zarządzaj swoim kontem i wybierz Dodaj dane uwierzytelniające. Amazon pozwala na posiadanie maksymalnie dwóch par kluczy dostępu jednocześnie. Możesz usunąć istniejącą parę Korzystając z opcji Usuń.

Składanie żądanie za pomocą Scratchpad API reklamy produktowej

Żądanie ma na celu wywołanie określonego działania API reklamy produktowej. Możesz na przykład zażądać dostępu do informacji na temat konkretnego produktu lub całej kategorii produktów, a API przedstawi Ci zdjęcia produktu, ceny, recenzje klientów i wiele więcej.

Żądanie wysyłasz przez internet wykorzystując protokoły REST (Representational State Transfer) lub SOAP (Simple Object Access Protocol). API reklamy produktowej podaję Ci odpowiedzi w formie dokumentu XML/HTML.

W jaki sposób złożyć żądanie za pomocą Scratchpad API reklamy produktowej?

Scratchpad API reklamy produktowej to darmowe narzędzie umożliwiające partnerom Amazon składanie żądań API reklamy produktowej. Dzięki niemu możesz w ciągu kilku minut stworzyć kod żądania.

• Przejdź do Scratchpad API reklamy produktowej.
• W lewym panelu wybierz operację którą chcesz przeprowadzić (na przykład ItemSearch).
• W polu Wspólne parametry podaj następujące informacje:
• Lokalizację rynku (Marketplace locale)
• Tag partnera (Amazon Associate Tag)
• Klucz dostępu (Access Key)
• Tajny klucz (Secret Key)

4. Następnie wybierz Parametry żądania. Na przykład wpisując “mikser” w parametrze określającym słowa kluczowe, a w indeksie wyszukiwania wpisz „Narzędzia kuchenne” i td.
5. Kliknij Wyślij żądanie.

Jeśli odpowiednio złożyłeś żądanie API, zobaczysz wyświetlone następujące informacje:

• Podpisany adres URL żądania i niepodpisany adres URL żądania
• Odpowiedź w różnych formatach i odpowiadających im blokach kodu. Odpowiedź pojawia się w trzech formatach:
• Dostarczona odpowiedź (Rendered Response) – w ten sposób odpowiedź pojawi się na Twojej stronie, w formie obrazów produktu i linków produktowe
• XML odpowiedzi
• HTML odpowiedzi.

Aby wysłać nowe żądanie wyczyść wszystkie parametry i powtórz kolejne kroki od początku.

Jak widać API reklamy produktowej pomaga skutecznie dodawać odpowiednie linki produktowe do Twojej strony i monetyzować generowany przez nią ruch. Aby lepiej zrozumieć, jak to działa, warto najpierw “pobawić się” nieco narzędziem Scratchpad.