คุณดูรายการชิ้นงานและแอตทริบิวต์ได้โดยส่งคําค้นหา Google Ads Query Language (GAQL) ไปยัง GoogleAdsService ชิ้นงานจะแสดงโดยเอนทิตี asset ซึ่งแสดงช่องเฉพาะชิ้นงานจำนวนหนึ่ง
แอตทริบิวต์ชิ้นงาน
คําค้นหา GAQL ต่อไปนี้แสดงรายการชิ้นงานทั้งหมดในบัญชี Google Ads พร้อมกับชื่อและประเภททรัพยากร
SELECT
asset.id,
asset.name,
asset.resource_name,
asset.type
FROM asset
คุณสามารถเพิ่มแอตทริบิวต์เฉพาะประเภทลงในการค้นหานี้เพื่ออ่านพร็อพเพอร์ตี้ที่เจาะจงสำหรับชิ้นงาน เช่น ImageAsset หรือ YoutubeVideoAsset
ตัวอย่างเช่น คำค้นหาต่อไปนี้จะแสดงรหัสวิดีโอ YouTube สำหรับออบเจ็กต์ YoutubeVideoAsset ทั้งหมดในบัญชี Google Ads โดยกรองค่า asset.type ดูรายการค่า asset.type ที่เป็นไปได้
SELECT
asset.id,
asset.name,
asset.resource_name,
asset.youtube_video_asset.youtube_video_id
FROM asset
WHERE asset.type = 'YOUTUBE_VIDEO'
เมตริกชิ้นงาน
เมตริกชิ้นงานพร้อมใช้งานผ่านแหล่งข้อมูลต่อไปนี้
แหล่งข้อมูลเหล่านี้ช่วยให้คุณค้นหาเมตริกชิ้นงานในแต่ละระดับที่เกี่ยวข้องได้
ตัวอย่างเช่น เมื่อค้นหาทรัพยากร ad_group_asset คุณสามารถใช้ช่อง ad_group.id เพื่อแบ่งกลุ่มผลลัพธ์ ซึ่งจะดึงเมตริกสําหรับชุดค่าผสมที่ไม่ซ้ำกันของ ad_group และ asset ดังนี้
SELECT
ad_group.id,
asset.id,
metrics.clicks,
metrics.impressions
FROM ad_group_asset
WHERE segments.date DURING LAST_MONTH
ORDER BY metrics.impressions DESC
เมตริกระดับโฆษณา
ประเด็นสำคัญ: ad_group_ad_asset_view จะแสดงผลเฉพาะข้อมูลของชิ้นงานที่เกี่ยวข้องกับโฆษณาแอป, Demand Gen และโฆษณา Search ที่ปรับเปลี่ยนตามบริบทเท่านั้น
เมตริกประสิทธิภาพระดับโฆษณาสําหรับชิ้นงานจะรวมอยู่ใน ad_group_ad_asset_view มุมมองนี้จะรวบรวมเมตริกของชิ้นงานต่อโฆษณาเดี่ยวแต่ละรายการ ดังนั้น การค้นหามุมมองนี้จะแสดงผล 1 แถวต่อกลุ่มโฆษณาและโฆษณา
ad_group_ad_asset_view จะแสดงแอตทริบิวต์เฉพาะมุมมอง performance_label ซึ่งให้ข้อมูลเชิงลึกเกี่ยวกับลักษณะประสิทธิภาพของการจับคู่โฆษณากับชิ้นงานที่เฉพาะเจาะจงนี้ ตารางต่อไปนี้แสดงค่าที่เป็นไปได้ของช่อง performance_label
performance_label | คำอธิบาย |
|---|---|
BEST | ชิ้นงานที่มีประสิทธิภาพดีที่สุด |
GOOD | ชิ้นงานที่มีประสิทธิภาพดี |
LOW | ชิ้นงานที่มีประสิทธิภาพแย่ที่สุด |
LEARNING | ชิ้นงานเริ่มได้รับการแสดงผลแล้ว แต่สถิติยังไม่มีนัยสำคัญทางสถิติมากพอที่จะได้รับป้ายกำกับประสิทธิภาพของชิ้นงาน |
PENDING | ชิ้นงานนี้ยังไม่มีข้อมูลประสิทธิภาพเลย ซึ่งอาจเป็นเพราะบัญชียังอยู่ระหว่างตรวจสอบ |
UNKNOWN | แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้ |
UNSPECIFIED | ไม่ได้ระบุ |
คําค้นหา GAQL ต่อไปนี้จะแสดงผลการแสดงผล การคลิก ต้นทุน และ Conversion ของชิ้นงานทั้งหมดในบัญชี Google Ads ในช่วงเดือนที่ผ่านมา โดยจัดเรียงตาม performance_label
SELECT
ad_group_ad_asset_view.ad_group_ad,
ad_group_ad_asset_view.asset,
ad_group_ad_asset_view.field_type,
ad_group_ad_asset_view.performance_label,
metrics.impressions,
metrics.clicks,
metrics.cost_micros,
metrics.conversions
FROM ad_group_ad_asset_view
WHERE segments.date DURING LAST_MONTH
ORDER BY ad_group_ad_asset_view.performance_label
แหล่งที่มาของเนื้อหา
Asset.source จะถูกต้องสำหรับชิ้นงานที่เปลี่ยนแปลงได้เท่านั้น
สําหรับแหล่งที่มาของชิ้นงาน RSA ให้ใช้ ad_group_ad_asset_view.source