ربط مَعلمات 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 للشبكة.