فيديو: جلسة حول إعداد تقارير "إعلانات الفنادق" من ورشة العمل لعام 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
ستبدو نتائج الاستعلام على النحو التالي:
يتم تقسيم النقرات حسب 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
ستبدو نتائج الاستعلام على النحو التالي:
يتم فلترة الردّ لعرض المقاييس التي تستوفي شروط عبارة 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
ستبدو نتائج الاستعلام على النحو التالي:
{
"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"
}
}
}
]
}
طرق عرض مفيدة لإعداد تقارير "إعلانات الفنادق"
في واجهات برمجة التطبيقات السابقة لإعداد تقارير "إعلانات الفنادق"، كان بإمكانك استرداد تقرير محدّد، مثل تقرير الأداء. في 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
ستبدو نتائج الاستعلام على النحو التالي:
بما أنّ 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
ستبدو نتائج الاستعلام على النحو التالي:
يتم تقسيم النقرات حسب 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
ستبدو نتائج الاستعلام على النحو التالي:
{
"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
ستبدو نتائج الاستعلام على النحو التالي:
{
"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
ستبدو نتائج الاستعلام على النحو التالي:
{
"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". للاطّلاع على أمثلة على تقارير الجمهور، راجِع أمثلة طلبات البحث في عرض الجمهور على مستوى المجموعة الإعلانية وعرض الجمهور على مستوى الحملة.
تقرير التسوية المتعلّقة بالفندق
يحتوي تقرير تسوية حجوزات الفنادق على معلومات حول الإحالات الناجحة من حجوزات الفنادق لتسويتها مع سجلّات المعلِن. يمكنك تحميل البيانات بشكل مجمّع لإعلام Google بالحجوزات التي تم إلغاؤها أو الحجوزات المكتملة. في ما يلي الأعمدة الرئيسية في هذا التقرير:
عمود واجهة المستخدم | عمود واجهة برمجة التطبيقات | الشرح |
---|---|---|
قيمة الحجز | metrics.value_per_conversions_by_conversion_date |
قيمة الإحالة الناجحة كما تمّ تسجيلها بواسطة العلامة |
تاريخ الإحالة الناجحة | segments.date |
تاريخ الحجز |
معدّل العمولة | metrics.hotel_commission_rate_micros |
النسبة المئوية لقيمة الحجز التي تقدِّم عرض سعر لها لمرة ظهور إعلان |
تكلفة العمولة |
إذا كانت القيمة |
المبلغ الذي يُتوقّع أن تدفعه مقابل إقامة النزيل أو المبلغ الذي دفعته فعليًا مقابل تلك الإقامة |