إعداد التقارير

فيديو: اطّلِع على حديث عن إعداد تقارير "إعلانات الفنادق" من ورشة العمل لعام 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، وبالتالي يمكن عرض عنصرَين أو أكثر لعرض أداء الفندق نفسه.

{
  "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"
        }
      }
    }
  ]
}

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

في واجهات برمجة التطبيقات السابقة لإعداد تقارير "إعلانات الفنادق"، كان بإمكانك استرداد تقرير معيّن، مثل تقرير الأداء. في 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"
      }
    }
  ]
}

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

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

نموذج طلب بحث:

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/123456789/hotelPerformanceView"
      },
      "segments": {
        "date": "2026-03-24",
        "partnerHotelId": "123"
      }
    }
  ]
}

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

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

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