Հայտարարությունների ներմուծում

Ներմուծումը հարմար է մեծ թվով առաջարկներ ունեցող ընկերությունների համար՝ ապրանքներ, անշարժ գույքի օբյեկտներ կամ ծառայություններ։ Դուք ձեր կայքում տեղադրում եք ամբողջ կատալոգը պարունակող ֆայլ, իսկ մեր կայքը այն ներբեռնում է մոտավորապես ժամը մեկ անգամ և դրա հիման վրա ստեղծում, թարմացնում ու ցուցադրությունից հանում ձեր հայտարարությունները։ Յուրաքանչյուր հայտարարություն ձեռքով տեղադրել և խմբագրել անհրաժեշտ չէ։ Միացումը և ներբեռնումներն անվճար են։

Նման ֆայլը կոչվում է ֆիդ։ Դրա ձևաչափը YML է՝ XML ֆայլ, որը շատ ինտերնետ-խանութներ և CMS համակարգեր կարող են արտահանել։

Ֆիդը պատրաստելու է ծրագրավորողը կամ AI գործակալը՞ Փոխանցեք նրան հրահանգները AI գործակալի և ծրագրավորողի համար (ռուսերեն)։ Դրանցում ներկայացված են ֆայլի բոլոր պահանջները, հարցերը, որոնք կատարողը պետք է տա ձեզ, և ստուգման ցանկը։ AI գործակալին (օրինակ՝ ChatGPT, Claude կամ Cursor) բավական է այդ ֆայլը կցել առաջադրանքին։ Եթե ֆիդը պատրաստելու մարդ չկա, գրեք մեզ հետադարձ կապի ձևի միջոցով։

Ինչպես միացնել ներմուծումը

Պատրաստեք ֆիդը այս հոդվածի պահանջներին համապատասխան և տեղադրեք այն մշտական հասցեով, օրինակ՝ https://ձեր-կայք.am/export/catalog.xml։ Հասցեն պետք է բացվի զննարկիչում՝ առանց գաղտնաբառի։
Պահպանեք հղումը։ Մուտք գործեք կայք և անձնական սենյակում բացեք «Հայտարարությունների ներմուծում» բաժինը։ Մուտքագրեք ֆիդի հասցեն և սեղմեք «Պահպանել հղումը»։
Հաստատեք կայքը։ «Կայքի հաստատում» բլոկում կհայտնվի partner-verification-….txt տեսքի անուն ունեցող ֆայլ։ Ներբեռնեք այն «Ներբեռնել ֆայլը» կոճակով և տեղադրեք ֆիդի shop/url տարրում նշված կայքի արմատում։ Ֆայլը պետք է բացվի https://ձեր-կայք.am/partner-verification-….txt հասցեով։ Այսպես մենք համոզվում ենք, որ ֆիդը հրապարակում է կայքի սեփականատերը։
Ստուգեք ֆիդը։ Սեղմեք «Ստուգել ֆիդը»։ Սովորաբար մի քանի րոպեից «Ֆիդի վերջին ստուգումը» բլոկում կհայտնվի հաշվետվություն։ Ստուգումը ոչինչ չի հրապարակում՝ այն փնտրում է ֆայլի սխալները, ստուգում հաստատման ֆայլը և ներբեռնում ձեր կատեգորիաների ցանկը։ Ուղղեք սխալները և կրկին ստուգեք ֆիդը՝ կրկնակի ստուգումը հասանելի է 2 րոպեից։
Ընտրեք բաժիններն ու տարածքը։ «Կատեգորիաներ և տարածք» բլոկում ֆիդի յուրաքանչյուր կատեգորիայի համար ընտրեք մեր կայքի բաժինը կամ «Չներմուծել»։ Նշեք երկիրը, մարզը և քաղաքը՝ դրանք կգործեն բոլոր հայտարարությունների համար։ Սեղմեք «Պահպանել կարգավորումները»։
Ընտրեք կոնտակտները։ «Կոնտակտները հայտարարություններում» բլոկում նշեք, թե ինչ ցուցադրել հայտարարություններում՝ անուն, էլեկտրոնային փոստ, հեռախոս, Telegram, լրացուցիչ կոնտակտներ։ Անձամբ տվյալները վերցվում են պրոֆիլից և փոխվում «Իմ անձնական տեղեկությունը» բաժնում։ Նշեք տարածման համաձայնությունը և սեղմեք «Պահպանել կոնտակտները»։
Ընդունեք պայմանները։ «Հայտարարությունների ներմուծման պայմաններ» բլոկում կարդացեք պայմանները և սեղմեք «Ընդունում եմ հայտարարությունների ներմուծման պայմանները»։
Ուղարկեք հայտը։ «Հայտ ինքնաշխատ ներմուծման համար» բլոկում սեղմեք «Ուղարկել հայտը»։ Եթե ինչ-որ բան պատրաստ չէ, սենյակը կցուցադրի, թե կոնկրետ ինչ։ Ադմինիստրատորի կողմից հայտի հաստատումից հետո առաջին ներբեռնումը կկատարվի մեկ ժամվա ընթացքում, այնուհետև կայքը ֆիդը կներբեռնի ինքնուրույն։

Ֆայլի պահանջները

Ֆայլում միշտ լինում է ամբողջ ընթացիկ կատալոգը, ոչ միայն փոփոխությունները։ Ֆայլի նոր տարբերակում բացակայող առաջարկը հանվում է ցուցադրությունից։
Ձևաչափը՝ 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 նշան։ Նկարագրությունը պարտադիր է։
Առանց հղումների, էլեկտրոնային փոստի հասցեների և հեռախոսահամարների՝ կոնտակտները կայքը ինքը կավելացնի հայտարարությանը։ 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 օրից հետո ներմուծումը կդադարի, իսկ հայտարարությունները կջնջվեն։

Հենց ֆայլը կրկին ընդունվի, հայտարարությունները կվերադառնան կայք։

Հայտարարությունների կառավարում

Ներմուծված հայտարարությունները հնարավոր չէ խմբագրել և ջնջել կայքում. «Խմբագրել»-ի փոխարեն նրանց մոտ գրված է «Կառավարվում է ֆիդով»։ Տվյալները փոխեք ֆիդում։
Ձեր հայտարարությունների ցանկում հասանելի են «Կասեցնել ցուցադրումը» և «Փակել հայտարարությունը» (տեղափոխում արխիվ) գործողությունները։ Առաջարկի ֆիդ վերադարձը չի չեղարկում այդ գործողությունները։
«Հայտարարությունների ներմուծում» բաժնում կարելի է դադարեցնել ներմուծումը, թաքցնել բոլոր հայտարարությունները, փոխել ֆիդի հասցեն կամ դադարեցնել ներմուծումը՝ ջնջելով բոլոր հայտարարությունները։

Ներմուծման աշխատանքի պայմանները ներկայացված են Հայտարարությունների ներմուծման պայմաններ փաստաթղթում։ Հարցեր տվեք հետադարձ կապի ձևի միջոցով։

Այսօր 16:05-ին