گزارش نویسی

گزارش به شما امکان می دهد اطلاعات مربوط به عملکرد تبلیغات و اطلاعات سرنخ حساب های مرتبط خود را بازیابی کنید.

گزارشات حساب

گزارش‌های حساب، عملکرد و معیارهای مرتبط با حساب‌های مرتبط خدمات محلی یک حساب مدیر را نشان می‌دهد. می توانید این داده ها را در یک بازه زمانی مشخص مشاهده کنید. ممکن است داده ها تا 30 دقیقه قدیمی باشند.

برای دریافت گزارش، یک درخواست HTTP GET به https://localservices.googleapis.com/v1/accountReports:search با پارامترهای URL قابل تنظیم زیر ارسال کنید:

پارامترهای URL
query	مورد نیاز حاوی یک یا چند مقدار ID است که یکی از آنها باید شناسه حساب مدیر برای درخواست باشد. query می تواند چندین مقدار جدا شده با نقطه ویرگول را بپذیرد: مورد نیاز: manager_customer_id: <manager_cid> اختیاری: customer_id: <linked_cid> مثال: query=manager_customer_id:123;customer_id:456
startDate.day	اختیاری روزی از ماهی که دوره گزارش در آن شروع می شود. می تواند مقادیری بین 1 تا 31 شامل شود. پیش فرض 1 است.
startDate.month	اختیاری ماه شروع دوره گزارش. می تواند مقادیری بین 1 تا 12 شامل شود. پیش‌فرض در ماه جاری
startDate.year	اختیاری سالی که دوره گزارش شروع می شود، در قالب YYYY . پیش فرض های سال جاری
endDate.day	اختیاری روزی از ماه که دوره گزارش به پایان می رسد. می تواند مقادیری بین 1 تا 31 شامل شود. پیش‌فرض به روز جاری
endDate.month	اختیاری ماهی که دوره گزارش به پایان می رسد. می تواند مقادیری بین 1 تا 12 شامل شود. پیش‌فرض در ماه جاری
endDate.year	اختیاری سالی که دوره گزارش به پایان می رسد، در قالب YYYY . پیش فرض های سال جاری
pageSize	اختیاری یک عدد صحیح مثبت که نشان دهنده تعداد ورودی های بازگشتی است. پیش فرض 1000 و حداکثر 10000 است.
pageToken	اختیاری یک رشته next_page_token از پاسخ قبلی در این قسمت وارد کنید.

از فیلدهای جدول قبلی برای ساخت SearchAccountReportsRequest استفاده می شود. برای هر شناسه مشتری در درخواست، یک AccountReports مربوطه در SearchAccountReportsResponse گنجانده شده است. هر گزارش حساب یک به یک با یک حساب مشتری مرتبط که تبلیغات خدمات محلی را نمایش می دهد، نقشه می کشد.

توجه: پروتوهای درخواست، پاسخ، ساختارهای داده در دسترس هستند و پس از راه‌اندازی به آن‌ها پیوند داده می‌شوند.

جدول زیر فیلدهای AccountReports را نشان می دهد:

فیلدها
accountId	شناسه مشتری مرتبط با حساب خدمات محلی.
businessName	نام تجاری مشتری.
averageWeeklyBudget	متوسط بودجه هفتگی فعلی مشتری.
averageFiveStarRating	میانگین امتیاز پنج ستاره، که از روی تمام نظرات موجود مشتری محاسبه می شود.
totalReview	تعداد کل نظرات موجود برای مشتری.
impressionsLastTwoDays	تعداد کل بازدیدهایی که حساب در دو روز گذشته داشته است.
phoneLeadResponsiveness	پاسخگویی سرنخ تلفن حساب برای 90 روز گذشته. برای محاسبه این، تعداد کل تماس های متصل از سرنخ های تلفن شارژ شده بر تعداد کل تماس های دریافت شده تقسیم می شود.
currentPeriodChargedLeads	تعداد سرنخ های شارژ شده در دوره محدوده تاریخ مشخص شده.
previousPeriodChargedLeads	تعداد سرنخ های شارژ شده در دوره قبل. به عنوان مثال، اگر محدوده تاریخ از 21 ژانویه تا 30 ژانویه تنظیم شود، دوره قبلی از 11 ژانویه تا 20 ژانویه خواهد بود.
currentPeriodTotalCost	مجموع هزینه از سرنخ های شارژ شده در دوره محدوده تاریخ مشخص شده.
previousPeriodTotalCost	مجموع هزینه از سرنخ های شارژ شده در دوره قبل. به عنوان مثال، اگر محدوده تاریخ از 21 ژانویه تا 30 ژانویه تنظیم شود، دوره قبلی از 11 ژانویه تا 20 ژانویه خواهد بود.
currencyCode	کد ارز حساب مشتری.
currentPeriodPhoneCalls	تعداد تماس های تلفنی در بازه زمانی مشخص شده، چه متصل و چه غیر متصل.
previousPeriodPhoneCalls	تعداد تماس‌های تلفنی در دوره قبل، چه متصل و چه غیرمتصل.
currentPeriodConnectedPhoneCalls	تعداد تماس های تلفنی متصل در بازه زمانی مشخص شده با مدت زمان بیش از 30 ثانیه.
previousPeriodConnectedPhoneCalls	تعداد تماس های تلفنی متصل در دوره قبل با مدت زمان بیش از 30 ثانیه.

نمونه ها

URL درخواست HTTP

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

نمونه درخواست HTTP را کامل کنید

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]

گزارش های سرب مفصل

