أبعاد ومقاييس واجهة برمجة التطبيقات

تتوفّر هذه السمات والمقاييس في تقارير مسارات الإحالات الناجحة في Data API على "إحصاءات Google".

الأبعاد

يمكن طلب السمات التالية في تقارير مسارات الإحالات الناجحة لأي موقع. حدِّد "اسم واجهة برمجة التطبيقات" في حقل name لمورد Dimension.

اسم واجهة برمجة التطبيقات	اسم واجهة المستخدم	متاح في "الشرائح"	الوصف
achievementId	رقم تعريف الإنجاز	نعم	رقم تعريف الإنجاز في إحدى الألعاب لأحد الأحداث. وتتم التعبئة بواسطة مَعلمة الحدث achievement_id.
adFormat	شكل الإعلان	نعم	تصِف طريقة ظهور الإعلانات ومكان ظهورها. تشمل التنسيقات النموذجية كلاً من Interstitial وBanner وRewarded وNative advanced.
adSourceName	مصدر الإعلان	لا	شبكة المصدر التي عرضت الإعلان. تشمل المصادر النموذجية كلاً من AdMob Network وLiftoff وFacebook Audience Network وMediated house ads.
adUnitName	الوحدة الإعلانية	لا	الاسم الذي اختَرته لوصف هذه الوحدة الإعلانية. والوحدات الإعلانية هي حاويات تضعها في تطبيقاتك لعرض إعلانات للمستخدمين.
appVersion	إصدار التطبيق	نعم	versionName للتطبيق (Android) أو الإصدار القصير للحزمة (iOS).
audienceId	رقم تعريف الجمهور	لا	المعرّف الرقمي لشريحة جمهور معيّنة. ويتمّ الإبلاغ عن المستخدِمين في شرائح الجمهور التي كانوا ينتمون إليها خلال النطاق الزمني للتقرير. لا يؤثر سلوك المستخدمين الحالي في انتماءاتهم السابقة إلى شرائح الجمهور في التقارير.
audienceName	اسم شريحة الجمهور	لا	الاسم المحدّد لشريحة جمهور. ويتمّ الإبلاغ عن المستخدِمين في شرائح الجمهور التي كانوا ينتمون إليها خلال النطاق الزمني للتقرير. لا يؤثر سلوك المستخدمين الحالي في انتماءاتهم السابقة إلى شرائح الجمهور في التقارير.
brandingInterest	اهتماماتي	لا	الاهتمامات التي أبداها المستخدمون الذين بلغوا مرحلة متقدمة في مسار الإحالة الناجحة للتسوق. يمكن إضافة المستخدِمين إلى فئات اهتمام متعددة. على سبيل المثال، Shoppers أو Lifestyles & Hobbies/Pet Lovers أو Travel/Travel Buffs/Beachbound Travelers.
متصفّح	المتصفح	نعم	المتصفّحات المستخدَمة لعرض موقعك الإلكتروني.
campaignId	معرّف الحملة	لا	معرّف الحملة التسويقية. ويتوفّر ذلك فقط لأحداث الإحالات الناجحة.
campaignName	الحملة	لا	اسم الحملة التسويقية. ويتوفّر ذلك فقط لأحداث الإحالات الناجحة.
حرف	حرف	نعم	شخصية اللاعب في اللعبة أثناء وقوع الحدث. وتتم التعبئة بواسطة مَعلمة الحدث character.
مدينة	المدينة	نعم	المدينة التي نشأ منها نشاط المستخدِم.
cityId	رقم تعريف المدينة	نعم	رقم التعريف الجغرافي للمدينة التي نشأ منها نشاط المستخدِم، المستمد من عنوان IP الخاص بجهاز المستخدم.
مجموعة نموذجية	المجموعة النموذجية	لا	اسم المجموعة النموذجية في الطلب. المجموعة النموذجية هي مجموعة من المستخدمين الذين بدأوا استخدام موقعك الإلكتروني أو تطبيقك في أي مجموعة متتالية من الأيام. إذا لم يتم تحديد اسم مجموعة نموذجية في الطلب، تتم تسمية المجموعات النموذجية باستخدام فهرسها المستند إلى صفر، مثل: group_0 وgroup_1.
cohortNthDay	المجموعة النموذجية اليومية	لا	معادلة اليوم بالنسبة إلى أوّل جلسة ممكنة للمستخدمين في المجموعة النموذجية. على سبيل المثال، إذا تم اختيار مجموعة نموذجية بتاريخَي البدء والانتهاء 2020-03-01، سيكون التاريخ 2020-03-02 بالقيمة 0001.
cohortNthMonth	المجموعة النموذجية الشهرية	لا	معادلة الشهر مقارنةً بأول SessionDate للمستخدمين في المجموعة النموذجية. تتوافق حدود الأشهر مع حدود أشهر التقويم. على سبيل المثال، إذا تمّ اختيار مجموعة نموذجية بتاريخَي البدء والانتهاء في آذار (مارس) 2020، ستكون القيمة 0001 لأي تاريخ في نيسان (أبريل) 2020.
cohortNthWeek	المجموعة النموذجية الأسبوعية	لا	معادلة الأسبوع مقارنةً بأولSessionDate للمستخدمين في المجموعة النموذجية. تبدأ الأسابيع يوم الأحد وتنتهي يوم السبت. على سبيل المثال، إذا تم اختيار مجموعة نموذجية بتاريخَي البدء والانتهاء في النطاقَين 2020-11-08 إلى 2020-11-14، فبالنسبة إلى التواريخ التي تقع في النطاق 2020-11-15 إلى 21-11-2020، سيكون أسبوع أنواع البيانات 0001.
contentGroup	مجموعة المحتوى	نعم	فئة تنطبق على عناصر المحتوى المنشور. وتتم التعبئة بواسطة مَعلمة الحدث content_group.
contentId	Content ID	نعم	معرّف المحتوى الذي تم اختياره وتتم التعبئة بواسطة مَعلمة الحدث content_id.
contentType	نوع المحتوى	نعم	فئة المحتوى المختار. وتتم التعبئة بواسطة مَعلمة الحدث content_type.
بلد	البلد	نعم	البلد الذي نشأ منه نشاط المستخدِم.
countryId	رقم تعريف البلد	نعم	رقم التعريف الجغرافي للبلد الذي نشأ منه نشاط المستخدِم، المستمد من عنوان IP الخاص بجهاز المستخدم. يتم تنسيقه وفقًا لمعيار ISO 3166-1 alpha-2.
التاريخ	التاريخ	نعم	تاريخ الحدث، بالتنسيق YYYYMMDD.
dateHour	التاريخ + الساعة (YYYYMMDDHH)	لا	القيم المجمّعة للتاريخ والساعة بالتنسيق YYYYMMDDHH.
dateHourMinute	التاريخ والساعة والدقيقة	لا	القيم المجمّعة للتاريخ والساعة والدقيقة بالتنسيق YYYYMMDDHHMM.
يوم	يوم	نعم	اليوم من الشهر، عدد مكوّن من رقمَين من 01 إلى 31.
dayOfWeek	يوم من الأسبوع	نعم	اليوم من الأسبوع. يعرض القيم في النطاق [0,6] بحيث يكون الأحد هو أول يوم من الأسبوع.
defaultChannelGrouping	التصنيف التلقائي للقنوات إلى مجموعات	لا	يستند التصنيف التلقائي للقنوات إلى مجموعات في الإحالة الناجحة إلى المصدر والوسيط بشكلٍ أساسي. تعداد يتضمّن Direct وOrganic Search وPaid Social وOrganic Social وEmail وAffiliates وReferral وPaid Search وVideo وDisplay.
deviceCategory	فئة الجهاز	نعم	نوع الجهاز: جهاز كمبيوتر مكتبي أو لوحي أو جوّال.
deviceModel	طراز الجهاز	نعم	طراز الجهاز الجوّال (على سبيل المثال: iPhone 10,6).
eventName	اسم الحدث	نعم	اسم الحدث
fileExtension	امتداد الملف	نعم	امتداد الملف الذي تم تنزيله (مثل pdf أو txt). تتم تعبئته تلقائيًا في حال تفعيل ميزة "القياس المحسَّن". وتتم التعبئة بواسطة مَعلمة الحدث file_extension.
fileName	اسم الملف	نعم	مسار الصفحة للملف الذي تم تنزيله (مثل /menus/dinner-menu.pdf)، وتتم تعبئته تلقائيًا في حال تفعيل "القياس المحسَّن". وتتم التعبئة بواسطة مَعلمة الحدث file_name.
firstSessionDate	تاريخ الجلسة الأولى	نعم	تاريخ حدوث أول جلسة للمستخدِم، والمنسق على هذا النحو: YYYYMMDD.
firstUserCampaignId	رقم تعريف حملة المستخدِم الجديد	لا	معرّف الحملة التسويقية التي اكتسبت المستخدم لأول مرة. ويشمل ذلك الحملات على "إعلانات Google".
firstUserCampaignName	حملة المستخدم الجديد	نعم	اسم الحملة التسويقية التي اكتسبت المستخدم لأول مرة. وتشمل "إعلانات Google" و"الحملات اليدوية".
firstUserDefaultChannelGrouping	التصنيف التلقائي للقنوات إلى مجموعات للمستخدم الجديد	نعم	التصنيف التلقائي للقنوات إلى مجموعات الذي اكتسبت المستخدِم للمرّة الأولى يستند التصنيف التلقائي للقنوات إلى مجموعات إلى المصدر والوسيط بشكلٍ أساسي. تعداد يتضمّن Direct وOrganic Search وPaid Social وOrganic Social وEmail وAffiliates وReferral وPaid Search وVideo وDisplay.
firstUserGoogleAdsAccountName	اسم الحساب على "إعلانات Google" للمستخدم الأول	لا	اسم الحساب من "إعلانات Google" الذي اكتسب المستخدم لأول مرة.
firstUserGoogleAdsAdGroupId	رقم تعريف المجموعة الإعلانية على "إعلانات Google" للمستخدم الأول	لا	رقم تعريف المجموعة الإعلانية في "إعلانات Google" الذي اكتسب المستخدم لأول مرة.
firstUserGoogleAdsAdGroupName	اسم المجموعة الإعلانية على "إعلانات Google" للمستخدِم الجديد	لا	اسم المجموعة الإعلانية في "إعلانات Google" التي اكتسبت المستخدم لأول مرة.
firstUserGoogleAdsAdNetworkType	نوع شبكة الإعلانات على "إعلانات Google" للمستخدِم الجديد	نعم	شبكة الإعلانات التي اكتسبت المستخدم لأول مرة. تعداد يتضمّن Google search وSearch partners وGoogle Display Network وYoutube Search وYoutube Videos وCross-network وSocial و(universal campaign).
firstUserGoogleAdsCampaignType	نوع الحملة على "إعلانات Google" للمستخدم الأول	لا	نوع حملة حملة "إعلانات Google" التي اكتسبت المستخدم لأول مرة. تحدِّد أنواع الحملات المواضع التي يشاهد فيها العملاء إعلاناتك والإعدادات والخيارات المتوفّرة لك في "إعلانات Google". نوع الحملة هو تعداد يتضمّن: "شبكة البحث" و"الشبكة الإعلانية" وShopping و"الفيديو" و"أثناء التصفّح" و"التطبيقات" و"الفنادق الذكية" و"الفنادق" و"المحلية" و"حملات الأداء الأفضل". ولمزيد من المعلومات، اطّلِع على اختيار نوع الحملة المناسب.
firstUserGoogleAdsCreativeId	رقم تعريف تصميم الإعلان على "إعلانات Google" للمستخدم الأول	لا	رقم تعريف تصميم الإعلان في "إعلانات Google" الذي اكتسب المستخدم لأول مرة. تحدّد أرقام تعريف تصميمات الإعلانات الإعلانات الفردية.
firstUserGoogleAdsCustomerId	الرقم التعريفي لعميل "إعلانات Google" للمستخدم الأول	لا	الرقم التعريفي للعميل من "إعلانات Google" الذي اكتسب المستخدم لأول مرة. تُحدِّد الأرقام التعريفية للعملاء في "إعلانات Google" حسابات "إعلانات Google" بشكلٍ فريد.
firstUserGoogleAdsKeyword	نص الكلمة الرئيسية في "إعلانات Google" للمستخدم الأول	لا	الكلمة الرئيسية المطابقة التي اكتسبت المستخدم لأول مرة. الكلمات الرئيسية هي كلمات أو عبارات تصف منتجك أو خدمتك وتختارها لعرض إعلانك أمام العملاء المناسبين. للاطّلاع على مزيد من المعلومات عن "الكلمات الرئيسية"، اطّلِع على تعريف الكلمات الرئيسية.
firstUserGoogleAdsQuery	الطلب في "إعلانات Google" للمستخدم الأول	لا	طلب البحث الذي اكتسب المستخدِم للمرّة الأولى
firstUserManualAdContent	محتوى الإعلان الموجَّه للمستخدِم الجديد والمزوَّد بعلامات مُضافة يدويًا	نعم	محتوى الإعلان الذي اكتسب المستخدِم للمرّة الأولى وتتم التعبئة بواسطة المَعلمة utm_content.
firstUserManualTerm	عبارة المستخدِم الجديد ذات العلامات المُضافة يدويًا	نعم	العبارة التي اكتسبت المستخدم لأول مرة. وتتم التعبئة بواسطة المَعلمة utm_term.
firstUserMedium	وسيط المستخدم الجديد	نعم	الوسيط الذي اكتسب المستخدِم للمرّة الأولى إلى موقعك الإلكتروني أو تطبيقك.
firstUserSource	مصدر المستخدم الجديد	نعم	المصدر الذي اكتسب المستخدم للمرة الأولى إلى موقعك الإلكتروني أو تطبيقك.
firstUserSourceMedium	مصدر/ وسيط المستخدِم الجديد	لا	القيم المجمّعة للسمتَين firstUserSource وfirstUserMedium.
firstUserSourcePlatform	منصّة المصدر للمستخدم الجديد	لا	المنصة المصدر التي اكتسبت المستخدم لأول مرة. لا تعتمد على هذا الحقل الذي يعرض القيمة Manual للزيارات التي تستخدم أنظمة مراقبة الزيارات من Urchin، لأنّه سيتم تعديل هذا الحقل من عرض Manual إلى عرض (not set) عند إطلاق ميزة قادمة.
fullPageUrl	عنوان URL الكامل للصفحة	لا	اسم المضيف ومسار الصفحة وسلسلة طلب البحث لصفحات الويب التي تمت زيارتها. على سبيل المثال، الجزء fullPageUrl من https://www.example.com/store/contact-us?query_string=true هو www.example.com/store/contact-us?query_string=true.
funnelStepName	الخطوة	لا	الاسم الوصفي الذي يتم تعيينه لخطوة مسار الإحالة الناجحة. على سبيل المثال، يؤدّي تحديد name = Purchase في الخطوة الثالثة في مسار الإحالة الناجحة إلى ظهور 3. Purchase للسمة funnelStepName هذه في استجابة تقرير مسار الإحالة الناجحة.
funnelStepNewVsContinuing	الجديد مقابل المستمر	لا	يواصل المستخدِم في الخطوات في مسار الإحالة الناجحة إذا كان متوفّرًا في الخطوة السابقة في مسار الإحالة الناجحة. وبخلاف ذلك، يكون هذا المستخدم جديدًا. هذه السمة مفيدة فقط لمسارات الإحالات الناجحة المفتوحة، وتعرض قيمتَين: new وcontinuing.
funnelStepNextAction	الإجراء التالي في مسار الإحالة الناجحة	لا	الإجراء التالي هو قيمة البُعد التالية التي يكتسبها المستخدم بعد إكمال الخطوة الحالية وتشمل إكمال الخطوة التالية. على سبيل المثال، إذا كان بُعد الإجراء التالي المطلوب هو eventName، تعرِض هذه السمة اسم الحدث التالي بعد تحقيق الخطوة الأولى، ولا يشمل هذا الإجراء التالي الحدث الذي وصل إلى الخطوة الأولى ويشمل الحدث الذي وصل إلى الخطوة الأولى من الخطوة الأولى.
googleAdsAccountName	اسم حساب "إعلانات Google"	لا	اسم الحساب من "إعلانات Google" للحملة التي أدّت إلى حدث الإحالة الناجحة. يتطابق مع customer.descriptive_name في Google Ads API.
googleAdsAdGroupId	رقم تعريف المجموعة الإعلانية على "إعلانات Google"	لا	رقم تعريف المجموعة الإعلانية المنسوب إلى حدث الإحالة الناجحة.
googleAdsAdGroupName	اسم المجموعة الإعلانية على "إعلانات Google"	لا	اسم المجموعة الإعلانية المنسوب إلى حدث الإحالة الناجحة.
googleAdsAdNetworkType	نوع شبكة الإعلانات على "إعلانات Google"	لا	نوع شبكة الإعلانات للإحالة الناجحة. تعداد يتضمّن Google search وSearch partners وGoogle Display Network وYoutube Search وYoutube Videos وCross-network وSocial و(universal campaign).
googleAdsCampaignType	نوع حملة "إعلانات Google"	لا	نوع الحملة لحملة "إعلانات Google" المنسوبة إلى حدث الإحالة الناجحة. تحدِّد أنواع الحملات المواضع التي يشاهد فيها العملاء إعلاناتك والإعدادات والخيارات المتوفّرة لك في "إعلانات Google". نوع الحملة هو تعداد يتضمّن: "شبكة البحث" و"الشبكة الإعلانية" وShopping و"الفيديو" و"أثناء التصفّح" و"التطبيقات" و"الفنادق الذكية" و"الفنادق" و"المحلية" و"حملات الأداء الأفضل". ولمزيد من المعلومات، اطّلِع على اختيار نوع الحملة المناسب.
googleAdsCreativeId	رقم تعريف تصميم الإعلان في "إعلانات Google"	لا	رقم تعريف تصميم الإعلان على "إعلانات Google" المنسوب إلى حدث الإحالة الناجحة. تحدّد أرقام تعريف تصميمات الإعلانات الإعلانات الفردية.
googleAdsCustomerId	الرقم التعريفي لعميل "إعلانات Google"	لا	الرقم التعريفي للعميل من "إعلانات Google" للحملة التي أدّت إلى حدث إحالة ناجحة تُحدِّد الأرقام التعريفية للعملاء في "إعلانات Google" حسابات "إعلانات Google" بشكلٍ فريد.
googleAdsKeyword	نص الكلمة الرئيسية على "إعلانات Google"	لا	الكلمة الرئيسية المطابقة التي أدت إلى حدث الإحالة الناجحة. الكلمات الرئيسية هي كلمات أو عبارات تصف منتجك أو خدمتك وتختارها لعرض إعلانك أمام العملاء المناسبين. للاطّلاع على مزيد من المعلومات عن "الكلمات الرئيسية"، اطّلِع على تعريف الكلمات الرئيسية.
googleAdsQuery	طلب البحث في "إعلانات Google"	لا	طلب البحث الذي أدى إلى حدث الإحالة الناجحة.
groupId	رقم تعريف المجموعة	نعم	رقم تعريف مجموعة اللاعبين في اللعبة أثناء وقوع الحدث. وتتم التعبئة بواسطة مَعلمة الحدث group_id.
hostName	اسم المضيف	نعم	يتضمن اسم النطاق الفرعي واسم النطاق لعنوان URL؛ على سبيل المثال، اسم المضيف للعنوان www.example.com/contact.html هو www.example.com.
ساعة	ساعة	نعم	الساعة المكوّنة من رقمَين من اليوم الذي تم فيه تسجيل الحدث. تتراوح هذه السمة بين 0 و23، ويتمّ تسجيلها في المنطقة الزمنية لموقعك.
isConversionEvent	هو حدث إحالة ناجحة	نعم	السلسلة true إذا كان الحدث إحالة ناجحة. يتمّ وضع علامة على الأحداث كإحالات ناجحة في وقت جمع البيانات، ويتمّ تطبيق التغييرات على علامة الإحالة الناجحة للحدث من الآن فصاعدًا. يمكنك وضع علامة على أي حدث لتصنيفه كإحالة ناجحة في "إحصاءات Google"، كما يمكنك تلقائيًا وضع علامة على بعض الأحداث (مثل first_open وpurchase) كإحالات ناجحة. للمزيد من المعلومات، اطّلِع على المقالة لمحة عن الإحالات الناجحة.
itemAffiliation	ارتباط السلعة	لا	اسم أو رمز الشريك التابع (الشريك/المورّد، إن وجد) المرتبط بسلعة فردية وتتم التعبئة بواسطة مَعلمة السلعة affiliation.
itemBrand	العلامة التجارية للسلعة	لا	اسم العلامة التجارية للسلعة.
itemCategory	فئة السلعة	لا	فئة التدرّج الهرمي التي تم تصنيف السلعة ضمنها. على سبيل المثال، في الملابس/الرجال/الصيف/القمصان/قمصان "تي شيرت"، "الملابس" هي فئة السلعة.
itemCategory2	فئة السلعة 2	لا	فئة التدرّج الهرمي التي تم تصنيف السلعة ضمنها. على سبيل المثال، في الملابس/الرجال/الصيف/القمصان/قمصان "تي شيرت"، "الرجال" هي فئة السلعة 2.
itemCategory3	فئة السلعة 3	لا	فئة التدرّج الهرمي التي تم تصنيف السلعة ضمنها. على سبيل المثال، في الملابس/الرجال/الصيف/القمصان/قمصان "تي شيرت"، "الصيف" هي فئة السلعة 3.
itemCategory4	فئة السلعة 4	لا	فئة التدرّج الهرمي التي تم تصنيف السلعة ضمنها. على سبيل المثال، في الملابس/الرجال/الصيف/القمصان/قمصان "تي شيرت"، "القمصان" هي فئة السلعة 4.
itemCategory5	فئة السلعة 5	لا	فئة التدرّج الهرمي التي تم تصنيف السلعة ضمنها. على سبيل المثال، في الملابس/الرجال/الصيف/القمصان/قمصان "تي شيرت"، "قمصان تي شيرت" هي فئة السلعة 5.
itemId	معرِّف السلعة	لا	معرّف العنصر.
itemListId	رقم تعريف قائمة السلع	لا	رقم تعريف قائمة السلع.
itemListName	اسم قائمة السلع	لا	اسم قائمة السلع.
itemName	اسم السلعة	لا	اسم السلعة.
itemPromotionCreativeName	اسم تصميم إعلان العرض الترويجي للسلعة	لا	اسم تصميم الإعلان للعرض الترويجي للسلعة.
itemPromotionId	معرّف العرض الترويجي للسلعة	لا	رقم تعريف العرض الترويجي للسلعة.
itemPromotionName	اسم العرض الترويجي للسلعة	لا	اسم العرض الترويجي للسلعة.
itemVariant	صيغة السلعة	لا	شكل المنتج المحدد. على سبيل المثال، XS أو S أو M أو L للحجم، أو الأحمر أو الأزرق أو الأخضر أو الأسود للون. وتتم التعبئة بواسطة المَعلمة item_variant.
landingPage	الصفحة المقصودة	نعم	مسار الصفحة + سلسلة طلب البحث المرتبطتَان بأول مشاهدة صفحة على الويب في إحدى الجلسات
language	Language	نعم	تشير هذه السمة إلى إعدادات اللغة في متصفّح المستخدم أو جهازه، مثل الإنجليزية.
languageCode	رمز اللغة	نعم	إعداد اللغة (ISO 639) في متصفّح المستخدم أو جهازه، على سبيل المثال، en-us
المستوى	المستوى	نعم	مستوى اللاعب في إحدى الألعاب. وتتم التعبئة بواسطة مَعلمة الحدث level.
linkClasses	فئات الروابط	نعم	سمة فئة HTML لرابط خارجي. على سبيل المثال، إذا نقر أحد المستخدِمين على الرابط <a class="center" href="www.youtube.com">، ستعرض هذه السمة القيمة center. تتم تعبئة هذا الحقل تلقائيًا في حال تفعيل "القياس المحسّن". وتتم التعبئة بواسطة مَعلمة الحدث link_classes.
linkDomain	نطاق الرابط	نعم	نطاق الوجهة للرابط الخارجي. على سبيل المثال، إذا نقر أحد المستخدِمين على الرابط <a href="www.youtube.com">، ستعرض هذه السمة القيمة youtube.com. تتم تعبئة هذا الحقل تلقائيًا في حال تفعيل "القياس المحسّن". وتتم التعبئة بواسطة مَعلمة الحدث link_domain.
linkId	رقم تعريف الرابط	نعم	سمة معرّف HTML لرابط خارجي أو لعملية تنزيل ملفّ. على سبيل المثال، إذا نقر أحد المستخدِمين على الرابط <a id="socialLinks" href="www.youtube.com">، ستعرض هذه السمة القيمة socialLinks. تتم تعبئة هذا الحقل تلقائيًا في حال تفعيل "القياس المحسّن". وتتم التعبئة بواسطة مَعلمة الحدث link_id.
linkText	نص الرابط	نعم	نص الرابط الخاص بتنزيل الملف. تتم تعبئة هذا الحقل تلقائيًا في حال تفعيل "القياس المحسّن". وتتم التعبئة بواسطة مَعلمة الحدث link_text.
linkUrl	عنوان URL للرابط	نعم	عنوان URL الكامل لرابط خارجي أو لعملية تنزيل ملفّ. على سبيل المثال، إذا نقر أحد المستخدِمين على الرابط <a href="https://www.youtube.com/results?search_query=analytics">، ستعرض هذه السمة القيمة https://www.youtube.com/results?search_query=analytics. تتم تعبئة هذا الحقل تلقائيًا في حال تفعيل "القياس المحسّن". وتتم التعبئة بواسطة مَعلمة الحدث link_url.
manualAdContent	محتوى الإعلان المضاف يدويًا	لا	محتوى الإعلان المنسوب إلى حدث الإحالة الناجحة. وتتم التعبئة بواسطة المَعلمة utm_content.
manualTerm	العبارة المضافة يدويًا	لا	العبارة المنسوبة إلى حدث الإحالة الناجحة. وتتم التعبئة بواسطة المَعلمة utm_term.
متوسط	الوسيط	لا	الوسيط المنسوب إلى حدث الإحالة الناجحة.
method	الطريقة	نعم	الطريقة التي تم بها تشغيل الحدث. وتتم التعبئة بواسطة مَعلمة الحدث method.
دقيقة واحدة	الدقيقة	لا	الدقيقة المكوّنة من رقمَين من الساعة التي تم فيها تسجيل الحدث. تتراوح هذه السمة بين 0 و59، ويتمّ تسجيلها حسب المنطقة الزمنية لموقعك.
mobileDeviceBranding	العلامة التجارية للجهاز	نعم	اسم الشركة المصنّعة أو اسم العلامة التجارية (أمثلة: Samsung وHTC وVerizon وT-Mobile).
mobileDeviceMarketingName	الجهاز	نعم	اسم الجهاز الذي يحمل العلامة التجارية (أمثلة: Galaxy S10 أو P30 Pro).
mobileDeviceModel	طراز الجهاز الجوّال	نعم	اسم طراز الجهاز الجوّال (أمثلة: iPhone X أو SM-G950F).
شهر	الشهر	نعم	شهر الحدث، وهو عدد صحيح مكوّن من رقمَين من 01 إلى 12.
newVsReturning	المستخدم الجديد/المستخدم المكرر الزيارة	نعم	يسجِّل المستخدمون الجدد 0 جلسة سابقة، ويحصل المستخدمون المكرّرو الزيارة على جلسة سابقة واحدة أو أكثر. تعرِض هذه السمة قيمتَين: new أو returning.
nthDay	ترتيب اليوم	لا	عدد الأيام التي مرت منذ بداية النطاق الزمني.
nthHour	ترتيب الساعة	لا	عدد الساعات التي مرّت منذ بداية النطاق الزمني. ساعة البدء هي 0000.
nthMinute	ترتيب الدقيقة	لا	عدد الدقائق التي مرّت منذ بداية النطاق الزمني. ودقيقة البدء هي 0000.
nthMonth	ترتيب الشهر	لا	عدد الأشهر التي مرت منذ بداية النطاق الزمني. وشهر البدء هو 0000.
nthWeek	ترتيب الأسبوع	لا	رقم يمثّل عدد الأسابيع التي مرّت منذ بداية نطاق زمني.
nthYear	ترتيب السنة	لا	عدد السنوات التي مرت منذ بداية النطاق الزمني. وسنة البدء هي 0000.
operatingSystem	نظام التشغيل	نعم	أنظمة التشغيل التي استخدمها زوّار تطبيقك أو موقعك الإلكتروني. وتشمل أنظمة تشغيل أجهزة الكمبيوتر المكتبي والأجهزة الجوّالة، مثل Windows وAndroid.
operatingSystemVersion	إصدار نظام التشغيل	نعم	إصدارات نظام التشغيل التي استخدمها زوّار موقعك الإلكتروني أو تطبيقك. على سبيل المثال، إصدار Android 10 هو 10، وإصدار iOS 13.5.1 هو 13.5.1.
operatingSystemWithVersion	نظام التشغيل مع الإصدار	نعم	نظام التشغيل والإصدار على سبيل المثال، Android 10 أو Windows 7.
orderCoupon	قسيمة الطلب	نعم	رمز القسيمة على مستوى الطلب.
رحلة ذهاب	رسالة صادرة	نعم	تعرض true إذا لم يكن الرابط الذي يؤدي إلى موقع إلكتروني جزءًا من نطاق الموقع. تتم تعبئة هذا الحقل تلقائيًا في حال تفعيل "القياس المحسّن". وتتم التعبئة بواسطة مَعلمة الحدث outbound.
pageLocation	موقع الصفحة	نعم	البروتوكول واسم المضيف ومسار الصفحة وسلسلة طلب البحث لصفحات الويب التي تمت زيارتها. على سبيل المثال، الجزء pageLocation من https://www.example.com/store/contact-us?query_string=true هو https://www.example.com/store/contact-us?query_string=true. وتتم التعبئة بواسطة مَعلمة الحدث page_location.
pagePath	مسار الصفحة	لا	الجزء من عنوان URL بين اسم المضيف وسلسلة طلب البحث لصفحات الويب التي تمت زيارتها. على سبيل المثال، جزء pagePath في https://www.example.com/store/contact-us?query_string=true هو /store/contact-us.
pagePathPlusQueryString	مسار الصفحة + سلسلة طلب البحث	نعم	الجزء من عنوان URL الذي يلي اسم المضيف لصفحات الويب التي تمّت زيارتها، على سبيل المثال، جزء pagePathPlusQueryString في https://www.example.com/store/contact-us?query_string=true هو /store/contact-us?query_string=true.
pageReferrer	مُحيل الصفحة	نعم	عنوان URL للإحالة بالكامل، بما في ذلك اسم المضيف والمسار. عنوان URL للإحالة هذا هو عنوان URL السابق للمستخدم، ويمكن أن يكون نطاق هذا الموقع الإلكتروني أو نطاقات أخرى. وتتم التعبئة بواسطة مَعلمة الحدث page_referrer.
pageTitle	عنوان الصفحة	نعم	عناوين صفحات الويب المستخدَمة على موقعك الإلكتروني.
percentScrolled	النسبة المئوية للانتقال	نعم	النسبة المئوية التي تُظهِر مدى انتقال المستخدم إلى أسفل الصفحة (على سبيل المثال، 90). تتم تعبئته تلقائيًا في حال تفعيل "القياس المحسَّن". وتتم التعبئة بواسطة مَعلمة الحدث percent_scrolled.
platform	النظام الأساسي	نعم	النظام الأساسي الذي تم تشغيل تطبيقك أو موقعك الإلكتروني عليه، على سبيل المثال، ويب أو iOS أو Android. لتحديد نوع مصدر بيانات في أحد التقارير، استخدِم كلاً من النظام الأساسي ومعرّف مصدر البيانات.
platformDeviceCategory	النظام الأساسي / فئة الجهاز	نعم	النظام الأساسي ونوع الجهاز الذي تم تشغيل موقعك الإلكتروني أو تطبيقك المتوافق مع الأجهزة الجوّالة عليه. (مثال: Android / الأجهزة الجوّالة)
المنطقة	منطقة	نعم	المنطقة الجغرافية التي نشأ منها نشاط المستخدم، المستمدة من عنوان IP للمستخدم.
screenResolution	درجة دقة الشاشة	نعم	درجة دقة شاشة المستخدِم. على سبيل المثال، 1920×1080.
searchTerm	عبارة البحث	نعم	العبارة التي بحث عنها المستخدِم. على سبيل المثال، إذا زار المستخدِم /some-page.html?q=some-term، تعرِض هذه السمة some-term. تتم تعبئة هذا الحقل تلقائيًا في حال تفعيل "القياس المحسّن". وتتم التعبئة بواسطة مَعلمة الحدث search_term.
قسم	تقسيم	لا	الشريحة هي مجموعة فرعية من بيانات "إحصاءات Google". على سبيل المثال، من بين المجموعة الكاملة من مستخدِمي موقعك، قد تتألف إحدى الشرائح من المستخدِمين من بلد معيّن أو مدينة معيّنة. لمزيد من المعلومات، راجع أداة إنشاء الشرائح. تعرض سمة الشريحة الاسم المعيّن للمقطع في الطلب ببادئة مستندة إلى 1 (على سبيل المثال، إذا تمت تسمية المقطع الأول بـ Paid Traffic في الطلب، ستكون هذه الشريحة 1. Paid Traffic في الرد). إذا لم يتم تحديد أسماء المقاطع في الطلب، تتم تسمية المقاطع بأسماء قائمة على 1 (مثل 1. Segment و2. Segment وما إلى ذلك).
sessionCampaignId	رقم تعريف حملة الجلسة	لا	رقم تعريف الحملة التسويقية لجلسة معيّنة. يتضمّن "الحملات اليدوية" و"الحملات" من عمليات ربط الدمج مثل "إعلانات Google" و"إعلانات شبكة البحث 360".
sessionCampaignName	حملة الجلسة	نعم	اسم الحملة التسويقية لجلسة معيّنة. يتضمّن "الحملات اليدوية" و"الحملات" من عمليات ربط الدمج مثل "إعلانات Google" و"إعلانات شبكة البحث 360".
sessionDefaultChannelGrouping	التصنيف التلقائي للقنوات إلى مجموعات المتعلق بالجلسات	نعم	يستند التصنيف التلقائي للقنوات إلى مجموعات للجلسة إلى المصدر والوسيط بشكلٍ أساسي. تعداد يتضمّن Direct وOrganic Search وPaid Social وOrganic Social وEmail وAffiliates وReferral وPaid Search وVideo وDisplay.
sessionGoogleAdsAccountName	اسم حساب "إعلانات Google" المنسوب إلى الجلسة	لا	اسم الحساب من "إعلانات Google" الذي أدّى إلى الجلسة. يتطابق مع customer.descriptive_name في Google Ads API.
sessionGoogleAdsAdGroupId	رقم تعريف المجموعة الإعلانية على "إعلانات Google" المنسوب إلى الجلسة	لا	رقم تعريف المجموعة الإعلانية في "إعلانات Google" لإحدى الجلسات.
sessionGoogleAdsAdGroupName	اسم المجموعة الإعلانية على "إعلانات Google" المنسوب إلى الجلسة	لا	اسم المجموعة الإعلانية في "إعلانات Google" لإحدى الجلسات.
sessionGoogleAdsAdNetworkType	نوع شبكة الإعلانات على "إعلانات Google" المنسوب إلى الجلسة	نعم	شبكة الإعلانات التي أدّت إلى الجلسة تعداد يتضمّن Google search وSearch partners وGoogle Display Network وYoutube Search وYoutube Videos وCross-network وSocial و(universal campaign).
sessionGoogleAdsCampaignType	نوع الحملة على "إعلانات Google" المنسوب إلى الجلسة	لا	نوع الحملة للحملة على "إعلانات Google" التي أدّت إلى هذه الجلسة. تحدِّد أنواع الحملات المواضع التي يشاهد فيها العملاء إعلاناتك والإعدادات والخيارات المتوفّرة لك في "إعلانات Google". نوع الحملة هو تعداد يتضمّن: "شبكة البحث" و"الشبكة الإعلانية" وShopping و"الفيديو" و"أثناء التصفّح" و"التطبيقات" و"الفنادق الذكية" و"الفنادق" و"المحلية" و"حملات الأداء الأفضل". ولمزيد من المعلومات، اطّلِع على اختيار نوع الحملة المناسب.
sessionGoogleAdsCreativeId	رقم تعريف تصميم الإعلان في "إعلانات Google" للجلسة	لا	رقم تعريف تصميم الإعلان على "إعلانات Google" الذي يؤدّي إلى جلسة على موقعك الإلكتروني أو تطبيقك. وتحدِّد أرقام تعريف تصميمات الإعلانات إعلانات فردية.
sessionGoogleAdsCustomerId	الرقم التعريفي للعميل على "إعلانات Google" المنسوب إلى المستخدم	لا	الرقم التعريفي للعميل من "إعلانات Google" الذي أدّى إلى الجلسة. تُحدِّد الأرقام التعريفية للعملاء في "إعلانات Google" حسابات "إعلانات Google" بشكلٍ فريد.
sessionGoogleAdsKeyword	نص الكلمات الرئيسية في "إعلانات Google" المنسوب إلى الجلسة	لا	الكلمة الرئيسية المطابقة التي أدّت إلى الجلسة الكلمات الرئيسية هي كلمات أو عبارات تصف منتجك أو خدمتك وتختارها لعرض إعلانك أمام العملاء المناسبين. لمزيد من المعلومات عن "الكلمات الرئيسية"، اطّلِع على تعريف [الكلمات الرئيسية: تعريف

](//support.google.com/google-ads/answer/6323). sessionGoogleAdsQuery | طلب البحث في "إعلانات Google" للجلسة | لا | طلب البحث الذي أدّى إلى الجلسة. sessionGuideContent | محتوى الإعلان المضاف يدويًا للجلسة | نعم | محتوى الإعلان الذي أدّى إلى تسجيل جلسة. وتتم التعبئة بواسطة مَعلمة utm_content. sessionGuideterm | العبارة اليدوية للجلسة | نعم | العبارة التي أدّت إلى تسجيل جلسة تتم تعبئة هذه البيانات بواسطة المَعلمة utm_term. sessionMedium | وسيط الجلسة | نعم | الوسيط الذي بدأ جلسة على موقعك الإلكتروني أو تطبيقك. sessionSa360AdGroupName | اسم المجموعة الإعلانية في "إعلانات شبكة البحث 360" | لا | اسم المجموعة الإعلانية من "إعلانات شبكة البحث 360" الذي أدّى إلى هذه الجلسة. sessionSa360CampaignName | الجلسة SA360 للجلسة من نوع "إعلانات شبكة البحث" التي أدّت إلى هذه الجلسة | لا | تنسيق هذا الإعلان. على سبيل المثال، Responsive search ad أو Expanded text ad. للاطّلاع على مزيد من المعلومات، يمكنك الاطّلاع على سمات مصدر الزيارات في "إحصاءات Google 4". sessionSa360EngineAccountId | رقم تعريف حساب محرّك البحث الخاص بالجلسة في "إعلانات شبكة البحث 360" | لا | رقم تعريف حساب محرّك البحث في "إعلانات شبكة البحث 360" الذي أدّى إلى هذه الجلسة. sessionSa360EngineAccountName | اسم حساب محرك البحث في "إعلانات شبكة البحث 360" | لا | اسم حساب محرّك البحث في نوع الحساب SA360 الذي نتج عنه محرك البحث SA360 | نوع الجلسة S360 | نوع الجلسة S3. على سبيل المثال، google ads أو bing أو baidu. الجلسات مثلاً: cpc الجلسات على سبيل المثال، example.com أو google. مصدر الجلسة | مصدر الجلسة | نعم | المصدر الذي بدأ جلسة على موقعك الإلكتروني أو تطبيقك. sessionSourceMedium | مصدر / وسيط الجلسة | لا | القيم المجمّعة للسمتَين sessionSource وsessionMedium. sessionSourcePlatform | منصة مصدر الجلسة | لا | النظام الأساسي المصدر لحملة الجلسة. لا تعتمد على هذا الحقل الذي يُرجع Manual للزيارات التي تستخدم أنظمة مراقبة الزيارات من Urchin، لأنّه سيتم تعديل هذا الحقل من إرجاع Manual إلى إرجاع (not set) عند إطلاق ميزة قادمة. shippingTier | فئة الشحن | لا | فئة الشحن (على سبيل المثال، الشحن البري أو الجوي أو الشحن في اليوم التالي) التي تم اختيارها لتسليم السلعة المشتراة. وتتم التعبئة بواسطة مَعلمة الحدث shipping_tier. SignedInWithUserId | تم تسجيل الدخول باستخدام رقم تعريف المستخدم | نعم | السلسلة yes إذا سجَّل المستخدم الدخول باستخدام ميزة User-ID. للمزيد من المعلومات عن User-ID، اطّلِع على قياس النشاط على جميع المنصّات باستخدام User-ID. المصدر | المصدر | لا | المصدر المنسوب إلى حدث الإحالة الناجحة. المصدر | المصدر / الوسيط | لا | القيم المجمّعة للسمتَين source وmedium. sourcePlatform | منصة المصدر | لا | النظام الأساسي المصدر لحملة حدث الإحالة الناجحة. لا تعتمد على هذا الحقل الذي يعرض Manual للزيارات التي تستخدم أنظمة مراقبة الزيارات من Urchin، سيتم تعديل هذا الحقل من عرض Manual إلى عرض (not set) عند إطلاق ميزة قادمة. streamId | رقم تعريف مصدر البيانات | نعم | رقم تعريف مصدر البيانات الرقمي لتطبيقك أو موقعك الإلكتروني. streamName | اسم مصدر البيانات | نعم | اسم مصدر البيانات لتطبيقك أو موقعك الإلكتروني. testDataFilterName | اسم فلتر البيانات التجريبي | لا | اسم فلاتر البيانات في حالة الاختبار. ويمكنك استخدام فلاتر البيانات لتضمين بيانات الأحداث أو استثنائها من تقاريرك التي تستند إلى قيم مَعلمات الحدث. لمعرفة المزيد من المعلومات، يُرجى الاطّلاع على فلاتر البيانات. اسم المستخدم الذي تم تسجيله في الحقل (نعم، مَعلمة "نوع العنصر" | رقم تعريفyoutube وتتم التعبئة بواسطة مَعلمة الحدث video_provider. videoTitle | عنوان الفيديو | نعم | عنوان الفيديو تتم تعبئة هذا الحقل تلقائيًا للفيديوهات المضمّنة في حال تفعيل "القياس المحسّن". وتتم التعبئة بواسطة مَعلمة الحدث video_title. videoUrl | عنوان URL للفيديو | نعم | عنوان URL للفيديو تتم تعبئة هذا الحقل تلقائيًا للفيديوهات المضمّنة في حال تفعيل "القياس المحسّن". وتتم التعبئة بواسطة مَعلمة الحدث video_url. VirtualCurrencyName | اسم العملة الافتراضية | نعم | اسم العملة الافتراضية التي يتفاعل معها المستخدم. على سبيل المثال، إنفاق جواهر أو شراءها في لعبة معيّنة. وتتم التعبئة بواسطة معلّمة الحدث virtual_currency_name. مرئي | مرئي | نعم | يعرض true إذا كان المحتوى مرئيًا. تتم تعبئة هذا الحقل تلقائيًا للفيديوهات المضمّنة في حال تفعيل "القياس المحسّن". وتتم التعبئة بواسطة مَعلمة الحدث visible. أسبوع | الأسبوع | نعم | أسبوع الحدث، رقم يتكوّن من رقمَين من 01 إلى 53. يبدأ كل أسبوع يوم الأحد. 1 كانون الثاني (يناير) دائمًا في الأسبوع 01. يكون للأسبوع الأول والأخير من العام أقل من 7 أيام في معظم السنوات. تحتوي الأسابيع بخلاف الأسبوع الأول والأخير من السنة دائمًا على 7 أيام. بالنسبة إلى السنوات التي يكون فيها 1 كانون الثاني (يناير) هو أحد أيام الأحد، يكون للأسبوع الأول من تلك السنة والأسبوع الأخير من العام السابق 7 أيام. السنة | السنة | نعم | السنة المكوّنة من أربعة أرقام للفعالية، على سبيل المثال، 2020.

السمات المخصّصة

يمكن لواجهة Data API إنشاء تقارير عن السمات المخصّصة على مستوى الحدث والمستخدم. اطّلِع على تقارير السمات والمقاييس المخصَّصة على مستوى الحدث وخصائص المستخدِمين المخصَّصة لمعرفة مزيد من المعلومات عن السمات المخصَّصة. يتمّ تحديد السمات المخصّصة في طلب تقرير واجهة برمجة التطبيقات حسب اسم مَعلمة السمة ونطاقها. على سبيل المثال، يمكنك تضمين "customEvent:achievement_id" في طلب Data API لإنشاء تقرير للسمة المخصّصة على مستوى الحدث مع اسم المَعلمة "achievement_id". سيتعذّر تنفيذ طلب البيانات من واجهة برمجة التطبيقات هذا إذا لم يسجِّل الموقع هذه السمة المخصّصة على مستوى الحدث.

إذا تمّ تسجيل سمة مخصَّصة على مستوى الحدث قبل تشرين الأول (أكتوبر) 2020، يجب تحديد السمة في طلب بيانات من واجهة برمجة التطبيقات واسم الحدث المتعلق بها. على سبيل المثال، يمكنك تضمين "customEvent:achievement_id\[level_up\]" للسمة المخصّصة على مستوى الحدث مع اسم المَعلمة "achievement_id" واسم الحدث "level_up". في تشرين الأول (أكتوبر) 2020، استبدلت "إحصاءات Google" تقارير المَعلمات المخصَّصة بتقارير السمات والمقاييس المخصَّصة على مستوى الحدث.

في ما يلي البنية العامة للمكوّنات المخصّصة. يمكنك إجراء طلب بحث في طريقة Metadata API لإدراج جميع السمات المخصصة لموقع. وفي ما يلي مثال على استخدام طريقة Metadata API.

الاسم العام لواجهة برمجة التطبيقات	متاح في "الشرائح"	الوصف
customEvent:parameter_name	نعم	السمة المخصّصة على مستوى الحدث لـ parameter_name
customEvent:parameter_name[event_name]	نعم	السمة المخصّصة على مستوى الحدث المَعلمة_name في حال تسجيلها قبل تشرين الأول (أكتوبر) 2020
customUser:parameter_name	نعم	السمة المخصّصة على مستوى المستخدِم للمَعلمة parameter_name

مجموعات القنوات المخصَّصة

يمكن لواجهة Data API إنشاء تقارير عن مجموعات القنوات المخصَّصة. لمزيد من المعلومات عن مجموعات القنوات المخصَّصة، اطّلِع على مقالة مجموعات القنوات المخصَّصة في "إحصاءات Google 4". يتم تحديد مجموعات القنوات المخصَّصة في طلب تقرير واجهة برمجة التطبيقات من خلال نطاق السمة ورقم تعريف مجموعة القنوات. على سبيل المثال، يمكنك تضمين "sessionCustomChannelGroup:9432931" في طلب Data API لإنشاء تقرير للقناة المخصّصة على مستوى الجلسة برقم تعريف 9432931. ولن نتمكّن من تنفيذ طلب البيانات من واجهة برمجة التطبيقات هذا إذا لم يكن للموقع قناة مخصّصة تحمل هذا المعرّف.

في ما يلي البنية العامة لمجموعات القنوات المخصَّصة. يمكنك إرسال طلب بحث عن طريقة Metadata API لإدراج جميع مجموعات القنوات المخصَّصة لأحد المواقع.

الاسم العام لواجهة برمجة التطبيقات	الوصف
sessionCustomChannelGroup:custom_channel_id	القناة المخصّصة التي تؤدي إلى هذه الجلسة.
firstUserCustomChannelGroup:custom_channel_id	القناة المخصّصة التي اكتسبت هذا المستخدم لأول مرة.
customChannelGroup:custom_channel_id	القناة المخصّصة التي أدت إلى حدث الإحالة الناجحة.

المقاييس

يمكن أن تتوفّر المقاييس التالية في تقارير مسارات الإحالات الناجحة لأي موقع.

اسم واجهة برمجة التطبيقات	اسم واجهة المستخدم	الوصف
activeUsers	المستخدِمون النشطون	عدد المستخدمين المختلفين الذين زاروا موقعك الإلكتروني أو تطبيقك.
funnelStepAbandonmentRate	معدّل التراجع	النسبة المئوية للمستخدِمين الذين غادروا مسار الإحالة الناجحة في هذه الخطوة. يتمّ عرض هذا المقياس ككسر. على سبيل المثال، تعني 0.412 أنّ% 41.2 من المستخدِمين غادروا مسار الإحالة الناجحة في هذه الخطوة.
funnelStepAbandonments	مرات العزوف	العدد المطلق للمستخدمين الذين يغادرون مسار الإحالة الناجحة في هذه الخطوة.
funnelStepCompletionRate	معدّل مشاهدة الفيديو بالكامل	النسبة المئوية للمستخدِمين الذين يُكملون هذه الخطوة من مسار الإحالة الناجحة. يتمّ عرض هذا المقياس ككسر. على سبيل المثال، تعني 0.588 أنّ% 58.8 من المستخدِمين أكملوا هذه الخطوة في مسار الإحالة الناجحة.