คุณดูรายการชิ้นงานและแอตทริบิวต์ของชิ้นงานได้โดยส่งคําค้นหาภาษาคําค้นหาของ Google Ads (GAQL) ไปยัง GoogleAdsService ชิ้นงานจะแสดงโดยเอนทิตี asset
ซึ่งแสดงช่องเฉพาะสำหรับชิ้นงาน
แอตทริบิวต์เนื้อหา
การค้นหา GAQL ต่อไปนี้จะแสดงชิ้นงานทั้งหมดในบัญชีของผู้ลงโฆษณาพร้อมกับชื่อและประเภททรัพยากร
SELECT
asset.id,
asset.name,
asset.resource_name,
asset.type
FROM asset
โปรดทราบว่ามีแอตทริบิวต์เฉพาะประเภทที่คุณสามารถเพิ่มลงในคําค้นหานี้เพื่ออ่านพร็อพเพอร์ตี้เฉพาะของชิ้นงาน เช่น ImageAsset
หรือ YoutubeVideoAsset
เช่น การค้นหาต่อไปนี้จะแสดงรหัสวิดีโอ YouTube ของออบเจ็กต์ YoutubeVideoAsset
ทั้งหมดในบัญชีโดยกรองค่า asset.type
(ดูรายการค่าประเภทที่เป็นไปได้ในเอกสารประกอบ) สำหรับ YoutubeVideoAsset
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
มุมมองนี้จะรวบรวมเมตริกสําหรับชิ้นงานต่อโฆษณาแต่ละรายการ ดังนั้น การค้นหามุมมองนี้จะแสดงผล 1 แถวต่อกลุ่มโฆษณาและโฆษณา
ad_group_ad_asset_view
จะแสดงแอตทริบิวต์เฉพาะการดู performance_label
ซึ่งให้ข้อมูลเชิงลึกเกี่ยวกับลักษณะประสิทธิภาพของคู่โฆษณา-ชิ้นงานนี้ ค่าที่เป็นไปได้ของช่อง performance_label
แสดงอยู่ในตารางต่อไปนี้
performance_label | คำอธิบาย |
---|---|
BEST | ชิ้นงานที่มีประสิทธิภาพดีที่สุด |
GOOD | ชิ้นงานที่มีประสิทธิภาพดี |
LOW | ชิ้นงานที่มีประสิทธิภาพต่ำที่สุด |
LEARNING | ชิ้นงานเริ่มได้รับการแสดงผลแล้ว แต่สถิติมีนัยสำคัญทางสถิติไม่มากพอที่จะได้รับป้ายกำกับประสิทธิภาพของชิ้นงาน |
PENDING | ชิ้นงานนี้ยังไม่มีข้อมูลประสิทธิภาพเลย อาจเป็นเพราะคำขอยังอยู่ระหว่างตรวจสอบ |
UNKNOWN | แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้ |
UNSPECIFIED | ไม่ได้ระบุ |
การค้นหา GAQL ต่อไปนี้จะแสดงผล คลิก ต้นทุน และ Conversion ของชิ้นงานทั้งหมดในบัญชีในช่วงเดือนที่ผ่านมา โดยจัดเรียงตาม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
ถูกต้องสำหรับชิ้นงาน mutable
เท่านั้น
สำหรับแหล่งที่มาของการใช้ชิ้นงาน RSA ให้ใช้ AdGroupAdAsset.source