گزارش ها
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
الگوهای ردیابی، نشانیهای اینترنتی نهایی، نشانیهای اینترنتی نهایی موبایل، و پارامترهای سفارشی همگی به عنوان ویژگی در هنگام بازیابی گزارشها در دسترس هستند. به خاطر داشته باشید که نشانیهای اینترنتی نهایی و نشانیهای اینترنتی نهایی موبایل در گزارش بهصورت مقادیر رشتهای مکرر ارائه میشوند:
final_urls {
value: "http://www.example.com/locations/mars/"
}
final_urls {
value: "http://www.example.com/cruise/space/"
}
نمونه پرس و جو
پرس و جوی زیر URL های نهایی را از همه تبلیغات متنی گسترش یافته بازیابی می کند:
SELECT
ad_group_ad.ad.name,
ad_group_ad.ad.final_urls
FROM ad_group_ad
WHERE ad_group_ad.ad.type = EXPANDED_TEXT_AD
پارامترهای سفارشی به عنوان اشیاء پیام مکرر از نوع CustomParameter
بازگردانده می شوند، همانطور که در مثال زیر نشان داده شده است:
url_custom_parameters {
key {
value: "promocode"
}
value {
value: "NYC123"
}
}
url_custom_parameters {
key {
value: "season"
}
value {
value: "spring"
}
}
جستار زیر پارامترهای سفارشی URL را از همه تبلیغات جستجو بازیابی می کند:
SELECT
ad_group.name,
ad_group.url_custom_parameters
FROM ad_group
WHERE ad_group.type = SEARCH_STANDARD
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-08-26 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-26 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eTracking templates, final URLs, final mobile URLs, and custom parameters can be retrieved as attributes in reports.\u003c/p\u003e\n"],["\u003cp\u003eFinal URLs and final mobile URLs are displayed as repeated string values within the report data.\u003c/p\u003e\n"],["\u003cp\u003eCustom parameters are presented as repeated message objects of the \u003ccode\u003eCustomParameter\u003c/code\u003e type.\u003c/p\u003e\n"],["\u003cp\u003eSample queries demonstrate how to retrieve final URLs from expanded text ads and URL custom parameters from search ads.\u003c/p\u003e\n"]]],[],null,["# Reports\n\nTracking templates, final URLs, final mobile URLs, and custom parameters are all\navailable as attributes when retrieving reports. Keep in mind that final URLs\nand final mobile URLs are rendered in the report as repeated string values: \n\n final_urls {\n value: \"http://www.example.com/locations/mars/\"\n }\n final_urls {\n value: \"http://www.example.com/cruise/space/\"\n }\n\nSample queries\n--------------\n\nThe following query retrieves the final URLs from all expanded text ads: \n\n SELECT\n ad_group_ad.ad.name,\n ad_group_ad.ad.final_urls\n FROM ad_group_ad\n WHERE ad_group_ad.ad.type = EXPANDED_TEXT_AD\n\nCustom parameters are returned as repeated message objects of the type\n[`CustomParameter`](/google-ads/api/reference/rpc/v21/CustomParameter), as shown in the following\nexample: \n\n url_custom_parameters {\n key {\n value: \"promocode\"\n }\n value {\n value: \"NYC123\"\n }\n }\n url_custom_parameters {\n key {\n value: \"season\"\n }\n value {\n value: \"spring\"\n }\n }\n\nThe following query retrieves the URL custom parameters from all search ads: \n\n SELECT\n ad_group.name,\n ad_group.url_custom_parameters\n FROM ad_group\n WHERE ad_group.type = SEARCH_STANDARD"]]