การใช้งาน
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
สคีมา POST
คำขอ POST ที่ส่งไปยังเว็บฮุคจะอยู่ในรูปแบบ JSON ดังนี้
สคีมา:
เพย์โหลด Proto ของเว็บฮุค
// 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 ไบต์เพื่อประมวลผล
gcl_id
การคลิกของ Google
ID คือพารามิเตอร์ที่ไม่ซ้ำกันซึ่งใช้ติดตามการคลิกโฆษณาแต่ละครั้ง
google_key
คีย์ที่ผู้ลงโฆษณากำหนดค่าไว้ในแบบฟอร์มแต่ละรายการ
คำแนะนำในการจัดการ: ก่อนประมวลผลโอกาสในการขายที่ได้รับ
เว็บฮุค การตรวจสอบ google_key
เหมือนกับการกำหนดค่าใน
Google Ads เพื่อสร้างความมั่นใจมากขึ้นว่าโอกาสในการขายนั้นถูกต้อง เก็บ
คีย์นี้จะเป็นความลับและอัปเดตใน Google Ads หากมีเหตุผลที่จะ
เชื่อว่ามีการเผยแพร่ข่าวในวงกว้าง
is_test
ฟิลด์นี้มีความหมายเป็น "ไม่บังคับ" หากค่าเป็น "จริง" ให้ดำเนินการตามนี้
เป็นผู้มีโอกาสเป็นลูกค้าเพื่อทดสอบ หากค่าเป็น "เท็จ" หรือหากไม่มีช่อง ให้ใช้
ให้เป็นผู้มีโอกาสเป็นลูกค้าที่ถูกต้อง
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
แทน
user_column_data.column_id
เนื้อหา User_column_data.string_value
user_column_data.column_name (เลิกใช้งานแล้ว)
"FULL_NAME"
ชื่อเต็มของผู้ใช้
"ชื่อเต็ม"
"FIRST_NAME"
ชื่อจริงของผู้ใช้
"ชื่อ"
"LAST_NAME"
นามสกุลของผู้ใช้
"นามสกุล"
"EMAIL"
อีเมลผู้ใช้
"อีเมลผู้ใช้"
"PHONE_NUMBER"
โทรศัพท์ของผู้ใช้ใน E.164
รูปแบบ เช่น "+11234567890"
"โทรศัพท์ของผู้ใช้"
"POSTAL_CODE"
รหัสไปรษณีย์ของผู้ใช้
"รหัสไปรษณีย์"
"COMPANY_NAME"
ชื่อบริษัทของผู้ใช้
"ชื่อบริษัท"
"JOB_TITLE"
ตำแหน่งงานของผู้ใช้
"ตำแหน่งงาน"
"WORK_EMAIL"
อีเมลที่ทำงานของผู้ใช้
"อีเมลที่ทำงาน"
"WORK_PHONE"
หมายเลขโทรศัพท์ที่ทำงานของผู้ใช้
"โทรศัพท์ที่ทำงาน"
"STREET_ADDRESS"
ที่อยู่ของผู้ใช้
"ที่อยู่"
"CITY"
เมืองของผู้ใช้
"เมือง"
"ภูมิภาค"
ภูมิภาคของผู้ใช้
"ภูมิภาค"
"COUNTRY"
ประเทศของผู้ใช้
"ประเทศ"
"VEHICLE_MODEL"
คุณสนใจรุ่นใด
ไม่มี
"VEHICLE_TYPE"
คุณสนใจรถประเภทไหน
ไม่มี
"PREFERRED_DEALERSHIP"
เลือกตัวแทนจำหน่ายที่ต้องการ
ไม่มี
"VEHICLE_PURCHASE_TIMELINE"
คุณวางแผนจะซื้อรถเมื่อใด
ไม่มี
"VEHICLE_CONDITION"
คุณสนใจสภาพรถแบบใด
ไม่มี
"VEHICLE_OWNERSHIP"
คุณมีรถหรือไม่
"ไม่มี"
"VEHICLE_PAYMENT_TYPE"
คุณสนใจที่จะซื้อรถด้วยวิธีใด
ไม่มี
"COMPANY_SIZE"
บริษัทของคุณมีขนาดเท่าใด
ไม่มี
"ANNUAL_SALES"
คุณมียอดขายต่อปีเท่าไร
ไม่มี
"YEARS_IN_BUSINESS"
คุณทำงานในสายธุรกิจนี้มาแล้วกี่ปี
ไม่มี
"JOB_DEPARTMENT"
คุณทำงานในแผนกใด
ไม่มี
"JOB_ROLE"
คุณทำงานในตำแหน่งใด
ไม่มี
"EDUCATION_PROGRAM"
คุณสนใจโปรแกรมใด
ไม่มี
"หลักสูตร EDUCATION_COURSE"
คุณสนใจหลักสูตรไหน
ไม่มี
"PRODUCT"
คุณสนใจผลิตภัณฑ์ใด
ไม่มี
"SERVICE"
คุณสนใจบริการใด
ไม่มี
"ข้อเสนอพิเศษ"
คุณสนใจข้อเสนอใด
ไม่มี
"CATEGORY"
คุณสนใจประเภทใด
ไม่มี
"PREFERRED_CONTACT_METHOD"
เลือกวิธีการติดต่อที่ต้องการ
ไม่มี
"PREFERRED_LOCATION"
เลือกสถานที่ที่ต้องการ
ไม่มี
"PREFERRED_CONTACT_TIME"
เวลาที่คุณสะดวกให้ติดต่อได้คือช่วงใด
ไม่มี
"PURCHASE_TIMELINE"
ปกติคุณจะหาซื้อสินค้าเมื่อใด
ไม่มี
"YEARS_OF_EXPERIENCE"
คุณมีประสบการณ์ในการทำงานมานานกี่ปี
ไม่มี
"JOB_INDUSTRY"
คุณทำงานอยู่ในธุรกิจประเภทใด
ไม่มี
"LEVEL_OF_EDUCATION"
คุณจบการศึกษาสูงสุดในระดับใด
ไม่มี
"PROPERTY_TYPE"
คุณกำลังมองหาที่พักอาศัยประเภทใด
ไม่มี
"REALTOR_HELP_GOAL"
คุณต้องการความช่วยเหลือจากนายหน้าในเรื่องใด
ไม่มี
"PROPERTY_COMMUNITY"
คุณสนใจชุมชนใด
ไม่มี
"PRICE_RANGE"
คุณกำลังมองหาช่วงราคาใด
ไม่มี
"NUMBER_OF_BEDROOMS"
คุณกำลังมองหาที่อยู่ที่มีกี่ห้องนอน
ไม่มี
"FURNISHED_PROPERTY"
คุณกำลังมองหาที่พักอาศัยซึ่งตกแต่งไว้เรียบร้อยหมดแล้วอยู่ใช่ไหม
ไม่มี
"PETS_ALLOWED_PROPERTY"
คุณกำลังหาที่พักอาศัยที่อนุญาตให้เลี้ยงสัตว์ได้ใช่ไหม
ไม่มี
"NEXT_PLANNED_PURCHASE"
คุณวางแผนจะซื้อผลิตภัณฑ์ใดต่อไป
ไม่มี
"EVENT_SIGNUP_INTEREST"
คุณต้องการลงชื่อเข้าร่วมกิจกรรมไหม
ไม่มี
"PREFERRED_SHOPPING_PLACES"
คุณสนใจที่จะช็อปปิ้งที่ไหน
ไม่มี
"แบรนด์โปรด"
คุณชอบแบรนด์ไหนมากที่สุด
ไม่มี
"TRANSPORTATION_COMMERCIAL_ LICENSE_TYPE"
คุณมีจดทะเบียนพาณิชย์ประเภทใด
ไม่มี
"EVENT_BOOKING_INTEREST"
คุณสนใจที่จะจองเพื่อเข้าร่วมกิจกรรมไหม
ไม่มี
"DESTINATION_COUNTRY"
ประเทศจุดหมายของคุณคือที่ใด
ไม่มี
"DESTINATION_CITY"
จุดหมายของคุณคือเมืองใด
ไม่มี
"DEPARTURE_COUNTRY"
คุณออกเดินทางจากประเทศใด
ไม่มี
"DEPARTURE_CITY"
คุณออกเดินทางจากเมืองใด
ไม่มี
"DEPARTURE_DATE"
คุณออกเดินทางวันที่เท่าไหร่
ไม่มี
"RETURN_DATE"
คุณจะเดินทางกลับวันที่เท่าใด
ไม่มี
"NUMBER_OF_TRAVELERS"
คุณมีผู้ร่วมเดินทางกี่คน
ไม่มี
"TRAVEL_BUDGET"
คุณมีงบประมาณการท่องเที่ยวเท่าใด
ไม่มี
"TRAVEL_ACCOMMODATION"
คุณต้องการพักที่ใดในระหว่างการเดินทาง
ไม่มี
การจัดการผู้มีโอกาสเป็นลูกค้า
แฮนเดิลโอกาสในการขายควรตอบกลับด้วยรหัส HTTP ต่อไปนี้
การตอบกลับ HTTP
เนื้อหาการตอบกลับ (JSON)
เกิดข้อผิดพลาดที่กู้คืนซ้ำได้ใช่ไหม
200
{}
ไม่มี
4XX
{"message: ข้อความแสดงข้อผิดพลาดรูปแบบอิสระ การอธิบายว่าคำขอเกิดข้อผิดพลาดอะไร"}
ไม่ได้
5XX
{"message: ข้อความแสดงข้อผิดพลาดที่ทำซ้ำได้เป็นระยะๆ"}
ใช่
รายการซ้ำ
ไม่รับประกันว่าผู้มีโอกาสเป็นลูกค้ารายการเดียวจะได้รับการนำส่งเพียงครั้งเดียว โอกาสในการขายจึงจะได้รับ
การจัดการเว็บฮุคควรจัดการกับรายการที่ซ้ำกันได้อย่างสวยงาม
ประเด็นหลัก: ใช้ lead_id
เพื่อกรองโอกาสในการขายที่ซ้ำกัน
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2024-09-11 UTC
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"ไม่มีข้อมูลที่ฉันต้องการ"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"ซับซ้อนเกินไป/มีหลายขั้นตอนมากเกินไป"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"ล้าสมัย"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"ปัญหาเกี่ยวกับการแปล"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"ตัวอย่าง/ปัญหาเกี่ยวกับโค้ด"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"อื่นๆ"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"เข้าใจง่าย"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"แก้ปัญหาของฉันได้"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"อื่นๆ"
}]
{"lastModified": "\u0e2d\u0e31\u0e1b\u0e40\u0e14\u0e15\u0e25\u0e48\u0e32\u0e2a\u0e38\u0e14 2024-09-11 UTC"}
[[["เข้าใจง่าย","easyToUnderstand","thumb-up"],["แก้ปัญหาของฉันได้","solvedMyProblem","thumb-up"],["อื่นๆ","otherUp","thumb-up"]],[["ไม่มีข้อมูลที่ฉันต้องการ","missingTheInformationINeed","thumb-down"],["ซับซ้อนเกินไป/มีหลายขั้นตอนมากเกินไป","tooComplicatedTooManySteps","thumb-down"],["ล้าสมัย","outOfDate","thumb-down"],["ปัญหาเกี่ยวกับการแปล","translationIssue","thumb-down"],["ตัวอย่าง/ปัญหาเกี่ยวกับโค้ด","samplesCodeIssue","thumb-down"],["อื่นๆ","otherDown","thumb-down"]],["อัปเดตล่าสุด 2024-09-11 UTC"]]