Google Ads API มีมุมมองหลายแบบเพื่อวิเคราะห์ตำแหน่งที่โฆษณาปรากฏและประสิทธิภาพของโฆษณา ดังนี้
managed_placement_view,
group_placement_view,
detail_placement_view และ
performance_max_placement_view แต่ละมุมมองจะแสดงข้อมูลตำแหน่งโฆษณาในมุมมองที่แตกต่างกัน ดูคู่มือการค้นหาสำหรับคำค้นหา Google Ads Query Language (GAQL) และ curl ที่พร้อมใช้งานซึ่งจำลองหน้าจอตำแหน่งโฆษณาใน UI ของ Google Ads
มุมมองตำแหน่งที่กำหนดเอง
- สิ่งที่แสดง: แหล่งข้อมูล
managed_placement_viewจะแสดงข้อมูลประสิทธิภาพที่รวบรวมตามเกณฑ์ตำแหน่งโฆษณาเชิงบวกที่คุณกำหนดเป้าหมายในกลุ่มโฆษณา มุมมองนี้ประกอบด้วยเกณฑ์ทั้ง 5 ประเภทที่จัดการภายใต้เนื้อหา > ตำแหน่งโฆษณาใน UI ของ Google Ads ได้แก่ เว็บไซต์, ช่อง YouTube, วิดีโอ YouTube, แอปบนมือถือ และหมวดหมู่แอปบนมือถือ - เทียบเท่า UI: เนื้อหา > ตำแหน่งโฆษณา
- Query Builder: สำรวจใน Query Builder
ประเภทเกณฑ์ตำแหน่งที่กำหนดเป้าหมาย
แต่ละแถวในทรัพยากร managed_placement_view จะป้อนข้อมูลในช่อง AdGroupCriterion ที่ตรงกับค่า ad_group_criterion.type และปล่อยให้ช่องตำแหน่งโฆษณาอื่นๆ ไม่มีการตั้งค่า ดังนี้
| ประเภทตำแหน่ง UI | ค่า ad_group_criterion.type |
ช่องรายละเอียดเกณฑ์ | หมายเหตุ |
|---|---|---|---|
| เว็บไซต์ | PLACEMENT |
ad_group_criterion.placement.url |
URL ของเว็บไซต์หรือโดเมนเป้าหมาย |
| ช่อง YouTube | YOUTUBE_CHANNEL |
ad_group_criterion.youtube_channel.channel_id |
รหัสช่อง YouTube ฟิลด์ ad_group_criterion.display_name จะแสดงชื่อช่อง |
| วิดีโอ YouTube | YOUTUBE_VIDEO |
ad_group_criterion.youtube_video.video_id |
รหัสวิดีโอ YouTube ฟิลด์ ad_group_criterion.display_name จะแสดงชื่อวิดีโอ |
| แอป | MOBILE_APPLICATION |
ad_group_criterion.mobile_application.app_id, ad_group_criterion.mobile_application.name |
รหัสแอปในรูปแบบ {platform}-{platform_native_id} (1- สำหรับ iOS, 2- สำหรับ Android) และชื่อแอป |
| หมวดหมู่แอป | MOBILE_APP_CATEGORY |
ad_group_criterion.mobile_app_category.mobile_app_category_constant |
ชื่อทรัพยากรในรูปแบบ mobileAppCategoryConstants/{mobile_app_category_id} ดูชื่อและลำดับชั้นของหมวดหมู่แอปบนมือถือ |
ตัวอย่างคำค้นหา
หากต้องการดึงเมตริกประสิทธิภาพของตำแหน่งที่กำหนดเป้าหมายทุกประเภทในช่วง 30 วันที่ผ่านมา ให้เลือกช่อง ad_group_criterion.type ควบคู่ไปกับช่องเฉพาะประเภท ดังนี้
SELECT
campaign.id,
ad_group.id,
managed_placement_view.resource_name,
ad_group_criterion.criterion_id,
ad_group_criterion.type,
ad_group_criterion.display_name,
ad_group_criterion.placement.url,
ad_group_criterion.youtube_channel.channel_id,
ad_group_criterion.youtube_video.video_id,
ad_group_criterion.mobile_application.app_id,
ad_group_criterion.mobile_application.name,
ad_group_criterion.mobile_app_category.mobile_app_category_constant,
metrics.impressions,
metrics.clicks,
metrics.cost_micros
FROM managed_placement_view
WHERE segments.date DURING LAST_30_DAYS
ชื่อและลำดับชั้นของหมวดหมู่แอปบนมือถือ
ใน UI ของ Google Ads หมวดหมู่แอปบนมือถือที่กำหนดเป้าหมายจะแสดงเส้นทาง Store แบบเต็ม เช่น หมวดหมู่แอป > Apple App Store > การศึกษา เมื่อค้นหา Google Ads API โปรดคำนึงถึงลักษณะการทำงานต่อไปนี้
- การระบุค่าคงที่ของหมวดหมู่แอปบนอุปกรณ์เคลื่อนที่: ทรัพยากร
mobile_app_category_constantไม่ใช่ทรัพยากรที่ระบุแหล่งที่มาของทรัพยากรmanaged_placement_viewเลือกช่องad_group_criterion.mobile_app_category.mobile_app_category_constantแทน (เช่นmobileAppCategoryConstants/60503) หรือค้นหาทรัพยากรad_group_criterionเมื่อไม่ต้องการเมตริก - ชื่อที่แสดงเฉพาะหมวดหมู่ย่อย: ทั้งช่อง
ad_group_criterion.display_nameและmobile_app_category_constant.nameจะแสดงเฉพาะชื่อหมวดหมู่ย่อย เช่น"Education"หรือ"Games"ทั้ง 2 ช่องไม่มีเส้นทาง App Store หลัก - การแก้ไขเส้นทาง App Store: Google Play และ Apple App Store ใช้ชื่อหมวดหมู่ Leaf ร่วมกันในรหัสเกณฑ์ที่แตกต่างกัน ตัวอย่างเช่น รหัสเกณฑ์
60005(/All Apps/Google Play/Education),60060(/All Apps/Google Play/Family/Education) และ60503(/All Apps/Apple App Store/Education) ทั้งหมดจะแสดงผล"Education"ในช่องnameและdisplay_nameดึงข้อมูลคำต่อท้าย{mobile_app_category_id}จากชื่อทรัพยากร แล้วค้นหาเส้นทางลำดับชั้นแบบเต็มในตารางหรือไฟล์ CSV หมวดหมู่แอปบนมือถือ
มุมมองตำแหน่งกลุ่ม
- สิ่งที่แสดง: แหล่งข้อมูล
group_placement_viewแสดงตำแหน่งที่โฆษณาแสดงจริงในเครือข่าย Display และ YouTube ไม่ว่าตำแหน่งนั้นจะได้รับการกำหนดเป้าหมายอย่างชัดเจนหรือระบบของ Google ค้นพบโดยอัตโนมัติก็ตาม ซึ่งอาจรวมถึงเว็บไซต์ ช่องหรือวิดีโอ YouTube และแอป - เทียบเท่า UI: เนื้อหา > ตําแหน่งที่โฆษณาแสดง
- Query Builder: สำรวจใน Query Builder
ตัวอย่างคำค้นหา
คําค้นหาต่อไปนี้จะดึงข้อมูลเมตริกประสิทธิภาพสําหรับโดเมน แอปบนอุปกรณ์เคลื่อนที่ และช่อง YouTube ที่โฆษณาแสดงในช่วง 30 วันที่ผ่านมา
SELECT
campaign.id,
ad_group.id,
group_placement_view.display_name,
group_placement_view.target_url,
group_placement_view.placement_type,
metrics.impressions,
metrics.clicks,
metrics.cost_micros
FROM group_placement_view
WHERE segments.date DURING LAST_30_DAYS
แถว "ทั้งหมด: อื่นๆ"
เพื่อเร่งการสร้างรายงาน ทรัพยากร group_placement_view และ detail_placement_view จะไม่รวมตำแหน่งแต่ละตำแหน่งที่ไม่เป็นไปตามเกณฑ์กิจกรรมขั้นต่ำของการแสดงผลหรือการโต้ตอบ
- ใน UI ของ Google Ads: UI จะรวมตำแหน่งที่ไม่เป็นไปตามเกณฑ์กิจกรรมนี้ไว้ในแถวสรุปที่มีป้ายกำกับว่าทั้งหมด: อื่นๆ
- ใน Google Ads API: API จะละเว้นตำแหน่งที่ไม่เป็นไปตามเกณฑ์กิจกรรมจากผลลัพธ์ของรายงาน และจะไม่แสดงแถวสรุปที่ช่อง
group_placement_view.placementหรือdetail_placement_view.placementมีค่าเป็น"Other"
ด้วยเหตุนี้ ผลรวมของแถวตำแหน่งแต่ละแถวในทรัพยากร group_placement_view และ detail_placement_view อาจต่ำกว่าเมตริกทั้งหมดของกลุ่มโฆษณาหรือแคมเปญ ดูข้อมูลเพิ่มเติมได้ที่เกี่ยวกับรายงาน "ตําแหน่งที่โฆษณาแสดง" ดูรายละเอียดเกี่ยวกับผลกระทบของเกณฑ์และข้อมูลเมตาที่ขาดหายไปต่อการเปรียบเทียบข้ามมุมมองได้ที่ความแตกต่างของเมตริกระหว่างมุมมองตำแหน่งโฆษณาและแถวที่มีรายละเอียดตำแหน่งโฆษณาที่ไม่พร้อมใช้งาน
การตั้งค่าการกำหนดเป้าหมายจากตำแหน่ง
ลักษณะการทำงานและประโยชน์ของ group_placement_view ได้รับอิทธิพลจาก TargetingSetting สำหรับมิติข้อมูล PLACEMENT ที่ระดับกลุ่มโฆษณา การตั้งค่านี้ประกอบด้วยรายการ target_restrictions ซึ่งแต่ละรายการมีช่องบูลีน bid_only ที่กำหนดว่าโฆษณาจะแสดงเฉพาะในตำแหน่งที่กำหนดเป้าหมายหรือในตำแหน่งอื่นๆ ด้วย ดูเกี่ยวกับการตั้งค่า "การกำหนดเป้าหมาย" และ "การสังเกตการณ์"
bid_only = false: ค่านี้สอดคล้องกับการกำหนดเป้าหมายใน UI ของ Google Ads สำหรับตำแหน่ง หากกลุ่มโฆษณาตั้งค่าเป็น "การกำหนดเป้าหมาย" โฆษณาจะแสดงเฉพาะในตำแหน่งที่คุณเพิ่มเป็นเกณฑ์อย่างชัดเจน คุณเลือกใช้การปรับราคาเสนอกับตำแหน่งเหล่านี้ได้ ในสถานการณ์นี้group_placement_viewจะคล้ายกับmanaged_placement_viewเป็นส่วนใหญ่ แต่ยังคงขึ้นอยู่กับเกณฑ์กิจกรรมขั้นต่ำbid_only = true: ค่านี้สอดคล้องกับการสังเกตการณ์ใน UI ของ Google Ads สำหรับตำแหน่งโฆษณา หากตั้งค่ากลุ่มโฆษณาเป็น "การสังเกตการณ์" โฆษณาจะแสดงในตำแหน่งที่มีสิทธิ์บนเครือข่าย Display และ YouTube นอกจากนี้ คุณยังใช้การปรับราคาเสนอกับตำแหน่งที่กำหนดเป้าหมายได้ด้วย ในกรณีนี้group_placement_viewมีความสำคัญอย่างยิ่งต่อการค้นพบตำแหน่งใหม่ๆ ที่โฆษณาแสดง ซึ่งคุณอาจเลือกเพิ่มเป็นตำแหน่งที่กำหนดเองหรือการยกเว้นได้
มุมมองตำแหน่งโฆษณาอย่างละเอียด
- สิ่งที่แสดง: ทรัพยากร
detail_placement_viewแสดงรายละเอียดตำแหน่งโฆษณาที่ละเอียดยิ่งขึ้น โดยให้รายละเอียดนอกเหนือจากระดับโดเมนหรือช่องทาง เช่น แสดง URL หรือรหัสวิดีโอ YouTube ที่เฉพาะเจาะจงซึ่งโฆษณาปรากฏ - เทียบเท่า UI: เทียบเท่ากับการเลือกแถวในเนื้อหา > ตําแหน่งที่โฆษณาแสดง แล้วคลิกดูรายละเอียด
- Query Builder: สำรวจใน Query Builder
- ข้อควรพิจารณาที่สำคัญ: มุมมองนี้จะละเว้นตำแหน่งที่มีกิจกรรมต่ำซึ่งไม่เป็นไปตามเกณฑ์กิจกรรมขั้นต่ำ (ดูส่วนแถว "ทั้งหมด: อื่นๆ") เช่นเดียวกับทรัพยากร
group_placement_view
ตัวอย่างคำค้นหา
หากต้องการจำกัดปริมาณผลลัพธ์ คำค้นหาต่อไปนี้จะดึงข้อมูลเมตริกตำแหน่งโฆษณาระดับ URL และระดับวิดีโอในกรอบเวลา 7 วัน สำหรับบัญชีขนาดใหญ่ ให้กรองเพิ่มเติมตามช่อง campaign.id หรือ ad_group.id ดังนี้
SELECT
campaign.id,
ad_group.id,
detail_placement_view.display_name,
detail_placement_view.target_url,
detail_placement_view.group_placement_target_url,
detail_placement_view.placement_type,
metrics.impressions,
metrics.clicks,
metrics.cost_micros
FROM detail_placement_view
WHERE segments.date DURING LAST_7_DAYS
หากต้องการยกเว้นแถวที่ไม่มีข้อมูลเมตาของตำแหน่ง ให้เพิ่ม AND
detail_placement_view.target_url IS NOT NULL (ดูแถวที่ไม่มีรายละเอียดตำแหน่ง) เมื่อไม่ต้องการช่อง resource_name ที่แสดงผล ให้เพิ่มส่วนคำสั่ง PARAMETERS
omit_unselected_resource_names = true
ความแตกต่างของเมตริกระหว่างมุมมองตำแหน่งโฆษณา
ระบบจะประเมินเกณฑ์กิจกรรมขั้นต่ำแยกกันในแต่ละระดับความละเอียด ดังนี้
- ทรัพยากร
group_placement_viewจะประเมินเกณฑ์ในโดเมน แอปบนอุปกรณ์เคลื่อนที่ หรือช่อง YouTube ที่รวบรวมไว้ - ทรัพยากร
detail_placement_viewจะประเมินเกณฑ์แยกกันสำหรับ URL ของหน้าเว็บหรือวิดีโอ YouTube แต่ละรายการ
ทรัพยากร detail_placement_view จะละเว้น URL ของหน้าเว็บแต่ละหน้าหรือวิดีโอ YouTube ที่ไม่เป็นไปตามเกณฑ์ ด้วยเหตุนี้ การรวมแถว detail_placement_view สำหรับโดเมนหรือช่อง YouTube (กรองตามช่อง detail_placement_view.group_placement_target_url) จึงอาจแสดงผลการแสดงผลน้อยกว่าแถว group_placement_view ที่เกี่ยวข้อง
แถวที่มีรายละเอียดตำแหน่งโฆษณาที่ไม่พร้อมใช้งาน
การค้นหาทรัพยากร group_placement_view หรือ detail_placement_view สามารถแสดงผลหลายแถวในกลุ่มโฆษณาเดียวกันที่มีฟิลด์ placement, display_name และ target_url ที่ไม่ได้ตั้งค่า และค่า resource_name ที่เหมือนกัน (เช่น ลงท้ายด้วย ~MTRf)
ลักษณะการทำงานนี้เกิดขึ้นเนื่องจากสาเหตุต่อไปนี้
- การจัดกลุ่มตำแหน่งโฆษณาภายใน: ทั้ง 2 มุมมองจะจัดกลุ่มเมตริกประสิทธิภาพตามตัวระบุตำแหน่งโฆษณาภายในที่ไม่ซ้ำกัน แทนที่จะจัดกลุ่มตามช่องสตริง
resource_nameหรือplacement - ข้อมูลเมตาของตำแหน่งที่ไม่พร้อมใช้งาน: ใน UI ของ Google Ads ตำแหน่งที่ไม่มีข้อมูลเมตาในตารางตรวจสอบแบ็กเอนด์จะปรากฏเป็นไม่ทราบ ช่องไม่พร้อมใช้งานอีกต่อไป หรือวิดีโอไม่พร้อมใช้งานอีกต่อไป ใน API ตัวระบุตำแหน่งโฆษณาที่แตกต่างกันแต่ละรายการจะยังคงแสดงแถวเมตริก โดยที่ไม่ได้ตั้งค่าช่อง
placement,display_nameและtarget_url - ชื่อทรัพยากรที่สังเคราะห์: ส่วนต่อท้าย
{base64_placement}ในช่องresource_nameมีการเข้ารหัส Base64 จาก{type_id}_{placement}โดยที่{type_id}เป็นตัวระบุประเภทตำแหน่งโฆษณาภายใน ไม่ใช่หมายเลข enumPlacementTypeเมื่อฟิลด์placement_typeเป็นWEBSITE(รหัสภายใน14) และไม่ได้ตั้งค่าฟิลด์placementสตริง"14_"จะเข้ารหัสเป็นMTRf(ในทำนองเดียวกันMOBILE_APPLICATIONจะเข้ารหัส"55_"เป็นNTVf,YOUTUBE_VIDEOจะเข้ารหัส"89_"เป็นODlfและYOUTUBE_CHANNELจะเข้ารหัส"90_"เป็นOTBf) ตำแหน่งโฆษณาหลายตำแหน่งที่เป็นประเภทเดียวกันซึ่งไม่มีข้อมูลเมตาในกลุ่มโฆษณาเดียวกันจึงใช้ค่าresource_nameเดียวกันขณะรายงานแถวเมตริกแยกกัน
เมื่อประมวลผลผลลัพธ์ group_placement_view หรือ detail_placement_view ในโค้ดไคลเอ็นต์ อย่ากรองแถวที่ซ้ำกันออกโดยใช้ช่อง resource_name เพียงอย่างเดียว เนื่องจากการทำเช่นนั้นอาจเขียนทับเมตริกในตำแหน่งโฆษณาที่แตกต่างกันซึ่งมีข้อมูลเมตาที่ไม่พร้อมใช้งาน
หากต้องการยกเว้นแถวที่มีข้อมูลเมตาที่ไม่พร้อมใช้งานใน GAQL ให้กรองในช่อง target_url หรือ display_name เนื่องจากช่อง placement และ resource_name ไม่สามารถกรองได้ เช่น ใช้ WHERE group_placement_view.target_url IS
NOT NULL หรือ WHERE detail_placement_view.target_url IS NOT NULL
มุมมองตำแหน่งโฆษณา Performance Max
- สิ่งที่แสดง: ทรัพยากร
performance_max_placement_viewให้ข้อมูลการแสดงผล (metrics.impressions) สําหรับตําแหน่งที่โฆษณา Performance Max แสดง ใน v24 ขึ้นไป คุณสามารถแบ่งกลุ่มperformance_max_placement_viewตามsegments.ad_network_type(ไม่รองรับใน v23) - เทียบเท่า UI: ข้อมูลเชิงลึกและรายงาน > เครื่องมือแก้ไขรายงาน > ตำแหน่งโฆษณาแคมเปญ Performance Max
- Query Builder: สำรวจใน Query Builder
ตัวอย่างคำค้นหา
คําค้นหาต่อไปนี้จะดึงข้อมูลการแสดงผลของตําแหน่งโฆษณาที่แบ่งกลุ่มตามประเภทเครือข่ายโฆษณาสําหรับแคมเปญ Performance Max ในช่วง 30 วันที่ผ่านมา
SELECT
campaign.id,
performance_max_placement_view.display_name,
performance_max_placement_view.target_url,
performance_max_placement_view.placement_type,
segments.ad_network_type,
metrics.impressions
FROM performance_max_placement_view
WHERE segments.date DURING LAST_30_DAYS
เลือกมุมมองตำแหน่งโฆษณา
- ใช้
managed_placement_viewเพื่อประเมินประสิทธิภาพของตำแหน่งที่คุณกำลังกำหนดเป้าหมายและเสนอราคาอยู่ - ใช้
group_placement_viewเพื่อทำความเข้าใจขอบเขตทั้งหมดของตำแหน่งที่โฆษณาปรากฏ โดยเฉพาะเมื่อใช้การตั้งค่า "การสังเกตการณ์" เพื่อค้นหาโอกาสในการกำหนดเป้าหมายหรือการยกเว้นใหม่ๆ - ใช้
detail_placement_viewเพื่อดูรายละเอียดที่ละเอียดยิบที่สุดเกี่ยวกับ URL หรือวิดีโอที่เฉพาะเจาะจงซึ่งโฆษณาแสดง ซึ่งมักใช้หลังจากระบุโดเมนหรือช่องที่สนใจในgroup_placement_view - ใช้
performance_max_placement_viewเพื่อตรวจสอบการแสดงผลของตำแหน่งโฆษณาสำหรับแคมเปญ Performance Max