الخلاصة هي مصدر البيانات المركزي الذي تستخدمه Google للوصول إلى المركبات وعرضها. نتيح حاليًا استخدام الخلاصات بتنسيق ملف CSV، ويمكنك اختياريًا ضغطها بتنسيقَي ZIP أو GZ.
إنشاء خلاصة
لتنسيق معلوماتك لخدمة بيانات المركبات، استخدِم التنسيق описанном в تنسيق الخلاصة والسمات المقدَّمة في مواصفات الخلاصة ومثال الخلاصة. ننصحك بالبدء ببعض المركبات الاختبارية وتقديم نموذج لملف CSV إلى أداة التحقّق للتحقّق من صحة تنسيق الخلاصة. ويمكنك لاحقًا توسيع نطاق استخدامها ليشمل كل مستودعك على Google.
احرص على تضمين التفاصيل التالية في الخلاصة لنتمكّن من مطابقة المركبات بدقة مع وكالات السيارات على Google:
- سمة مطلوبة: رمز المتجر
- لمعرفة التفاصيل، يُرجى الاطّلاع على مطابقة الوكلاء.
- مطلوبة: اسم وكالة البيع وعنوانه البريدي
- إجراء يُنصَح به: رقم تعريف المكان على Google أو عنوان URL في "خرائط Google"
- وتُحدِّد هذه الأرقام بشكلٍ فريد "الملف التجاري" للوكالة على Google، وتزيل أي غموض مقارنةً بالمطابقات التي تستخدِم الاسم والعنوان البريدي.
تنسيق الخلاصة
حمِّل خلاصتك كملفّ "قيم مفصولة بفواصل" (CSV) أو "قيم مفصولة بعلامات تبويب" (TSV). تأكَّد من استيفاء ملفك للمتطلبات التالية:
- يجب أن يكون تنسيق CSV متوافقًا مع RFC 4180:
- لا تُدرِج علامات اقتباس مزدوجة في أي مكان في الملف ما لم يتم تحويلها.
- لتجنُّب وضع علامة اقتباس مزدوجة، استخدِم علامتَي اقتباس مزدوجتَين، بالإضافة إلى إحاطة الحقل بأكمله في ملف CSV بين علامتَي اقتباس مزدوجتَين. لمزيد من التفاصيل، يُرجى الاطّلاع على المقاطع من 2.5 إلى 2.7 في RFC 4180.
- في ما يلي مثال على استخدام صالح لعلامات الاقتباس المزدوجة:
"Wheels 17"" Alloy"، والذي يظهر على النحو التالي:Wheels 17" Alloy.
- لا تُدرِج علامات اقتباس مزدوجة في أي مكان في الملف ما لم يتم تحويلها.
- يمكنك اختياريًا ضغط الملف بتنسيقات الملفات ZIP أو GZ.
- يجب أن تحتوي الخلاصة على ملف واحد. لا نسمح باستخدام عدة أجزاء من الملف، ويُعرف ذلك أيضًا باسم التجزئة.
- يجب أن يحتوي كل إصدار من الخلاصة على المستودع بالكامل لجميع وكالات بيع المركبات التي تريد عرضها على Google. بما أنّ كل ملف خلاصة يحتوي على مستودع لكل وكلاء بيع سيارتك، ليس عليك إنشاء حسابات منفصلة لكل وكيل بيع. بعد معالجة الخلاصة بنجاح، سيتم تجميع المركبات حسب وكالة البيع في صفحة بيانات التشخيص في بوابة الشركاء.
- لا نتيح إجراء تعديلات جزئية (تدريجيّة) على المستودع.
مثال على خلاصة
يمكن استخدام مثال خلاصة CSV التالي كنموذج لخلاصاتك:
store_code,id,VIN,year,make,model,trim,exterior_color,interior_color,mileage,condition,price,dealership_name,dealership_address,link,image_link,additional_image_link,vehicle_option,vehicle_fulfillment,legal_disclaimer
123,123,JA4AR3AW8GZ057772,2016,Mitsubishi,Outlander Sport,SE,Silver,Black,90377,Used,13998 USD,Dealer 123,123 Street,http://www.example.com/JA4AR3AW8GZ057772,http://www.image.com/image1,"http://www.image.com/image2, http://www.image.com/image3","Bluetooth,Rear View Camera,Front Seat Heaters,Navigation System",IN_STORE,"Price does not include taxes, fees"
تحميل الخلاصة إلى صندوق تحميل SFTP
عند الاشتراك في حساب بيانات المركبات، يتم تلقائيًا إنشاء صندوق تحميل SFTP. استخدِم معلومات بروتوكول النقل الآمن للملفات (SFTP) المقدَّمة في صفحة الخلاصة فيبوابة الشركاء لتحميل ملفات CSV.
هناك العديد من الطرق لتحميل ملف باستخدام بروتوكول SFTP. تشمل الطرق الأكثر شيوعًا استخدام سطر الأوامر (Terminal) أو استخدام برنامج SFTP. تعتمد الطريقة التي تُحقّق لك أفضل النتائج على كيفية إدارة مستودعك. ولهذا السبب، لا نقدّم تعليمات محدّدة هنا حول كيفية تصدير المركبات وتحميلها إلى خادم Google SFTP.
للحدّ من التأخيرات الناتجة عن طريقة معالجة Google لخلاصتك، ننصحك باتّباع الخطوات التالية:
- تأكَّد من أنّ خلاصتك تجتاز أداة التحقّق.
- تأكَّد من أنّ بيانات المركبة تتوافق مع مواصفات الخلاصة و سياساتنا والقيود التي نفرضها.
- أرسِل الخلاصة مرة واحدة يوميًا على الأقل.
- حمِّل المستودع بالكامل لكل وكالة بيع تريد عرضها على Google.
مراجعة نتائج معالجة الخلاصة
بعد إرسال الخلاصة، يمكنك مراجعة نتائج المعالجة. تعرض صفحة الخلاصة في بوابة الشركاء حالة كل عملية تحميل خلاصة. لا يتحقّق هذا الإجراء إلا من المشاكل الأساسية في الملفات والبيانات، مثل عدم توفّر الحقول المطلوبة أو استخدام تنسيق غير صحيح. تصبح النتائج الكاملة للمعالجة متاحة في صفحة بيانات التشخيص بعد بضع ساعات.
الاحتفاظ بخلاصتك
ننصحك بتحميل أحدث إصدار من الخلاصة كل أربع ساعات. هناك سببان رئيسيان ننصح بإعادة تحميل الخلاصة بهذه الصعوبة:
- يؤدي تحميل الخلاصات بشكلٍ متكرّر إلى زيادة حداثة البيانات بشكلٍ عام. ويؤدي ذلك إلى تقليل الوقت بين تعديل المستودع الإعلاني ووقت إرسال البيانات إلى Google.
- تتيح التحديثات المتكرّرة رصد حالات انقطاع الخدمة والتعافي منها بشكل أسرع، إذ يمكن أن تؤدي هذه الانقطاعات إلى عدم معالجة الخلاصة بنجاح.
في كل مرة تحمّل فيها الخلاصة، تأكّد من أنّها تحتوي على المستودع بالكامل لجميع الوكالات. تتم إزالة المركبات ووكلاء البيع غير المدرَجين في خلاصة في غضون بضع ساعات من Google.
بعد تحميل خلاصة إلى Google، يعتمد الوقت الذي يستغرقه تعديل البيانات على نوع التعديل. الأرقام الواردة في الجدول التالي هي تقديرات وليست مضمونة.
| تغيير في الخلاصة | الوقت المتوقّع للظهور على Google |
|---|---|
| إضافة وكالة بيع جديدة | يوم واحد |
| إزالة وكالة بيع | 6 ساعات |
| تغيير الملف التجاري لوكالة سيارات | 12 ساعة |
| إضافة سيارة أو إزالتها أو تعديلها | 6 ساعات |
الاشتراك في تنبيهات الخلاصة
يمكنك تلقّي إشعار عبر البريد الإلكتروني عندما لا تتلقّى Google خلاصة، أو عندما لا تتم معالجة الخلاصة بنجاح لأكثر من 24 ساعة. انتقِل إلى صفحة الحساب في بوابة الشركاء وأضِف عنوان بريد إلكتروني جديدًا لجهة اتصال تريد تلقّي تنبيهات الخلاصة هذه عليه.