שילוב 1C-Bitrix עם אביטו: הזנת XML, API ואוטומציה

שילוב 1C-Bitrix עם Avito

אנו נתקלים באופן קבוע במצבים שבהם חנות מקוונת על 1C-Bitrix כבר פעילה, אך הכניסה ל-Avito מתעכבת עקב אי-התאמת פורמטים ומורכבות המודרציה. Avito אינה שוק מקוון קלאסי אלא לוח מודעות עם אלמנטים של שוק מקוון. זה קובע את ייחודיות השילוב: מוצרים מועלים כמודעות דרך עדכון XML (Avito Autoload), והניהול מתבצע דרך החשבון האישי או REST API. האתגר המרכזי הוא שלכל קטגוריה ב-Avito יש סט שדות וכללי מודרציה משלה, השונים מכל שוק מקוון אחר.

הניסיון שלנו מראה ששילוב מוגדר כראוי מחזיר את ההשקעה בתוך החודשים הראשונים על ידי אוטומציה של פעולות שגרתיות. אנו מבטיחים טיפול נכון בשדות הקטגוריה ועמידה בכל דרישות Avito.

שני ערוצי שילוב

1. Avito Autoload (עדכון XML). השיטה העיקרית להעלאה המונית. המוכר מציב קובץ XML על השרת שלו ומציין את ה-URL בהגדרות Avito: כלים מקצועיים → העלאה אוטומטית. Avito מנתח את העדכון בלוח זמנים (כל כמה שעות).

