קמפיינים של 'Google בעלי מקצוע' מאפשרים לכם לפרסם את העסק ב-Google ולקבל לידים ישירות לקוחות פוטנציאליים. מדריך זה מסכם את הפעולות הנתמכות הגבלות בגרסה הנוכחית של Google Ads API.
פעולות נתמכות
אחזור של קמפיינים ותקציבים ב-'Google בעלי מקצוע'
כדי לאחזר קמפיינים ותקציבים של 'Google בעלי מקצוע',
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
ומגדירים אותו
סוג של
.
צריך להשתמש במזהה שירות שתואם לטירגוט של הקמפיין location ו category.
פעולות שלא נתמכות
ההגבלות שמפורטות בטבלה הבאה עשויות להשתנות בגרסאות עתידיות של ל-Google Ads API.
פעולות שלא נתמכות | |
---|---|
יצירה והסרה של קמפיינים | Google Ads API חוסם את האפשרות ליצור קמפיינים חדשים של 'Google בעלי מקצוע'. |
פעולות על ישויות משנה בקמפיין | Google Ads API לא תומך ביצירה, בשינוי, בהסרה או אחזור של קבוצות מודעות, מודעות או קריטריונים בקמפיינים של 'Google בעלי מקצוע'. |
מקורות מידע של 'Google בעלי מקצוע'
החל מ-Google Ads API v15, חלק מהנתונים מ- מודעות 'Google בעלי מקצוע' חשופות ישירות ב-Google Ads API דרך משאבי הדוחות הבאים לקריאה בלבד:
local_services_lead
local_services_lead_conversation
local_services_verification_artifact
local_services_employee
כדי שהמשאבים האלה יחזירו נתונים, צריך הקמפיין בחשבון הלקוח שממנו נשלחה הבקשה. ומכיוון שייתכנו רק קמפיין אחד של '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, אפשר להשתמש
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 בעלי מקצוע', נוצר בשבילו ארטיפקט לאימות ב-Google Ads API. כל פריט מידע שנוצר בתהליך אימות מייצג בקשת אימות אחת. כל אחד ארטיפקט האימות עלול להכיל חלק מהפרטים הבאים, בהתאם לגבי הסוג של בקשת האימות שהיא מייצגת:
- הסטטוס של כל פריט מידע שנוצר בתהליך אימות
- כתובת URL לבדיקת רקע שתשמש לאימות לצורך בדיקת רקע
- זמן ההחלטה לגבי בדיקת הרקע (אם רלוונטי)
- כתובת ה-URL של מסמך הביטוח כדי לראות את פרטי הביטוח שכבר נשלח
- הסיבה לדחיית הביטוח (אם רלוונטי)
- פרטי הרישיון (סוג, מספר, שם פרטי, שמות משפחה)
- הסיבה לדחיית הרישיון (אם רלוונטי)
- כתובת ה-URL של מסמך הרישיון כדי להציג תמונה של הרישיון שכבר נשלחה (אם רלוונטי)
- פרטי הרישום של העסק (מזהה ביקורת, מספר רישום)
- הסיבה לדחיית הרישום של העסק (אם רלוונטי)
- כתובת ה-URL של מסמך רישום העסק כדי להציג רישום שכבר נשלח תמונה (אם רלוונטי)
ניתן לאחזר את הנתונים של פריטי המידע שנוצרו בתהליך הפיתוח (Artifact) של האימות
local_services_verification_artifact
משאב. הנה שאילתה לדוגמה שמאחזרת נתונים עבור כל
פריטי מידע שנוצרו בתהליך אימות (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