ربط مَعلمات 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 يُرجى العِلم أنّه يمكن العثور على طلب البحث النصي باستخدام اسم مصدر المعيار.	بالنسبة إلى "شبكة بحث 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 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 للشبكة.