تقارير "إعلانات الفنادق"

باستخدام Google Ads API، يمكنك تصميم طلبات للحصول على تقارير "إعلانات الفنادق" التي تحتاج إليها. يمكنك بعد ذلك دمج طلبات البحث هذه في تطبيقات العميل.

المتطلبات الأساسية

طلبات البحث الأساسية في "إعلانات الفنادق"

اطّلِع على نماذج طلبات البحث هذه للتعرّف على كيفية استخدام Google Ads API لتقارير "إعلانات الفنادق".

الحصول على مقاييس النقرات

يعرض طلب البحث المثال التالي عدد النقرات من عرض أداء الفندق.

SELECT metrics.clicks
FROM hotel_performance_view

تبدو نتائج الاستعلام مشابهة لاستجابة JSON التالية:

{
  "results": [
    {
      "metrics": {
        "clicks": "78090"
      },
      "hotelPerformanceView": {
        "resourceName": "customers/1234567890/hotelPerformanceView"
      }
    }
  ],
  "totalResultsCount": "1",
  "fieldMask": "metrics.clicks"
}

الحصول على مقاييس المجموعات الإعلانية

يحصل طلب البحث التالي للمجموعات الإعلانية على مرّات الظهور والنقرات خلال آخر 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 فقط. بما أنّه تم اختيار segments.date، يعرض الاستعلام صفًا واحدًا لكل يوم خلال فترة الـ 30 يومًا.

{
  "results": [
    {
      "campaign": {
        "resourceName": "customers/1234567890/campaigns/23456789",
        "name": "test campaign",
        "status": "ENABLED"
      },
      "adGroup": {
        "resourceName": "customers/1234567890/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/1234567890/campaigns/23456789",
        "name": "test campaign",
        "status": "ENABLED"
      },
      "adGroup": {
        "resourceName": "customers/1234567890/adGroups/11111111",
        "id": "11111111",
        "name": "test adgroup",
        "status": "ENABLED"
      },
      "adGroupAd": {
        "resourceName": "customers/1234567890/adGroupAds/11111111~33333333",
        "status": "ENABLED",
        "ad": {
          "resourceName": "customers/1234567890/ads/77777777"
        }
      }
    }
  ]
}

طرق العرض المفيدة لتقارير "إعلانات الفنادق"

في واجهات برمجة التطبيقات السابقة لتقارير "إعلانات الفنادق"، كان بإمكانك استرداد تقرير معيّن، مثل تقرير الأداء. في Google Ads API، يتم تمثيل هذا النوع من البيانات في موارد *_view منفصلة، مثل hotel_performance_view وhotel_group_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/2222222~1111111"
      },
      "hotelGroupView": {
        "resourceName": "customers/1234567890/hotelGroupViews/2222222~1111111"
      }
    },
    {
      "metrics": {
        "clicks": "0"
      },
      "adGroupCriterion": {
        "resourceName": "customers/1234567890/adGroupCriteria/2222222~1111112",
        "listingGroup": {
          "caseValue": {
            "hotelId": {}
          }
        }
      },
      "hotelGroupView": {
        "resourceName": "customers/1234567890/hotelGroupViews/2222222~1111112"
      }
    },
    {
      "metrics": {
        "clicks": "3"
      },
      "adGroupCriterion": {
        "resourceName": "customers/1234567890/adGroupCriteria/2222222~1111113",
        "listingGroup": {
          "caseValue": {
            "hotelId": {
              "value": "11111111111111111"
            }
          }
        }
      },
      "hotelGroupView": {
        "resourceName": "customers/1234567890/hotelGroupViews/2222222~1111113"
      }
    },
    {
      "metrics": {
        "clicks": "2"
      },
      "adGroupCriterion": {
        "resourceName": "customers/1234567890/adGroupCriteria/2222222~1111114",
        "listingGroup": {
          "caseValue": {
            "hotelId": {
              "value": "11111111111111112"
            }
          }
        }
      },
      "hotelGroupView": {
        "resourceName": "customers/1234567890/hotelGroupViews/2222222~1111114"
      }
    }
  ]
}

عرض أداء الفنادق

تكون طريقة عرض أداء الفندق مفيدة إذا أردت استرداد مقاييس الأداء لفندق باستخدام بيانات لا تأتي من تجميعة فنادق، حتى إذا كان لديك قسم فرعي استنادًا إلى رقم تعريف الفندق.

يحصل مثال طلب البحث التالي الخاص بطرق عرض أداء الفنادق على النقرات ويقسّم النتائج حسب معرّف الفندق.

SELECT
  segments.partner_hotel_id,
  metrics.clicks
FROM hotel_performance_view

تبدو نتائج الاستعلام مشابهة لاستجابة JSON التالية. يتم تقسيم النقرات حسب partner_hotel_id (partnerHotelId في REST JSON)، لذا يمكن عرض عنصرَين أو أكثر للسمة hotel_performance_view نفسها.

{
  "results": [
    {
      "metrics": {
        "clicks": "7055"
      },
      "hotelPerformanceView": {
        "resourceName": "customers/1234567890/hotelPerformanceView"
      },
      "segments": {
        "partnerHotelId": "1111"
      }
    },
    {
      "metrics": {
        "clicks": "3047"
      },
      "hotelPerformanceView": {
        "resourceName": "customers/1234567890/hotelPerformanceView"
      },
      "segments": {
        "partnerHotelId": "1112"
      }
    }
  ]
}

طريقة عرض شرائح الجمهور على مستوى المجموعة الإعلانية

تكون طريقة عرض الجمهور على مستوى المجموعة الإعلانية مفيدة إذا كنت تريد استرداد مقاييس الأداء للجمهور المستهدَف على مستوى المجموعة الإعلانية.

