Pelaporan

Video: Lihat pembahasan pelaporan Iklan Hotel dari workshop 2019

Dengan Google Ads API, Anda dapat mendesain kueri untuk mendapatkan laporan Iklan Hotel yang Anda butuhkan. Anda kemudian dapat menggabungkan kueri ini ke dalam aplikasi klien.

Prasyarat

Kueri dasar untuk Iklan Hotel

Lihat contoh kueri ini untuk memahami penggunaan Google Ads API untuk Hotel Pelaporan iklan.

Mendapatkan metrik klik

Contoh kueri berikut menampilkan jumlah klik dari hotel tampilan performa.

SELECT metrics.clicks
FROM hotel_performance_view

Hasil kueri akan terlihat seperti ini:

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

Mendapatkan metrik klik yang tersegmentasi

Contoh kueri untuk tampilan performa hotel berikut mendapatkan klik dan segmen hasilnya menurut ID Hotel.

SELECT
  segments.partner_hotel_id,
  metrics.clicks
FROM hotel_performance_view

Hasil kueri akan terlihat seperti string JSON berikut. Klik disegmentasikan menurut partnerHotelID sehingga dua objek atau lebih dapat ditampilkan untuk hotelPerformanceView yang sama.

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

Dapatkan metrik grup iklan

Contoh kueri untuk grup iklan berikut mendapatkan tayangan dan klik selama 30 hari terakhir, disegmentasikan menurut tanggal.

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

Hasil kueri akan terlihat seperti string JSON berikut. Respons difilter hanya untuk metrik yang memenuhi klausul WHERE kondisi tertentu. Kolom tanggal diisi dengan tanggal terakhir yang tercantum dalam rentang 30 hari titik.

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

Dapatkan iklan grup iklan yang diaktifkan

Contoh kueri untuk iklan grup iklan berikut mendapatkan grup iklan yang akan ditayangkan. Agar grup iklan ditayangkan, iklan grup iklan, grup iklan, dan kampanye harus diaktifkan.

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

Hasil kueri akan terlihat seperti string JSON berikut.

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

Tampilan yang berguna untuk pelaporan Iklan Hotel

Dalam API sebelumnya untuk pelaporan Iklan Hotel, Anda dapat mengambil laporan tertentu, seperti laporan performa. Di Google Ads API, data semacam ini direpresentasikan dalam resource *_view terpisah, seperti hotel_performance_view dan hotel_group_view. Bagian ini menjelaskan resource *_view yang untuk pelaporan Iklan Hotel. Contoh kueri juga disediakan.

Perhatikan bahwa setiap resource *_view memiliki kolom resource, segmen, dan metrik. Baca dokumentasi untuk resource *_view tertentu sebelum membangun kueri Anda.

Tampilan Grup Hotel

Tampilan Grup Hotel adalah kriteria , sehingga berguna untuk mengambil metrik untuk jenis kriteria grup hotel tertentu.

Contoh kueri untuk tampilan grup hotel berikut mendapatkan klik untuk setiap hotel di grup listingan untuk seluruh hierarki grup listingan hotel, termasuk node root ("Semua hotel").

SELECT
  metrics.clicks,
  ad_group_criterion.listing_group.case_value.hotel_id.value
FROM hotel_group_view

Hasil kueri akan terlihat seperti string JSON berikut. Karena case_value tidak terdefinisi untuk node root ("Semua hotel"), berarti terlihat bahwa baris pertama mewakili metrik untuk "Semua hotel" listingan grup, sedangkan baris kedua menunjukkan metrik untuk grup listingan turunan yang mewakili "Lainnya".

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

Tampilan Performa Hotel

Tampilan Performa Hotel berguna jika Anda ingin mengambil metrik performa untuk sebuah hotel menggunakan data yang dari pengelompokan hotel, meskipun Anda memiliki subdivisi berdasarkan ID Hotel.

Contoh kueri untuk tampilan performa hotel berikut mendapatkan klik dan segmen hasilnya menurut ID Hotel.

SELECT
  segments.partner_hotel_id,
  metrics.clicks
FROM hotel_performance_view

Hasil kueri akan terlihat seperti string JSON berikut. Klik disegmentasikan menurut partner_hotel_id sehingga dua objek atau lebih dapat ditampilkan untuk tampilan performa hotel yang sama.

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

Tampilan Audiens Grup Iklan

Tampilan Audiens Grup Iklan berguna jika Anda ingin mengambil metrik performa untuk audiens yang disertakan di grup iklan level organisasi.

Perhatikan bahwa ini adalah tampilan umum untuk berbagai jenis kampanye, bukan hanya informasi hotel kampanye. Tampilan ini juga memberikan kemampuan untuk menyegmentasikan hasil menurut hotel_date_selection_type, yang dapat digunakan untuk menentukan apakah tanggal hotel dipilih oleh pengguna atau merupakan tanggal default untuk penelusuran yang ditetapkan oleh Google. Jika Anda menyegmentasikan menurut hotel_date_selection_type, hanya hasil untuk kampanye Hotel yang dikembalikan.

Kueri berikut mengembalikan satu baris per 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

Hasil kueri akan terlihat seperti string JSON berikut.

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

Tampilan Audiens Kampanye

