דיווח

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

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

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

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

תוכלו לעיין בשאילתות לדוגמה כדי להכיר את אופן השימוש ב-Google Ads API for Hotel Ads.

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

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

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.

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

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

השאילתה לדוגמה הבאה בנושא תצוגות של קבוצת מלונות מקבלת קליקים לכל מלון בקבוצה של כרטיסי מוצר, לכל עץ הקבוצה של כרטיסי המוצר, כולל צומת הרמה הבסיסית (root) ("כל המלונות").

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. לדוגמאות של דוחות 'קהלים', ראו שאילתות לדוגמה ב-Ad Group View Audience View וב-Campaign Audience View.

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

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

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