إعداد التقارير عن ميزة "الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق" واختبارها

توضِّح هذه المقالة كيفية إعداد ميزة "الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق" وإرسال بيانات سلة التسوّق. اطّلِع على مزيد من المعلومات عن إعداد تقارير عن الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق.

التعليمات

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

استشِر المطوِّر على الويب الذي تتعامل معه للتعرّف على كيفية تمرير البيانات التي يتم إنشاؤها ديناميكيًا، مثل معرِّفات المنتجات التي تم بيعها في إطار إحالة ناجحة.

إضافة مَعلمات بيانات سلة التسوّق

لإرسال بيانات سلة التسوّق، عليك إضافة هذه المَعلمات الإضافية إلى رمز المقتطف عن الحدث:

المَعلمة	نوع القيمة	مثال للقيمة	الوصف
event	سلسلة	"purchase"	ستتم معالجة أحداث "purchase" فقط لبيانات سلة التسوّق.
discount (اختيارية)	عدد عائم	1.50	الخصم، 1.50 دولار أمريكي (أو ما يعادله بالعملة المحلية)، يتم تطبيقه على الطلب بالكامل، على سبيل المثال: شحن مجاني تخفيض لفترة محدودة ملاحظة: عند استخدام "إحصاءات Google" كمصدر إحالة ناجحة، تكون مَعلمة الخصم غير متاحة.
aw_merchant_id (اختيارية)	عدد صحيح	98765	رقم تعريف Merchant Center. قدِّم هذه المَعلمة إذا كنت تُرسِل سلعة معيّنة في عدّة حسابات على Merchant Center وكنت تريد تحديد حساب Merchant Center الذي يجب قراءة بيانات السلعة منه، مثل تكلفة السلع المُباعة المتعلّقة بها.
aw_feed_country (اختيارية)	سلسلة	"US"	البلد المرتبط بالخلاصة التي يتمّ تحميل سلعك فيها. يمكنك استخدام رموز CLDR للأقاليم. ملاحظة: عند استخدام "إحصاءات Google" كمصدر إحالة ناجحة، يُرجى استخدام المَعلمة aw_feed_label بدلاً منها.
aw_feed_language (اختيارية)	سلسلة	"EN"	اللغة المرتبطة بالخلاصة التي تمّ تحميل سلعك فيها. يمكنك استخدام رموز ISO 639-1‎ للّغات.
aw_feed_label (اختيارية)	سلسلة	"feed_label"	التصنيف المرتبط بالخلاصة التي تمّ تحميل سلعك فيها. ملاحظة: لا تتوفّر هذه الميزة إلا عند استخدام "إحصاءات Google" كمصدر إحالة ناجحة.
items	مصفوفة	[{ id: "P12345", price: 12.50, quantity: 2 }]	مصفوفة من الأسعار والكميات ومعرّفات السلع لكل سلعة تم شراؤها.
items.id	سلسلة	'P12345'	معرّف السلعة للمنتج الذي تم شراؤه. ويجب أن يتطابق مع معرّف السلعة المستخدَم في Merchant Center. ملاحظة: عند استخدام "إحصاءات Google" كمصدر إحالة ناجحة، تتم إتاحة المَعلمة البديلة items.item_id.
items.price	عدد عائم	12.50	السعر المخفَّض لسلعة واحدة، باستثناء الضرائب ورسوم الشحن وأي خصومات على مستوى المعاملة.
items.quantity	عدد صحيح	2	عدد الوحدات المُباعة من السلع.

 

مثال على تنفيذ علامة Google مع بيانات سلة التسوّق

<!-- Sample Code Conversion -->
<script type="text/javascript">
gtag('event', 'purchase', {
  "send_to": "AW-9999999999/abc123xyz",
  "transaction_id": "1545c34e-691e-4726-aeda-b798df255e9c",
  "value": 53.50,
  "currency": "USD",
<!-- Start of CwCD Parameters -->
  "discount": 1.50,
  "aw_merchant_id": 98765,
  "aw_feed_country": "US",
  "aw_feed_language": "EN",
  "items": [
    {
      "id": "P12345",
      "quantity": 2,
      "price": 12.50
    },
    {
      "id": "P67890",
      "quantity": 1,
      "price": 30.00
    }
  ]
<!-- End of CwCD Parameters -->
});
/* ]]> */
</script>

مثال على تنفيذ طبقة بيانات

