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