Pelaporan

Pelaporan memungkinkan Anda mengambil informasi tentang performa iklan dan informasi prospek akun tertaut.

Laporan Akun

Laporan Akun menampilkan performa dan metrik yang terkait dengan akun Jasa Lokal tertaut dari Akun pengelola. Anda dapat melihat data ini selama jangka waktu tertentu. Data mungkin sudah usang hingga 30 menit.

Untuk mendapatkan laporan, kirim permintaan HTTP GET ke https://localservices.googleapis.com/v1/accountReports:search dengan parameter URL yang dapat dikonfigurasi berikut:

Parameter URL
query	Wajib Berisi satu atau beberapa nilai ID, salah satunya harus berupa ID akun Pengelola untuk kueri. query dapat menerima beberapa nilai yang dipisahkan dengan titik koma: Wajib: manager_customer_id:<manager_cid> Opsional: customer_id:<linked_cid> Contoh: query=manager_customer_id:123;customer_id:456
startDate.day	Opsional Hari dalam sebulan saat periode pelaporan dimulai. Dapat mengambil nilai antara 1 dan 31 inklusif. Nilai defaultnya adalah 1.
startDate.month	Opsional Bulan awal untuk periode pelaporan. Dapat mengambil nilai antara 1 dan 12 inklusif. Secara default, nilainya adalah bulan saat ini.
startDate.year	Opsional Tahun saat periode pelaporan dimulai, dalam format YYYY. Default-nya adalah tahun saat ini.
endDate.day	Opsional Hari dalam sebulan saat periode pelaporan berakhir. Dapat mengambil nilai antara 1 dan 31 inklusif. Nilai defaultnya adalah hari ini.
endDate.month	Opsional Bulan saat periode pelaporan berakhir. Dapat mengambil nilai antara 1 dan 12 inklusif. Secara default, nilainya adalah bulan saat ini.
endDate.year	Opsional Tahun saat periode pelaporan berakhir, dalam format YYYY. Default-nya adalah tahun saat ini.
pageSize	Opsional Bilangan bulat positif yang menunjukkan jumlah entri yang akan ditampilkan. Default-nya adalah 1000, dan maksimumnya adalah 10000.
pageToken	Opsional String. Masukkan next_page_token dari respons sebelumnya di kolom ini.

Kolom dalam tabel sebelumnya digunakan untuk membuat SearchAccountReportsRequest. Untuk setiap ID pelanggan dalam permintaan, AccountReports yang sesuai disertakan dalam SearchAccountReportsResponse. Setiap Laporan Akun dipetakan satu-ke-satu dengan akun pelanggan tertaut yang menampilkan iklan Layanan Lokal.

Catatan: Protos untuk permintaan, respons, struktur data tersedia dan ditautkan setelah peluncuran Anda.

Tabel berikut menunjukkan kolom di AccountReports:

Kolom
accountId	ID pelanggan yang ditautkan dengan Akun Jasa dan Servis.
businessName	Nama bisnis pelanggan.
averageWeeklyBudget	Anggaran mingguan rata-rata pelanggan saat ini.
averageFiveStarRating	Rating bintang lima rata-rata, yang dihitung dari semua ulasan pelanggan yang tersedia.
totalReview	Jumlah total ulasan yang tersedia untuk pelanggan.
impressionsLastTwoDays	Jumlah total tayangan iklan yang diperoleh akun dalam dua hari terakhir.
phoneLeadResponsiveness	Responsivitas prospek telepon akun selama 90 hari sebelumnya. Untuk menghitungnya, total jumlah panggilan yang terhubung dari prospek telepon yang dikenai biaya dibagi dengan total jumlah panggilan yang diterima.
currentPeriodChargedLeads	Jumlah prospek yang ditagih dalam periode rentang tanggal yang ditentukan.
previousPeriodChargedLeads	Jumlah prospek yang dikenai biaya dalam periode sebelumnya. Misalnya, jika rentang tanggal ditetapkan dari 21 Januari hingga 30 Januari, maka periode sebelumnya adalah 11 Januari hingga 20 Januari.
currentPeriodTotalCost	Jumlah biaya dari prospek yang ditagih dalam rentang tanggal yang ditentukan.
previousPeriodTotalCost	Jumlah biaya dari prospek yang ditagih pada periode sebelumnya. Misalnya, jika rentang tanggal ditetapkan dari 21 Januari hingga 30 Januari, maka periode sebelumnya adalah 11 Januari hingga 20 Januari.
currencyCode	Kode mata uang akun pelanggan.
currentPeriodPhoneCalls	Jumlah panggilan telepon dalam jangka waktu rentang tanggal yang ditentukan, baik yang terhubung maupun tidak terhubung.
previousPeriodPhoneCalls	Jumlah panggilan telepon pada periode sebelumnya, baik yang terhubung maupun tidak terhubung.
currentPeriodConnectedPhoneCalls	Jumlah panggilan telepon yang tersambung dalam jangka waktu rentang tanggal yang ditentukan dengan durasi lebih dari 30 detik.
previousPeriodConnectedPhoneCalls	Jumlah panggilan telepon tersambung dalam periode sebelumnya dengan durasi lebih dari 30 detik.

Contoh

URL Permintaan HTTP

https://localservices.googleapis.com/v1/accountReports:search?query=manager_customer_id:{manager_customer_id}

Contoh permintaan HTTP lengkap

GET /v1/accountReports:search?query=manager_customer_id:{manager_customer_id} HTTP/1.1
Host: localservices.googleapis.com
User-Agent: curl
Content-Type: application/json
Accept: application/json
Authorization: Bearer [Enter OAuth 2.0 access token here]