2. Avito API (https://api.avito.ru/). REST API לניהול מודעות, סטטיסטיקות, הודעות. הרשאה דרך OAuth 2.0 (client_id + client_secret → access_token).

לשילוב עם 1C-Bitrix, אנו בדרך כלל משתמשים בשילוב: עדכון להעלאת קטלוג + API לניטור סטטוס ואוטומציה.

פורמט עדכון Avito Autoload

לעדכון ה-XML של Avito יש סכמה משלו, שאינה תואמת ל-YML:

<Ads formatVersion="3" target="Avito.ru">
  <Ad>
    <Id>уникальный_id</Id>
    <Category>Бытовая электроника</Category>
    <AdType>Товар приобретён на продажу</AdType>
    <Title>Смартфон Samsung Galaxy S24</Title>
    <Description>Текст описания</Description>
    <Price>79990</Price>
    <Images>
      <Image url="https://site.ru/photo1.jpg"/>
      <Image url="https://site.ru/photo2.jpg"/>
    </Images>
    <Address>Москва, ул. Примерная, 1</Address>
    <ContactMethod>По телефону и в сообщениях</ContactMethod>
    <!-- Поля, специфичные для категории -->
    <GoodsType>Телефоны</GoodsType>
    <Brand>Samsung</Brand>
    <Model>Galaxy S24</Model>
  </Ad>
</Ads>

שדות קטגוריה הם האתגר המרכזי. עבור קטגוריית "אלקטרוניקה לצרכן", יש צורך ב-<Ads formatVersion="3" target="Avito.ru"> <Ad> <Id>уникальный_id</Id> <Category>Бытовая электроника</Category> <AdType>Товар приобретён на продажу</AdType> <Title>Смартфон Samsung Galaxy S24</Title> <Description>Текст описания</Description> <Price>79990</Price> <Images> <Image url="https://site.ru/photo1.jpg"/> <Image url="https://site.ru/photo2.jpg"/> </Images> <Address>Москва, ул. Примерная, 1</Address> <ContactMethod>По телефону и в сообщениях</ContactMethod> <!-- Поля, специфичные для категории --> <GoodsType>Телефоны</GoodsType> <Brand>Samsung</Brand> <Model>Galaxy S24</Model> </Ad> </Ads> , GoodsType, Brand. עבור "ביגוד" — Model, Size, Gender. עבור "חלקי רכב" — ClothingType, OEMPartNumber, Brand. הרשימה המלאה של קטגוריות ושדות זמינה בתיעוד Avito Autoload.

יצירת העדכון מבלוק המידע של Bitrix

אין פרופיל ייצוא סטנדרטי ל-Avito ב-Bitrix. יישום: סקריפט PHP מותאם אישית — קובץ PartType, המופעל על ידי cron או נגיש דרך URL. לוגיקה:

1. קבלת אלמנטים של בלוק מידע דרך /local/avito_feed.php עם מסנני פעילות ומלאי.
2. עבור כל אלמנט, קביעת הקטגוריה ב-Avito. המיפוי מאוחסן במאפיין אלמנט נפרד (CIBlockElement::GetList()) או בטבלת מיפוי של סעיף בלוק מידע → קטגוריית Avito.
3. בהתאם לקטגוריה, יצירת סט תגים ספציפי.
4. הרכבת XML וכתיבה לקובץ.

מיפוי שדות:

בעיה עם <Address>. Avito מזהה מודעה לפי <Id>. אם ה-ID משתנה (לדוגמה, במהלך אינדוקס מחדש של קטלוג ב-Bitrix), Avito תיצור מודעה חדשה ותמחק את הישנה. צפיות, סטטיסטיקות וביקורות אובדות. השתמש במק"ט או בקוד חיצוני (<Id>), לא במספר ה-ID האלמנטרי.

בעיה עם XML_ID. Avito מקשרת מודעה לכתובת. הכתובת בעדכון חייבת להתאים בדיוק לאחת מהכתובות שצוינו בפרופיל המוכר. אי-התאמה מובילה לדחיית המודעה.

כיצד להגדיר עדכון XML ל-Avito ללא שגיאות?

בעת הגדרת העדכון, חשוב לספק מיפוי קטגוריות ושדות עבור כל קבוצת מוצרים. אם הקטלוג שלך מכיל 2000 מוצרים והמודרציה אורכת בממוצע שעתיים, עיבוד ידני הופך לבלתי אפשרי. אנו הופכים תהליך זה לאוטומטי באמצעות טבלאות מיפוי מותאמות אישית.

Avito API: ניהול ואוטומציה

ה-API משמש למשימות שהעדכון אינו מכסה:

• קבלת סטטיסטיקות מודעות. <Address> — צפיות, שיחות, הודעות. ניתן לשמור נתונים במאפיין משתמש של בלוק מידע לניתוח ביצועים.
• ניהול מודעות. GET /core/v1/items/{item_id}/stats — עדכון שדות ללא טעינת העדכון מחדש.
• קבלת הודעות. PUT /core/v1/items/{item_id} — אוטומציה של תשובות או העברה ל-CRM של Bitrix24.
• הפעלה/השבתה. כאשר מוצר נגמר, השבת את המודעה דרך API מהר יותר מאשר המתנה לעדכון.

טיפול ב-SKU

Avito אינה תומכת בווריאציות מוצר בתוך מודעה אחת. כל SKU (מידה, צבע) הוא מודעה נפרדת. עבור חנות מקוונת עם טבלת מידות, זה אומר:

• חולצת טי S, M, L, XL — 4 מודעות בעדכון.
• לכל אחת GET /messenger/v3/accounts/{user_id}/chats ייחודי (לדוגמה, <Id>).
• לכל אחת מידה מצוינת בכותרת או בתיאור.

בעת יצירת העדכון, אנו עוברים על בלוק המידע של SKU ויוצרים ARTICLE_SIZE נפרד עבור כל הצעה עם מלאי שאינו אפס. זה מגדיל משמעותית את גודל העדכון — עבור קטלוג של 1000 מוצרים עם 4 מידות, מדובר ב-4000 מודעות.

מגבלות ומודרציה

Avito מגבילה את מספר המודעות: המגבלה החינמית תלויה בקטגוריה (בדרך כלל 1–5), ולאחר מכן חבילות מודעות בתשלום. עבור חנויות מקוונות, תעריף "לעסקים" מספק מגבלות מוגדלות.

המודרציה של כל מודעה אורכת 1–24 שעות. סיבות דחייה נפוצות: כפילויות (תמונות או תיאורים זהים), פריטים אסורים, אי-התאמת קטגוריה, תיאור ספאמי.

מה כוללת עבודת השילוב?

• ביקורת על הקטלוג הנוכחי ומבנה ה-SKU ב-1C-Bitrix.
• פיתוח מודול יצירת עדכון XML עם מיפוי קטגוריות ושדות.
• הגדרת ייצוא תמונות וטיפול בשגיאות.
• חיבור Avito API לניטור ואוטומציה (אופציונלי).
• בדיקת העדכון בחשבון Avito לבדיקה, תיקון בעיות.
• תיעוד התהליך והדרכת צוות.
• תמיכה לאחר ההשקה למשך חודש.

ציר זמן לשילוב

אם אתה צריך שילוב 1C-Bitrix עם Avito במפתח מלא, צור קשר — אנו נעריך את הפרויקט שלך ונכין הצעה מסחרית. בעבודתנו, אנו משתמשים בפתרונות מוסמכים ומבטיחים עמידה בכל דרישות Avito.