รายงาน Hotel Ads

Google Ads API ช่วยให้คุณออกแบบคําค้นหาเพื่อรับรายงาน Hotel Ads ที่ต้องการได้ จากนั้นคุณจะรวมคำค้นหาเหล่านี้ไว้ในแอปพลิเคชันไคลเอ็นต์ได้

ข้อกำหนดเบื้องต้น

การค้นหาพื้นฐานสำหรับโฆษณาโรงแรม

ดูตัวอย่างคำค้นหาเหล่านี้เพื่อทำความคุ้นเคยกับการใช้ Google Ads API สำหรับรายงานโฆษณาโรงแรม

รับเมตริกการคลิก

ตัวอย่างคําค้นหาต่อไปนี้จะแสดงจํานวนคลิกจากมุมมองประสิทธิภาพของโรงแรม 

SELECT metrics.clicks
FROM hotel_performance_view

ผลลัพธ์จากการค้นหาจะมีลักษณะคล้ายกับการตอบกลับ JSON ต่อไปนี้

{
  "results": [
    {
      "metrics": {
        "clicks": "78090"
      },
      "hotelPerformanceView": {
        "resourceName": "customers/1234567890/hotelPerformanceView"
      }
    }
  ],
  "totalResultsCount": "1",
  "fieldMask": "metrics.clicks"
}

รับเมตริกกลุ่มโฆษณา

ตัวอย่างการค้นหาต่อไปนี้สําหรับกลุ่มโฆษณาจะได้รับการแสดงผลและการคลิกในช่วง 30 วันที่ผ่านมา โดยแบ่งกลุ่มตามวันที่

SELECT
  campaign.name,
  campaign.status,
  ad_group.name,
  segments.date,
  metrics.impressions,
  metrics.clicks
FROM ad_group
WHERE ad_group.type = HOTEL_ADS
  AND segments.date DURING LAST_30_DAYS

ผลลัพธ์จากการค้นหาจะมีลักษณะคล้ายกับการตอบกลับ JSON ต่อไปนี้ การตอบกลับจะได้รับการกรองให้แสดงเฉพาะเมตริกที่ตรงตามเงื่อนไขของWHERE เนื่องจากมีการเลือก segments.date ไว้ การค้นหาจึงแสดงผล 1 แถวต่อวันในช่วง 30 วัน

{
  "results": [
    {
      "campaign": {
        "resourceName": "customers/1234567890/campaigns/23456789",
        "name": "test campaign",
        "status": "ENABLED"
      },
      "adGroup": {
        "resourceName": "customers/1234567890/adGroups/11111111",
        "name": "test adgroup"
      },
      "metrics": {
        "clicks": "91",
        "impressions": "5145"
      },
      "segments": {
        "date": "2020-05-10"
      }
    }
  ]
}

รับโฆษณากลุ่มโฆษณาที่เปิดใช้

ตัวอย่างการค้นหาต่อไปนี้สําหรับโฆษณากลุ่มโฆษณาจะดึงกลุ่มโฆษณาที่จะแสดง หากต้องการให้กลุ่มโฆษณาแสดง โฆษณาของกลุ่มโฆษณา กลุ่มโฆษณา และ แคมเปญต้องเปิดใช้ทั้งหมด

SELECT
  ad_group.id,
  ad_group.name,
  ad_group.status,
  campaign.name,
  campaign.status,
  ad_group_ad.status
FROM ad_group_ad
WHERE ad_group_ad.status = ENABLED
  AND campaign.status = ENABLED
  AND ad_group.status = ENABLED

ผลลัพธ์จากการค้นหาจะมีลักษณะคล้ายกับการตอบกลับ JSON ต่อไปนี้

{
  "results": [
    {
      "campaign": {
        "resourceName": "customers/1234567890/campaigns/23456789",
        "name": "test campaign",
        "status": "ENABLED"
      },
      "adGroup": {
        "resourceName": "customers/1234567890/adGroups/11111111",
        "id": "11111111",
        "name": "test adgroup",
        "status": "ENABLED"
      },
      "adGroupAd": {
        "resourceName": "customers/1234567890/adGroupAds/11111111~33333333",
        "status": "ENABLED",
        "ad": {
          "resourceName": "customers/1234567890/ads/77777777"
        }
      }
    }
  ]
}

