Pelaporan

Video: Tonton diskusi pelaporan Iklan Hotel dari workshop 2019

Dengan Google Ads API, Anda dapat mendesain kueri untuk mendapatkan laporan Iklan Hotel yang Anda butuhkan. Selanjutnya, Anda 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 dari 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 berikut untuk tampilan performa hotel mendapatkan klik dan mengelompokkan hasil menurut ID Hotel.

SELECT
  segments.partner_hotel_id,
  metrics.clicks
FROM hotel_performance_view

Hasil dari kueri akan terlihat seperti string JSON berikut. Klik disegmentasikan menurut partnerHotelID sehingga dua atau beberapa objek 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"
      }
    },
    ...
  ]
}

Mendapatkan metrik grup iklan

Contoh kueri berikut untuk grup iklan 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 dari 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"
      }
    }
  ]
}

Mendapatkan iklan grup iklan yang diaktifkan

Contoh kueri berikut untuk iklan grup iklan mendapatkan grup iklan yang akan ditayangkan. Agar grup iklan dapat 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 dari 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

Di 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 resource *_view yang berguna untuk pelaporan Iklan Hotel. Contoh kueri juga disediakan.

Perhatikan bahwa setiap resource *_view memiliki kolom, segmen, dan metrik resource 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 dari grup hotel.

Contoh kueri berikut untuk tampilan grup hotel 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 dari kueri akan terlihat seperti string JSON berikut. Mengingat case_value tidak ditentukan untuk node root ("Semua hotel"), jelas 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 berikut untuk tampilan performa hotel mendapatkan klik dan menyegmentasikan hasil menurut ID Hotel.

SELECT
  segments.partner_hotel_id,
  metrics.clicks
FROM hotel_performance_view

Hasil dari 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 tingkat grup iklan.

Perhatikan bahwa ini adalah tampilan umum untuk berbagai jenis kampanye, bukan hanya kampanye hotel. Tampilan ini juga memberikan kemampuan untuk menyegmentasikan hasil berdasarkan 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 membuat segmen menurut hotel_date_selection_type, hanya hasil untuk kampanye Hotel yang 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 dari 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 memberikan kemampuan untuk menyegmentasikan hasil berdasarkan 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 membuat segmen menurut hotel_date_selection_type, hanya hasil untuk kampanye Hotel yang 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 dari 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 dirancang khusus untuk iklan Hotel.

Laporan performa

Kueri ini menggunakan 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 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 menurut:

  • 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; namun, 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 dari 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 selesai. 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 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. Dalam semua 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