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

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

{
  "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 المعروضة أدناه. تتم فلترة الردود لتوفير المقاييس التي تتوافق مع شروط الجملة "المكان" فقط. تتم تعبئة حقل التاريخ بآخر تاريخ تم تضمينه في الفترة البالغة 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"
      }
    }
  ]
}

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

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

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

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

الأداء

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

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"