קמפיינים ב-'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 בעלי מקצוע" כקריטריון ברמת הקמפיין.

יוצרים 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.

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

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

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

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

בטבלה הבאה מפורטות הפעולות שלא נתמכות בקמפיינים עצמאיים של "Google בעלי מקצוע" (advertising_channel_type = 'LOCAL_SERVICES').

פעולות לא נתמכות
יצירה והסרה של קמפיינים ‫Google Ads API חוסם את היצירה וההסרה של קמפיינים עצמאיים של "Google בעלי מקצוע" (advertising_channel_type = 'LOCAL_SERVICES'). החל מ-v26, אפשר ליצור קמפיינים חדשים למיקסום הביצועים של "Google בעלי מקצוע" (advertising_channel_type = 'PERFORMANCE_MAX') על ידי הגדרת pmax_campaign_settings.local_services_enabled = true. מידע נוסף זמין במאמר יצירת קמפיינים למיקסום הביצועים של "Google בעלי מקצוע".
פעולות על ישויות משנה בקמפיין בקמפיינים עצמאיים של "Google בעלי מקצוע" (advertising_channel_type = 'LOCAL_SERVICES'), Google Ads API לא תומך ביצירה, בשינוי, בהסרה או באחזור של קבוצות של מודעות, מודעות או קריטריונים, מלבד הקריטריונים של הקמפיין שמפורטים בקטע פעולות נתמכות. בקמפיינים למיקסום הביצועים של "Google בעלי מקצוע", משתמשים בקבוצות נכסים ובקריטריונים ברמת הקמפיין.

מקורות מידע על "Google בעלי מקצוע"

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

כדי שהמשאבים האלה יחזירו נתונים, צריך להיות קמפיין "Google בעלי מקצוע" או קמפיין למיקסום הביצועים של "Google בעלי מקצוע" בחשבון הלקוח ששולח את הבקשה. השדה local_services_lead.campaign מקשר בין רשומות של לידים לבין הקמפיין שמשויך אליהן (כולל קמפיינים למיקסום הביצועים עם יעדי תשלום לפי ליד שבהם campaign.advertising_channel_type = 'PERFORMANCE_MAX' ו-campaign.pmax_campaign_settings.local_services_enabled = true). כדי לזהות את הקמפיין שהמשאבים האלה משויכים אליו, משתמשים בשאילתה הבאה:

SELECT
  campaign.id,
  campaign.advertising_channel_type,
  campaign.pmax_campaign_settings.local_services_enabled
FROM campaign
WHERE campaign.advertising_channel_type IN ('LOCAL_SERVICES', 'PERFORMANCE_MAX')

ליד מ-"Google בעלי מקצוע"

LocalServicesLead חושף את פרטי הליד שנוצר כשצרכן מתקשר, שולח הודעה, מזמין שירות או משתמש בשובר מהמפרסם.

סוג הליד מוגדר על ידי LocalServicesLeadType. החל מv26, יש תמיכה בCOUPON כדי לאפשר סוגי לידים של שוברים בקמפיינים של "Google בעלי מקצוע" ובקמפיינים למיקסום הביצועים של "Google בעלי מקצוע".

השדה campaign מקשר את רשומת הליד בחזרה לקמפיין שמשויך אליה. בנוסף לבחירת שדות משויכים של campaign (כמו campaign.id ו-campaign.name), אתם יכולים לסנן שאילתות של לידים לפי שם המשאב של הקמפיין (WHERE local_services_lead.campaign = ...) או לפי סוג ערוץ הפרסום (WHERE campaign.advertising_channel_type = ...) כדי לפלח לידים לפי סוג הקמפיין.

אפשר לאחזר נתוני לידים של "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,
  local_services_lead.campaign
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'

פריטי מידע לאימות

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

הנה שאילתה לדוגמה שמאחזרת נתונים של כל העובדים ב-"Google בעלי מקצוע" בחשבון לקוח נתון:

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

