Raporlama

Raporlama, bağlı hesaplarınızın reklam performansı ve potansiyel müşteri bilgileri hakkında bilgi almanıza olanak tanır.

Hesap Raporları

Hesap raporları, bir yönetici hesabının bağlı Yerel Hizmet hesaplarıyla ilişkili performansı ve metrikleri gösterir. Bu verileri belirli bir zaman aralığında görüntüleyebilirsiniz. Veriler 30 dakikaya kadar eski olabilir.

Raporu almak için aşağıdaki yapılandırılabilir URL parametreleriyle https://localservices.googleapis.com/v1/accountReports:search uç noktasına bir HTTP GET isteği gönderin:

URL parametreleri
query	Zorunlu Bir veya daha fazla kimlik değeri içerir. Bunlardan biri, sorgu için yönetici hesabının kimliği olmalıdır. query, noktalı virgülle ayrılmış birden çok değeri kabul edebilir: Zorunlu: manager_customer_id:<manager_cid> İsteğe bağlı: customer_id:<linked_cid> Örnek: query=manager_customer_id:123;customer_id:456
startDate.day	İsteğe bağlı Raporlama döneminin başladığı ayın günü. 1 ile 31 arasında (bu değerler dahil) değerler alabilir. Varsayılan olarak 1 değerine ayarlanır.
startDate.month	İsteğe bağlı Raporlama döneminin başlangıç ayı. 1 ile 12 arasında (bu değerler dahil) değerler alabilir. Varsayılan olarak geçerli ay seçilir.
startDate.year	İsteğe bağlı Raporlama döneminin başladığı yıl (YYYY biçiminde). Varsayılan olarak geçerli yıl kullanılır.
endDate.day	İsteğe bağlı Raporlama döneminin sona erdiği ayın günü. 1 ile 31 arasında (bu değerler dahil) değerler alabilir. Varsayılan olarak geçerli gün kullanılır.
endDate.month	İsteğe bağlı Raporlama döneminin sona erdiği ay. 1 ile 12 arasında (bu değerler dahil) değerler alabilir. Varsayılan olarak geçerli ay seçilir.
endDate.year	İsteğe bağlı Raporlama döneminin sona erdiği yıl (YYYY biçiminde). Varsayılan olarak geçerli yıl kullanılır.
pageSize	İsteğe bağlı Döndürülecek giriş sayısını belirten pozitif bir tam sayı. Varsayılan olarak 1000 değerine ayarlanır ve maksimum değer 10000'dir.
pageToken	İsteğe bağlı Bir dize. Önceki yanıttaki next_page_token değerini bu alana girin.

Önceki tablodaki alanlar, bir SearchAccountReportsRequest oluşturmak için kullanılır. İstekteki her müşteri kimliği için AccountReports karşılık gelen bir SearchAccountReportsResponse değeri SearchAccountReportsResponse içinde yer alır. Her Hesap Raporu, Yerel Hizmet reklamları gösteren bağlı bir müşteri hesabıyla bire bir eşleşir.

Not: İstek, yanıt ve veri yapıları için Protos kullanıma sunulur ve lansmanınızdan sonra bağlantı verilir.

Aşağıdaki tabloda AccountReports içindeki alanlar gösterilmektedir:

