קמפיינים ב-'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'

עריכה של קמפיינים לקידום עסקים מקומיים

אפשר לעדכן את השדות status של הקמפיין ואת השדות amount_micros של תקציב הקמפיין המשויך.

הגדרת שיטת הבידינג בקמפיינים לקידום עסקים מקומיים

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

הגדרת תזמון הצגת מודעות כקריטריון של קמפיין

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

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

חלק מהנתונים ממודעות 'Google בעלי מקצוע' מוצגים ישירות ב-Google Ads API באמצעות משאבי הדוחות הבאים שהם לקריאה בלבד:

כדי שהמשאבים האלה יחזירו נתונים, צריך להיות בחשבון הלקוח ששולח את הבקשה קמפיין של שירותים מקומיים. בנוסף, יכול להיות רק קמפיין אחד של מודעות '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'

אפשר להשתמש בשיטה 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