יצירת קמפיינים למיקסום הביצועים של מודעות ב-"Google בעלי מקצוע"

החל מגרסה v26, אפשר להשתמש ב-Google Ads API כדי ליצור ולעדכן קמפיינים למיקסום הביצועים של מודעות "Google בעלי מקצוע". כדי ליצור קמפיינים חדשים למיקסום הביצועים ב-"Google בעלי מקצוע" דרך ה-API, יוצרים קמפיין למיקסום הביצועים (advertising_channel_type = 'PERFORMANCE_MAX') ומגדירים את local_services_enabled = true ב-pmax_campaign_settings (לא ניתן לשינוי אחרי היצירה). כשיוצרים קמפיין למיקסום הביצועים של מודעות "Google בעלי מקצוע", צריך לציין גם את country_code וגם את listing_id ב-local_services_pmax_campaign_settings. בגרסאות v24 ו-v25, ה-API תומך בעדכונים בלבד בקמפיינים קיימים למיקסום הביצועים של "Google בעלי מקצוע" שנוצרו בממשק המשתמש על ידי חשבונות ברשימת ההיתרים. במדריך בנושא קמפיינים למיקסום הביצועים עם יעדים שקשורים לתשלום לפי ליד מוסבר איך להגדיר את הדרישות המוקדמות וליצור קמפיינים באופן אטומי.

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

כדי לזהות אם קמפיין למיקסום הביצועים הוא קמפיין ב-"Google בעלי מקצוע", בודקים את השדה local_services_enabled ב-pmax_campaign_settings של הקמפיין. השדה הזה הוא ערך בוליאני שלא ניתן לשינוי (CREATE ONLY) ומוגדר כ-true בזמן יצירת הקמפיין.

קביעת הגדרות

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

  • listing_id: מזהה הדף העסקי בפרופיל העסק ב-Google שמקושר לקמפיין. החל מגרסה v26, השדה הזה הוא שדה חובה ואי אפשר לשנות אותו במהלך היצירה של קמפיין למיקסום הביצועים של "Google בעלי מקצוע". מזהה המלון חייב להיות מקושר לחשבון כנכס LOCATION מופעל. אחרת, ה-API מחזיר את השגיאה CampaignError.INVALID_LOCAL_SERVICES_PERFORMANCE_MAX_LISTING_ID. השדה listing_id מסומן כ-IMMUTABLE, ולכן ניסיון לעדכן אותו אחרי יצירת הקמפיין ייכשל עם השגיאה RequestError.IMMUTABLE_FIELD. מפתחים יכולים למצוא או לאמת מזהי דפים מקושרים באמצעות שליחת שאילתה למשאב Asset לגבי נכסי LOCATION מופעלים (בדיקת location_asset.business_profile_locations). מידע נוסף זמין במאמר נכסי מיקום.
  • ‫navigational_query_leads_enabled: אם להשתמש במסנן שאילתות ניווט.
  • ‫founding_year: השנה שבה העסק הוקם.
  • ‫country_code: קוד המדינה של המודעה ב-"Google בעלי מקצוע". החל מ-v26, השדה הזה הוא שדה חובה שלא ניתן לשינוי, וצריך להגדיר אותו פעם אחת במהלך יצירת הקמפיין. זהו קוד מדינה בן שתי אותיות רישיות (כרגע, רק US נתמך בקמפיינים למיקסום הביצועים של מודעות "Google בעלי מקצוע"), שמשמש לקביעת דרישות האימות ולאימות הבחירה בקריטריון המיקום.
  • ‫phone_numbers: רשימה של מספרי טלפון שמשויכים לספק, שמיוצגים על ידי הודעות LocalServicesPhoneNumber. אם לא מציינים מספר טלפון, כברירת מחדל המערכת משתמשת במספר הטלפון שמופיע בפרופיל העסק ב-Google שמקושר לחשבון. אם לא מופיע מספר טלפון בפרופיל העסק, חובה לציין מספר טלפון.

מספרי טלפון

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

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