ربط مَعلمات ValueTrack بحقول التقارير

ValueTrack هي معلمات عناوين URL يمكنك إضافتها إلى عناوين URL للصفحات المقصودة لإعلاناتك، وهي تجمع معلومات عن مصدر النقرات على إعلاناتك. ويكون استخدامها مفيدًا إذا كنت تسعى إلى معرفة المزيد عن النقرات على إعلانك أو إذا كنت قد بدأت للتو في استخدام التتبُّع.

عند تفعيل وضع العلامات التلقائي، تتم إضافة معرّف النقرة من Google‏ (GCLID) تلقائيًا إلى كل عنوان URL يمكن استخدامه لاحقًا لربط نقرة على إعلان بصف في التقرير.

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

توفّر إحصاءات Google وواجهة برمجة التطبيقات المرتبطة بها خيارًا آخر لجمع مقاييس النقرات.

تتضمّن تقارير Google Ads API مواردًا وطرق عرض يمكنك من خلالها طلب الحقول التي تتوافق مع مَعلمات ValueTrack. ومع ذلك، لا يتضمّن الحقل الذي تم ربطه بالضرورة قيمة نصية مطابقة. على سبيل المثال، عندما تكون {matchType} مساوية e (وهي اختصار للمطابقة التامة)، سيظهر في حقل التقرير المقابل، مثل ad_group_criterion.keyword.match_type، الرمز EXACT. يتم عرض بعض الأمثلة على عمليات الربط في الجدول التالي.

كيفية ربط مَعلمات ValueTrack بحقول التقارير

