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

דף זה תורגם על ידי Cloud Translation API.

דיווח

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

תצוגת הקהל של הקמפיין

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

השאילתה הבאה מחזירה שורה אחת לכל 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`	הסכום שאתם צפויים או ששילמתם עבור שהות האורחים

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

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