Akakçe to największa turecka porównywarka cen, uruchomiona w 2000 roku. Zamiast sprzedawać produkty bezpośrednio, agreguje oferty tysięcy tureckich sprzedawców detalicznych, dzięki czemu kupujący mogą porównać ceny, stany magazynowe i reputację sprzedawcy tego samego produktu przed kliknięciem i zakupem. W przypadku sprzedawców, Akakçe działa w modelu płatności za kliknięcie: Twoja oferta jest bezpłatna, ale płacisz tylko wtedy, gdy kupujący kliknie link do Twojego sklepu, co sprawia, że jakość danych w pliku danych (dokładne ceny, pasujące tytuły, aktualny stan magazynowy) jest bezpośrednio powiązana z tym, ile z tych wydatków przekłada się na sprzedaż, a nie na odrzucenie.
Akakçe to jedno z najbardziej intencjonalnych źródeł ruchu w tureckim e-commerce: klienci przychodzą na stronę porównując ceny konkretnego produktu, a nie przeglądając go pobieżnie, więc kliknięcie jest bliskie decyzji o zakupie. Ten zamiar jest realizowany tylko wtedy, gdy to, co klient widzi w Akakçe, pokrywa się z tym, co znajduje na Twojej stronie. Cena wyświetlana jako dostępna, która w rzeczywistości jest niedostępna, lub cena różniąca się od ceny na stronie finalizacji zamówienia, powoduje usunięcie oferty lub zmarnowanie kliknięcia. Połączenie kanału danych przez Feedance zapewnia automatyczną synchronizację cen i stanów magazynowych w miarę ich zmian w sklepie, zamiast polegać na okresowym ręcznym eksporcie, który jest już nieaktualny w momencie ponownego indeksowania przez Akakçe.
Akakçe rozlicza się na podstawie kosztu kliknięcia (CPC): wyświetlanie się w wynikach porównania cen w Akakçe jest bezpłatne, a płacisz tylko wtedy, gdy klient kliknie z Akakçe na stronę produktu. Ponieważ rozliczanie odbywa się za kliknięcie, niezależnie od tego, czy dojdzie do konwersji, dokładność pliku danych ma tutaj bezpośredni wymiar kosztowy, którego nie ma w kanałach rozliczanych za wyświetlenie — kliknięcie produktu, którego faktycznie nie ma w magazynie lub którego cena nie zgadza się z ceną na stronie płatności, to pieniądze wydane na klienta, którego i tak miałeś stracić.
Akakçe samo pobiera dane o produktach — niczego im nie przesyłasz. Publikujesz pojedynczy plik XML pod kontrolowanym przez siebie adresem URL, a serwery Akakçe żądają tego adresu URL w ustalonych przez siebie odstępach czasu. Każdy produkt, który chcesz umieścić w ofercie, oraz każda zmiana ceny, stanu magazynowego lub oferty muszą znaleźć odzwierciedlenie w tym samym pliku, ponieważ publikowanie i anulowanie publikacji produktów odbywa się tylko na podstawie informacji aktualnie znajdujących się w kanale.
Plik musi być zakodowany w formacie XML UTF-8 z <products> element główny zawierający jeden <product> element na element. Akakçe dokładnie dokumentuje, które adresy IP będą żądać adresu URL Twojego kanału — jeśli Twój serwer lub zapora sieciowa ograniczają dostęp przez IP, te adresy muszą być dozwolone, w przeciwnym razie kanał po prostu nigdy nie zostanie pobrany:
| Żądanie adresu IP |
|---|
| 85.105.26.146 |
| 178.251.45.163 |
| 178.251.45.210 |
| 185.67.125.150 |
Poza modelem pobierania za pomocą adresu URL nie udokumentowano żadnych ograniczeń co do rozmiaru pliku, alternatywnej metody dostarczania (FTP/API) ani formatu kompresji, więc najbezpieczniejszym podejściem jest dostarczanie zwykłego, nieskompresowanego pliku XML pod dowolnym podanym adresem URL, chyba że zespół Akakçe przekazał Ci bezpośrednio inne informacje.
Schemat XML Akakçe ma 9 pól wymaganych i 8 opcjonalnych. Poniższa tabela dokładnie odzwierciedla nazwy pól Akakçe, dzięki czemu są one mapowane jeden do jednego na tagi w Twoim kanale.
| Pole | Wymagane | Format: | Przykład | Komentarz |
|---|---|---|---|---|
sku | Tak | ciąg | 404718 | Twój własny, unikalny kod produktu, numeryczny lub alfanumeryczny |
name | Tak | ciąg, maks. 200 znaków | Braun Series 1 150s-1 Şarjlı Tıraş Makinesi | |
url | Tak | ciąg, maks. 255 znaków | https://www.site.com/product_404718.html | |
imgUrl | Tak | ciąg, maks. 255 znaków, min. 250 pikseli | https://img.site.com/404718.jpg | |
price | Tak | dziesiętny, XXXX.XX | 109.69 | Cena z VAT, płatność jednorazowa w TL |
shipPrice | Tak | dziesiętny, XX.XX | 7.90 (0.00 jeśli za darmo) | |
dayOfDelivery | Tak | liczba całkowita | 3 (0 = tego samego dnia) | Dni robocze na wysyłkę |
expressDeliveryTime | Tylko w tym samym dniu | liczba całkowita, tylko godzina, format 24-godzinny | 16 | Wymagane zawsze, gdy dayOfDelivery jest 0 |
productBrand | Tak | ciąg, maks. 60 znaków | Brązowy | |
productCategory | Tak | ciąg | Elektronik > Telefon > Cep Telefonu | Pełna ścieżka nawigacyjna (oddzielona znakiem „>”) lub nazwa kategorii |
additionalimages | Nie | nested <imgUrl> tagi | do 5 | |
description | Nie | ciąg, dozwolony HTML | zawinięte w CDATA | Musi być w środku <![CDATA[...]]> |
distributor | Nie | boolean | prawda / fałsz / pusty | prawda = dystrybutor gwarantowany, fałsz = import równoległy, pusty = nieznany |
quantity | Nie | liczba całkowita | 12 (0 = brak w magazynie) | |
barcode | Nie | ciąg | 4210201616641 | EAN-13 lub UPC, tylko wydane przez producenta |
localDelivery | Nie | ciąg rozdzielony przecinkami | 34,6,35 | Kody tablic rejestracyjnych miast, bez zera na początku — tylko w przypadku dostaw regionalnych własną flotą |
campaignCode | Nie | ciąg, maks. 16 znaków | 3A2O | Maksymalnie 1 na produkt |
Feedance mapuje istniejący katalog produktów bezpośrednio na nazwy pól Akakçe, dzięki czemu nie musisz ręcznie tworzyć szablonu XML od podstaw.
name, url, imgUrl, price, shipPrice, productBrand oraz productCategory Tagi. Dwa mapowania wymagają szczególnej uwagi w przypadku Akakçe: productCategory powinien zawierać pełną ścieżkę nawigacyjną kategorii („Elektronik > Telefon > Cep Telefonu”), a nie tylko nazwę liścia i dowolny kod HTML description jest automatycznie zawijany <![CDATA[...]]> aby kanał nie został przerwany w parserze Akakçe.Własne serwery Akakçe decydują, kiedy ponownie pobrać Twój kanał — specyfikacja nie zobowiązuje do stałego interwału, co oznacza, że nie kontrolujesz, jak szybko zmiana dociera do Akakçe, a jedynie to, czy jest już aktualna pod Twoim adresem URL w momencie jej ponownego pobrania. Z tego powodu publikowany plik powinien odzwierciedlać aktualną cenę. shipPrice oraz quantity ciągły, a nie eksport zbiorczy odświeżany raz dziennie: niezgodność ceny między Twoim plikiem a kwotą, którą kupujący faktycznie płaci przy kasie, to właśnie ten rodzaj niespójności, który naraża ofertę na ryzyko. quantity do 0 moment, w którym coś się wyprzeda, ma tutaj większe znaczenie niż na kanałach, w których sam sobie wysyłasz aktualizacje, ponieważ Akakçe nie ma żadnego innego sygnału, że cena akcji się zmieniła, dopóki nie odczyta ponownie twojego pliku.
| Błąd | Prawdopodobna przyczyna | Fix |
|---|---|---|
| Produkt nie jest wyświetlany | Brakuje wymaganego pola lub jest ono puste dla tego produktu | Potwierdzać sku, name, url, imgUrl, price, shipPrice, dayOfDelivery, productBrand oraz productCategory są zaludnione dla każdego , nie tylko próbka |
| Oferta oznaczona z powodu ceny | price nie wysłano XXXX.XX format lub nie obejmuje podatku VAT | Wyślij cenę TL z uwzględnieniem podatku VAT w formie jednorazowej płatności, dokładnie taką, jaką pobrano przy kasie, w formacie: XXXX.XX |
| Dostawa tego samego dnia nie jest widoczna | dayOfDelivery jest 0, ale expressDeliveryTime jest pusty | expressDeliveryTime jest wymagane zawsze, gdy dayOfDelivery wynosi 0 — wyślij godzinę odcięcia w formacie 24-godzinnym |
| Opis jest uszkodzony lub nie można przeanalizować kanału | HTML w description wysłane bez opakowania CDATA | Zawiń całą treść opisu w <![CDATA[...]]>, zwłaszcza jeśli zawiera znaczniki HTML |
| Obraz odrzucony lub oferta wygląda na uszkodzoną | imgUrl poniżej minimalnej wartości 250px lub adres URL przekracza 255 znaków | Wyświetlaj obrazy o rozmiarze 250 pikseli lub większym i utrzymuj adres URL w granicach 255 znaków |
| Produkt trafił do niewłaściwej kategorii | productCategory wysłane jako pojedyncze słowo zamiast pełnej ścieżki | Wyślij cały ślad chleba oddzielony znakiem ">" (np. "Elektronik > Telefon > Cep Telefonu") |
| Pasza w ogóle nie jest pobierana | Serwer lub zapora sieciowa blokująca adresy IP żądań Akakçe | Zezwól na dostęp do adresu URL Twojego kanału dla adresów 85.105.26.146, 178.251.45.163, 178.251.45.210 i 185.67.125.150 |
| Informacje o dostawie regionalnej zignorowano | localDelivery wysłane w celu uzyskania produktu, który nie został faktycznie dostarczony przez Twoją własną flotę lub kody tablic rejestracyjnych z wiodącym zerem | Tylko zaludniaj localDelivery w przypadku prawdziwej dostawy regionalnej własną flotą, kody tablic rozdzielone przecinkami, bez zera na początku |
Wyślij pełną ścieżkę nawigacyjną kategorii, a nie tylko jej nazwę. Udokumentowany przykład autorstwa Akakçe to „Elektronik > Telefon > Cep Telefonu” — pełna ścieżka daje Akakçe więcej kontekstu do prawidłowego umiejscowienia produktu niż samo „Cep Telefonu”.
Zastosowanie quantity, nie usuwaj produktu po prostu. Oprawa quantity Wartość 0 to udokumentowany sposób sygnalizowania braku towaru w magazynie; całkowite usunięcie produktu z kanału informacyjnego oznacza, że Akakçe nie będzie miało danych do ponownej aktywacji w przyszłości.
Utrzymuj uczciwą i aktualną cenę i cenę wysyłki. Ponieważ Akakçe działa według własnego harmonogramu, a nie reaguje na napływ klientów, każda różnica między ceną w Twoim kanale a rzeczywistą kwotą, którą klient faktycznie płaci, jest niedopasowaniem, które Akakçe w końcu wychwyci.
Jeśli posiadasz kod kreskowy producenta, podaj go. barcode jest opcjonalny, ale prawdziwy kod EAN-13 lub UPC daje firmie Akakçe silniejszy sygnał, pozwalający dopasować Twoją ofertę do właściwego produktu, zamiast tworzyć duplikat.
Dodaj dodatkowe obrazy za pomocą additionalimages. Do pięciu dodatkowych <imgUrl> wpisy są obsługiwane — w przypadku kategorii, które kupujący porównują wizualnie, jest to sygnał zaufania, którego nie daje pojedynczy obraz główny.
Opakuj CDATA prawidłowo i tylko tam, gdzie jest to konieczne. Jeśli wysyłasz HTML w description, to musi być w środku <![CDATA[...]]> — nieprawidłowo sformatowany plik CDATA to częsty powód, dla którego kanał nie może zostać w ogóle przeanalizowany.
Czy Akakçe obsługuje formaty inne niż XML?
Nie — udokumentowany system kanałów Akakçe składa się wyłącznie z pliku XML, pojedynczego pliku z <products> korzeń i jeden <product> element na pozycję.
W jaki sposób Akakçe pobiera mój kanał?
Publikujesz go pod adresem URL, a serwery Akakçe żądają tego adresu URL w ustalonych przez siebie odstępach czasu — nie wysyłasz do nich aktualizacji. Zmiany zaczną obowiązywać dopiero, gdy Akakçe ponownie odczyta Twój plik.
Co mam wysłać, jeśli produktu nie ma w magazynie?
Wyślij quantity jako 0. Całkowite usunięcie produktu oznacza, że Akakçe traci swój zapis dotyczący tej oferty.
Czy wymagana jest określona ilość towaru?
Nie, quantity jest opcjonalny — ale jeśli go śledzisz, 0 to wartość, jakiej Akakçe spodziewa się, że zostanie zasygnalizowana o braku towaru w magazynie.
Co się stanie, jeśli cena w moim kanale nie będzie odpowiadała cenie w kasie?
W dokumentacji Akakçe podano, że firma zastrzega sobie prawo do całkowitego niepublikowania produktów z kanału — niezgodność cen to właśnie ten rodzaj nieścisłości, który naraża ofertę na ryzyko.
Czy muszę podać kod kreskowy?
Nie, barcode jest opcjonalne i należy wysyłać wyłącznie kody EAN-13 lub UPC wydane przez producenta, nigdy kody wygenerowane samodzielnie.
Czy Akakçe obsługuje dostawę tego samego dnia?
Tak — ustaw dayOfDelivery do 0 w przypadku wysyłki tego samego dnia, należy również wysłać expressDeliveryTime z godziną odcięcia w formacie 24-godzinnym.