รายงาน Hotel Ads

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

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

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

ดูตัวอย่างการค้นหาเหล่านี้เพื่อทำความคุ้นเคยกับการใช้ 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 ข้อมูลประเภทนี้จะแสดงในทรัพยากร *_view แยกกัน เช่น hotel_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