Tampilan Audiens Kampanye berguna jika Anda ingin mengambil metrik performa untuk audiens yang disertakan di kampanye level organisasi.

Perhatikan bahwa ini adalah tampilan umum untuk berbagai jenis kampanye, bukan hanya informasi hotel kampanye. Tampilan ini juga memberikan kemampuan untuk menyegmentasikan hasil menurut hotel_date_selection_type, yang dapat digunakan untuk menentukan apakah tanggal hotel dipilih oleh pengguna atau merupakan tanggal default untuk penelusuran yang ditetapkan oleh Google. Jika Anda menyegmentasikan menurut hotel_date_selection_type, hanya hasil untuk kampanye Hotel yang dikembalikan.

Kueri berikut mengembalikan satu baris per 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

Hasil kueri akan terlihat seperti string JSON berikut.

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

Laporan yang berguna untuk Iklan Hotel

Bagian ini menyediakan beberapa laporan berguna yang didesain khusus untuk Hotel iklan.

Laporan performa

Kueri ini memanfaatkan Tampilan Performa Hotel untuk mendapatkan data performa.

hotel_performance_view memungkinkan Anda menggunakan resource campaign untuk menyegmentasikan metrik. Misalnya, Anda dapat menggunakan kolom campaign.id untuk mendapatkan performa metrik berdasarkan kampanye.

Performa

Contoh kueri:

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

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

Performa dengan jenis klik

Contoh kueri:

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

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

Laporan performa tarif bersyarat

Kueri berikut mendapatkan metrik performa yang disegmentasikan berdasarkan:

  • campaign
  • hotel_center_id
  • hotel_country
  • hotel_rate_rule_id
  • hotel_rate_type
  • device
  • partner_hotel_id

Lihat HotelRateType untuk deskripsi jenis-jenis data.

Beberapa segmen dapat disertakan dalam kueri; Namun, jumlah respons baris dapat meningkat secara signifikan dengan segmen tambahan.

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

Hasil kueri akan terlihat seperti string JSON berikut.

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

Laporan persaingan harga

Anda bisa mendapatkan insight tentang perbandingan harga Anda dengan kompetitor harga di itinerari hotel yang sama.

Contoh kueri:

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

Contoh respons JSON:

{
  "results": [
    {
      "metrics": {
        "hotelAverageLeadValueMicros": "96416341.829268292",
        "hotelPriceDifferencePercentage": "-0.014627310872986811"
      },
      "hotelPerformanceView": {
        "resourceName": "customers/123456789/hotelPerformanceView"
      },
      "segments": {
        "hotelCenterId": "1234",
        "partnerHotelId": "123",
        "hotelPriceBucket": "LOWEST_TIED"
      }
    }
  ]
}

Laporan harga pemesanan rata-rata

Anda bisa mendapatkan data yang diperlukan untuk menghitung harga pemesanan rata-rata (all_conversions_value dibagi dengan conversions) untuk hotel.

Contoh kueri:

SELECT
  segments.hotel_center_id,
  segments.partner_hotel_id,
  segments.hotel_price_bucket,
  metrics.all_conversions_value,
  metrics.conversions
FROM hotel_performance_view

Contoh respons JSON:

{
  "results": [
    {
      "metrics": {
        "allConversionsValue": "123.5",
        "conversions": "1"
      },
      "hotelPerformanceView": {
        "resourceName": "customers/123456789/hotelPerformanceView"
      },
      "segments": {
        "hotelCenterId": "1234",
        "partnerHotelId": "123",
        "hotelPriceBucket": "LOWEST_TIED"
      }
    }
  ]
}

Laporan audiens

Laporan audiens menunjukkan performa pengganda bid pada audiens Google Ads daftar. Untuk contoh laporan audiens, lihat kueri contoh di Grup Iklan Tampilan Audiens dan Audiens Kampanye View.

Laporan Rekonsiliasi Hotel

Laporan Rekonsiliasi Hotel berisi informasi konversi dari pemesanan Hotel untuk direkonsiliasi dengan pengiklan {i>record<i}. Anda dapat mengupload data melalui upload massal untuk memberi tahu Google pemesanan dibatalkan atau diselesaikan. Kolom utama dalam laporan ini adalah berikut ini:

Kolom UI Kolom API Penjelasan
Nilai pemesanan metrics.value_per_conversions_by_conversion_date Nilai konversi seperti yang dilaporkan oleh tag
Tanggal konversi segments.date Tanggal pemesanan
Tarif komisi metrics.hotel_commission_rate_micros Persentase nilai pemesanan yang Anda ajukan bid untuk tayangan iklan
Biaya komisi

Jika status == RECONCILED atau CANCELED, maka dapat dihitung sebagai metrics.hotel_commission_rate_micros * hotel_reconciliation.reconciled_value_micros. Dalam semua kasus lain, nilai ini dapat diperoleh dari metrics.hotel_expected_commission_cost, atau dihitung sebagai metrics.hotel_commission_rate_micros * metrics.value_per_conversions_by_conversion_date

 Jumlah yang diperkirakan akan Anda bayar atau telah dibayar untuk masa inap tamu
Sebelumnya
Sesuaikan tawaran
Berikutnya
Buat kampanye Reservasi di Google