گزارش نویسی

ویدیو : بحث گزارش تبلیغات هتل از کارگاه 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 تقسیم بندی می شوند و بنابراین دو یا چند شی را می توان برای همان hotelPerformanceView برگرداند.

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

نماهای مفید برای گزارش تبلیغات هتل

در APIهای قبلی برای گزارش تبلیغات هتل، می‌توانید گزارش خاصی مانند گزارش عملکرد را بازیابی کنید. در 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 Ads نشان می‌دهد. برای نمونه‌هایی از گزارش‌های مخاطب، به نمونه پرس و جوها در نمای مخاطب گروه آگهی و نمای مخاطب کمپین مراجعه کنید.

گزارش آشتی هتل

گزارش تطبیق هتل حاوی اطلاعات تبدیل از رزرو هتل برای تطبیق با سوابق تبلیغ‌کننده است. می‌توانید داده‌ها را از طریق آپلود انبوه آپلود کنید تا به Google اطلاع دهید کدام رزرو لغو یا تکمیل شده است. ستون های اصلی این گزارش به شرح زیر است:

ستون UI ستون API توضیح
ارزش رزرو metrics.value_per_conversions_by_conversion_date مقدار تبدیل همانطور که توسط برچسب گزارش شده است
تاریخ تبدیل segments.date تاریخ رزرو
نرخ کمیسیون metrics.hotel_commission_rate_micros درصد ارزش رزروی که برای نمایش آگهی پیشنهاد می دهید
هزینه کمیسیون

اگر status == RECONCILED یا CANCELED ، این مقدار را می توان به عنوان metrics.hotel_commission_rate_micros * hotel_reconciliation.reconciled_value_micros محاسبه کرد. در تمام موارد دیگر، این مقدار را می توان از ستون metrics.hotel_expected_commission_cost به دست آورد، یا به عنوان metrics.hotel_commission_rate_micros * metrics.value_per_conversions_by_conversion_date محاسبه شد.

 مبلغی که انتظار می رود برای اقامت مهمان بپردازید یا پرداخت کرده اید
قبلی
پیشنهادات را تنظیم کنید