มุมมองที่เป็นประโยชน์สำหรับรายงานโฆษณาโรงแรม

ใน API ก่อนหน้าสำหรับรายงานโฆษณาโรงแรม คุณสามารถดึงข้อมูลรายงานที่เฉพาะเจาะจง เช่น รายงานประสิทธิภาพ ใน Google Ads API ข้อมูลประเภทนี้จะแสดงใน*_viewhotel_performance_viewและhotel_group_viewแยกกัน ส่วนนี้จะอธิบาย*_viewทรัพยากรที่เป็นประโยชน์สำหรับรายงานโฆษณาโรงแรม พร้อมกับการค้นหาตัวอย่าง

มุมมองกลุ่มโรงแรม

มุมมองกลุ่มโรงแรมคือมุมมองเกณฑ์ จึงมีประโยชน์ในการดึงข้อมูลเมตริกสำหรับเกณฑ์ประเภทใดประเภทหนึ่งของกลุ่มโรงแรม

ตัวอย่างคําค้นหาต่อไปนี้สําหรับมุมมองกลุ่มโรงแรมจะได้รับการคลิกสําหรับโรงแรมแต่ละแห่งใน กลุ่มข้อมูลสําหรับทั้งโครงสร้างกลุ่มข้อมูลโรงแรม รวมถึงโหนดรูท ("โรงแรมทั้งหมด") 

SELECT
  metrics.clicks,
  ad_group_criterion.listing_group.case_value.hotel_id.value
FROM hotel_group_view

ผลลัพธ์จากการค้นหาจะมีลักษณะคล้ายกับการตอบกลับ JSON ต่อไปนี้ เนื่องจากcase_valueไม่ได้กำหนดไว้สำหรับโหนดรูท ("โรงแรมทั้งหมด") แถวแรกจึงแสดงเมตริกสำหรับกลุ่มรายชื่อ "โรงแรมทั้งหมด" ส่วนแถวที่ 2 แสดงเมตริกสำหรับกลุ่มรายชื่อย่อยที่แสดง "อื่นๆ"

{
  "results": [
    {
      "metrics": {
        "clicks": "5"
      },
      "adGroupCriterion": {
        "resourceName": "customers/1234567890/adGroupCriteria/2222222~1111111"
      },
      "hotelGroupView": {
        "resourceName": "customers/1234567890/hotelGroupViews/2222222~1111111"
      }
    },
    {
      "metrics": {
        "clicks": "0"
      },
      "adGroupCriterion": {
        "resourceName": "customers/1234567890/adGroupCriteria/2222222~1111112",
        "listingGroup": {
          "caseValue": {
            "hotelId": {}
          }
        }
      },
      "hotelGroupView": {
        "resourceName": "customers/1234567890/hotelGroupViews/2222222~1111112"
      }
    },
    {
      "metrics": {
        "clicks": "3"
      },
      "adGroupCriterion": {
        "resourceName": "customers/1234567890/adGroupCriteria/2222222~1111113",
        "listingGroup": {
          "caseValue": {
            "hotelId": {
              "value": "11111111111111111"
            }
          }
        }
      },
      "hotelGroupView": {
        "resourceName": "customers/1234567890/hotelGroupViews/2222222~1111113"
      }
    },
    {
      "metrics": {
        "clicks": "2"
      },
      "adGroupCriterion": {
        "resourceName": "customers/1234567890/adGroupCriteria/2222222~1111114",
        "listingGroup": {
          "caseValue": {
            "hotelId": {
              "value": "11111111111111112"
            }
          }
        }
      },
      "hotelGroupView": {
        "resourceName": "customers/1234567890/hotelGroupViews/2222222~1111114"
      }
    }
  ]
}

มุมมองประสิทธิภาพของโรงแรม

มุมมองประสิทธิภาพของโรงแรมมีประโยชน์ในกรณีที่คุณต้องการเรียกเมตริกประสิทธิภาพของโรงแรมโดยใช้ข้อมูลที่ไม่ได้มาจากกลุ่มโรงแรม แม้ว่าคุณจะมีกลุ่มย่อยตามรหัสโรงแรมก็ตาม

