קמפיינים של 'Google בעלי מקצוע' מאפשרים לכם לפרסם את העסק ב-Google ולקבל לידים ישירות מלקוחות פוטנציאליים. במדריך הזה מופיע סיכום של הפעולות וההגבלות שנתמכות בגרסה הנוכחית של Google Ads API.
פעולות נתמכות
אחזור של קמפיינים ותקציבים ב-'Google בעלי מקצוע'
אפשר לאחזר קמפיינים ותקציבים ב-'Google בעלי מקצוע' באמצעות ה-method GoogleAdsService.Search
או GoogleAdsService.SearchStream
כדי לשלוח שאילתות לגבי משאבי הקמפיין שבהם
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
ומגדירים אותו לסוג השירות.
צריך להשתמש במזהה שירות שתואם למיקום ולקטגוריה הטירגוט של הקמפיין.
פעולות שלא נתמכות
ההגבלות שמפורטות בטבלה הבאה עשויות להשתנות בגרסאות הבאות של Google Ads API.
פעולות שלא נתמכות | |
---|---|
יצירה והסרה של קמפיינים | Google Ads API חוסם את האפשרות ליצור קמפיינים חדשים של 'Google בעלי מקצוע'. |
פעולות על ישויות משנה בקמפיין | Google Ads API לא תומך ביצירה, בשינוי, בהסרה או באחזור של קבוצות מודעות, מודעות או קריטריונים בקמפיינים של 'Google בעלי מקצוע'. |
מקורות מידע של 'Google בעלי מקצוע'
החל מ-Google Ads API גרסה 15, חלק מהנתונים מ-Local Services Ads חשופים ישירות ב-Google Ads API דרך משאבי הדוחות הבאים לקריאה בלבד:
local_services_lead
local_services_lead_conversation
local_services_verification_artifact
local_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'
החל מגרסה 17 של Google Ads API, תוכלו להשתמש ב-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
פריט מידע שנוצר בתהליך האימות ב-'Google בעלי מקצוע'
פלטפורמת LocalServicesVerificationArtifact
חושפת נתוני אימות לעסקים של מפרסמים. שימו לב שהאימותים האלה הם ברמת העסק, והם לא כוללים אימות לעובדים. הנתונים כוללים את הפרטים הבאים:
- אימות רישיונות
- אימות ביטוח
- אימותים באמצעות בדיקות רקע
- אימות רישום העסק
בכל פעם ששולחים בקשת אימות למודעות 'Google בעלי מקצוע', נוצר בשבילה מכונה של פריט מידע שנוצר בתהליך אימות (Artifact) ב-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
, שנקרא LocalServicesSetting
.
בשדה הזה מוצג סיכום ברמה גבוהה של סטטוס הבקשות לאימות של רישיונות וביטוח לפי מיקום וקטגוריה. הנה שאילתה לדוגמה שמאחזרת את כל הנתונים האלה:
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