Pelaporan

Video: Tonton diskusi pelaporan Iklan Hotel dari workshop 2019

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

Prasyarat

Kueri dasar untuk Iklan Hotel

Lihat contoh kueri berikut untuk memahami penggunaan pelaporan Google Ads API untuk 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"
}

Dapatkan metrik klik yang tersegmentasi

Contoh kueri untuk tampilan performa hotel berikut mendapatkan klik dan menyegmentasikan 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 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, 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 menurut tanggal terakhir yang termasuk 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 semua grup iklan dapat ditayangkan, iklan dari grup iklan, grup iklan, dan kampanye harus diaktifkan semua.

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

Di API sebelumnya untuk pelaporan Iklan Hotel, Anda dapat mengambil laporan tertentu, seperti laporan performa. Di Google Ads API, jenis data ini diwakili 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, segmen, dan metrik resource tertentu. Baca 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 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 merepresentasikan "Other".

{
  "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 menyegmentasikan 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 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 pada 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 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 melakukan segmentasi 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 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

Campaign Audience View berguna jika Anda ingin mengambil metrik performa untuk audiens yang disertakan pada tingkat kampanye.

Perhatikan bahwa ini adalah tampilan umum untuk berbagai jenis kampanye, bukan hanya kampanye Hotel. 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 melakukan segmentasi 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 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 berguna 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 mengelompokkan 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; 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 untuk 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 rata-rata yang dipesan

Anda bisa mendapatkan data yang diperlukan untuk menghitung harga rata-rata yang dipesan (all_conversions_value dibagi 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 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 merekonsiliasi dengan data pengiklan. Anda dapat mengupload data melalui upload massal untuk memberi tahu Google pemesanan mana yang dibatalkan atau telah 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