דיווח

סרטון: צפייה בהרצאה על דיווח במודעות להזמנת חדרים מסדנת 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. בקטע הזה מתוארים *_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"
      }
    }
  ]
}

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

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

דוח התאמה של מלונות

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

עמודה של ממשק המשתמש עמודה של API הסבר
ערך ההזמנה metrics.value_per_conversions_by_conversion_date ערך ההמרה כפי שדווח על ידי התג
תאריך המרה segments.date תאריך ההזמנה
שיעור עמלה metrics.hotel_commission_rate_micros אחוז מערך ההזמנה שאתם מגישים עליו הצעת מחיר לחשיפה של מודעה
עלות עמלה

אם הערך הוא status == RECONCILED או CANCELED, אפשר לחשב את הערך הזה כ-metrics.hotel_commission_rate_micros * hotel_reconciliation.reconciled_value_micros. בכל המקרים האחרים, אפשר לקבל את הערך הזה מהעמודה metrics.hotel_expected_commission_cost, או לחשב אותו לפי הנוסחה metrics.hotel_commission_rate_micros * metrics.value_per_conversions_by_conversion_date

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