იმპორტი განკუთვნილია იმ კომპანიებისთვის, რომლებსაც ბევრი შეთავაზება აქვთ — პროდუქტები, უძრავი ქონების ობიექტები ან მომსახურებები. თქვენ თქვენს საიტზე აქვეყნებთ მთელი კატალოგის ფაილს, ჩვენი საიტი კი მას დაახლოებით საათში ერთხელ ჩამოტვირთავს და მისი საფუძვლით ქმნის, ანახლებს და ჩვენებიდან შლის თქვენს განცხადებებს. თითოეული განცხადების ხელით გამოქვეყნება და რედაქტირება არ არის საჭირო. დაკავშირება და ჩამოტვირთვები უფასოა.

ასეთ ფაილს ფიდი ეწოდება. მისი ფორმატია YML: XML ფაილი, რომლის ექსპორტიც ბევრ ინტერნეტ-მაღაზიას და CMS სისტემას შეუძლია.

შინაარსი

• როგორ დავაკავშიროთ იმპორტი
• ფაილის მოთხოვნები
• რა მონაცემებს იღებს საიტი ფაილიდან
• სათაური და აღწერა
• ფასი, ვალუტა და ფოტოები
• როგორ განვაახლოთ და ამოვიღოთ შეთავაზებები
• შეცდომები და ანგარიშები
• თუ ფაილის ჩამოტვირთვა შეწყდა
• განცხადებების მართვა

როგორ დავაკავშიროთ იმპორტი

1. მოამზადეთ ფიდი ამ სტატიის მოთხოვნების შესაბამისად და განათავსეთ მუდმივ მისამართზე, მაგალითად https://თქვენი-საიტი.ge/export/catalog.xml. მისამართი ბრაუზერში პაროლის გარეშე უნდა იღებოდეს.
2. შეინახეთ ბმული. შედით საიტზე და პირად კაბინეტში გახსენით „განცხადებების იმპორტი“ განყოფილება. ჩაწერეთ ფიდის მისამართი და დააჭირეთ „ბმულის შენახვას“.
3. გადაამოწმეთ საიტი. „საიტის გადამოწმების“ ბლოკში გამოჩნდება partner-verification-….txt სახის სახელის მქონე ფაილი. ჩამოტვირთეთ ის „ფაილის ჩამოტვირთვის“ ღილაკით და მოათავსეთ ფიდის shop/url ელემენტში მითითებული საიტის ძირში. ფაილი უნდა იღებოდეს მისამართზე https://თქვენი-საიტი.ge/partner-verification-….txt. ასე ვამოწმებთ, რომ ფიდს საიტის მფლობელი აქვეყნებს.
4. შეამოწმეთ ფიდი. დააჭირეთ „ფიდის შემოწმებას“. როგორც წესი, რამდენიმე წუთში „ფიდის ბოლო შემოწმების“ ბლოკში გამოჩნდება ანგარიში. შემოწმება არაფერს აქვეყნებს: ის ეძებს ფაილის შეცდომებს, ამოწმებს გადამოწმების ფაილს და ჩამოტვირთავს თქვენი კატეგორიების სიას. გაასწორეთ შეცდომები და ფიდი ხელახლა შეამოწმეთ — განმეორებითი შემოწმება 2 წუთშია ხელმისაწვდომი.
5. აირჩიეთ განყოფილებები და ტერიტორია. „კატეგორიები და ტერიტორიის“ ბლოკში ფიდის თითოეული კატეგორიისთვის აირჩიეთ ჩვენი საიტის განყოფილება ან „არ შემოიტანოთ“. მიუთითეთ ქვეყანა, რეგიონი და ქალაქი: ისინი ყველა განცხადებაზე გავრცელდება. დააჭირეთ „პარამეტრების შენახვას“.
6. აირჩიეთ კონტაქტები. „კონტაქტები განცხადებებში“ ბლოკში მონიშნეთ, რა უნდა გამოჩნდეს განცხადებებში: სახელი, email, ტელეფონი, Telegram, დამატებითი კონტაქტები. თავად მონაცემები პროფილიდან მოდის და იცვლება „ჩემი პირადი ინფორმაციის“ განყოფილებაში. მონიშნეთ გავრცელებაზე თანხმობა და დააჭირეთ „კონტაქტების შენახვას“.
7. მიიღეთ პირობები. „განცხადებების იმპორტის პირობების“ ბლოკში წაიკითხეთ პირობები და დააჭირეთ „ვიღებ განცხადებების იმპორტის პირობებს“.
8. გაგზავნეთ განაცხადი. „განაცხადი ავტომატურ იმპორტზე“ ბლოკში დააჭირეთ „განაცხადის გაგზავნას“. თუ რამე მზად არ არის, კაბინეტი გაჩვენებთ, კონკრეტულად რა. ადმინისტრატორის მიერ განაცხადის დამტკიცების შემდეგ პირველი ჩამოტვირთვა ერთ საათში განხორციელდება, შემდეგ კი საიტი ფიდს თავად ჩამოტვირთავს.

