إذا كنت تمثل علامة تجارية للأزياء، فإن موقع الويب الخاص بك هو متجرك الرئيسي. لكن موجز المنتج الخاص بك هو لوحة الإعلانات الخاصة بك، والكتالوج الخاص بك، ومندوب المبيعات الخاص بك، والذي يتم توزيعه عبر الإنترنت بالكامل. بالنسبة لمعظم التجار، تعتبر خلاصة المنتج فكرة لاحقة. يقومون بتثبيت البرنامج الإضافي “Google Shopping”، ثم ينقرون على “مزامنة”، وينسونه.

ولهذا السبب يخسرون.

في Maison Code Paris، نتعامل مع خلاصة المنتج باعتبارها منتج بيانات. إنها قطعة أثرية هندسية ترتبط ارتباطًا مباشرًا بعائد الإنفاق الإعلاني (ROAS). إذا كانت خلاصتك بطيئة أو غير دقيقة أو عامة، فأنت تدفع “ضريبة كسولة” إلى Google.

يستكشف هذا الدليل كيفية إعادة هندسة الخلاصة من ملف XML سلبي إلى مسار ديناميكي مدر للدخل.

لماذا تتحدث Maison Code عن هذا

في Maison Code Paris، نعمل كضمير معمari لعملائنا. غالبًا ما نرث حزمًا “حديثة” تم بناؤها دون فهم أساسي للحجم.

نناقش هذا الموضوع لأنه يمثل نقطة تحول حاسمة في النضج الهندسي. التنفيذ الصحيح يميز MVP الهش عن منصة مؤسسية مرنة يمكنها التعامل مع حركة مرور الجمعة السوداء.

مشكلة المزامنة “الافتراضية”.

توفر الأنظمة الأساسية القياسية (Shopify وMagento وSalesforce) عمليات تكامل أصلية. تفشل هذه على نطاق واسع (GMV > 10 مليون دولار) لثلاثة أسباب:

