‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

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

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

התאמת הצעות מחיר

פידים של נסיעות למודעות לרשת החיפוש

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

דרישות מוקדמות

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

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

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

קבלת מודעות פעילות בקבוצת מודעות

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

תצוגת קבוצת מלונות

תצוגת ביצועי המלון

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

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

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

דוחות ביצועים

ביצועים

ביצועים עם סוג קליק

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

דוח השוואת מחירים ביחס לשוק

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

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

דוחות 'קהלים'

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