דיווח

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

{
  "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

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