استيراد بيانات التكلفة باستخدام Management API

يوضِّح هذا الدليل كيفية استيراد بيانات التكلفة باستخدام Management API.

مقدمة

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

ملاحظة: هذا الدليل غير مخصّص للحملات على "إعلانات Google". لاستيراد بيانات "إعلانات Google"، اربط حسابك على "إعلانات Google" بخدمة "إحصاءات Google".

قبل البدء

قبل البدء في هذا الدليل، على المطوِّرين تنفيذ ما يلي:

• الاطّلاع على دليل استيراد البيانات (مركز المساعدة) للتعرّف على ميزة استيراد البيانات
• اقرأ دليل المطوّر لاستيراد البيانات للتعرّف على المفاهيم حول كيفية استخدام Management API لاستيراد البيانات.
• يُرجى قراءة مرجع تحميل الموارد للتعرّف على معلومات حول تحميل البيانات.

نظرة عامة

يتطلب استيراد بيانات التكلفة إلى "إحصاءات Google" باستخدام Management API تنفيذ الخطوات التالية:

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

وضع علامات على عناوين URL للحملة

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

مثال

في المثال التالي للإعلان، تم وضع علامات على عنوان URL المقصود باستخدام معايير تتبع الحملة (utm_campaign، utm_source، utm_medium، utm_term). يضمن ذلك ربط الزيارات إلى الموقع الإلكتروني من النقرات على الإعلان بحملة تخفيضات الصيف في "إحصاءات Google".

الشكل 1: مثال على إعلان.

استخدم متجر الحيوانات الأليفة عنوان URL المقصود التالي لهذا الإعلان:

http://www.examplepetstore.com?utm_campaign=Summer%2BSale&utm_source=ad%2Bnetwork&utm_medium=cpc&utm_term=dogbone

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

اسم البُعد في واجهة ويب Google Analytics	معلمة تتبع الحملة	مجموعة القيم في Google Analytics
اسم الحملة	utm_campaign	تخفيضات موسم الصيف
المصدر	utm_source	شبكة الإعلانات
الوسيط	utm_medium	تكلفة النقرة
كلمة رئيسية	utm_term	عظم للكلاب

يضمن ذلك أن "إحصاءات Google" تحتوي على معايير تتبع الحملة المرتبطة بالجلسة، ويضمن أيضًا توفُّر طريقة لدمج بيانات "إحصاءات Google" مع المصدر الخارجي لبيانات التكلفة.

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

لاستيراد بيانات التكلفة، يجب إنشاء مجموعة بيانات. يتم استخدام مجموعة بيانات لتمثيل مصدر بيانات خارجي واحد أو أكثر في "إحصاءات Google". لا يمكن إنشاء مجموعة بيانات إلا من خلال واجهة الويب.

ضمن علامة تبويب "الموقع" في صفحة المشرف، اتّبِع الخطوات التالية:

1. انقر على علامة التبويب استيراد البيانات.
2. انقر على الزر مجموعة بيانات جديدة.
3. اختَر بيانات التكلفة للنوع وانقر على الخطوة التالية.
4. أدخِل اسمًا لمجموعة البيانات واختَر ملفًا شخصيًا واحدًا أو أكثر لتفعيل تحليل التكلفة في التقارير، ثم انقر على الخطوة التالية.
5. اختَر السمات والمقاييس التي تريد تحميلها.
6. اختر سلوك الاستيراد المطلوب.
   • يتحكّم هذا الإعداد في ما إذا كان سيتم استبدال بيانات التكلفة أو جمعها في الحالات التي يتم فيها العثور على مفتاح مكرّر. للاطّلاع على مزيد من المعلومات عن سلوك الاستيراد، يُرجى الاطّلاع على القسم تجميع بيانات التكلفة مقابل الاستبدال في دليل مطوّري برامج استيراد البيانات.
7. انقر على حفظ.

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

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

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

في ما يلي التعديلات وعمليات التحقّق الأساسية التي تحتاج إلى إجرائها على ملف CSV:

• أعِد تسمية عناوين الأعمدة لتطابق تلك التي تتعرّف عليها "إحصاءات Google". يمكنك استرداد العنوان من صفحة تفاصيل مجموعة البيانات في واجهة الويب.
• أضِف أي قيم مطلوبة غير متوفّرة.
• ويجب أن تتطابق القيم الواردة في ملف CSV مع القيم المستخدَمة في معايير تتبُّع الحملة، حيثما ينطبق ذلك.

مثال

باستخدام مثال متجر الحيوانات الأليفة، يتم تصدير البيانات بشكل مجمّع وحفظها كملف CSV:

الشكل 3: ملف CSV لبيانات التكلفة التي تم تصديرها.

يتم بعد ذلك تعديل ملف CSV لاستيفاء التنسيق الذي تطلبه "إحصاءات Google":

الشكل 4: ملف CSV لبيانات التكلفة المنسّقة.

ملاحظة: بالنسبة إلى الصف الأول من بيانات التكلفة، تتوافق قيم ga:source وga:medium وga:campaign وga:keyword مع قيم مَعلمات تتبُّع الحملة التي تمّ تحديدها كجزء من عنوان URL للإعلان.

بعد إعداد ملف CSV، من المفترض أن يبدو التنسيق مشابهًا للمثال التالي:

ga:date,ga:source,ga:medium,ga:campaign,ga:keyword,ga:impressions,ga:adClicks,ga:adCost
20140615,ad network,cpc,Summer Sale,dogbone,9387,288,100.3
20140615,ad network,cpc,Summer Sale,dog treat,1684,52,19.35
20140615,ad network,cpc,Summer Sale,pet store,3187,143,76.23
20140616,ad network,cpc,Summer Sale,dogbone,8754,188,86.21

راجِع دليل المطوّر لاستيراد البيانات للاطّلاع على القيود العامة لتنسيق الملفات.

تحميل بيانات التكلفة باستخدام Management API

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

التقارير

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