إعداد التقارير

تتيح لك التقارير استرداد معلومات حول أداء إعلانات حساباتك المرتبطة ومعلومات العملاء المحتملين.

تقارير الحساب

تعرض "تقارير الحساب" الأداء والمقاييس المرتبطة بحسابات "الخدمات المحلية" المرتبطة بحساب إداري. يمكنك الاطّلاع على هذه البيانات خلال فترة زمنية محدّدة. قد تكون البيانات قديمة لمدة تصل إلى 30 دقيقة.

للحصول على التقرير، أرسِل طلب HTTP GET إلى https://localservices.googleapis.com/v1/accountReports:search مع مَعلمات عنوان URL القابلة للضبط التالية:

معلمات عنوان URL
query	مطلوب يحتوي على قيمة معرّف واحدة أو أكثر، ويجب أن تكون إحداها معرّف الحساب الإداري الخاص بطلب البحث. يمكن أن يقبل 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	مطلوب يحتوي على قيمة معرّف واحدة أو أكثر، ويجب أن تكون إحداها معرّف الحساب الإداري الخاص بطلب البحث. يمكن أن يقبل 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	معلومات خاصة بشركاء التجميع الخارجيين يتم ملء هذا الحقل فقط لبرامج عملاء واجهة برمجة التطبيقات المرتبطة بشركاء تجميع تابعين لجهات خارجية. ملاحظة: لا ينطبق ذلك على عملاء حسابات My Client Center (مركز عملائي) العادية.
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]