דיווח

סרטון: צפייה בהרצאה על דיווח במודעות להזמנת חדרים מסדנת 2019

בעזרת Google Ads API, אתם יכולים לעצב שאילתות כדי לקבל את הדוחות שאתם צריכים לגבי מודעות להזמנת חדרים. אחרי כן תוכלו לשלב את השאילתות האלה באפליקציות הלקוח שלכם.

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

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

כדי להכיר את השימוש ב-Google Ads API לדיווח על מודעות להזמנת חדרים במלונות, כדאי לעיין בשאילתות לדוגמה הבאות.

קבלת מדדי קליקים

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

SELECT metrics.clicks
FROM hotel_performance_view

התוצאות מהשאילתה ייראו בערך כך:

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

קבלת מדדי קליקים מפולחים

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

SELECT
  segments.partner_hotel_id,
  metrics.clicks
FROM hotel_performance_view

התוצאות של השאילתה ייראו בערך כמו מחרוזת ה-JSON הבאה. הקליקים מפולחים לפי partnerHotelID ולכן יכול להיות שיוחזרו שני אובייקטים או יותר עבור אותו hotelPerformanceView.

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

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

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

{
  "results": [
    {
      "campaign": {
        "resourceName": "customers/123456789/campaigns/23456789",
        "name": "test campaign",
        "status": "ENABLED"
      },
      "adGroup": {
        "resourceName": "customers/123456789/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/123456789/campaigns/23456789",
        "name": "test campaign",
        "status": "ENABLED"
      },
      "adGroup": {
        "resourceName": "customers/123456789/adGroups/111111111111",
        "id": "106121857411",
        "name": "test adgroup",
        "status": "ENABLED"
      },
      "adGroupAd": {
        "resourceName": "customers/123456789/adGroupAds/111111111111~33333333333",
        "status": "ENABLED",
        "ad": {
          "resourceName": "customers/123456789/ads/77777777777"
        }
      }
    }
  ]
}

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

בממשקי API קודמים לדיווח על מודעות להזמנת חדרים במלונות, הייתה אפשרות לאחזר דוח ספציפי, כמו דוח ביצועים. ב-Google Ads API, נתונים מהסוג הזה מיוצגים במשאבי *_view נפרדים, כמו hotel_performance_view ו-hotel_group_view. בקטע הזה מתוארים המשאבים שמועילים לדיווח על Hotel Ads.*_view מסופקות גם דוגמאות לשאילתות.

שימו לב שלכל *_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/22222222222~111111111111"
      },
      "hotelGroupView": {
        "resourceName": "customers/1234567890/hotelGroupViews/22222222222~111111111111"
      }
    },
    {
      "metrics": {
        "clicks": "0"
      },
      "adGroupCriterion": {
        "resourceName": "customers/1234567890/adGroupCriteria/22222222222~111111111112"
        "listingGroup": {
          "caseValue": {
            "hotelId": {
            }
          }
        }
      },
      "hotelGroupView": {
        "resourceName": "customers/1234567890/hotelGroupViews/22222222222~111111111112"
      }
    },
    {
      "metrics": {
        "clicks": "3"
      },
      "adGroupCriterion": {
        "resourceName": "customers/1234567890/adGroupCriteria/22222222222~111111111113"
        "listingGroup": {
          "caseValue": {
            "hotelId": {
              "value": "11111111111111111"
              }
            }
          }
        }
      },
      "hotelGroupView": {
        "resourceName": "customers/1234567890/hotelGroupViews/22222222222~111111111113"
      }
    },
    {
      "metrics": {
        "clicks": "2"
      },
      "adGroupCriterion": {
        "resourceName": "customers/1234567890/adGroupCriteria/22222222222~111111111114"
        "listingGroup": {
          "caseValue": {
            "hotelId": {
              "value": "11111111111111112"
              }
            }
          }
        }
      },
      "hotelGroupView": {
        "resourceName": "customers/1234567890/hotelGroupViews/22222222222~111111111114"
      }
    },
  ]
}

תצוגת ביצועים של מלונות

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

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

SELECT
  segments.partner_hotel_id,
  metrics.clicks
FROM hotel_performance_view

התוצאות של השאילתה ייראו בערך כמו מחרוזת ה-JSON הבאה. הקליקים מפולחים לפי partner_hotel_id ולכן יכול להיות שיוחזרו שני אובייקטים או יותר עבור אותה תצוגת ביצועים של מלון.

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

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

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

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