ფაილის მოთხოვნები

• ფაილი ყოველთვის შეიცავს მთელ მიმდინარე კატალოგს და არა მხოლოდ ცვლილებებს. ფაილის ახალ ვერსიაში არმყოფი შეთავაზება ჩვენებიდან იშლება.
• ფორმატია YML (XML) UTF-8 ან Windows-1251 კოდირებით. XML-ის ნაცვლად ZIP ან GZ არქივი არ შეესაბამება.
• მისამართი იწყება http:// ან https://-ით, მუშაობს სტანდარტულ პორტზე, არ საჭიროებს ლოგინსა და პაროლს და ინტერნეტიდან ხელმისაწვდომია.
• საიტი ფიდს ჩამოტვირთავს პროგრამით და არა ბრაუზერით. ბოტებისგან დაცვამ — კაპჩამ, ბრაუზერის შემოწმებამ ან IP მისამართით დაბლოკვამ — არ უნდა დაკეტოს ფიდი, გადამოწმების ფაილი და ფოტოები. მოთხოვნებს აქვს User-Agent სათაური, რომელშიც არის PartnerImport, — შეგიძლიათ ის დაცვის გამონაკლისებში დაამატოთ.
• სერვერი მთელ ფაილს აბრუნებს არაუმეტეს 60 წამში. ზომა — 50 მბ-მდე.
• შეთავაზებები — 1000-მდე, გაყიდვიდან ამოღებულების ჩათვლით. თუ მეტი გჭირდებათ, მოგვწერეთ. ლიმიტზე მეტი ფაილი მთლიანად არ მიიღება.
• კატეგორიები — 150-მდე, მშობელი და ცარიელი კატეგორიების ჩათვლით.

ფიდის მაგალითი:

<?xml version="1.0" encoding="UTF-8"?>
<yml_catalog>
  <shop>
    <url>http://partner.example/</url>
    <categories>
      <category id="10">გადამზიდავები და ჩანთები</category>
    </categories>
    <offers>
      <offer id="SKU-0042" available="true">
        <name>კატის გადამზიდავი</name>
        <url>http://partner.example/products/SKU-0042</url>
        <price>1500</price>
        <currencyId>RUB</currencyId>
        <categoryId>10</categoryId>
        <picture>http://partner.example/images/SKU-0042-main.jpg</picture>
        <picture>http://partner.example/images/SKU-0042-side.jpg</picture>
        <picture>http://partner.example/images/SKU-0042-detail.jpg</picture>
        <description>ახალი გადამზიდავი. ზომა 48 × 32 × 30 სმ. თავად წაღება.</description>
      </offer>
    </offers>
  </shop>
</yml_catalog>

ჩამოტვირთვა: ეს მაგალითი, მაგალითი ყველა მხარდაჭერილი ველით.

რა მონაცემებს იღებს საიტი ფაილიდან

shop/url — აუცილებელია

თქვენი საიტის მისამართი. მის ძირში მოთავსდება გადამოწმების ფაილი, ხოლო შეთავაზებების გვერდების ბმულები იმავე საიტზე უნდა მიდიოდეს.

category — აუცილებელია

თქვენი კატეგორიები. ატრიბუტი id არის დადებითი მთელი რიცხვი, უნიკალური ფაილში; parentId — მშობელი კატეგორიის id. კაბინეტში თითოეულ კატეგორიას ჩვენი საიტის განყოფილება ემთხვევა.

offer, ატრიბუტი id — აუცილებელია

შეთავაზების მუდმივი იდენტიფიკატორი, 80 სიმბოლომდე. მისი მეშვეობით საიტი შემდგომი ჩამოტვირთვებისას ცნობს შეთავაზებას.

offer, ატრიბუტი available — არასავალდებულო

true — ჩვენება, false — ჩვენებიდან ამოღება. ატრიბუტის გარეშე შეთავაზება ხელმისაწვდომად ითვლება.

name — აუცილებელია

განცხადების სათაური. მის ნაცვლად შეგიძლიათ შეთავაზებაში მიუთითოთ type="vendor.model" და typePrefix, vendor, model ელემენტები.

categoryId — აუცილებელია

შეთავაზების კატეგორიის id.

description — აუცილებელია

განცხადების ტექსტი. HTML დაშვებულია: საიტი შლის მარკირებას და ინახავს აბზაცებს.

price — არასავალდებულო

