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