ตัวอย่างการค้นหาต่อไปนี้สําหรับมุมมองประสิทธิภาพของโรงแรมจะได้รับการคลิกและ แบ่งกลุ่มผลลัพธ์ตามรหัสโรงแรม

SELECT
  segments.partner_hotel_id,
  metrics.clicks
FROM hotel_performance_view

ผลลัพธ์จากการค้นหาจะมีลักษณะคล้ายกับการตอบกลับ JSON ต่อไปนี้ ระบบจะแบ่งกลุ่มการคลิกตาม partner_hotel_id (partnerHotelId ใน REST JSON) ดังนั้น จึงอาจมีการแสดงออบเจ็กต์ 2 รายการขึ้นไปสำหรับ hotel_performance_view เดียวกัน

{
  "results": [
    {
      "metrics": {
        "clicks": "7055"
      },
      "hotelPerformanceView": {
        "resourceName": "customers/1234567890/hotelPerformanceView"
      },
      "segments": {
        "partnerHotelId": "1111"
      }
    },
    {
      "metrics": {
        "clicks": "3047"
      },
      "hotelPerformanceView": {
        "resourceName": "customers/1234567890/hotelPerformanceView"
      },
      "segments": {
        "partnerHotelId": "1112"
      }
    }
  ]
}

มุมมองกลุ่มเป้าหมายของกลุ่มโฆษณา

มุมมองกลุ่มเป้าหมายของกลุ่มโฆษณามีประโยชน์หากคุณต้องการ เรียกเมตริกประสิทธิภาพสําหรับกลุ่มเป้าหมายที่แนบไว้ที่ระดับกลุ่มโฆษณา

คําค้นหาต่อไปนี้จะแสดงผล 1 แถวต่อ ad_group_criterion.user_list.user_list

SELECT
  ad_group.id,
  campaign.id,
  ad_group_criterion.user_list.user_list,
  segments.device,
  segments.hotel_date_selection_type,
  metrics.impressions,
  metrics.clicks,
  metrics.cost_micros,
  metrics.conversions,
  metrics.all_conversions_value
FROM ad_group_audience_view

ผลลัพธ์จากการค้นหาจะมีลักษณะคล้ายกับการตอบกลับ JSON ต่อไปนี้

{
  "results": [
    {
      "campaign": {
        "resourceName": "customers/1234567890/campaigns/23456789",
        "id": "23456789"
      },
      "metrics": {
        "clicks": "0",
        "conversions": "0",
        "costMicros": "0",
        "impressions": "3",
        "allConversionsValue": "0"
      },
      "adGroupCriterion": {
        "resourceName": "customers/1234567890/adGroupCriteria/23456789~789456",
        "userList": {
          "userList": "customers/1234567890/userLists/456789"
        }
      },
      "adGroupAudienceView": {
        "resourceName":
          "customers/1234567890/adGroupAudienceViews/23456789~789456"
      },
      "segments": {
        "device": "TABLET",
        "hotelDateSelectionType": "USER_SELECTED"
      }
    }
  ]
}

มุมมองกลุ่มเป้าหมายของแคมเปญ

มุมมองกลุ่มเป้าหมายของแคมเปญมีประโยชน์หากคุณต้องการ ดึงข้อมูลเมตริกประสิทธิภาพสําหรับกลุ่มเป้าหมายที่แนบไว้ที่ระดับแคมเปญ

คําค้นหาต่อไปนี้จะแสดงผล 1 แถวต่อ campaign_criterion.user_list.user_list

SELECT
  campaign.id,
  campaign_criterion.user_list.user_list,
  segments.device,
  segments.hotel_date_selection_type,
  metrics.impressions,
  metrics.clicks,
  metrics.cost_micros,
  metrics.conversions,
  metrics.all_conversions_value
FROM campaign_audience_view

ผลลัพธ์จากการค้นหาจะมีลักษณะคล้ายกับการตอบกลับ JSON ต่อไปนี้