Laporan Prospek Mendetail

Penting: Laporan Prospek yang Mendetail tidak digunakan lagi. Gunakan Google Ads API untuk mengambil Prospek dan Konversi yang terkait dengan akun Jasa dan Servis Anda.

Laporan Prospek yang mendetail menampilkan tampilan mendalam tentang prospek yang terkait dengan akun Jasa dan Servis tertaut dari Akun pengelola. Anda dapat melihat data ini selama jangka waktu tertentu. Untuk rentang waktu tertentu, laporan menyertakan prospek yang dibuat atau prospek yang status sengketa telah diperbarui. Data mungkin sudah usang hingga 30 menit.

Catatan: Klien API hanya dapat meminta Laporan Prospek yang Mendetail untuk periode maksimal 31 hari. Hal ini disebabkan oleh banyaknya volume prospek yang dapat ditampilkan oleh laporan.

Untuk mendapatkan laporan, kirim permintaan HTTP GET ke https://localservices.googleapis.com/v1/detailedLeadReports:search dengan parameter URL yang dapat dikonfigurasi berikut:

Parameter URL
query	Wajib Berisi satu atau beberapa nilai ID, salah satunya harus berupa ID akun Pengelola untuk kueri. query dapat menerima beberapa nilai yang dipisahkan dengan titik koma: Wajib: manager_customer_id:<manager_cid> Opsional: customer_id:<linked_cid> Contoh: query=manager_customer_id:123;customer_id:456
startDate.day	Opsional Hari dalam sebulan saat periode pelaporan dimulai. Dapat mengambil nilai antara 1 dan 31 inklusif. Nilai defaultnya adalah 1.
startDate.month	Opsional Bulan awal untuk periode pelaporan. Dapat mengambil nilai antara 1 dan 12 inklusif. Secara default, nilainya adalah bulan saat ini.
startDate.year	Opsional Tahun saat periode pelaporan dimulai, dalam format YYYY. Default-nya adalah tahun saat ini.
endDate.day	Opsional Hari dalam sebulan saat periode pelaporan berakhir. Dapat mengambil nilai antara 1 dan 31 inklusif. Nilai defaultnya adalah hari ini.
endDate.month	Opsional Bulan saat periode pelaporan berakhir. Dapat mengambil nilai antara 1 dan 12 inklusif. Secara default, nilainya adalah bulan saat ini.
endDate.year	Opsional Tahun saat periode pelaporan berakhir, dalam format YYYY. Default-nya adalah tahun saat ini.
pageSize	Opsional Bilangan bulat positif yang menunjukkan jumlah entri yang akan ditampilkan. Default-nya adalah 1000, dan maksimumnya adalah 10000.
pageToken	Opsional String. Masukkan next_page_token dari respons sebelumnya di kolom ini.

Kolom sebelumnya digunakan untuk membuat SearchDetailedLeadReportsRequest. Untuk setiap ID pelanggan dalam permintaan, DetailedLeadReports yang sesuai disertakan dalam SearchDetailedLeadReportsResponse. Setiap Laporan Prospek Detail dipetakan satu-ke-satu dengan prospek tertentu yang terkait dengan akun pelanggan tertaut yang menampilkan iklan Jasa dan Servis.

Tabel berikut menunjukkan kolom di DetailedLeadReports:

Kolom
leadId	ID unik prospek.
accountId	Mengidentifikasi akun yang menerima prospek.
businessName	Nama bisnis yang dikaitkan dengan akun.
leadCreationTimestamp	Stempel waktu saat prospek dibuat. Mencakup tanggal dalam format M/D/YYYY dan waktu dalam format HH:MM:SS. Contoh: 11/1/2019 12:13:20
leadType	Jenis prospek: MESSAGE atau PHONE_CALL.
leadCategory	Kategori layanan yang terkait dengan prospek. Contoh: housecleaner
geo	Lokasi kota asal akun terkait. Contoh: San Francisco, California, United States
messageLead	Informasi yang hanya terkait dengan prospek pesan: customerName, jobType, postalCode, dan consumerPhoneNumber.
phoneLead	Informasi yang hanya terkait dengan prospek telepon: chargedCallTimestamp, chargedConnectedCallDurationSeconds, dan consumerPhoneNumber.
bookingLead	Informasi yang hanya terkait dengan prospek pemesanan: customerName, consumerPhoneNumber, jobType, consumerEmail, dan bookingAppointmentTimestamp.
chargeStatus	Apakah prospek telah ditagih. Dapat berupa true atau false.
currencyCode	Kode mata uang akun tempat prospek dibuat.
disputeStatus	Status sengketa prospek.
aggregatorInfo	Informasi khusus untuk partner agregator pihak ketiga. Kolom ini hanya diisi untuk klien API yang terkait dengan partner agregator pihak ketiga. Catatan: Hal ini tidak berlaku untuk klien Pusat Klien Saya (MCC) standar.
timezone	Zona waktu akun yang terkait dengan prospek. Diberikan dalam format Database Zona Waktu IANA.

Contoh

URL Permintaan HTTP

https://localservices.googleapis.com/v1/detailedLeadReports:search?query=manager_customer_id:{manager_customer_id}

Contoh permintaan HTTP lengkap

GET /v1/detailedReports:search?query=manager_customer_id:{manager_customer_id} HTTP/1.1
Host: localservices.googleapis.com
User-Agent: curl
Content-Type: application/json
Accept: application/json
Authorization: Bearer [Enter OAuth 2.0 access token here]