مهم: گزارش‌های سرنخ دقیق منسوخ شده است. از Google Ads API برای واکشی سرنخ ها و مکالمات مرتبط با حساب های خدمات محلی خود استفاده کنید.

گزارش‌های سرنخ تفصیلی، نمای عمیقی از سرنخ‌های مرتبط با حساب‌های مرتبط خدمات محلی یک حساب مدیر را نشان می‌دهند. می توانید این داده ها را در یک بازه زمانی مشخص مشاهده کنید. برای یک محدوده زمانی معین، گزارش شامل سرنخ های ایجاد شده یا سرنخ هایی است که وضعیت اختلاف آنها به روز شده است. ممکن است داده ها تا 30 دقیقه قدیمی باشند.

توجه: کلاینت‌های API فقط می‌توانند برای یک دوره حداکثر 31 روزه، گزارش‌های سرنخ دقیق را درخواست کنند. این به دلیل حجم زیاد سرنخ هایی است که می توان با گزارش برگرداند.

برای دریافت گزارش، یک درخواست HTTP GET به https://localservices.googleapis.com/v1/detailedLeadReports:search با پارامترهای URL قابل تنظیم زیر ارسال کنید:

پارامترهای URL
query	مورد نیاز حاوی یک یا چند مقدار ID است که یکی از آنها باید شناسه حساب مدیر برای درخواست باشد. query می تواند چندین مقدار جدا شده با نقطه ویرگول را بپذیرد: مورد نیاز: manager_customer_id: <manager_cid> اختیاری: customer_id: <linked_cid> مثال: query=manager_customer_id:123;customer_id:456
startDate.day	اختیاری روزی از ماهی که دوره گزارش در آن شروع می شود. می تواند مقادیری بین 1 تا 31 شامل شود. پیش فرض 1 است.
startDate.month	اختیاری ماه شروع دوره گزارش. می تواند مقادیری بین 1 تا 12 شامل شود. پیش‌فرض در ماه جاری
startDate.year	اختیاری سالی که دوره گزارش شروع می شود، در قالب YYYY . پیش فرض های سال جاری
endDate.day	اختیاری روزی از ماه که دوره گزارش به پایان می رسد. می تواند مقادیری بین 1 تا 31 شامل شود. پیش‌فرض به روز جاری
endDate.month	اختیاری ماهی که دوره گزارش به پایان می رسد. می تواند مقادیری بین 1 تا 12 شامل شود. پیش‌فرض در ماه جاری
endDate.year	اختیاری سالی که دوره گزارش به پایان می رسد، در قالب YYYY . پیش فرض های سال جاری
pageSize	اختیاری یک عدد صحیح مثبت که نشان دهنده تعداد ورودی های بازگشتی است. پیش فرض 1000 و حداکثر 10000 است.
pageToken	اختیاری یک رشته next_page_token از پاسخ قبلی در این قسمت وارد کنید.

از فیلدهای قبلی برای ساخت SearchDetailedLeadReportsRequest استفاده می شود. برای هر شناسه مشتری در درخواست، DetailedLeadReports مربوطه در SearchDetailedLeadReportsResponse گنجانده شده است. هر گزارش سرنخ تفصیلی یک به یک با یک سرنخ خاص که با یک حساب مشتری مرتبط مرتبط است که تبلیغات خدمات محلی را نمایش می دهد، نقشه می کشد.

جدول زیر فیلدهای DetailedLeadReports را نشان می دهد:

فیلدها
leadId	شناسه منحصر به فرد یک سرنخ
accountId	حسابی را که سرنخ دریافت کرده است را شناسایی می کند.
businessName	نام تجاری مرتبط با حساب.
leadCreationTimestamp	مهر زمانی از زمان ایجاد سرنخ. شامل تاریخ در قالب M/D/YYYY و زمان در قالب HH:MM:SS . مثال: 11/1/2019 12:13:20
leadType	نوع سرنخ: MESSAGE یا PHONE_CALL .
leadCategory	دسته خدمات مرتبط با سرنخ مثال: housecleaner
geo	مکان‌های شهر اصلی حساب مرتبط. مثال: San Francisco, California, United States
messageLead	اطلاعاتی که فقط با سرنخ های پیام مرتبط است: customerName ، jobType ، postalCode ، و consumerPhoneNumber .
phoneLead	اطلاعاتی که فقط با سرنخ های تلفن همراه است: chargedCallTimestamp ، chargedConnectedCallDurationSeconds ، و consumerPhoneNumber .
bookingLead	اطلاعاتی که فقط با سرنخ‌های رزرو مرتبط است: customerName ، consumerPhoneNumber ، jobType ، consumerEmail ، و bookingAppointmentTimestamp .
chargeStatus	اینکه آیا سرب شارژ شده است. می تواند true یا false باشد.
currencyCode	کد ارز حسابی که سرنخ برای آن ایجاد شده است.
disputeStatus	وضعیت اختلاف رهبر
aggregatorInfo	اطلاعاتی که مختص شرکای گردآورنده شخص ثالث است. این فیلد فقط برای کلاینت‌های API پر شده است که با شرکای جمع‌آوری شخص ثالث مرتبط هستند. توجه: این مورد برای مشتریان استاندارد My Client Center (MCC) قابل اجرا نیست.
timezone	منطقه زمانی حساب مرتبط با سرنخ. در قالب پایگاه داده منطقه زمانی IANA ارائه شده است.

نمونه ها

URL درخواست HTTP

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

نمونه درخواست HTTP را کامل کنید

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]