דוחות על מודעות להזמנת חדרים

בעזרת 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, השאילתה מחזירה שורה אחת לכל יום בחלון של 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 לא מוגדר לצומת הבסיס ("כל המלונות"), השורה הראשונה מייצגת את המדדים של קבוצת כרטיסי המוצר "כל המלונות", והשורה השנייה מייצגת את המדדים של קבוצת כרטיסי המוצר הצאצא שמייצגת את "אחר".

{
  "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), כך שאפשר להחזיר שני אובייקטים או יותר עבור אותו 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"
      }
    }
  ]
}

תצוגת קהלים של קבוצת מודעות

תצוגת הקהלים של קבוצת המודעות שימושית אם רוצים לאחזר מדדי ביצועים של קהלים שמצורפים ברמת קבוצת המודעות.

השאילתה הבאה מחזירה שורה אחת לכל 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"
      }
    }
  ]
}

תצוגת קהל בקמפיין

תצוגת הקהלים בקמפיין שימושית אם רוצים לאחזר מדדים לבדיקת ביצועים של קהלים שמצורפים ברמת הקמפיין.

השאילתה הבאה מחזירה שורה אחת לכל 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"
      }
    }
  ]
}

דוח ביצועים של המרות ועלויות

השאילתה הבאה מאחזרת את נתוני הביצועים הכוללים של ההמרות והעלויות של המודעות להזמנת חדרים. הנתונים האלה שימושיים להערכת הביצועים הפיננסיים וההחזר על הוצאות הפרסום.

שאילתה לדוגמה:

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. דוגמאות לדוחות על קהלים מופיעות בשאילתות לדוגמה בקטע תצוגת קהל ברמת קבוצת המודעות ובקטע תצוגת קהל ברמת הקמפיין.

הקודם
התאמת הצעות מחיר
הבא
פידים של נסיעות למודעות לרשת החיפוש