مَعلمة ValueTrack	الحقول في مراجع التقارير	الوصف
{adgroupid}	ad_group.id	رقم تعريف المجموعة الإعلانية. (استخدِم هذه المَعلمة عندما تنتهي من إعداد معلومات التتبّع على مستوى الحساب أو الحملة وتريد معرفة المجموعة الإعلانية التي عرضت إعلانك).
{adposition}	تتم مطابقة هذه السمة مع إحدى الحالات التالية: click_view.page_number segments.slot لا يتوفّر حقل يربط بموقع الإعلان، مثل "أعلى الصفحة" أو "الجانب".	الموضع الذي ظهر فيه إعلانك على الصفحة، وتكون له قيمة معينة ولتكن "1t2" مثلاً (ويعني ذلك الصفحة 1، في الأعلى، الموضع 2).
{advanced_booking_window}	segments.hotel_booking_window_days	عدد الأيام بين تاريخ النقر على الإعلان وتاريخ تسجيل الوصول المعلِن عنه على سبيل المثال، "3" لإعلان تم النقر عليه في 5 حزيران (يونيو) مع تاريخ تسجيل الوصول في 8 حزيران (يونيو).
{campaignid}	campaign.id	رقم تعريف الحملة. (استخدِم هذه المَعلمة عندما تنتهي من إعداد معلومات التتبّع على مستوى الحساب وتريد معرفة الحملة التي عرضت إعلانك).
{creative}	ad_group_ad.ad.id	معرّف فريد لإعلانك.
{device}	segments.device	نوع الجهاز الذي تمّت منه النقرة.
{feeditemid}	feed_item.id	رقم تعريف الإضافة المستندة إلى الخلاصة التي تم النقر عليها
{extensionid}	asset.id	رقم تعريف الإضافة المستندة إلى مادة العرض التي تم النقر عليها
{hotelcenter_id}	segments.hotel_center_id	رقم تعريف حساب Hotel Center المرتبط بالحملة التي أدّت إلى إنشاء الإعلان عند النقر عليه
{hotel_id}	segments.partner_hotel_id	رقم تعريف الفندق من خلاصة الفندق للحساب المرتبط
{keyword}	segments.keyword.ad_group_criterion يُرجى العِلم أنّه يمكن العثور على طلب البحث النصي باستخدام اسم مورد المعيار.	بالنسبة إلى "شبكة بحث Google"، الكلمة الرئيسية من حسابك التي تتطابق مع طلب البحث. مع الشبكة الإعلانية: الكلمة الرئيسية من حسابك التي تتم مطابقتها مع المحتوى.
{loc_interest_ms}	click_view.area_of_interest.most_specific	رقم تعريف الموقع الجغرافي محل الاهتمام الذي ساعد على عرض الإعلان. (يمكنك البحث عن معرّف معيار باستخدام GeoTargetConstantService.SuggestGeoTargetConstants)
{loc_physical_ms}	click_view.location_of_presence.most_specific	رقم تعريف الموقع الجغرافي للنقرة. (يمكنك البحث عن معرّف معيار باستخدام GeoTargetConstantService.SuggestGeoTargetConstants)
{lpurl}	ad_group_ad.ad.final_urls ad_group_criterion.final_urls	عنوان URL النهائي. وسيتم تخطّيه ما لم تضع المعلمة {lpurl} في بداية نموذج التتبّع. إذا لم تكن المَعلمة {lpurl} في بداية نموذج التتبّع لديك، سيتم تخطّي الأحرف التالية: ? و= و" و# و\t و' و[space].
{matchtype}	ad_group_criterion.keyword.match_type feed_item_target.keyword.match_type shared_criterion.keyword.match_type segments.search_term_match_type	نوع مطابقة الكلمة الرئيسية التي أدت إلى ظهور إعلانك. (مزيد من المعلومات عن أنواع المطابقة)
{merchant_id}	segments.product_merchant_id	يتضمّن رقم تعريف الحساب في Google Merchant Center إعلان Shopping الذي تم النقر عليه مباشرةً.
{placement}	ad_group_criterion.placement.url group_placement_view.display_name	الموقع الإلكتروني في "شبكة Google الإعلانية" حيث تم النقر على إعلانك (للحملات التي تستهدِف الكلمات الرئيسية)، أو معايير استهداف مواضع الإعلان المطابقة للموقع الإلكتروني حيث تم النقر على إعلانك (للحملات التي تستهدِف مواضع الإعلان).
{product_channel}	segments.product_channel	نوع قناة التسوق التي تم من خلالها بيع المنتج المعروض في "إعلان قائمة المنتجات" الذي تم النقر عليه.
{product_country}	segments.product_country	بلد بيع المنتج المدرج في الإعلان الذي تم النقر عليه.
{product_id}	segments.product_item_id	رقم تعريف المنتج المعروض في الإعلان الذي تم النقر عليه، كما هو موضح في خلاصة بياناتك على Merchant Center.
{product_language}	segments.product_language	لغة معلومات المنتج، كما هو موضّح في خلاصة بياناتك على Merchant Center.
{product_partition_id}	ad_group_criterion.criterion_id	رقم التعريف الفريد لمجموعة المنتجات التي ينتمي إليها إعلان المنتج الذي تم النقر عليه.
{rate_rule_id}	segments.hotel_rate_rule_id	رقم تعريف أي سعر خاص تم النقر عليه. يمكن للمعلِنين في مجال السفر تطبيق أسعار مشروطة على مستخدمين محدّدين (مثل المشتركين في برنامج الولاء)، وأجهزة محدّدة (مثل خصم لمستخدِمي الأجهزة الجوالة)، وبلدان معيّنة.
{store_code}	segments.product_store_id	من خلال حملة تستخدم قناة التسوّق المحلية، سترى المعرّف الفريد للمتجر المحلي.
{targetid}	ad_group_criterion.criterion_id segments.keyword.ad_group_criterion segments.webpage	رقم تعريف الكلمة الرئيسية (تصنيف "kwd") أو استهداف الإعلان الديناميكي على شبكة البحث ("dsa") أو استهداف قائمة تجديد النشاط التسويقي ("aud") الذي أدى إلى ظهور إعلان. على سبيل المثال، إذا أضفت قائمة تجديد نشاط تسويقي إلى مجموعتك الإعلانية (رقم تعريف المعيار "456") واستهدفت رقم تعريف الكلمة الرئيسية "123"، ستحلّ "kwd-123:aud-456" محلّ معرّف {targetid}.
{travel_start_day} {travel_start_month} {travel_start_year}	segments.hotel_check_in_date	اليوم/الشهر/السنة في تاريخ تسجيل الوصول المعروض في الإعلان

كيفية ربط مَعلمات ValueTrack بين واجهة مستخدم "إعلانات Google" وGoogle Ads API

يُجري هذا الجدول عملية ربط بين مَعلمات ValueTrack في واجهة مستخدم Google Ads API وGoogle Ads API، وتحديدًا قيم تعداد AdNetworkType.

اسم واجهة المستخدم	تعداد واجهة برمجة التطبيقات	المَعلمة ValueTrack	ملاحظات
شبكة Google الإعلانية	CONTENT	d	بالنسبة إلى "شركاء فيديو Google" الذين يستخدمون المَعلمة ValueTrackvp، ستظهر هذه المَعلمة أيضًا على النحو CONTENT في واجهة برمجة التطبيقات.
Google TV	GOOGLE_TV	gtv
الشبكة المتقاطعة	MIXED	x	يُرجى العِلم أنّه لا تتوفّر دائمًا المَعلمة ValueTrack.
بحث Google	البحث	g
شركاء البحث	SEARCH_PARTNERS	s
لا ينطبق	UNKNOWN	لا ينطبق	إذا كانت Google Ads API لا تتوافق مع التعداد حتى الآن، ولكن التعداد متوفّر في واجهة المستخدم، ستعرض Google Ads API القيمة UNKNOWN.
لا ينطبق	UNSPECIFIED	لا ينطبق
YouTube	YOUTUBE	ytv
القنوات التي تملكها Google	UNKNOWN		لا تعرض "حملات زيادة الطلب" المَعلمة ValueTrack للشبكة.