ربط مَعلمات 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")، أو المطابقة غير المستندة إلى كلمات رئيسية في 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 Ads API و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 Ads API لا تتيح التعداد بعد، ولكنّه يظهر في واجهة المستخدم، تعرض Google Ads API القيمة UNKNOWN.
لا ينطبق	UNSPECIFIED	لا ينطبق
YouTube	YOUTUBE	ytv
القنوات التي تملكها Google	UNKNOWN		لا تعرض "حملات زيادة الطلب" مَعلمة ValueTrack للشبكة.