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

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

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

‫Google Ads API תומך בפעולות הבאות בקמפיינים של 'Google בעלי מקצוע'.

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

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

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

אפשר להגדיר תזמון להצגת מודעות בקמפיין של מודעות 'Google בעלי מקצוע' כקריטריון לקמפיין.

יוצרים AdScheduleInfo ומגדירים אותו לad_schedule של CampaignCriterion שנשלח אל Google Ads API, באמצעות CampaignCriterionService.MutateCampaignCriteria.

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

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

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

כדי להפעיל טירגוט לסוג שירות ספציפי, יוצרים LocalServiceIdInfo עם אחד ממזהי הקטגוריות של Google בעלי מקצוע, מגדירים אותו בשדה local_service_id של CampaignCriterion ושולחים אותו באמצעות CampaignCriterionService.MutateCampaignCriteria.

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

שליחת משוב על לידים

משתמשים בשיטה ProvideLeadFeedback של LocalServicesLeadService כדי לשלוח דירוג ומשוב על ליד. אפשר גם לבדוק את השדה lead_feedback_submitted של LocalServicesLead כדי לדעת אם ניתן דירוג לליד ונשלח משוב.

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

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

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

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

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

כדי שהמשאבים האלה יחזירו נתונים, צריך להיות בחשבון הלקוח ששולח את הבקשה קמפיין של 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.
  • החל מ-v25, ‏ ContactDetails.email מוסר ו-ContactDetails.phone_number_extension זמין בהודעה ContactDetails שמוחזרת על ידי local_services_lead.contact_details.
  • הנתונים מלידים שבהם 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'

אפשר להשתמש ב-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_conversation.lead = 'customers/CUSTOMER_ID/localServicesLeads/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'

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

כדי לקבוע באופן פרוגרמטי את הסטטוס של בקשות אימות לפי מיקום גיאוגרפי (במיוחד, קוד מיקום גיאוגרפי לטירגוט) ומזהה קטגוריית Google בעלי מקצוע, אפשר להשתמש בשדה local_services_settings במשאב 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

קמפיינים למיקסום הביצועים של 'Google לבעלי מקצוע'

קמפיינים למיקסום הביצועים תומכים בהגדרות שקשורות לשירותים מקומיים החל מv24. ההגדרות האלה מאפשרות לכם להגדיר ולזהות קמפיין למיקסום הביצועים שמציג מודעות לשירותים מקומיים (GLS PMax).

איך מזהים קמפיינים למיקסום הביצועים של Google בעלי מקצוע

כדי לדעת אם קמפיין למיקסום הביצועים הוא קמפיין Google בעלי מקצוע, צריך לבדוק את השדה local_services_enabled לקריאה בלבד בpmax_campaign_settings של הקמפיין.

קביעת הגדרות

בקמפיינים שבהם הערך של local_services_enabled הוא true, מגדירים את ההגדרות בשדה local_services_pmax_campaign_settings:

  • ‫navigational_query_leads_enabled: האם להשתמש במסנן של שאילתות ניווט.
  • ‫founding_year: שנת ההקמה של העסק.
  • ‫country_code: קוד המדינה של המודעה ב-'Google בעלי מקצוע'. אי אפשר לשנות את השדה הזה, והוא מוגדר פעם אחת במהלך יצירת המודעה. זהו קוד מדינה בן שתי אותיות באותיות רישיות, שמשמש לקביעת דרישות האימות ולאימות הבחירה של קריטריון המיקום.
  • ‫phone_numbers: רשימה של מספרי טלפון שמשויכים לספק, שמיוצגים על ידי הודעות LocalServicesPhoneNumber.

מספרי טלפון

כל רשומה בשדה החוזר phone_numbers משתמשת בסוג ההודעה LocalServicesPhoneNumber עם השדות הבאים:

  • ‫phone_number: מספר הטלפון.
  • ‫country_code: קוד המדינה בן שתי אותיות רישיות.
  • ‫phone_number_type: סוג מספר הטלפון, מוגדר על ידי GlsPhoneNumberTypeEnum.GlsPhoneNumberType. הסוגים הנתמכים כוללים:
    • ‫DESTINATION_PHONE_NUMBER_FOR_ADS: מספר היעד לשימוש בשיחות מיחידת מודעות של מודעות לשירותים מקומיים (ברירת מחדל).
    • ‫DESTINATION_PHONE_NUMBER_FOR_SMS_ONLY: מספר היעד שתומך ב-SMS.
    • ‫DESTINATION_PHONE_NUMBER_FOR_WHATSAPP_ONLY: מספר היעד של חשבון וואטסאפ של ספק.