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

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

فيديو: اطّلِع على حديث إعداد تقارير إعلانات الفنادق من ورشة العمل لعام 2019.

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

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

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

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

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

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

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، ما يعني أنه يمكن عرض كائنَين أو أكثر للعرض نفسه في HotelPerformView.

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

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

يحصل مثال طلب البحث التالي للمجموعات الإعلانية على مرات ظهور ونقرات على مدار الثلاثين يومًا الأخيرة، مقسمة حسب التاريخ.

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

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

يوفر هذا القسم العديد من التقارير المفيدة المصممة خصيصًا لإعلانات الفنادق.

تقارير الأداء

تستفيد طلبات البحث هذه من "طريقة عرض أداء الفنادق" للحصول على بيانات الأداء.

الأداء

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

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"