تحميل البيانات لمتغيرات Floodlight المخصصة

بشكل افتراضي، تحتوي الإحالة الناجحة على مقدار محدود من البيانات الوصفية، مثل الوقت التي حدثت فيها الإحالة الناجحة، ومصدر الإحالة الناجحة، وكذلك القيمة المالية اختياريًا. إذا كنت جمع بيانات إضافية عن إحالاتك الناجحة، مثل البلد الذي تمّ شراء سلعة إليه الشحن أو معرّفات المنتجات أو حتى مدة مكالمة هاتفية، يمكنك استخدام متغيّرات Floodlight المخصّصة لتتبّع البيانات وتحميلها إلى "إعلانات شبكة البحث 360".

بعد تحميل البيانات، يمكنك:

  • يمكنك إنشاء أعمدة إعداد التقارير في "إعلانات شبكة البحث 360" لعرض البيانات أو استخدامها فلترة عمود Floodlight

  • استخدِم البيانات في أعمدة الصيغ.

  • استخدِم البيانات لتقسيم التقارير وتجميعها.

  • استخدام Search Ads 360 API لتنفيذ ما يلي: تنزيل التقارير التي تحتوي على البيانات

مزيد من المعلومات عن استخدام البيانات المحمَّلة.

إعداد متغيّرات Floodlight المخصّصة

أعددت متغيّرات Floodlight المخصّصة في البداية كجزء من تهيئة Floodlight في مدير الحملة. بعد ذلك، يجب على جهة اتصال خدمة العملاء في "إعلانات شبكة البحث 360" وإعداد خيار المتغيّرات في "إعلانات شبكة البحث 360". بعد الانتهاء من هذه الخطوات، يمكنك تحديد البيانات للمتغيرات عند إضافة أو تعديل الإحالات الناجحة.

اسم المتغيّر ونوعه

يتم تعيين اسم مناسب لكل متغير يكون فريدًا لمتغير أحد المعلنين وأحد أنواع البيانات التالية:

  • المقياس: البيانات الرقمية التي تجمعها "إعلانات شبكة البحث 360" في تقارير الإحالات الناجحة. بالنسبة على سبيل المثال، يمكن استخدام متغيرات المقاييس لتتبع تكاليف الشحن الإجمالية أو للاحتفاظ عدد السلع التي تمّ شراؤها

  • السمة: بيانات رقمية أو نصية يمكن استخدامها لفلترة البيانات في إبلاغ. على سبيل المثال، يمكن لمتغيّرات السمات تتبُّع اسم متجر أو معرّف رقمي للمنتج ثم استخدامها في تقارير Floodlight عمود يحتوي فقط على البيانات من متجر معيّن أو من متجر المنتج.

تحميل البيانات المخصّصة

لتحميل بيانات أحد متغيّرات Floodlight المخصّصة لمقياس، يجب تضمين الحقل التالي في Conversion.insert() أو Conversion.update() الطلب:

   'customMetric': [
      {
        'name': 'friendly-name',
        'value': Number
      },
     ]

لتحميل بيانات أحد متغيّرات Floodlight المخصّصة لسمة، عليك تضمين الحقل التالي في Conversion.insert() أو Conversion.update() الطلب:

   'customDimension': [
      {
        'name': 'friendly-name',
        'value': String
      },
     ]

مثال

على سبيل المثال، تم ضبط متغيّرات Floodlight المخصّصة التالية لأحد المعلِنين من أجل "إعلانات شبكة البحث 360":

  • المبيعات (المقياس)
  • الشحن (المقياس)
  • product_type (السمة)
  • product_id (السمة)

إذا أكمل العميل عملية شراء عبر الهاتف، يمكنك إجراء ما يلي: Conversion.insert() طلب تحميل الإحالة الناجحة وتضمين بيانات المقاييس المخصّصة:

POST  https://www.googleapis.com/doubleclicksearch/v2/conversion
Authorization: Bearer your OAuth 2.0 access token
Content-type: application/json

{
 'kind': 'doubleclicksearch#conversionList',
 'conversion' : [{
   'agencyId': '12300000000000456', // Replace with your ID
   'advertiserId': '78900000000000123', // Replace with your ID
   'engineAccountId': '101100000000000123', // Replace with your ID
   'campaignId': '13400000003156701', // Replace with your ID
   'adGroupId': '58700000128508001', // Replace with your ID
   'criterionId': '43700001095692142', // Replace with your ID
   'adId': '0',
   'conversionId': 'test_20140121_01',
   'state': 'ACTIVE',
   'type': 'TRANSACTION',
   'revenueMicros': 10000000, // To report $10 of revenue, specify 10 million revenueMicros
   'currencyCode': 'USD',
   'segmentationType': 'FLOODLIGHT',
   'segmentationId': '25700000001472562', // Replace with your ID
   'conversionTimestamp': '1390073000011',
   'floodlightOrderId': 'test',
   'customMetric': [
    {
      'name': 'sales',
      'value': 2.0
    },
    {
      'name': 'shipping',
      'value': 3.0
    }
   ],
   'customDimension': [
    {
      'name': 'product_type',
      'value': 'shoes'
    },
    {
      'name': 'product_id',
      'value': 'shoe 2'
    }
   ]
 }]
}

التعامل مع ردود "إعلانات شبكة البحث 360"

كما هي الحال مع أنشطة Conversion.insert() الأخرى أو Conversion.update() من الطلبات، في حال نجح الطلب، ستتضمّن الاستجابة التمثيل الداخلي الكامل في "إعلانات شبكة البحث 360". لكل إحالة ناجحة يتم تحميلها.

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