فيديو: حضور حديث عن إعداد تقارير إعلانات الفنادق من ورشة العمل لعام 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
فقط. تتم تعبئة حقل التاريخ بآخر تاريخ تم تضمينه في فترة الثلاثين يومًا.
{
"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 |
النسبة المئوية لقيمة الحجز التي تقدِّم عرض سعر لمرة ظهور إعلان |
تكلفة العمولة |
إذا كانت |
المبلغ الذي من المتوقّع دفعه أو الذي دفعته مقابل إقامة النزيل |