يعرض الاستعلام التالي صفًا واحدًا لكل 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/1234567890/campaigns/23456789",
        "id": "23456789"
      },
      "metrics": {
        "clicks": "0",
        "conversions": "0",
        "costMicros": "0",
        "impressions": "3",
        "allConversionsValue": "0"
      },
      "adGroupCriterion": {
        "resourceName": "customers/1234567890/adGroupCriteria/23456789~789456",
        "userList": {
          "userList": "customers/1234567890/userLists/456789"
        }
      },
      "adGroupAudienceView": {
        "resourceName":
          "customers/1234567890/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/1234567890/campaigns/23456789",
        "id": "23456789"
      },
      "metrics": {
        "clicks": "0",
        "conversions": "0",
        "costMicros": "0",
        "impressions": "3",
        "allConversionsValue": "0"
      },
      "campaignCriterion": {
        "resourceName": "customers/1234567890/campaignCriteria/23456789~789456",
        "userList": {
          "userList": "customers/1234567890/userLists/456789"
        }
      },
      "campaignAudienceView": {
        "resourceName":
          "customers/1234567890/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/1234567890/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/1234567890/hotelPerformanceView"
      },
      "segments": {
        "device": "DESKTOP",
        "hotelBookingWindowDays": "3",
        "hotelCenterId": "1234",
        "hotelCheckInDayOfWeek": "MONDAY",
        "hotelDateSelectionType": "USER_SELECTED",
        "hotelLengthOfStay": "4",
        "partnerHotelId": "123"
      }
    },
    {
      "campaign": {
        "resourceName": "customers/1234567890/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/1234567890/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/1234567890/campaigns/23456789"
      },
      "metrics": {
        "clicks": "0",
        "conversions": "0.0",
        "costMicros": "0",
        "impressions": "1",
        "allConversionsValue": "0.0"
      },
      "hotelPerformanceView": {
        "resourceName": "customers/1234567890/hotelPerformanceView"
      },
      "segments": {
        "device": "DESKTOP",
        "hotelBookingWindowDays": "0",
        "hotelCenterId": "1234",
        "hotelCheckInDayOfWeek": "TUESDAY",
        "hotelDateSelectionType": "USER_SELECTED",
        "hotelLengthOfStay": "4",
        "partnerHotelId": "123",
        "clickType": "HOTEL_PRICE"
      }
    },
    {
      "campaign": {
        "resourceName": "customers/1234567890/campaigns/23456789"
      },
      "metrics": {
        "clicks": "1",
        "conversions": "0.0",
        "costMicros": "0",
        "impressions": "1",
        "allConversionsValue": "0.0"
      },
      "hotelPerformanceView": {
        "resourceName": "customers/1234567890/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/1234567890/campaigns/23456789",
        "id": "23456789"
      },
      "metrics": {
        "clicks": "1",
        "conversions": "0.0",
        "costMicros": "0",
        "impressions": "24",
        "searchAbsoluteTopImpressionShare": "0.0999",
        "searchTopImpressionShare": "0.17073170731707318"
      },
      "hotelPerformanceView": {
        "resourceName": "customers/1234567890/hotelPerformanceView"
      },
      "segments": {
        "device": "TABLET",
        "hotelCenterId": "1234",
        "partnerHotelId": "123",
        "hotelRateRuleId": "desktop",
        "hotelRateType": "PUBLIC_RATE"
      }
    },
    {
      "campaign": {
        "resourceName": "customers/1234567890/campaigns/23456789",
        "id": "23456789"
      },
      "metrics": {
        "clicks": "107",
        "conversions": "0.0",
        "costMicros": "0",
        "impressions": "1668",
        "searchAbsoluteTopImpressionShare": "0.0999",
        "searchTopImpressionShare": "0.3581201665675193"
      },
      "hotelPerformanceView": {
        "resourceName": "customers/1234567890/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/1234567890/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/1234567890/hotelPerformanceView"
      },
      "segments": {
        "hotelCenterId": "1234",
        "partnerHotelId": "123",
        "hotelPriceBucket": "LOWEST_TIED"
      }
    }
  ]
}

تقرير أداء الإحالات الناجحة والتكلفة

يحصل طلب البحث التالي على الأداء العام للإحالات الناجحة والتكلفة في "إعلانات الفنادق"، وهو أمر مفيد لتقييم الأداء المالي وعائد الإنفاق الإعلاني.

مثال على طلب البحث:

SELECT
  segments.date,
  segments.partner_hotel_id,
  metrics.all_conversions_value,
  metrics.cost_micros,
  metrics.conversions
FROM hotel_performance_view
WHERE segments.date DURING LAST_30_DAYS

مثال على استجابة JSON:

{
  "results": [
    {
      "metrics": {
        "allConversionsValue": "250.0",
        "costMicros": "15000000",
        "conversions": "2.0"
      },
      "hotelPerformanceView": {
        "resourceName": "customers/1234567890/hotelPerformanceView"
      },
      "segments": {
        "date": "2026-03-24",
        "partnerHotelId": "123"
      }
    }
  ]
}

تقارير الجمهور

تعرض تقارير الجمهور أداء مضاعفات عروض الأسعار في قوائم المستخدمين على "إعلانات Google". للاطّلاع على أمثلة على تقارير الجمهور، راجِع أمثلة طلبات البحث في عرض الجمهور على مستوى المجموعة الإعلانية وعرض الجمهور على مستوى الحملة.

السابق
تعديل عروض الأسعار
التالي
خلاصات السفر للإعلانات على شبكة البحث