קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
סכימת POST
בקשת ה-POST שנשלחה ל-webhook תהיה בפורמט JSON עם הסכימה הבאה:
מטען ייעודי (payload) של Webhook Pro
// Represent user lead data for single column
message UserLeadColumnData {
// Human-readable text of the field type (e.g.: Full Name, What is your
// preferred dealership?). This field might not always be populated.
optional string column_name = 1;
// Column value based on column type
oneof column_value {
string string_value = 2;
}
// Column id. Populated for all types of fields. (e.g.: FULL_NAME)
optional string column_id = 3;
}
// Message to construct webhook JSON payload
message WebhookLead {
// Unique id to represent lead
optional string lead_id = 1;
// User inputted data per column
repeated UserLeadColumnData user_column_data = 2;
// API version
optional string api_version = 3;
// Form id to which lead belonged to.
optional int64 form_id = 4;
// Campaign id that the lead form is associated with
optional int64 campaign_id = 5;
// Key to be used by advertiser to verify the request
// is from Google.
optional string google_key = 6;
// Denotes if the lead is a test lead.
optional bool is_test = 7;
// Click ID for the lead submission.
optional string gcl_id = 8;
// Adgroup id which generated the lead.
optional int64 adgroup_id = 9;
// Creative id which generated the lead.
optional int64 creative_id = 10;
}
תיאור השדה
שדה
התיאור
lead_id
מחרוזת ייחודית שמזהה ליד נתון.
טיפול בהמלצה: כדאי להשתמש באפשרות הזו כדי לבטל כפילויות של לידים שמתקבלים. השם הזה יהיה ייחודי בכל הטפסים. כשמדווחים על בעיות שקשורות לליד ספציפי, צריך לציין את המזהה הזה.
api_version
גרסת ה-API שאליה סכימת הלידים הזו שייכת. ייעשה שימוש באפשרות הזו במהלך ההעברה לסכימה חדשה, ואפשר להתעלם ממנה כרגע.
form_id
מזהה ייחודי לכל טופס שהוגדר ב-Google Ads. במוצר הנוכחי אפשר
לצרף טופס ברמת הקמפיין (לעומת צירוף ברמת קבוצת המודעות או
המודעה).
השלכות: ניתן לפלח לידים רק ברמה form_id (כלומר, ברמת הקמפיין).
כדי לעבד את הנתונים, לקוחות צריכים להשתמש במספר שלם של 8 בייטים.
campaign_id
מזהה הקמפיין ב-Google Ads או מזהה הפריט (Display & Video 360) של
הטופס להשארת פרטים המצורף.
כדי לעבד את הנתונים, לקוחות צריכים להשתמש במספר שלם בגודל 8 בייטים.
adgroup_id
המזהה של קבוצת המודעות ב-Google Ads משמש להבחנה בין קבוצת המודעות הספציפית בקמפיין. (זמין רק ללידים ממודעות וידאו
וממודעות Discovery)
כדי לעבד את הנתונים, לקוחות צריכים להשתמש במספר שלם בגודל 8 בייטים.
creative_id
מזהה הקריאייטיב של Google Ads משמש להבחנה בין הקריאייטיב הספציפי בקבוצת המודעות. (זמין רק ללידים ממודעות וידאו
וממודעות Discovery)
כדי לעבד את הנתונים, לקוחות צריכים להשתמש במספר שלם בגודל 8 בייטים.
טיפול בהמלצה: לפני עיבוד של ליד שהתקבל באמצעות תגובה לפעולה מאתר אחר (webhook), אימות google_key זהה להגדרה
ב-Google Ads כדי שיהיה לך יותר ביטחון שהליד חוקי. יש לשמור על
הסודיות של המפתח הזה ולעדכן אותו ב-Google Ads אם יש סיבה
להאמין שהפרטים האלה הודלפו בתפוצה רחבה.
is_test
השדה הזה הוא 'אופציונלי'. אם הערך הוא True, אפשר להתייחס לליד הזה
כאל ליד לניסיון. אם הערך הוא False או אם השדה לא קיים, יש להתייחס לליד הזה בתור ליד חוקי של סביבת הייצור.
user_column_data
tuple חוזר עם ערך מפתח/ערך שמעביר נתונים שהמשתמש שלח.
user_column_data.column_id: סוג הנתונים שנשלח
על ידי המשתמש.
User_column_data.column_value: לכל סוג נתונים
יאוכלס סוג ערך בהתאם לסוג הנתונים. כל סוגי הנתונים הקיימים שלנו מקבלים את הערך
user_column_data.string_value.
user_column_data.column_name: טקסט קריא לאנשים של סוג הנתונים שנשלח על ידי המשתמש. יכול להיות שהשדה הזה לא תמיד יאוכלס. במקום זאת יש להשתמש ב-column_id .