{
  "results": [
    {
      "campaign": {
        "resourceName": "customers/1234567890/campaigns/23456789",
        "id": "23456789"
      },
      "metrics": {
        "clicks": "0",
        "conversions": "0",
        "costMicros": "0",
        "impressions": "3",
        "allConversionsValue": "0"
      },
      "campaignCriterion": {
        "resourceName": "customers/1234567890/campaignCriteria/23456789~789456",
        "userList": {
          "userList": "customers/1234567890/userLists/456789"
        }
      },
      "campaignAudienceView": {
        "resourceName":
          "customers/1234567890/campaignAudienceViews/23456789~789456"
      },
      "segments": {
        "device": "TABLET",
        "hotelDateSelectionType": "USER_SELECTED"
      }
    }
  ]
}

รายงานที่เป็นประโยชน์สำหรับโฆษณาโรงแรม

ส่วนนี้มีรายงานที่มีประโยชน์หลายรายการซึ่งออกแบบมาสําหรับโฆษณาโรงแรมโดยเฉพาะ

รายงานประสิทธิภาพ

การค้นหาเหล่านี้ใช้มุมมองประสิทธิภาพของโรงแรมเพื่อรับข้อมูลประสิทธิภาพ

hotel_performance_view ช่วยให้คุณใช้ทรัพยากร campaign เพื่อแบ่งกลุ่ม เมตริกได้ เช่น คุณสามารถใช้ฟิลด์ campaign.id เพื่อดูเมตริกประสิทธิภาพตามแคมเปญได้

ประสิทธิภาพ

ตัวอย่างคำค้นหา

SELECT
  segments.hotel_center_id,
  segments.device,
  segments.partner_hotel_id,
  segments.hotel_check_in_day_of_week,
  segments.hotel_date_selection_type,
  segments.hotel_length_of_stay,
  segments.hotel_booking_window_days,
  metrics.search_top_impression_share,
  metrics.search_absolute_top_impression_share,
  metrics.impressions,
  metrics.clicks,
  metrics.cost_micros,
  metrics.conversions,
  metrics.all_conversions_value,
  metrics.search_impression_share
FROM hotel_performance_view

ตัวอย่างการตอบกลับ JSON

{
  "results": [
    {
      "campaign": {
        "resourceName": "customers/1234567890/campaigns/23456789"
      },
      "metrics": {
        "clicks": "0",
        "conversions": "0.0",
        "costMicros": "0",
        "impressions": "0",
        "searchImpressionShare": "0.0999",
        "searchAbsoluteTopImpressionShare": "0.0999",
        "searchTopImpressionShare": "0.0999",
        "allConversionsValue": "1"
      },
      "hotelPerformanceView": {
        "resourceName": "customers/1234567890/hotelPerformanceView"
      },
      "segments": {
        "device": "DESKTOP",
        "hotelBookingWindowDays": "3",
        "hotelCenterId": "1234",
        "hotelCheckInDayOfWeek": "MONDAY",
        "hotelDateSelectionType": "USER_SELECTED",
        "hotelLengthOfStay": "4",
        "partnerHotelId": "123"
      }
    },
    {
      "campaign": {
        "resourceName": "customers/1234567890/campaigns/23456789"
      },
      "metrics": {
        "clicks": "0",
        "conversions": "0.0",
        "costMicros": "0",
        "impressions": "1",
        "searchImpressionShare": "1.0",
        "searchAbsoluteTopImpressionShare": "0.0999",
        "searchTopImpressionShare": "1.0",
        "allConversionsValue": "1"
      },
      "hotelPerformanceView": {
        "resourceName": "customers/1234567890/hotelPerformanceView"
      },
      "segments": {
        "device": "DESKTOP",
        "hotelBookingWindowDays": "3",
        "hotelCenterId": "1234",
        "hotelCheckInDayOfWeek": "MONDAY",
        "hotelDateSelectionType": "USER_SELECTED",
        "hotelLengthOfStay": "4",
        "partnerHotelId": "123"
      }
    }
  ]
}

ประสิทธิภาพตามประเภทคลิก

ตัวอย่างคำค้นหา

SELECT
  segments.click_type,
  segments.hotel_center_id,
  segments.device,
  segments.partner_hotel_id,
  segments.hotel_check_in_day_of_week,
  segments.hotel_date_selection_type,
  segments.hotel_length_of_stay,
  segments.hotel_booking_window_days,
  metrics.impressions,
  metrics.clicks,
  metrics.cost_micros,
  metrics.conversions,
  metrics.all_conversions_value
