Użyj API CJ aby zyskać kody promocyjne | VIVnetworks.com Sp. z o.o.
+48 537 673 915 (Poniedziałek - Piątek: 8:30–17:30)
VIVnetworksVIVnetworks

Użyj API CJ aby zyskać kody promocyjne

cj api

Jakiś czas temu mogliście w artykule Jak znaleźć kupony promocyjne doszukać się sklepów w sieci affiliate CJ. Nawiązując do tej możliwości chcielibyśmy poniżej ukazać sposoby uzyskania kodów promocyjnych poprzez API CJ.

Jakiś czas temu mogliście w artykule Jak znaleźć kupony promocyjne dowiedzieć się, w jaki sposób wyszukiwać kuponów promocyjnych z poziomu konta na CJ.com. Nawiązując do poprzedniego artykułu, chcielibyśmy wam przedstawić kolejny sposób zyskiwania informacji o kodach promocyjnych – poprzez CJ API.

Krok pierwszy: Uzyskanie klucza aktywacyjnego

Aby uzyskać klucz aktywacyjny do CJ API, musicie zalogować się na stronie api.cj.com z użyciem swoich danych wydawcy (nazwa użytkownika i hasło) w CJ.com. Po kliknięciu na "Submit" wyświetli się klucz, który będzie jednocześnie wysłany na podany e-mail.

Krok drugi: Przygotowanie nagłówka

Nagłówek powinien brzmieć „Authorization: w tym miejscu wpisz klucz aktywacyjny”. Jeśli chcielibyście wypróbować dostęp do API już teraz, możecie użyć add-on dla Firefox Modify Headers.


 

Krok trzeci: Podanie odpowiedniego URL

W momencie, kiedy macie zapewnione użycie klucza w nagłówku, możecie przystąpić do zestawienia URL, które następnie, w ramach testu, umieścicie w przeglądarce internetowej (w przypadku użycia Modify Headers będzie to Firefox). Jego struktura jest specyficzna i przy pomocy dodawania różnych parametrów umożliwia wyfiltrowanie dokładnie tych informacji/rekordów, których szukacie.
 

W tym artkule będą nas interesować kody promocyjne reklamodawców, do programów których jesteśmy jako wydawcy zapisani. Powiedzmy, że po jednej stronie chcemy widzieć jedynie 5 rekordów i spójrzmy na „stronę” nr 2. Struktura końcowego URL wygląda w następujący sposób:

https://linksearch.api.cj.com/v2/link-search?website-id=7474903&promotion-type=coupon&advertiser-ids=joined&records-per-page=5&page-number=1

W tym miejscu zatrzymajmy się nad znaczeniem pojedynczych zastosowanych parametrów. Poprzez najechanie kursorem na konkretną część powyższego linku ukaże się pomoc.
 

  • website-id=7474903 zawiera ID konkretnej witryny w CJ
  • promotion-type=coupon wyfiltruje jedynie linki oznaczone jako kupon
  • advertiser-ids=joined wyfiltruje jedynie linki programów afiliacyjnych, do których jest przypisana dana strona WWW
  • records-per-page=5 ograniczy liczbę wyświetleń linków do 5
  • page-number=2 określa, która „strona” będzie wyświetlona
  • link-type=text link wyfiltruje jedynie linki tekstowe
  • promotion-end-date=ongoing ten parametr pokazałby jedynie kupony ważne bez ograniczenia czasowego, jednak takich nie będzie wiele, dlatego nie użyliśmy tego parametru na przykładzie

Tym samym sposobem moglibyśmy wyfiltrować także kody programów, do których nie jesteśmy zapisani (notjoined). Dotyczy to zarówno polskich jak i zagranicznych programów afiliacyjnych.

W przypadku celowania w większą liczbę programów, bez określenia liczby rekordów, na stronie pokaże się jedynie ułamek z nich. Dlatego ważne jest aby określić liczbę rekordów lub w zależności od potrzeby przejść na następną stronę za pomocą parametru page-number.

Krok czwarty: Zorientowanie się w feedzie XML

Z feedu zaczerpniecie szereg informacji o danym linku, a więc też o kuponie. Najważniejsza będzie nazwa programu (advertiser name), kategoria (category), link (clickUrl), opis (description), nazwa linku (link-name), czas ważności (promotion-start-date, promotion-end-date), sam kod promocyjny (coupon-code) i prowizja w danym programie (sale-commission).

Przykład widoczny jest na obrazku poniżej:

Wypróbujcie zyskanie kodów promocyjnych za pośrednictwem CJ API!

Szczegółowsze informacje o pojedynczych parametrach możecie uzyskać w centrum obsługi CJ – wymagane jest logowanie.

[:]

The website is operated by webon.cz