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 pelaporan Iklan Hotel.

Mendapatkan metrik klik

Contoh kueri berikut menampilkan jumlah klik dari tampilan performa hotel.

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 mengelompokkan hasil menurut ID Hotel.

SELECT
  segments.partner_hotel_id,
  metrics.clicks
FROM hotel_performance_view

Hasil kueri akan terlihat seperti string JSON berikut. Klik disegmentasikan berdasarkan 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, yang 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 kondisi klausa WHERE. Kolom tanggal diisi dengan tanggal terakhir yang disertakan dalam periode 30 hari.

{
  "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, jenis data ini direpresentasikan dalam resource *_view terpisah, seperti hotel_performance_view dan hotel_group_view. Bagian ini menjelaskan referensi *_view yang berguna untuk pelaporan Iklan Hotel. Contoh kueri juga disediakan.

Perhatikan bahwa setiap resource *_view memiliki kolom resource, segmen, dan metrik tertentu. Lihat dokumentasi untuk resource *_view tertentu sebelum membuat kueri.

Tampilan Grup Hotel

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

Contoh kueri untuk tampilan grup hotel berikut mendapatkan klik untuk setiap hotel dalam 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. Mengingat bahwa case_value tidak ditentukan untuk node root ("Semua hotel"), terlihat bahwa baris pertama mewakili metrik untuk grup listingan "Semua hotel", sedangkan baris kedua mewakili 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 hotel menggunakan data yang tidak berasal dari pengelompokan hotel, meskipun Anda memiliki subdivisi berdasarkan ID Hotel.

Contoh kueri untuk tampilan performa hotel berikut mendapatkan klik dan mengelompokkan hasil menurut ID Hotel.

SELECT
  segments.partner_hotel_id,
  metrics.clicks
FROM hotel_performance_view

Hasil kueri akan terlihat seperti string JSON berikut. Klik disegmentasikan berdasarkan 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 tingkat grup iklan.

Perhatikan bahwa ini adalah tampilan umum untuk berbagai jenis kampanye, bukan hanya kampanye Hotel. Tampilan ini juga menyediakan 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 disetel oleh Google. Jika Anda menyegmentasikan menurut hotel_date_selection_type, hanya hasil untuk kampanye Hotel yang akan ditampilkan.

Kueri berikut menampilkan 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 tingkat kampanye.

Perhatikan bahwa ini adalah tampilan umum untuk berbagai jenis kampanye, bukan hanya kampanye Hotel. Tampilan ini juga menyediakan 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 disetel oleh Google. Jika Anda menyegmentasikan menurut hotel_date_selection_type, hanya hasil untuk kampanye Hotel yang akan ditampilkan.

Kueri berikut menampilkan 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 memberikan beberapa laporan bermanfaat yang dirancang khusus untuk iklan Hotel.

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 metrik performa menurut 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.

Beberapa segmen dapat disertakan dalam kueri, tetapi jumlah baris yang ditampilkan 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 harga pesaing pada 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 menampilkan performa pengganda bid di daftar audiens Google Ads. Untuk contoh laporan audiens, lihat contoh kueri di Tampilan Audiens Grup Iklan dan Tampilan Audiens Kampanye.

Laporan Rekonsiliasi Hotel

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

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, nilai ini dapat dihitung sebagai metrics.hotel_commission_rate_micros * hotel_reconciliation.reconciled_value_micros. Pada kasus lainnya, nilai ini dapat diperoleh dari kolom 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