پارامترهای 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»)، تطابق بدون کلیدواژه «بیشینه‌سازی هوشواره‌ای» («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، نگاشت می‌کند.

نام میانای کاربر	شمارشی میانای برنامه‌سازی کاربردی	پارامتر 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 را برنمی‌گرداند.