FROM hotel_performance_view

ตัวอย่างการตอบกลับ JSON

{
  "results": [
    {
      "campaign": {
        "resourceName": "customers/1234567890/campaigns/23456789"
      },
      "metrics": {
        "clicks": "0",
        "conversions": "0.0",
        "costMicros": "0",
        "impressions": "1",
        "allConversionsValue": "0.0"
      },
      "hotelPerformanceView": {
        "resourceName": "customers/1234567890/hotelPerformanceView"
      },
      "segments": {
        "device": "DESKTOP",
        "hotelBookingWindowDays": "0",
        "hotelCenterId": "1234",
        "hotelCheckInDayOfWeek": "TUESDAY",
        "hotelDateSelectionType": "USER_SELECTED",
        "hotelLengthOfStay": "4",
        "partnerHotelId": "123",
        "clickType": "HOTEL_PRICE"
      }
    },
    {
      "campaign": {
        "resourceName": "customers/1234567890/campaigns/23456789"
      },
      "metrics": {
        "clicks": "1",
        "conversions": "0.0",
        "costMicros": "0",
        "impressions": "1",
        "allConversionsValue": "0.0"
      },
      "hotelPerformanceView": {
        "resourceName": "customers/1234567890/hotelPerformanceView"
      },
      "segments": {
        "device": "DESKTOP",
        "hotelBookingWindowDays": "0",
        "hotelCenterId": "1234",
        "hotelCheckInDayOfWeek": "TUESDAY",
        "hotelDateSelectionType": "USER_SELECTED",
        "hotelLengthOfStay": "4",
        "partnerHotelId": "12345",
        "clickType": "HOTEL_PRICE"
      }
    }
  ]
}

รายงานประสิทธิภาพของราคาสำหรับลูกค้าที่เข้าเกณฑ์

คําค้นหาต่อไปนี้จะได้รับเมตริกประสิทธิภาพที่แบ่งกลุ่มตาม

  • campaign
  • hotel_center_id
  • hotel_country
  • hotel_rate_rule_id
  • hotel_rate_type
  • device
  • partner_hotel_id

ดูคำอธิบายประเภทได้ที่ HotelRateType

คุณสามารถรวมกลุ่มหลายกลุ่มไว้ในคําค้นหาได้ แต่จํานวนแถวที่แสดงผลอาจเพิ่มขึ้นอย่างมากเมื่อมีกลุ่มเพิ่มเติม

SELECT
  campaign.id,
  segments.hotel_center_id,
  segments.hotel_country,
  segments.hotel_rate_rule_id,
  segments.hotel_rate_type,
  segments.device,
  segments.partner_hotel_id,
  metrics.search_top_impression_share,
  metrics.search_absolute_top_impression_share,
  metrics.impressions,
  metrics.clicks,
  metrics.cost_micros,
  metrics.conversions
FROM hotel_performance_view

ผลลัพธ์จากการค้นหาจะมีลักษณะคล้ายกับการตอบกลับ JSON ต่อไปนี้

{
  "results": [
    {
      "campaign": {
        "resourceName": "customers/1234567890/campaigns/23456789",
        "id": "23456789"
      },
      "metrics": {
        "clicks": "1",
        "conversions": "0.0",
        "costMicros": "0",
        "impressions": "24",
        "searchAbsoluteTopImpressionShare": "0.0999",
        "searchTopImpressionShare": "0.17073170731707318"
      },
      "hotelPerformanceView": {
        "resourceName": "customers/1234567890/hotelPerformanceView"
      },
      "segments": {
        "device": "TABLET",
        "hotelCenterId": "1234",
        "partnerHotelId": "123",
        "hotelRateRuleId": "desktop",
        "hotelRateType": "PUBLIC_RATE"
      }
    },
    {
      "campaign": {
        "resourceName": "customers/1234567890/campaigns/23456789",
        "id": "23456789"
      },
      "metrics": {
        "clicks": "107",
        "conversions": "0.0",
        "costMicros": "0",
        "impressions": "1668",
        "searchAbsoluteTopImpressionShare": "0.0999",
        "searchTopImpressionShare": "0.3581201665675193"
      },
      "hotelPerformanceView": {
        "resourceName": "customers/1234567890/hotelPerformanceView"
      },
      "segments": {
        "device": "TABLET",
        "hotelCenterId": "1234",
        "partnerHotelId": "1235",
        "hotelRateRuleId": "desktop",
        "hotelRateType": "PUBLIC_RATE"
      }
    }
  ]
}

