קמפיינים ב-'Google בעלי מקצוע'

קמפיינים של '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 בעלי מקצוע

אתם יכולים להגדיר את שיטות הבידינג הבאות כשיטת הבידינג הרגילה של קמפיינים לקידום שירותים מקומיים:

• 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.

הגדרת טירגוט למיקום גיאוגרפי

כדי להפעיל טירגוט למיקום גיאוגרפי בקמפיין לשירותים מקומיים, מוסיפים את הערך LocationInfo ומגדירים אותו כ-location של הערך CampaignCriterion שנשלח ל-Google Ads API באמצעות CampaignCriterionService.MutateCampaignCriteria. פרטים נוספים זמינים במאמר טירגוט לפי מיקום.

טירגוט לסוגים ספציפיים של שירותים

כדי להפעיל טירגוט לסוג שירות ספציפי, מוסיפים את הערך LocalServiceIdInfo ומגדירים אותו לסוג השירות.

צריך להשתמש במזהה שירות שמתאים למיקום ולקטגוריה של הטירגוט בקמפיין.

פעולות לא נתמכות

ההגבלות שמפורטות בטבלה הבאה עשויות להשתנות בגרסאות עתידיות של Google Ads API.

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

משאבים בנושא 'Google בעלי מקצוע'

חלק מהנתונים מ-מודעות '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, אפשר להשתמש ב-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 בעלי מקצוע, נוצרת בשבילה מופע חדש של פריט אימות ב-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