التقارير
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تتوفّر نماذج التتبُّع وعناوين URL النهائية وعناوين URL النهائية للجوّال والمَعلمات المخصّصة جميعها كسمات عند استرداد التقارير. يُرجى العِلم أنّ عناوين URL النهائية وعناوين URL النهائية للأجهزة الجوّالة يتم عرضها في التقرير كقيم سلسلة متكرّرة:
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 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-27 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-27 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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"]]