پارامترهای ValueTrack را به فیلدهای گزارش نگاشت کنید

پارامترهای ValueTrack پارامترهای نشانی وب هستند که می‌توانید به نشانی‌های وب صفحه مقصد آگهی‌هایتان اضافه کنید. این پارامترها اطلاعات مربوط به منبع کلیک‌های آگهی‌تان را جمع‌آوری می‌کنند. بهترین زمان استفاده از آن‌ها وقتی است که می‌خواهید درباره کلیک‌های آگهی‌تان بیشتر بدانید، یا اگر تازه می‌خواهید ردیابی را شروع کنید.

وقتی برچسب‌گذاری خودکار را فعال می‌کنید، «شناسه کلیک Google» (GCLID) به‌طور خودکار به هر نشانی وب اضافه می‌شود و می‌توان بعداً از آن برای نگاشت کلیک آگهی به ردیفی در گزارش استفاده کرد.

برای نمای کلی از نحوه عملکرد پارامترهای ValueTrack، به درباره پارامترهای ValueTrack مراجعه کنید. برای فهرست کامل پارامترهای ValueTrack، بخش پارامترهای ValueTrack دردسترس را در راه‌اندازی ردیابی با پارامترهای ValueTrack ببینید.

Google Analytics و میانای برنامه‌سازی کاربردی مرتبط با آن گزینه دیگری برای جمع‌آوری سنجه‌های مربوط به کلیک‌ها ارائه می‌دهند.

گزارش‌دهی Google Ads API دارای منابع و نماهایی است که در آن می‌توانید فیلدهایی را که با پارامترهای ValueTrack مطابقت دارند پُرسمان کنید. بااین‌حال، فیلد نگاشت‌شده لزوماً مقدار نوشتاری یکسانی ندارد. برای مثال، وقتی {matchtype} برابر با e (که مخفف exact match است) باشد، فیلد گزارش مربوطه مانند ad_group_criterion.keyword.match_type EXACT را نشان می‌دهد. برخی‌از نگاشت‌های نمونه در جدول زیر نشان داده شده است.

نحوه نگاشت پارامترهای ValueTrack به فیلدهای گزارش

پارامتر ValueTrack	فیلد(ها) در منابع گزارش	شرح
{adgroupid}	ad_group.id	شناسه گروه آگهی. (وقتی اطلاعات ردیابی را در سطح حساب یا پویش راه‌اندازی کرده‌اید و می‌خواهید بدانید کدام گروه آگهی آگهی‌تان را ارائه کرده است، از این استفاده کنید.)
{adposition}	به ترکیبی از موارد زیر نگاشت می‌شود: click_view.page_number segments.slot هیچ فیلدی وجود ندارد که با مکان آگهی، مانند «بالا» یا «کنار»، مطابقت داشته باشد.	موقعیت آگهی شما در صفحه، با مقداری مانند «1t2» (به معنی صفحه ۱، بالا، موقعیت ۲).
{advanced_booking_window}	segments.hotel_booking_window_days	تعداد روزهای بین تاریخ کلیک آگهی و تاریخ ورود تبلیغ‌شده. برای مثال، «۳» برای آگهی‌ای که در ۵ ژوئن روی آن کلیک شده است و تاریخ ورود آن ۸ ژوئن است.
{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	نشانی وب نهایی. این کاراکترها نادیده گرفته می‌شوند، مگراینکه {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	سایت محتوایی که آگهی شما در آن کلیک شده است (برای کمپین‌های هدف‌گیری‌شده با کلیدواژه)، یا معیارهای هدف‌گیری جایگاه منطبق برای سایتی که آگهی شما در آن کلیک شده است (برای کمپین‌های هدف‌گیری‌شده با جایگاه).
{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») که آگهی را راه‌اندازی کرده است. برای مثال، اگر فهرست بازاریابی مجددی را به گروه آگهی‌تان اضافه کنید (شناسه معیار «۴۵۶») و شناسه کلیدواژه «۱۲۳» را هدف قرار دهید، {targetid} با «kwd-123:aud-456» جایگزین می‌شود.
{travel_start_day} {travel_start_month} {travel_start_year}	segments.hotel_check_in_date	روز/ ماه/ سال تاریخ ورود که در آگهی نشان داده می‌شود.

نحوه نگاشت پارامترهای ValueTrack بین میانای کاربری Google Ads و Google Ads API

این جدول پارامترهای ValueTrack را بین میانای کاربری Google Ads و Google Ads API، به‌ویژه برای مقادیر شمارشی AdNetworkType، نگاشت می‌کند.

نام میانای کاربر	API enum	پارامتر ValueTrack	یادداشت‌ها
شبکه تبلیغات Google	CONTENT	d	برای «شرکای ویدیو Google» با پارامتر ValueTrack vp، که در میانای برنامه‌سازی کاربردی نیز به‌صورت CONTENT نشان داده می‌شود.
Google TV	GOOGLE_TV	gtv
بین‌شبکه‌ای	MIXED	x	توجه داشته باشید که همیشه پارامتر ValueTrack وجود ندارد.
جستجوی Google	SEARCH	g
شرکای جستجو	SEARCH_PARTNERS	‫s یا a	a نشان‌دهنده مطابقت «بهینه‌ساز هوش مصنوعی» است که معمولاً با ترافیک بدون کلیدواژه مرتبط است.
موجود نیست	UNKNOWN	موجود نیست	زمانی برگردانده می‌شود که مقدار شبکه در میانای کاربری Google Ads در نسخه Google Ads API موردپرسش پشتیبانی نشود.
موجود نیست	UNSPECIFIED	موجود نیست
‫YouTube	YOUTUBE	ytv
کانال‌های تحت مالکیت Google	UNKNOWN		«تولید تقاضا» پارامتر شبکه ValueTrack را برنمی‌گرداند.