زمن الوصول: تتم عادةً المزامنة مرة واحدة كل 24 ساعة. إذا قمت ببيع SKU بالكامل في الساعة 10:00 صباحًا، فستستمر في الدفع مقابل النقرات حتى المزامنة التالية في الساعة 2:00 صباحًا. هذا هو الإنفاق الضائع.
العناوين العامة: تقوم بتعيين عنوان نظام إدارة المحتوى الداخلي الخاص بك (""Crop Top”`) مباشرة إلى Google. جوجل تريد ""قميص نسائي قصير من القطن - أسود - مقاس M"".
الإستراتيجية الصفرية: يقومون بملء الحقول المطلوبة، لكنهم يتجاهلون “التصنيفات_المخصصة”. لا يمكنك تقديم عروض أسعار مختلفة على عناصر “الهامش المرتفع” مقابل عناصر “التصفية” نظرًا لعدم توفر البيانات.

الهندسة المعمارية: خط الأنابيب الهجين

نحن لا نعتمد على التطبيقات. نحن نبني مسارًا مخصصًا على AWS/Vercel. نحن نستخدم منهجًا مختلطًا:

المزامنة المجمعة (XML): تجديد يومي للكتالوج الكامل للبيانات الهيكلية.
المزامنة التزايدية (API): تحديثات في الوقت الفعلي للسعر والتوافر.

الرسم البياني TD
    CMS[CMS بدون رأس / Shopify] -->|Nightly Cron| المولد[مولد Node.js XML]
    المولد -->|البث| S3[حاوية S3: Feed.xml]
    S3 -->|جلب| جي إم سي [مركز تجار جوجل]
    
    نظام إدارة المحتوى -->|خطاف الويب: PRICE_UPDATE| واجهة برمجة التطبيقات [وظيفة بدون خادم]
    واجهة برمجة التطبيقات -->|الدفع| ContentAPI[Google Content API]
    
    ContentAPI -->|تحديث فوري| جي إم سي

المرحلة الأولى: إنشاء XML عالي الأداء

يعد إنشاء ملف XML لـ 50000 وحدة SKU أمرًا ثقيلًا. إذا قمت بتحميل جميع المنتجات في الذاكرة، فسوف تتعطل عملية Node.js (نفاد الذاكرة). نحن نستخدم ** تيارات **.

مولد البث

نقوم بإحضار المنتجات باستخدام ترقيم الصفحات المستند إلى المؤشر (GraphQL)، وتحويلها، وتوجيه النتيجة مباشرة إلى تدفق التحميل S3.

استيراد {تحويل} من "الدفق"؛
استيراد { createGzip } من 'zlib'؛
استيراد {S3} من '@aws-sdk/client-s3'؛

// 1. تحويل الدفق: منتج JSON -> سلسلة XML
const xmlTransform = تحويل جديد({
  وضع الكائن القابل للكتابة: صحيح،
  تحويل (المنتج، الترميز، رد الاتصال) {
    const xmlNode = `
    <العنصر>
      <g:id>${product.sku}</g:id>
      <g:title><![CDATA[${optimizeTitle(product)}]]></g:title>
      <g:price>${product.price.amount} ${product.price.currency</g:price>
      <g:link>${product.onlineStoreUrl</g:link>
      <g:cogs>${product.cost</g:cogs> <!-- بيانات الهامش المخصصة -->
    </البند>
    `;
    callback(null, xmlNode);
  }
});

// 2. خط الأنابيب
وظيفة غير متزامنة createFeed() {
  const s3Stream = new PassThrough();
  تحميل ثابت = تحميل جديد({
    العميل: S3 الجديد ({})،
    المعلمات: { الحزمة: "الخلاصات"، المفتاح: "google.xml.gz"، النص: s3Stream }
  });

  const ProductStream = getShopifyProductStream(); // مولد مخصص

  com.productStream
    .الأنابيب (xmlTransform)
    .pipe(createGzip()) // الضغط دائمًا
    .pipe(s3Stream);

  في انتظار التحميل.done();
}

يتيح لنا خط الأنابيب هذا إنشاء خلاصات مميزة لمناطق مختلفة (الولايات المتحدة والاتحاد الأوروبي والمملكة المتحدة) بالتوازي مع الحد الأدنى من مساحة الذاكرة.

المرحلة الثانية: الطبقة المنطقية (إثراء البيانات)

هذا هو المكان الذي تلتقي فيه الهندسة بالتسويق. نحن لا نمرر البيانات فحسب؛ نحن نعززها.

تحسين العنوان (SEO للإعلانات)

تطابق الخوارزمية الاستعلامات مع عنوانك.

سيء: “Air Max 90” (اسم CMS الداخلي).
جيد: “حذاء الجري Nike Air Max 90 للرجال - أبيض/أحمر - مقاس 10”.

نحن نستخدم محرك القالب: العنوان = [العلامة التجارية] + [الجنس] + [المجموعة] + [نوع المنتج] + [اللون] + [المادة]

تسميات مخصصة لتقديم العطاءات

تسمح Google بخمسة تصنيفات مخصصة (custom_label_0 إلى 4). هذا هو سلاحك السري. نقوم بملء هذه العناصر برمجيًا بناءً على منطق العمل:

التسمية 0 (الهامش): إذا كان (السعر - التكلفة) > 50 دولارًا أمريكيًا، فاضبط ”الهامش_الأعلى”`. محاولة عالية.
التصنيف 1 (الموسم): إذا كانت العلامات تحتوي على “Summer25”، فاضبط "New_Arrival".
التصنيف 2 (الأداء): المزامنة مع Google Analytics. إذا كان معدل التحويل > 3%، فاضبط "الأفضل_البائع".
التسمية 3 (المخزون): إذا كان المخزون < 5، فاضبط "المخزون_المنخفض". أوقف الإعلانات العامة، وادفع إلى الإلحاح.

المرحلة الثالثة: واجهة برمجة تطبيقات المحتوى (في الوقت الفعلي)

بالنسبة للسعر والمخزون، XML بطيء جدًا. نحن نستخدم Google Content API للتسوق.

عندما تتم عملية شراء في المتجر، يتم تفعيل خطاف على الويب. “تم إنشاء الطلب” -> “مستوى المخزون: 0”.

تصل وظيفتنا بدون خادم إلى Google على الفور:

استيراد { content_v2_1 } من '@googleapis/content'؛

تحديث وظيفة غير متزامنةGoogleStock(sku: string,quantity: number) {
  const auth = انتظار getGoogleAuth();
  محتوى ثابت = محتوى جديد_v2_1.Content({ auth });

  في انتظار content.inventory.set({
    معرف التاجر: "12345678"،
    رمز المتجر: "عبر الإنترنت"، // أو رمز المتجر المحلي
    معرف المنتج: `عبر الإنترنت:en:US:${sku}`,
    نص الطلب: {
      التوفر: الكمية > 0؟ "في المخزون": "نفاد المخزون"،
      // يمكننا أيضًا تحديث سعر البيع هنا على الفور
      سعر البيع: { القيمة: '99.00'، العملة: 'USD' }
    }
  });
}

زمن الوصول: < 2 دقيقة. النتيجة: لن تدفع أبدًا مقابل النقرة على عنصر غير متوفر في المخزون.

توسيع القنوات: Meta وPinterest وTikTok

بمجرد حصولك على مسار البيانات الأولية هذا، فلن تقتصر على Google.

Meta (Facebook/Instagram): يقبل تنسيق CSV مماثل. نقوم بتقسيم الدفق، وتعيين g:id إلى fb:id، ثم تحميله إلى مدير الكتالوج.
TikTok: يتطلب أصول الفيديو. يمكننا تعيين “custom_label_4” إلى عنوان URL لمادة فيديو تم إنشاؤها (راجع AI Agents).
إعلانات المستودعات المحلية (LIA): إذا كانت لديك متاجر فعلية، فإننا نقوم بإنشاء خلاصة ثانوية تربط بين “رمز_المتجر” (باريس شانزليزيه) و”الكمية”. عندما يكون المستخدم بالقرب من باريس، يقول الإعلان “استلم السيارة اليوم”.

المزالق الشائعة (الكابوس “المرفوض”)

عدم تطابق رقم GTIN: تتحقق Google بدقة من الرموز الشريطية UPC/EAN. إذا قمت بإرسال رقم GTIN مزيف، فسيتم حظر المنتج. إذا لم يكن لديك واحد، أرسل “identifier_exists: no”.
تراكبات الصور: تطلب Google خلفيات بيضاء. إذا كانت صورتك الرئيسية تحتوي على علامة مائية “تخفيضات”، فسيتم رفضها. يتحقق خط الأنابيب الخاص بنا من البيانات الوصفية للصورة أو يستخدم عناوين URL المحولة من Cloudinary لإزالة التراكبات.
عدم تطابق السعر: إذا كان ملف XML يشير إلى 100 دولار أمريكي وكانت الصفحة المقصودة تشير إلى 101 دولار أمريكي (بسبب تحويل العملة أو التحديثات)، فسوف تقوم Google بتعليق الحساب. ولهذا السبب تعد Content API إلزامية لتحقيق الاتساق في الوقت الفعلي.

10. قواعد الخلاصة مقابل تحرير المصدر

يسمح Google Merchant Center بـ “قواعد الخلاصة”. “إذا كان العنوان يحتوي على ‘Nike’، قم بإلحاق ‘Sneakers’.” ** لا تستخدم هذا. ** المنطق المخفي في GMC غير مرئي للمطورين لديك. إذا قمت بتغيير العنوان في الكود، وقام GMC بتغييره مرة أخرى، فسوف تقضي أسابيع في تصحيح الأخطاء. القاعدة: ينتمي المنطق إلى مسار التعليمات البرمجية (المصدر)، وليس إلى واجهة الوجهة.

11. المخزون المؤقت للمخزون (شبكة الأمان)

مزامنة المستودع الخاص بك ليست فورية. يستغرق 10 دقائق. في تلك الدقائق العشر، قد تبيع وحدتك الأخيرة على أمازون. ينقر مستخدم Google على… “نفاد المخزون”. لقد دفعت مقابل تلك النقرة. الإصلاح: إذا كانت الكمية < 3، فعيِّن التوفر: out_of_stock. لقد “عمدنا إلى إخفاء” الوحدات القليلة الأخيرة من شبكات الإعلانات لمنع ارتفاع “معدل الارتداد” وتجربة العملاء السيئة.

12. إطعام الوحش: الأداء الأقصى (PMax)

نوع حملة “الصندوق الأسود” الجديد من Google (PMax) يحب الأصول. لا يريد اللقب فقط. يريد:

lifestyle_images: مجموعة من عناوين URL التي تعرض المنتج قيد الاستخدام.
وصف_قصير: 150 حرفًا.
product_highlight: نقاط نقطية. معظم الموصلات تسقط هذه. نقوم بتعيين حقول Sanity CMS الخاصة بنا إلى هذه السمات الموسعة. كلما زاد سياق PMax، أصبحت تكلفة النقرة أرخص.

13. عناوين خلاصة اختبار A/B

هل يعتبر “Nike Air Max” أفضل من “حذاء الجري الرجالي”؟ أنت لا تعرف. قمنا بتقسيم معرف المنتج.

ID-123-A -> العنوان أ.
ID-123-B -> العنوان ب. نرسل كلا الخيارين إلى Google (كمنتجات منفصلة، ولكن نتشارك المخزون عبر معرف مجموعة العناصر). نحن نحلل نسبة النقر إلى الظهور. الفائز يأخذ كل شيء. هذا تجربة الخلاصة.

14. الاستنتاج

تغذية المنتج هي نظام القلب والأوعية الدموية للتجارة الإلكترونية. إنه يضخ المنتجات إلى النظام البيئي للإنترنت. إذا كانت البيانات غنية ونظيفة وسريعة، فسيتم أداء الإعلانات. إذا كانت البيانات سيئة، فإن الخوارزمية تتضور جوعا.

نحن لا نقوم فقط “بمزامنة” المنتجات. نحن نصمم الرؤية.

هل تغذيتك تنزف أموالاً؟

إذا كنت ترى أخطاء “عدم تطابق السعر” أو انخفاض عائد الإنفاق الإعلاني.

[تدقيق مسار بياناتك](/جهة اتصال). قم بتوظيف مهندسينا.