<!-- Sample Code datalayer push -->
dataLayer.push({
"event": 'purchase',
"transaction_id": "1545c34e-691e-4726-aeda-b798df255e9c",
"value": 53.50,
"currency": "USD",
<!-- Start CwCD Parameters datalayer push -->
"discount": 1.50,
"aw_merchant_id": 98765,
"aw_feed_country": "US",
"aw_feed_language": "EN",
"items": [
  {
    "id": "P12345",
    "quantity": 2,
    "price": 12.50
  },
  {
    "id": "P67890",
    "quantity": 1,
    "price": 30.00
  }
]
<!-- End CwCD Parameters datalayer push -->
});

مثال على تقديم بيانات سلة التسوّق إلى أداة "إدارة العلامات من Google" باستخدام متغيّرات JavaScript

<!-- Sample Code JavaScript Variables-->
<script type="text/javascript">
transaction_id = "1545c34e-691e-4726-aeda-b798df255e9c";
value = 53.50;
currency = "USD";
<!-- Start of CwCD Parameters -->
discount = 1.50;
aw_merchant_id = 98765;
aw_feed_country = "US";
aw_feed_language = "EN";
items = [
{
  "id": "P12345",
  "quantity": 2,
  "price": 12.50
},
{
  "id": "P67890",
  "quantity": 1,
  "price": 30.00
}
];
<!-- End of CwCD Parameters -->
/* ]]> */
</script>

تقديم سمة خلاصة تكلفة السلع المُباعة للإبلاغ عن هوامش الربح

لإتاحة إعداد تقارير الأرباح، عليك تقديم سمة الخلاصة cost_of_goods_sold في خلاصة منتجاتك على Merchant Center. تعرّف على كيفية إنشاء خلاصة.

تمثِّل السمة Cost_of_goods_sold (تكلفة السلع المُباعة) تكلفة المنتج الذي تبيعه. تستخدِم "إعلانات Google" هذه السمة لاحتساب هامش الربح لكل منتج (الربح = الإيرادات - تكلفة السلع المُباعة). وإذا لم تتوفّر لديك بيانات تكلفة السلع المُباعة الدقيقة لمنتجاتك، ولكنّك لا تزال تريد الاطّلاع على تقارير الربح، يمكنك استخدام قيم تكلفة السلع المُباعة التقريبية. على سبيل المثال، يمكنك تقدير تكلفة السلع المُباعة بنسبة %80 من سعر المنتج.

يمكنك تقديم تكلفة السلع المُباعة بثلاث طرق:

• من خلال خلاصة المنتج
• من خلال Content API
• من خلال إنشاء خلاصة تكميليّة وتقديم قِيَم تقديرية أو قِيَم لمنتجات فردية

إذا اختَرت عدم تقديم سمة الخلاصة cost_of_goods_sold، لن تتمكّن من الاطّلاع على قِيَم بعض المقاييس في التقارير، مثل تكلفة السلع المُباعة والربح الإجمالي.

اختبار التنفيذ الصحيح لميزة الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق

إذا لم تكن ميزة الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق متاحة أو كانت تظهر بشكلٍ غير صحيح، عليك التأكّد من تنفيذ مَعلمات علامة الإحالة الناجحة بشكلٍ سليم. ولإجراء ذلك، أكمِل طلبًا تجريبيًا باتّباع الخطوات التالية لمعرفة ما إذا كان يتم تمرير المَعلمات بشكلٍ سليم:

1. افتح "أدوات مطوّري برامج Chrome" من خلال النقر على رمز قائمة Chrome في أعلى يسار صفحة متصفّح الويب Google Chrome، ثمّ اختَر المزيد من الأدوات > أدوات المطوّرين.
2. في لوحة "أدوات المطوّرين"، اختَر الشبكة.
3. أرسِل طلبك التجريبي من خلال متصفّح الويب Google Chrome.
4. ابحث عن الطلب الذي يتضمّن إحالتك الناجحة (ابحث عن "conversion/"). ومن المفترض أن تحتوي مَعلمات سلسلة طلب البحث على مَعلمات سلة التسوّق، كما هو موضّح في المثال التالي:

mid = aw_merchant_id
fcntr = aw_feed_country
flng = aw_feed_language
dscnt = discount
bttype = event type
item = items (the array) mapping all items with (items.id * items.price * items.quantity)

روابط ذات صلة

• لمحة عن ميزة الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق
• فهم بيانات تتبع الإحالات الناجحة