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