รายงานความสามารถในการแข่งขันด้านราคา

คุณจะได้รับข้อมูลเชิงลึกเกี่ยวกับวิธีที่ราคาของคุณเทียบกับราคาของคู่แข่งใน แผนการเดินทางของโรงแรมเดียวกัน

ตัวอย่างคำค้นหา

SELECT
  segments.hotel_center_id,
  segments.partner_hotel_id,
  segments.hotel_price_bucket,
  metrics.hotel_average_lead_value_micros,
  metrics.hotel_price_difference_percentage
FROM hotel_performance_view

ตัวอย่างการตอบกลับ JSON

{
  "results": [
    {
      "metrics": {
        "hotelAverageLeadValueMicros": "96416341.829268292",
        "hotelPriceDifferencePercentage": "-0.014627310872986811"
      },
      "hotelPerformanceView": {
        "resourceName": "customers/1234567890/hotelPerformanceView"
      },
      "segments": {
        "hotelCenterId": "1234",
        "partnerHotelId": "123",
        "hotelPriceBucket": "LOWEST_TIED"
      }
    }
  ]
}

รายงานราคาที่จองโดยเฉลี่ย

คุณสามารถรับข้อมูลที่จำเป็นในการคำนวณราคาเฉลี่ยที่จอง (all_conversions_value หารด้วย conversions) สำหรับโรงแรมได้

ตัวอย่างคำค้นหา

SELECT
  segments.hotel_center_id,
  segments.partner_hotel_id,
  segments.hotel_price_bucket,
  metrics.all_conversions_value,
  metrics.conversions
FROM hotel_performance_view

ตัวอย่างการตอบกลับ JSON

{
  "results": [
    {
      "metrics": {
        "allConversionsValue": "123.5",
        "conversions": "1"
      },
      "hotelPerformanceView": {
        "resourceName": "customers/1234567890/hotelPerformanceView"
      },
      "segments": {
        "hotelCenterId": "1234",
        "partnerHotelId": "123",
        "hotelPriceBucket": "LOWEST_TIED"
      }
    }
  ]
}

รายงานประสิทธิภาพของ Conversion และต้นทุน

คําค้นหาต่อไปนี้จะแสดงประสิทธิภาพ Conversion และต้นทุนโดยรวมสําหรับ โฆษณาโรงแรม ซึ่งมีประโยชน์ในการประเมินประสิทธิภาพทางการเงินและ ROAS

ตัวอย่างคำค้นหา

SELECT
  segments.date,
  segments.partner_hotel_id,
  metrics.all_conversions_value,
  metrics.cost_micros,
  metrics.conversions
FROM hotel_performance_view
WHERE segments.date DURING LAST_30_DAYS

ตัวอย่างการตอบกลับ JSON

{
  "results": [
    {
      "metrics": {
        "allConversionsValue": "250.0",
        "costMicros": "15000000",
        "conversions": "2.0"
      },
      "hotelPerformanceView": {
        "resourceName": "customers/1234567890/hotelPerformanceView"
      },
      "segments": {
        "date": "2026-03-24",
        "partnerHotelId": "123"
      }
    }
  ]
}

รายงานกลุ่มเป้าหมาย

รายงานกลุ่มเป้าหมายแสดงประสิทธิภาพของตัวคูณราคาเสนอในรายการกลุ่มเป้าหมายของ Google Ads ดูตัวอย่างรายงานกลุ่มเป้าหมายได้ที่ตัวอย่างการค้นหาในมุมมองกลุ่มเป้าหมายของกลุ่มโฆษณาและมุมมองกลุ่มเป้าหมายของแคมเปญ

ก่อนหน้า
ปรับราคาเสนอ
ถัดไป
ฟีดการเดินทางสําหรับโฆษณา Search