보고서
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
보고서를 가져올 때 추적 템플릿, 최종 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 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-27(UTC)
[null,null,["최종 업데이트: 2025-08-27(UTC)"],[[["\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"]]