استيراد بيانات المنتجات باستخدام Management API

"أندرو ويلز"، علاقات المطوّرين في "إحصاءات Google" – أيار (مايو) 2014

يوضّح هذا الدليل كيفية تبسيط عملية تنفيذ التجارة الإلكترونية المحسَّنة من خلال استيراد بيانات المنتجات باستخدام Management API. لمزيد من المعلومات حول استيراد بيانات المنتجات، يُرجى الاطّلاع على مثال على استيراد بيانات المنتج.

مقدمة

يعمل استيراد بيانات المنتجات إلى Google Analytics على تبسيط وتقليل كمية بيانات التجارة الإلكترونية التي تحتاج إلى إرسالها مع النتائج، مثل مشاهدات الصفحة على الويب والأحداث. يمكن دمج معرّف منتج واحد أو رمز تخزين تعريفي واحد تم إرساله إلى "إحصاءات Google" في وقت التجميع مع بيانات المنتج المستورَدة لتعبئة سمات ومقاييس المنتج في تقاريرك.

قبل البدء

قبل إكمال دليل الحل هذا، اقرأ ما يلي:

نظرة عامة

لتفعيل استيراد البيانات لبيانات المنتجات:

  1. إنشاء مجموعة البيانات
  2. تحضير ملف CSV لبيانات المنتج لتحميله
  3. تحميل بيانات المنتجات باستخدام Management API
  4. تعديل رمز التجارة الإلكترونية لإرسال رمز التخزين التعريفي للمنتج

لمعرفة كيفية تحميل مجموعة البيانات إلى "إحصاءات Google" باستخدام واجهة الويب، اطّلِع على دليل مستخدم التجارة الإلكترونية المحسَّنة.

إنشاء مجموعة البيانات

تتمثّل الخطوة الأولى لاستيراد بيانات المنتجات في إنشاء مجموعة بيانات لبيانات منتجاتك وإعداد المخطط الذي يحدّد السمات والمقاييس التي تريد استيرادها.

اتّبِع دليل المطوّر لاستيراد البيانات لإنشاء مجموعة البيانات، واختَر بيانات المنتج كنوع مجموعة البيانات ورمز التخزين التعريفي للمنتج كمفتاح.

الشكل 1: إنشاء مجموعة بيانات المنتج.

بعد إنشاء مجموعة البيانات، دوِّن رقم تعريف مصدر البيانات المخصّص، الذي ستستخدمه في الخطوة التالية لاستيراد بيانات المنتجات إلى "إحصاءات Google" باستخدام Management API.

تحضير ملف CSV لبيانات المنتج لتحميله

يجب أن تحتوي بيانات المنتج ملف CSV على صف عنوان وعمود رمز التخزين التعريفي للمنتج وعمود لكل سمة و/أو مقياس سيتم استيراده كما هو محدّد في مخطط مجموعة البيانات.

اتّبِع دليل المطوّر لاستيراد البيانات لإعداد ملف CSV لبيانات المنتج لاستيراده، باستخدام رمز التخزين التعريفي للمنتج كمفتاح في العمود الأول.

الشكل 2: تحضير بيانات المنتجات لتحميلها في ملف CSV
.

يبدو ملف CSV على النحو التالي:

ga:productSku,ga:productName,ga:productBrand,ga:productCategoryNew,ga:productVariant,ga:productPrice
12345,Triblend Shortsleeve T-Shirt,Google,Apparel,black,15.25
67890,Donut Friday Scented T-Shirt,Google,Apparel,gray,33.85
10292,Kaiser the Snake T-Shirt,Google,Apparel,green,19.10
67584,Organic Cotton Android T-Shirt,Google,Apparel,black,13.50
90876,Maps Biking T-Shirt,Google,Apparel,blue,15.65

تحميل بيانات المنتجات باستخدام Management API

بعد إنشاء مجموعة البيانات وتحديد المخطّط وإعداد بيانات المنتج لتحميلها بتنسيق ملف CSV، يمكنك تحميل بيانات منتجاتك باستخدام Management API.

بعد تحميل بيانات المنتج والتحقق منها ومعالجتها، سيتم ضم رموز التخزين التعريفية للمنتجات مع بيانات المنتج التي تم تحميلها عند حدوث مطابقة مع النتائج الواردة التي تم إرسالها إلى "إحصاءات Google" من موقعك.

تحديث رمز التجارة الإلكترونية لإرسال رمز التخزين التعريفي للمنتج

بعد الانتهاء من تحميل بيانات المنتج، عدِّل رمز التجارة الإلكترونية لإرسال رموز التخزين التعريفية للمنتجات مع كل نتيجة من نتائجك، إلى جانب أي بيانات إضافية تريدها في تقاريرك، مثل المقاييس والسمات المخصّصة.

// Example of sending a transaction when joining with imported product data.
ga('create', 'UA-XXXX-Y');
ga('require', 'ec', 'ec.js'); // Load the Enhanced Ecommerce plug-in. Required.

// The product name, price, and other product data will be added to this hit
// at collection time if the value of the id field matches a Product SKU
// you've uploaded.
ga('ec:addImpression', {
  'id': '12345',              // Product ID/SKU (Key). Required.
  'list': 'Search Results',
  'position': 1,
  'dimension1': 'Member'
});

ga('send', 'pageview');       // Send the impression with a pageview hit.

ستتم الآن مطابقة معرّفات المنتجات المُرسلة من تنفيذ التجارة الإلكترونية المحسَّنة مع رموز التخزين التعريفية للمنتجات في مجموعة بيانات المنتجات التي تم استيرادها، وستتم تعبئة تقاريرك تلقائيًا ببيانات المنتجات الإضافية التي حمّلتها.