Alanlar
accountId	Müşteri kimliği, bir Yerel Hizmetler hesabına bağlanmış olmalıdır.
businessName	Müşterinin işletme adı.
averageWeeklyBudget	Müşterinin mevcut ortalama haftalık bütçesi.
averageFiveStarRating	Müşterinin mevcut tüm yorumlarından hesaplanan ortalama beş yıldızlı puan.
totalReview	Müşteri için kullanılabilen toplam yorum sayısı.
impressionsLastTwoDays	Hesabın son iki gün içinde aldığı toplam gösterim sayısı.
phoneLeadResponsiveness	Hesabın son 90 gün içindeki telefonla alınan hizmet taleplerine yanıt verme oranı. Bu değeri hesaplamak için ücretli telefon görüşmelerinden gelen bağlı aramaların toplam sayısı, alınan aramaların toplam sayısına bölünür.
currentPeriodChargedLeads	Belirtilen tarih aralığında ücretlendirilen hizmet talebi sayısı.
previousPeriodChargedLeads	Önceki dönemde ücretlendirilen hizmet talebi sayısı. Örneğin, tarih aralığı 21 Ocak ile 30 Ocak olarak ayarlanmışsa önceki dönem 11 Ocak ile 20 Ocak arası olur.
currentPeriodTotalCost	Belirtilen tarih aralığında ücretlendirilen hizmet taleplerinin maliyetinin toplamı.
previousPeriodTotalCost	Önceki dönemde ücretlendirilen potansiyel müşterilerden elde edilen maliyetin toplamı. Örneğin, tarih aralığı 21 Ocak ile 30 Ocak olarak ayarlanmışsa önceki dönem 11 Ocak ile 20 Ocak arası olur.
currencyCode	Müşteri hesabının para birimi kodu.
currentPeriodPhoneCalls	Belirtilen tarih aralığında yapılan telefon görüşmelerinin sayısı (bağlanan ve bağlanmayan aramalar).
previousPeriodPhoneCalls	Önceki dönemde bağlanan ve bağlanmayan telefon görüşmelerinin sayısı.
currentPeriodConnectedPhoneCalls	Belirtilen tarih aralığında 30 saniyeden uzun süren bağlı telefon görüşmesi sayısı.
previousPeriodConnectedPhoneCalls	Önceki dönemde 30 saniyeden uzun süren bağlantılı telefon aramalarının sayısı.

Örnekler

HTTP İsteği URL'si

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

Tam HTTP isteği örneği

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]

Ayrıntılı potansiyel müşteri raporları

Önemli: Ayrıntılı potansiyel müşteri raporları kullanımdan kaldırıldı. Yerel Hizmet hesaplarınızla ilişkili potansiyel müşterileri ve görüşmeleri getirmek için Google Ads API'yi kullanın.

Ayrıntılı potansiyel müşteri raporları, bir yönetici hesabının bağlı Yerel Hizmet hesaplarıyla ilişkili potansiyel müşterilerin ayrıntılı görünümünü gösterir. Bu verileri belirli bir zaman aralığında görüntüleyebilirsiniz. Rapor, belirli bir zaman aralığında oluşturulan veya itiraz durumu güncellenen potansiyel müşterileri içerir. Veriler 30 dakikaya kadar eski olabilir.

Not: API istemcileri, en fazla 31 günlük bir dönem için Ayrıntılı Hizmet Talebi Raporları isteyebilir. Bunun nedeni, raporun döndürebileceği potansiyel müşterilerin yüksek hacmidir.

Raporu almak için aşağıdaki yapılandırılabilir URL parametreleriyle https://localservices.googleapis.com/v1/detailedLeadReports:search uç noktasına bir HTTP GET isteği gönderin:

URL parametreleri
query	Zorunlu Bir veya daha fazla kimlik değeri içerir. Bunlardan biri, sorgu için yönetici hesabının kimliği olmalıdır. query, noktalı virgülle ayrılmış birden çok değeri kabul edebilir: Zorunlu: manager_customer_id:<manager_cid> İsteğe bağlı: customer_id:<linked_cid> Örnek: query=manager_customer_id:123;customer_id:456
startDate.day	İsteğe bağlı Raporlama döneminin başladığı ayın günü. 1 ile 31 arasında (bu değerler dahil) değerler alabilir. Varsayılan olarak 1 değerine ayarlanır.
startDate.month	İsteğe bağlı Raporlama döneminin başlangıç ayı. 1 ile 12 arasında (bu değerler dahil) değerler alabilir. Varsayılan olarak geçerli ay seçilir.
startDate.year	İsteğe bağlı Raporlama döneminin başladığı yıl (YYYY biçiminde). Varsayılan olarak geçerli yıl kullanılır.
endDate.day	İsteğe bağlı Raporlama döneminin sona erdiği ayın günü. 1 ile 31 arasında (bu değerler dahil) değerler alabilir. Varsayılan olarak geçerli gün kullanılır.
endDate.month	İsteğe bağlı Raporlama döneminin sona erdiği ay. 1 ile 12 arasında (bu değerler dahil) değerler alabilir. Varsayılan olarak geçerli ay seçilir.
endDate.year	İsteğe bağlı Raporlama döneminin sona erdiği yıl (YYYY biçiminde). Varsayılan olarak geçerli yıl kullanılır.
pageSize	İsteğe bağlı Döndürülecek giriş sayısını belirten pozitif bir tam sayı. Varsayılan olarak 1000 değerine ayarlanır ve maksimum değer 10000'dir.
pageToken	İsteğe bağlı Bir dize. Önceki yanıttaki next_page_token değerini bu alana girin.

Önceki alanlar, SearchDetailedLeadReportsRequest oluşturmak için kullanılır. İstekteki her müşteri kimliği için DetailedLeadReports, SearchDetailedLeadReportsResponse'e dahil edilir. Her Ayrıntılı Hizmet Talebi Raporu, Yerel Hizmet reklamları gösteren bağlı bir müşteri hesabıyla ilişkili belirli bir hizmet talebiyle bire bir eşleşir.

Aşağıdaki tabloda DetailedLeadReports içindeki alanlar gösterilmektedir:

Alanlar
leadId	Potansiyel müşterinin benzersiz tanımlayıcısı.
accountId	Potansiyel müşteriyi alan hesabı tanımlar.
businessName	Hesapla ilişkili işletme adı.
leadCreationTimestamp	Potansiyel müşterinin oluşturulduğu zamanı gösteren zaman damgası. Tarihi M/D/YYYY biçiminde, saati ise HH:MM:SS biçiminde içerir. Örnek: 11/1/2019 12:13:20
leadType	Potansiyel müşteri türü: MESSAGE veya PHONE_CALL.
leadCategory	Potansiyel müşteriyle ilişkili hizmet kategorisi. Örnek: housecleaner
geo	İlişkilendirilmiş hesabın bulunduğu şehrin konumları. Örnek: San Francisco, California, United States
messageLead	Yalnızca mesajla alınan potansiyel müşterilerle ilişkili bilgiler: customerName, jobType, postalCode ve consumerPhoneNumber.
phoneLead	Yalnızca telefonla alınan potansiyel müşterilerle ilişkili bilgiler: chargedCallTimestamp, chargedConnectedCallDurationSeconds ve consumerPhoneNumber.
bookingLead	Yalnızca randevu alınan hizmet talepleriyle ilişkili bilgiler: customerName, consumerPhoneNumber, jobType, consumerEmail ve bookingAppointmentTimestamp.
chargeStatus	Hizmet talebinin ücretlendirilip ücretlendirilmediği true veya false olabilir.
currencyCode	Potansiyel müşterinin oluşturulduğu hesabın para birimi kodu.
disputeStatus	Potansiyel müşterinin itiraz durumu.
aggregatorInfo	Üçüncü taraf toplayıcı iş ortaklarına özgü bilgiler. Bu alan yalnızca üçüncü taraf toplayıcı iş ortaklarıyla ilişkili API istemcileri için doldurulur. Not: Bu özellik, standart Müşteri Merkezim (MM) müşterileri için geçerli değildir.
timezone	Potansiyel müşteriyle ilişkili hesabın saat dilimi. IANA Saat Dilimi Veritabanı biçiminde verilir.

Örnekler

HTTP İsteği URL'si

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

Tam HTTP isteği örneği

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]