ფასი. ფასის გარეშე განცხადება შეთანხმებითი ფასით ქვეყნდება.

currencyId — არასავალდებულო

ფასის ვალუტა. მის გარეშე გამოიყენება რუბლი.

url — არასავალდებულო

შეთავაზების გვერდი თქვენს საიტზე. განცხადებაში ის „ვებსაიტის“ სტრიქონად ჩანს.

picture — არასავალდებულო

ფოტოები, 5-მდე. პირველი მთავარია.

YML-ის სხვა ელემენტებს — მახასიათებლებს, ფასდაკლებებს, მიტანას და სხვებს — საიტი ტოვებს და ანგარიშში გაფრთხილებად მიუთითებს. ეს შეცდომა არ არის. იმპორტის ყველა განცხადება იღებს „შეთავაზების“ ტიპს, ხოლო განყოფილებას, ტერიტორიასა და კონტაქტებს ფაილი კი არა, კაბინეტის პარამეტრები განსაზღვრავს.

სათაური და აღწერა

სათაური და აღწერა მოწმდება იმავე წესებით, როგორც ხელით გამოქვეყნებული განცხადებები. წესის დამრღვევი შეთავაზება გამოიტოვება, მიზეზი კი ანგარიშში ჩანს. ტექსტები ავტომატურად არ სწორდება და არ მოკლდება.

• სათაური — 150 სიმბოლომდე, აღწერა — 5000 სიმბოლომდე. აღწერა აუცილებელია.
• ბმულების, email მისამართებისა და ტელეფონის ნომრების გარეშე: კონტაქტებს საიტი განცხადებაში თავად დაამატებს. 7-ით ან 8-ით დაწყებული 11 ციფრის თანმიმდევრობა ტელეფონად ითვლება, თუნდაც ეს პროდუქტის კოდი იყოს.
• გამოტოვებების გარეშე 30 ან მეტი სიმბოლოსგან შემდგარი სიტყვების გარეშე: გრძელი პროდუქტის კოდები და ერთადწერილი სიტყვები გამოტოვებებით დაყავით.
• სათაურში არ არის კაბინეტში განცხადებებისთვის არჩეული ქალაქის სახელი.
• უწესრიგო ლექსიკისა და აკრძალული თემების გარეშე: ალკოჰოლი, თამბაქო, იარაღი, რეცეპტით გაცემული მედიკამენტები, აზარტული თამაშები, კრედიტები და სესხები და სხვა.

ღილაკი „ფიდის შემოწმება“ ამ წესებს არ ამოწმებს — ამას განაცხადის დამტკიცების შემდგომი ჩამოტვირთვები ამოწმებენ. ცარიელ აღწერას და გამოტოვებულ categoryId-ს ის პოულობს: ასეთი შეთავაზებები ანგარიშში შეცდომით აისახება. ტექსტების წესების დარღვევების შესახებ პირველი ანგარიშიდან რომ არ გაიგოთ, წინასწარ შეამოწმეთ ტექსტები: AI აგენტისა და პროგრამისტისთვის განკუთვნილ ინსტრუქციაში (რუსულ ენაზე) წესები დეტალურადაა აღწერილი.

ფასი, ვალუტა და ფოტოები

• ფასი არის რიცხვი წერტილით: 1500 ან 1499.90, გამოტოვებების, მძიმეებისა და ვალუტის ნიშნის გარეშე. თანხა მთელ რიცხვამდე მრგვალდება: 1499.50 ხდება 1500. თუ ფასი არ არის, ცარიელია ან 0-ის ტოლია, განცხადებაში იქნება „შეთანხმებითი“.
• ვალუტა — RUB (ან RUR), USD, EUR, AMD, KZT, GEL, BYN, UAH, AZN, KGS, RSD. ფასი კურსით არ გადაიანგარიშება.
• ფოტოები — JPEG, PNG ან WebP, თითოეული 15 მბ-მდე. საიტი picture-ის პირველ 5 ბმულს იღებს.
• საიტი ფოტოს ბმულით იმახსოვრებს. ფოტოს შესაცვლელად შეცვალეთ ბმული — მაგალითად, ფაილის სახელი. ძველ ბმულზე ახალ ფაილს საიტი ვერ შენიშნავს.
• თუ ფოტო ვერ ჩამოიტვირთა, განცხადება მაინც ქვეყნდება, საიტი კი დაახლოებით ერთი დღის შემდეგ კვლავ სცდის.

როგორ განვაახლოთ და ამოვიღოთ შეთავაზებები