השאילתה הבאה מחזירה שורה אחת לכל 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/123456789/campaigns/23456789",
        "id": "23456789"
      },
      "metrics": {
        "clicks": "0",
        "conversions": "0",
        "costMicros": "0",
        "impressions": "3",
        "allConversionsValue": "0"
      },
      "adGroupCriterion": {
        "resourceName": "customers/123456789/adGroupCriteria/23456789~789456",
        "userList": {
          "userList": "customers/123456789/userLists/456789"
        }
      },
      "adGroupAudienceView": {
        "resourceName": "customers/8005193609/adGroupAudienceViews/23456789~789456"
      },
      "segments": {
        "device": "TABLET",
        "hotelDateSelectionType": "USER_SELECTED"
      }
    }
  ]
}

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

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

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

השאילתה הבאה מחזירה שורה אחת לכל 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/123456789/campaigns/23456789",
        "id": "23456789"
      },
      "metrics": {
        "clicks": "0",
        "conversions": "0",
        "costMicros": "0",
        "impressions": "3",
        "allConversionsValue": "0"
      },
      "campaignCriterion": {
        "resourceName": "customers/123456789/campaignCriteria/23456789~789456",
        "userList": {
          "userList": "customers/123456789/userLists/456789"
        }
      },
      "campaignAudienceView": {
        "resourceName": "customers/8005193609/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/123456789/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/123456789/hotelPerformanceView"
      },
      "segments": {
        "device": "DESKTOP",
        "hotelBookingWindowDays": "3",
        "hotelCenterId": "1234",
        "hotelCheckInDayOfWeek": "MONDAY",
        "hotelDateSelectionType": "USER_SELECTED",
        "hotelLengthOfStay": "4",
        "partnerHotelId": "123"
      }
    },
    {
      "campaign": {
        "resourceName": "customers/123456789/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/123456789/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/123456789/campaigns/23456789"
    },
      "metrics": {
        "clicks": "0",
        "conversions": "0.0",
        "costMicros": "0",
        "impressions": "1",
        "allConversionsValue": "0.0"
      },
      "hotelPerformanceView": {
        "resourceName": "customers/123456789/hotelPerformanceView"
      },
      "segments": {
        "device": "DESKTOP",
        "hotelBookingWindowDays": "0",
        "hotelCenterId": "1234",
        "hotelCheckInDayOfWeek": "TUESDAY",
        "hotelDateSelectionType": "USER_SELECTED",
        "hotelLengthOfStay": "4",
        "partnerHotelId": "123",
        "clickType": "HOTEL_PRICE"
      }
    },
    {
      "campaign": {
        "resourceName": "customers/123456789/campaigns/23456789"
      },
      "metrics": {
        "clicks": "1",
        "conversions": "0.0",
        "costMicros": "0",
        "impressions": "1",
        "allConversionsValue": "0.0"
      },
      "hotelPerformanceView": {
        "resourceName": "customers/123456789/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/123456789/campaigns/23456789",
        "id": "23456789"
      },
      "metrics": {
        "clicks": "1",
        "conversions": "0.0",
        "costMicros": "0",
        "impressions": "24",
        "searchAbsoluteTopImpressionShare": "0.0999",
        "searchTopImpressionShare": "0.17073170731707318"
      },
      "hotelPerformanceView": {
        "resourceName": "customers/123456789/hotelPerformanceView"
      },
      "segments": {
        "device": "TABLET",
        "hotelCenterId": "1234",
        "partnerHotelId": "123",
        "hotelRateRuleId": "desktop",
        "hotelRateType": "PUBLIC_RATE"
      }
    },
    {
      "campaign": {
        "resourceName": "customers/123456789/campaigns/23456789",
        "id": "23456789"
      },
      "metrics": {
        "clicks": "107",
        "conversions": "0.0",
        "costMicros": "0",
        "impressions": "1668",
        "searchAbsoluteTopImpressionShare": "0.0999",
        "searchTopImpressionShare": "0.3581201665675193"
      },
      "hotelPerformanceView": {
        "resourceName": "customers/123456789/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/123456789/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/123456789/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/123456789/hotelPerformanceView"
      },
      "segments": {
        "date": "2026-03-24",
        "partnerHotelId": "123"
      }
    }
  ]
}

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

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

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