ربط مَعلمات 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}	لا شيء (تم إيقافها نهائيًا، استخدِم asset.id مع {extensionid})	رقم تعريف الإضافة المستنِدة إلى الخلاصة التي تمّ النقر عليها ملاحظة: تم إيقاف الإضافات المستندة إلى الخلاصة نهائيًا، ولا يتوفّر لها أي مورد تقارير مقابل في إصدارات Google Ads API المتوافقة. تستخدم الإضافات المستندة إلى مواد العرض {extensionid}، والتي يتم ربطها بـ asset.id.
{extensionid}	asset.id	رقم تعريف الإضافة المستنِدة إلى مادة العرض التي تمّ النقر عليها
{hotelcenter_id}	segments.hotel_center_id	رقم تعريف حساب Hotel Center المرتبط بالحملة التي أدّت إلى إنشاء الإعلان عند النقر عليه
{hotel_id}	segments.partner_hotel_id	رقم تعريف الفندق من خلاصة الفندق للحساب المرتبط.
{keyword}	segments.keyword.ad_group_criterion يُرجى العِلم أنّه يمكن العثور على طلب البحث النصي باستخدام اسم مورد المعيار.	بالنسبة إلى "شبكة البحث"، الكلمة الرئيسية من حسابك التي تتطابق مع طلب البحث. بالنسبة إلى "الشبكة الإعلانية"، الكلمة الرئيسية من حسابك التي تتطابق مع المحتوى.
{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 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")، أو المطابقة غير المستندة إلى كلمات رئيسية في AI Max‏ ("kwl")، أو الإعلان الديناميكي على شبكة البحث ("dsa")، أو استهداف قائمة تجديد النشاط التسويقي ("aud") الذي أدّى إلى ظهور إعلان على سبيل المثال، إذا أضفت قائمة تجديد نشاط تسويقي إلى مجموعتك الإعلانية (رقم تعريف المعيار "456") واستهدفت معرّف الكلمة الرئيسية "123"، يتم استبدال {targetid} بـ "kwd-123:aud-456".
{travel_start_day} {travel_start_month} {travel_start_year}	segments.hotel_check_in_date	اليوم والشهر والسنة في تاريخ تسجيل الوصول المعروض في الإعلان.

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

يعرض هذا الجدول معلَمات ValueTrack بين واجهة مستخدم "إعلانات Google" وGoogle Ads API، لا سيما قيم التعداد AdNetworkType.

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