קמפיינים של מודעות ב-'Google בעלי מקצוע' מאפשרים לכם לפרסם את העסק ב-Google ולקבל לידים ישירות מלקוחות פוטנציאליים. במדריך הזה מפורטות הפעולות הנתמכות וההגבלות בגרסה הנוכחית של Google Ads API.
פעולות נתמכות
הפעולות הבאות נתמכות.
אחזור של קמפיינים ותקציבים של מודעות 'Google בעלי מקצוע'
אפשר לאחזר קמפיינים ותקציבים של מודעות 'Google בעלי מקצוע' באמצעות השיטה
GoogleAdsService.Search או
GoogleAdsService.SearchStream
כדי לשלוח שאילתה למשאבי campaign שבהם
advertising_channel_type = 'LOCAL_SERVICES'. לדוגמה:
SELECT
campaign.id,
campaign.status,
campaign_budget.id,
campaign_budget.period,
campaign_budget.amount_micros,
campaign_budget.type
FROM campaign
WHERE campaign.advertising_channel_type = 'LOCAL_SERVICES'
עריכה של קמפיינים של Google בעלי מקצוע
אפשר לעדכן את השדות status של הקמפיין ואת השדות amount_micros של תקציב הקמפיין המשויך.
הגדרת שיטת הבידינג בקמפיינים של Google בעלי מקצוע
אפשר להגדיר את שיטות הבידינג הבאות כשיטת הבידינג הרגילה בקמפיינים של Google בעלי מקצוע:
ManualCpaעל ידי הגדרת השדהmanual_cpaאפשר להגדיר את הצעות המחיר של
ManualCpaדרךLocalServicesCampaignSettings.category_bids. אפשר לאחזר ולהגדיר אתLocalServicesCampaignSettingsשל קמפיינים של מודעות 'Google בעלי מקצוע' באמצעותCampaign.local_services_campaign_settings.MaximizeConversionsעל ידי הגדרת השדהmaximize_conversions
הגדרת תזמון הצגת מודעות כקריטריון של קמפיין
אפשר להגדיר תזמון הצגת מודעות לקמפיין של מודעות 'Google בעלי מקצוע' כקריטריון לקמפיין.
יוצרים AdScheduleInfo ומגדירים אותו לערך ad_schedule של CampaignCriterion שנשלח אל Google Ads API, באמצעות CampaignCriterionService.MutateCampaignCriteria.
הגדרת טירגוט למיקום גיאוגרפי
כדי להפעיל טירגוט לפי מיקום בקמפיין של מודעות 'Google בעלי מקצוע', מוסיפים LocationInfo ומגדירים אותו לערך location של CampaignCriterion שנשלח אל Google Ads API באמצעות CampaignCriterionService.MutateCampaignCriteria.
פרטים נוספים זמינים במאמר בנושא טירגוט לפי מיקום.
טירגוט סוגים ספציפיים של שירותים
כדי להפעיל טירגוט לסוג שירות ספציפי, מוסיפים את התג LocalServiceIdInfo ומגדירים אותו לסוג השירות.
צריך להשתמש במזהה שירות שתואם למיקום ולקטגוריה של הטירגוט בקמפיין.
שליחת משוב על לידים
משתמשים בשיטה ProvideLeadFeedback() של LocalServicesLeadService כדי לשלוח דירוג ומשוב על ליד. אפשר גם לבדוק את השדה lead_feedback_submitted של LocalServicesLead כדי לדעת אם ניתן דירוג לליד ונשלח משוב.
פעולות שלא נתמכות
ההגבלות שמפורטות בטבלה הבאה עשויות להשתנות בגרסאות עתידיות של Google Ads API.
| פעולות שלא נתמכות | |
|---|---|
| יצירה והסרה של קמפיינים | Google Ads API חוסם את האפשרות ליצור קמפיינים חדשים ל-Google בעלי מקצוע. |
| פעולות על ישויות משנה בקמפיין | Google Ads API לא תומך ביצירה, בשינוי, בהסרה או באחזור של קבוצות של מודעות, מודעות או קריטריונים בקמפיינים של מודעות 'Google בעלי מקצוע'. |
משאבים בנושא 'Google בעלי מקצוע'
חלק מהנתונים ממודעות 'Google בעלי מקצוע' מוצגים ישירות ב-Google Ads API באמצעות משאבי הדוחות הבאים לקריאה בלבד:
local_services_leadlocal_services_lead_conversationlocal_services_verification_artifactlocal_services_employee
כדי שהמשאבים האלה יחזירו נתונים, צריך להיות בחשבון הלקוח ששולח את הבקשה קמפיין של Google בעלי מקצוע. יכול להיות רק קמפיין אחד של Google בעלי מקצוע לכל חשבון לקוח, ולכן המשאבים האלה לא מציינים קמפיין. כדי לזהות את הקמפיין שאליו משויכים הנכסים האלה, משתמשים בשאילתה הבאה:
SELECT campaign.id
FROM campaign
WHERE campaign.advertising_channel_type = 'LOCAL_SERVICES'
ליד מ-"Google בעלי מקצוע"
LocalServicesLead חושף את הפרטים של ליד שנוצר כשצרכן מתקשר, שולח הודעה או מזמין שירות מהמפרסם.
אפשר לאחזר נתוני לידים של 'Google בעלי מקצוע' מהמשאב local_services_lead. דוגמה לשאילתה:
SELECT
local_services_lead.lead_type,
local_services_lead.category_id,
local_services_lead.service_id,
local_services_lead.contact_details,
local_services_lead.lead_status,
local_services_lead.creation_date_time,
local_services_lead.locale,
local_services_lead.lead_charged,
local_services_lead.credit_details.credit_state,
local_services_lead.credit_details.credit_state_last_update_date_time
FROM local_services_lead
מגבלות
- הערך בשדה
contact_detailsהוא null אם הערך בשדהlead_statusשווה לערך בשדהWIPED_OUT. - נתונים מלידים שבהם
category_idהוא חלק מקטגוריה של שירותי בריאות לא זמינים.
שיחה עם ליד מ-"Google בעלי מקצוע"
LocalServicesLeadConversation
חושף את פרטי השיחות שהתנהלו כחלק מLocalServicesLead. יש יחס אחד-לרבים עם LocalServicesLead, שבו ליד אחד יכולות להיות הרבה שיחות. שם המשאב של הליד הקשור מופיע בשדה lead.
אפשר לאחזר נתוני שיחות מהמקור local_services_lead_conversation. דוגמה לשאילתה שמסננת תוצאות של שיחות טלפון:
SELECT
local_services_lead_conversation.id,
local_services_lead_conversation.conversation_channel,
local_services_lead_conversation.participant_type,
local_services_lead_conversation.lead,
local_services_lead_conversation.event_date_time,
local_services_lead_conversation.phone_call_details.call_duration_millis,
local_services_lead_conversation.phone_call_details.call_recording_url,
local_services_lead_conversation.message_details.text,
local_services_lead_conversation.message_details.attachment_urls
FROM local_services_lead_conversation
WHERE local_services_lead_conversation.conversation_channel = 'PHONE_CALL'
אפשר להשתמש ב-method LocalServicesLeadService.AppendLeadConversation כדי לצרף משאבי LocalServicesLeadConversation ל-LocalServicesLead.
מגבלות
- כדי לגשת לכתובת ה-URL של הקלטת השיחה, צריך להתחבר באמצעות כתובת אימייל עם הרשאת קריאה בלבד לפחות בחשבון הלקוח ב-Google Ads שבו מתנהל הקמפיין שאליו משויך הליד.
בקשה להצגת כל השיחות בבת אחת עלולה להיות ארוכה, ולכן כדאי לסנן את השיחות לפי לידים, למשל:
SELECT local_services_lead_conversation.id, local_services_lead_conversation.event_date_time, local_services_lead_conversation.message_details.text FROM local_services_lead_conversation WHERE local_services_lead.id = LEAD_ID
Local Services verification artifact
LocalServicesVerificationArtifact
חושף נתוני אימות של עסקים של מפרסמים. שימו לב: האימותים האלה מתבצעים ברמת העסק ולא כוללים אימותים של עובדים. הנתונים כוללים את הפרטים הבאים:
- אימות רישיון
- אימותים של ביטוח
- אימותים של בדיקות רקע
- אימות מסמכי רישום עסק
בכל פעם שמוגשת בקשת אימות למודעות ב-"Google בעלי מקצוע", נוצר בשבילה מופע חדש של ארטיפקט אימות ב-Google Ads API, וכל ארטיפקט אימות מייצג בקשת אימות אחת. כל פריט מידע לאימות עשוי להכיל חלק מהפרטים הבאים, בהתאם לסוג בקשת האימות שהוא מייצג:
- הסטטוס של כל פריט אימות
- כתובת URL של בדיקת הרקע שתשמש לאימות בדיקת הרקע
- זמן ההמתנה לקבלת החלטה לגבי בדיקת הרקע (אם רלוונטי)
- כתובת URL של מסמך ביטוח לצפייה בפרטי הביטוח שכבר נשלחו
- סיבת הדחייה של הביטוח (אם רלוונטי)
- פרטי הרישיון (סוג, מספר, שם פרטי, שם משפחה)
- הסיבה לדחיית הרישיון (אם רלוונטי)
- כתובת URL של מסמך הרישיון לצפייה בתמונה של הרישיון שכבר נשלחה (אם רלוונטי)
- מסמכי רישום עסק (מספר תעודת זהות, מספר רישום)
- הסיבה לדחייה של מסמכי רישום העסק (אם רלוונטי)
- כתובת URL של מסמך רישום העסק כדי לראות תמונה של רישום שכבר נשלח (אם רלוונטי)
אפשר לאחזר נתונים של ארטיפקט אימות מהמקור local_services_verification_artifact. הנה שאילתה לדוגמה שמחזירה נתונים של כל הארטיפקטים שקשורים לאימות רישיון בחשבון לקוח נתון:
SELECT
local_services_verification_artifact.id,
local_services_verification_artifact.creation_date_time,
local_services_verification_artifact.status,
local_services_verification_artifact.artifact_type,
local_services_verification_artifact.license_verification_artifact.license_type,
local_services_verification_artifact.license_verification_artifact.license_number,
local_services_verification_artifact.license_verification_artifact.licensee_first_name,
local_services_verification_artifact.license_verification_artifact.licensee_last_name,
local_services_verification_artifact.license_verification_artifact.rejection_reason
FROM local_services_verification_artifact
WHERE local_services_verification_artifact.artifact_type = 'LICENSE'
נתוני רישיונות וביטוח לפי מיקום גיאוגרפי וקטגוריה
כדי לקבוע באופן פרוגרמטי את הסטטוס של בקשות אימות לפי מיקום גיאוגרפי, באופן ספציפי, קוד טירגוט גיאוגרפי) ומזהה קטגוריית שירותים מקומיים, אפשר להשתמש בשדה חדש במשאב customer, שנקרא LocalServicesSettings.
בשדה הזה מוצג סיכום כללי של הסטטוס של בקשות לאימות רישיונות וביטוחים לפי מיקום וקטגוריה. הנה דוגמה לשאילתה שמחזירה את כל הנתונים האלה:
SELECT
customer.local_services_settings.granular_license_statuses,
customer.local_services_settings.granular_insurance_statuses
FROM customer
עובד/ת בשירותים מקומיים
LocalServicesEmployee חושף את הנתונים על העובדים של בעלי העסקים המקומיים שהמפרסמים העלו את פרופיל המודעה שלהם למערכות שלנו.
הנה דוגמה לשאילתה שמחזירה נתונים של כל העובדים בשירות המקומי בחשבון לקוח נתון:
SELECT
local_services_employee.status,
local_services_employee.type,
local_services_employee.university_degrees,
local_services_employee.residencies,
local_services_employee.fellowships,
local_services_employee.job_title,
local_services_employee.year_started_practicing,
local_services_employee.languages_spoken,
local_services_employee.first_name,
local_services_employee.middle_name,
local_services_employee.last_name
FROM local_services_employee
קמפיינים למיקסום הביצועים של 'Google בעלי מקצוע'
קמפיינים למיקסום הביצועים תומכים בהגדרות שקשורות לשירותים מקומיים החל מגרסה 24.2. ההגדרות האלה מאפשרות לכם להגדיר ולזהות קמפיין למיקסום הביצועים שמציג מודעות לשירותים מקומיים (GLS PMax).
איך מזהים קמפיינים למיקסום הביצועים של Google בעלי מקצוע
כדי לדעת אם קמפיין למיקסום הביצועים הוא קמפיין Google בעלי מקצוע, צריך לבדוק את השדה local_services_enabled לקריאה בלבד בpmax_campaign_settings של הקמפיין.
קביעת הגדרות
בקמפיינים שבהם הערך של local_services_enabled הוא true, קובעים את ההגדרות בשדה local_services_pmax_campaign_settings:
-
navigational_query_leads_enabled: האם להשתמש במסנן של שאילתות ניווט. -
founding_year: שנת ההקמה של העסק. -
country_code: קוד המדינה של המודעה ב-'Google בעלי מקצוע'. השדה הזה הוא קבוע ומוגדר פעם אחת במהלך יצירת המודעה. זהו קוד מדינה בן שתי אותיות באותיות רישיות, שמשמש לקביעת דרישות האימות ולאימות הבחירה של קריטריון המיקום. -
phone_numbers: רשימה של מספרי טלפון שמשויכים לספק, שמיוצגים על ידי הודעותLocalServicesPhoneNumber.
מספרי טלפון
כל רשומה בשדה החוזר phone_numbers משתמשת בסוג ההודעה LocalServicesPhoneNumber עם השדות הבאים:
-
phone_number: מספר הטלפון. -
country_code: קוד המדינה בן שתי אותיות רישיות. -
phone_number_type: סוג מספר הטלפון, מוגדר על ידיGlsPhoneNumberTypeEnum.GlsPhoneNumberType. הסוגים הנתמכים כוללים:-
DESTINATION_PHONE_NUMBER_FOR_ADS: מספר היעד לשיחות מיחידת מודעות של מודעות לשירותים מקומיים (ברירת מחדל). -
DESTINATION_PHONE_NUMBER_FOR_SMS_ONLY: מספר היעד שתומך ב-SMS. -
DESTINATION_PHONE_NUMBER_FOR_WHATSAPP_ONLY: מספר היעד של חשבון וואטסאפ של ספק.
-