דיווח

הדיווח מאפשר לכם לאחזר מידע על ביצועי המודעות ועל לידים בחשבונות המקושרים.

דוחות לגבי חשבונות

בדוחות החשבון מוצגים הביצועים והמדדים שמשויכים לחשבונות המקושרים של שירותים מקומיים בחשבון ניהול. אפשר לראות את הנתונים האלה לתקופה מסוימת. יכול להיות שהנתונים לא יהיו עדכניים למשך עד 30 דקות.

כדי לקבל את הדוח, שולחים בקשת HTTP GET אל https://localservices.googleapis.com/v1/accountReports:search עם הפרמטרים הבאים של כתובת ה-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. כל דוח חשבון ממופה אחד לאחד עם חשבון לקוח מקושר שבו מוצגות מודעות לספקי שירותים מקומיים.

הערה: קובצי פרוטוקול (protos) לבקשות, לתגובות ולמבני נתונים זמינים ומקושרים אחרי ההשקה.

בטבלה הבאה מוצגים השדות ב-AccountReports:

שדות
accountId	מספר לקוח מקושר לחשבון ב-'Google בעלי מקצוע'.
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 כדי לאחזר לידים והמרות שמשויכים לחשבונות שלכם ב'Google בעלי מקצוע'.

בדוחות מפורטים על לידים מוצגת תצוגה מעמיקה של לידים שמשויכים לחשבונות 'Google בעלי מקצוע' המקושרים לחשבון ניהול. אפשר לראות את הנתונים האלה לתקופה מסוימת. בטווח זמן נתון, הדוח כולל לידים שנוצרו או לידים שהסטטוס שלהם לגבי מחלוקת עודכן. יכול להיות שהנתונים לא יהיו עדכניים למשך 30 דקות.

הערה: לקוחות API יכולים לבקש דוחות מפורטים על לידים לתקופה של עד 31 ימים. הסיבה לכך היא שנפח הלידים שהדוח יכול להחזיר גדול מאוד.

כדי לקבל את הדוח, שולחים בקשת HTTP GET אל https://localservices.googleapis.com/v1/detailedLeadReports:search עם הפרמטרים הבאים של כתובת ה-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. כל דוח מפורט על לידים ממופה אחד לאחד עם ליד ספציפי שמשויך לחשבון לקוח מקושר שבו מוצגות מודעות ב-Local Services Ads.

בטבלה הבאה מוצגים השדות ב-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 שמשויכים לשותפי צד שלישי שמספקים שירותי צבירה. הערה: זה לא רלוונטי ללקוחות רגילים של חשבון ניהול (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]