• თუ ფასი, ტექსტი ან ფოტოები შეიცვალა, შეინახეთ წინა id. საიტი განაახლებს იმავე განცხადებას, მისი მისამართი და გამოქვეყნების თარიღი კი შენარჩუნდება.
• არ შეცვალოთ არსებული შეთავაზებების id და გაყიდვიდან ამოღებული პროდუქტის id სხვა პროდუქტს არ მიანჭოთ. ახალი id ახალი განცხადებაა, ძველი კი ჩვენებიდან ამოიღება. რეგისტრი მნიშვნელოვანია: SKU-42 და sku-42 განსხვავებული შეთავაზებებია.
• შეთავაზების ამოსაღებად მიუთითეთ available="false" ან ამოიღეთ ის ფაილიდან. განცხადება დაიმალება და 180 დღე შეინახება: თუ შეთავაზება იმავე id-ით დაბრუნდება, წინა განცხადებაც დაბრუნდება. 180 დღის შემდეგ განცხადება იშლება.
• კაბინეტში კატეგორიისთვის „არ შემოიტანოთ“ არჩევა მის ყველა განცხადებას პარამეტრების შენახვისთანავე მალავს.
• შეთავაზებების ცარიელი სია <offers/> ყველა განცხადებას ჩვენებიდან შლის. თუ ფაილში offers ელემენტი საერთოდ არ არის, ფაილი დაზიანებულად ითვლება და განცხადებები არ იცვლება.
• საიტის ადმინისტრატორის წაშლილი განცხადება იმავე id-ით ხელახლა არ იქმნება.

შეცდომები და ანგარიშები

შემოწმების ანგარიში „ფიდის ბოლო შემოწმების“ ბლოკში ჩანს, ჩვეულებრივი ჩამოტვირთვის ანგარიში კი — „ბოლო ჩატვირთვის“ ბლოკში. შეტყობინებები სამი სახისაა.

• ფაილის შეცდომა — ფაილი არ მიიღება და განცხადებები არ იცვლება. მაგალითად: დაზიანებული XML, არმყოფი shop/url, ლიმიტის გადაჭარბება ან საიტის გადაუმოწმებლობა.
• შეთავაზების შეცდომა — გამოიტოვება მხოლოდ ეს შეთავაზება: ახალი განცხადება არ იქმნება, არსებული კი წინა მონაცემებს ინახავს. დანარჩენი შეთავაზებები მუშავდება, ჩამოტვირთვის შედეგი კი — „ნაწილობრივი“.
• გაფრთხილება — არ მოქმედებს გამოქვეყნებაზე. მაგალითად: ზედმეტი ელემენტები ფაილში, არმყოფი available ატრიბუტი ან ჩამოუტვირთავი ფოტო.

თუ შეცდომის გასწორება ვერ ხერხდება, ანგარიშის ტექსტი ინსტრუქციასთან ერთად გადაეცით თქვენს პროგრამისტს ან AI აგენტს — მასში თითოეული შეტყობინებისთვის მითითებულია, რა უნდა გასწორდეს.

თუ ფაილის ჩამოტვირთვა შეწყდა

სანამ ფაილი არ მიიღება — სერვერი მიუწვდომელია, ფაილში შეცდომაა ან გადამოწმების ფაილი გაქრა — განცხადებები ბოლო მიღებული ვერსიით რჩება. თუ ეს გაგრძელდება:

• 24 საათის შემდეგ მიიღებთ წერილს მიზეზის აღწერით;
• 7 დღის შემდეგ კავშირის ყველა განცხადება დაიმალება, ჩამოტვირთვები კი იშვიათდება — დღეში ერთხელ;
• 180 დღის შემდეგ იმპორტი შეწყდება, განცხადებები კი წაიშლება.

როგორც კი ფაილი კვლავ მიიღება, განცხადებები საიტს დაუბრუნდება.

განცხადებების მართვა

• იმპორტირებული განცხადებების საიტზე რედაქტირება და წაშლა შეუძლებელია: „რედაქტირების“ ნაცვლად მათთან წერია „მართავს ფიდი“. მონაცემები ფიდში შეცვალეთ.
• თქვენი განცხადებების სიაში ხელმისაწვდომია „ჩვენების შეჩერება“ და „განცხადების დახურვა“ (არქივში გადატანა). შეთავაზების ფიდში დაბრუნება ამ მოქმედებებს არ უქმდება.
• „განცხადებების იმპორტის“ განყოფილებაში შეგიძლიათ შეაჩეროთ იმპორტი, დამალოთ ყველა განცხადება, შეცვალოთ ფიდის მისამართი ან შეწყვიტოთ იმპორტი ყველა განცხადების წაშლით.

იმპორტის მუშაობის პირობები მოცემულია დოკუმენტში განცხადებების იმპორტის პირობები. შეკითხვები დასვით უკუკავშირის ფორმით.