বাস্তবায়ন

পোস্ট স্কিমা

ওয়েবহুকে পাঠানো POST অনুরোধটি নিম্নলিখিত স্কিমা সহ JSON ফর্ম্যাটে হবে:

ওয়েবহুক প্রোটো পেলোড

// 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 এপিআই সংস্করণ যা এই লিড স্কিমা অন্তর্গত। এটি একটি নতুন স্কিমাতে স্থানান্তরিত করার সময় ব্যবহার করা হবে এবং আপাতত উপেক্ষা করা যেতে পারে৷
form_id Google বিজ্ঞাপনে কনফিগার করা প্রতিটি ফর্মের জন্য অনন্য আইডি। বর্তমান পণ্য প্রচারাভিযান স্তরের সাথে একটি ফর্ম সংযুক্ত করার অনুমতি দেয় (বনাম বিজ্ঞাপন গোষ্ঠী বা বিজ্ঞাপন স্তরে সংযুক্ত করা)।

অন্তর্নিহিততা: লিডগুলি শুধুমাত্র form_id স্তরে (অর্থাৎ, প্রচারাভিযানের স্তরে) কাটা যেতে পারে।

ক্লায়েন্টদের প্রক্রিয়া করতে 8 বাইট পূর্ণসংখ্যা ব্যবহার করতে হবে।

campaign_id সংযুক্ত লিড ফর্মের Google বিজ্ঞাপন প্রচারের আইডি বা লাইন আইটেম আইডি (Display & Video 360)।

ক্লায়েন্টদের প্রক্রিয়া করার জন্য একটি 8-বাইট পূর্ণসংখ্যা ব্যবহার করতে হবে।

adgroup_id প্রচারাভিযানের নির্দিষ্ট বিজ্ঞাপন গোষ্ঠীকে আলাদা করতে Google Ads বিজ্ঞাপন গ্রুপ আইডি ব্যবহার করা হয়। (শুধুমাত্র ভিডিও এবং আবিষ্কার বিজ্ঞাপন থেকে লিডের জন্য উপলব্ধ)

ক্লায়েন্টদের প্রক্রিয়া করার জন্য একটি 8-বাইট পূর্ণসংখ্যা ব্যবহার করতে হবে।

creative_id Google বিজ্ঞাপন ক্রিয়েটিভ আইডি বিজ্ঞাপন গ্রুপে নির্দিষ্ট ক্রিয়েটিভকে আলাদা করতে ব্যবহার করা হয়। (শুধুমাত্র ভিডিও এবং আবিষ্কার বিজ্ঞাপন থেকে লিডের জন্য উপলব্ধ)

ক্লায়েন্টদের প্রক্রিয়া করার জন্য একটি 8-বাইট পূর্ণসংখ্যা ব্যবহার করতে হবে।

gcl_id Google ক্লিক আইডি , একটি অনন্য প্যারামিটার যা একটি বিজ্ঞাপনের প্রতিটি ক্লিককে ট্র্যাক করতে ব্যবহৃত হয়।
google_key প্রতিটি ফর্মের সাথে বিজ্ঞাপনদাতা দ্বারা কনফিগার করা একটি কী৷

পরিচালনার সুপারিশ: ওয়েবহুকের মাধ্যমে প্রাপ্ত লিড প্রক্রিয়া করার আগে, google_key যাচাই করা Google Ads-এ কনফিগার করার মতোই যাতে লিডটি বৈধ বলে আরও আত্মবিশ্বাসী হয়। এই কী গোপনীয় রাখুন এবং Google বিজ্ঞাপনে আপডেট করুন যদি বিশ্বাস করার কারণ থাকে যে এটি ব্যাপকভাবে ফাঁস হয়েছে।

is_test এই ক্ষেত্রে "ঐচ্ছিক" শব্দার্থক আছে। মান সত্য হলে, এই সীসাটিকে পরীক্ষামূলক সীসা হিসাবে বিবেচনা করুন। মান মিথ্যা হলে বা ক্ষেত্র উপস্থিত না থাকলে, এই সীসাটিকে বৈধ উৎপাদন সীসা হিসাবে বিবেচনা করুন।
user_column_data একটি পুনরাবৃত্ত কী-মান টিপল ব্যবহারকারী জমা দেওয়া ডেটা প্রেরণ করে।
  • 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" ব্যবহারকারীর পদবি। "শেষ নাম"
"ইমেইল" ব্যবহারকারীর ইমেইল। "ব্যবহারকারীর ইমেল"
"PHONE_NUMBER" E.164 ফর্ম্যাটে ব্যবহারকারীর ফোন, যেমন, "+11234567890" "ব্যবহারকারীর ফোন"
"POSTAL_CODE" ব্যবহারকারীর পোস্টাল কোড। "পোস্টাল কোড"
"COMPANY_NAME" ব্যবহারকারীর কোম্পানির নাম। "কোম্পানির নাম"
"JOB_TITLE" ব্যবহারকারীর কাজের শিরোনাম। "চাকরীর নাম"
"WORK_EMAIL" ব্যবহারকারীর কাজের ইমেল। "কাজের ইমেল"
"WORK_PHONE" ব্যবহারকারীর কাজের ফোন। "কাজের ফোন"
"STREET_ADDRESS" ব্যবহারকারীর রাস্তার ঠিকানা। "রাস্তার ঠিকানা"
"CITY" ব্যবহারকারীর শহর। "শহর"
"অঞ্চল" ব্যবহারকারীর অঞ্চল। "অঞ্চল"
"দেশ" ব্যবহারকারীর দেশ। "দেশ"
"VEHICLE_MODEL" আপনি কোন মডেল আগ্রহী? N/A
"VEHICLE_TYPE" আপনি কোন ধরনের যানবাহনে আগ্রহী? N/A
"PREFERRED_DEALERSHIP" আপনার পছন্দের ডিলারশিপ নির্বাচন করুন N/A
"VEHICLE_PURCHASE_TIMELINE" আপনি কখন গাড়ি কেনার পরিকল্পনা করছেন? N/A
"VEHICLE_CONDITION" আপনি কি ধরনের যানবাহন অবস্থা আগ্রহী? N/A
"VEHICLE_OWNERSHIP" আপনি একটি যানবাহন মালিক? "N/A"
"VEHICLE_PAYMENT_TYPE" কোন গাড়ির মালিকানা বিকল্প আপনি আগ্রহী? N/A
"COMPANY_SIZE" আপনার কোম্পানির আকার কি? N/A
"ANNUAL_SALES" আপনার বার্ষিক বিক্রয় ভলিউম কি? N/A
"YEARS_IN_BUSINESS" আপনি কত বছর ধরে ব্যবসা করছেন? N/A
"জব_বিভাগ" আপনার কাজ বিভাগ কি? N/A
"কাজ_ভূমিকা" আপনার কাজের ভূমিকা কি? N/A
"EDUCATION_PROGRAM" আপনি কোন প্রোগ্রাম আগ্রহী? N/A
"EDUCATION_COURSE" আপনি কোন কোর্সে আগ্রহী? N/A
"উৎপাদন" আপনি কোন পণ্য আগ্রহী? N/A
"পরিষেবা" আপনি কোন সেবা আগ্রহী? N/A
"অফার" আপনি কোন অফারে আগ্রহী? N/A
"শ্রেণী" আপনি কোন বিভাগে আগ্রহী? N/A
"PREFERRED_CONTACT_METHOD" যোগাযোগের আপনার পছন্দের পদ্ধতি নির্বাচন করুন N/A
"PREFERRED_LOCATION" আপনার পছন্দের অবস্থান নির্বাচন করুন N/A
"PREFERRED_CONTACT_TIME" আপনার সাথে যোগাযোগ করার সেরা সময় কি? N/A
"PURCHASE_TIMELINE" আপনি যখন একটি ক্রয় করতে খুঁজছেন? N/A
"YEARS_OF_EXPERIENCE" আপনার কত বছরের কাজের অভিজ্ঞতা আছে? N/A
"জব_ইন্ডাস্ট্রি" আপনি কোন শিল্পে কাজ করেন? N/A
"LEVEL_OF_EDUCATION" আপনার শিক্ষার সর্বোচ্চ স্তর কি? N/A
"PROPERTY_TYPE" আপনি কি ধরনের সম্পত্তি খুঁজছেন? N/A
"REALTOR_HELP_GOAL" আপনি একটি রিয়েলটর এর সাহায্য প্রয়োজন কি? N/A
"PROPERTY_COMMUNITY" আপনি কি সম্প্রদায় আগ্রহী? N/A
"PRICE_RANGE" আপনি কি মূল্য পরিসীমা খুঁজছেন? N/A
"NUMBER_OF_BEDROOMS" আপনি কয়টি বেডরুম খুঁজছেন? N/A
"FURNISHED_PROPERTY" আপনি একটি সম্পূর্ণ সজ্জিত সম্পত্তি খুঁজছেন? N/A
"PETS_ALLOWED_PROPERTY" আপনি কি এমন বৈশিষ্ট্য খুঁজছেন যা পোষা প্রাণীদের অনুমতি দেয়? N/A
"NEXT_PLANNED_PURCHASE" আপনি ক্রয় করার পরিকল্পনা পরবর্তী পণ্য কি? N/A
"EVENT_SIGNUP_INTEREST" আপনি একটি ইভেন্টের জন্য সাইন আপ করতে চান? N/A
"PREFERRED_SHOPPING_PLACES" আপনি কোথায় কেনাকাটা করতে আগ্রহী? N/A
"FAVORITE_BRAND" আপনার প্রিয় ব্র্যান্ড কি? N/A
"TRANSPORTATION_COMMERCIAL_ LICENSE_TYPE" আপনার কোন ধরনের বৈধ বাণিজ্যিক লাইসেন্স আছে? N/A
"EVENT_BOOKING_INTEREST" আপনি একটি ইভেন্ট বুকিং আগ্রহী? N/A
"DESTINATION_COUNTRY" আপনার গন্তব্য দেশ কি? N/A
"DESTINATION_CITY" আপনার গন্তব্য শহর কি? N/A
"DEPARTURE_COUNTRY" আপনার প্রস্থান দেশ কি? N/A
"DEPARTURE_CITY" আপনার প্রস্থান শহর কি? N/A
"DEPARTURE_DATE" আপনার প্রস্থান তারিখ কি? N/A
"RETURN_DATE" আপনার রিটার্ন তারিখ কি? N/A
"NUMBER_OF_TRAVELERS" আপনি কত মানুষের সাথে ভ্রমণ করছেন? N/A
"TRAVEL_BUDGET" আপনার ভ্রমণ বাজেট কত? N/A
"TRAVEL_ACCOMMODATION" আপনি আপনার ভ্রমণের সময় কোথায় থাকতে চান? N/A

সীসা হ্যান্ডলিং

লিড হ্যান্ডলারদের নিম্নলিখিত HTTP কোডগুলির সাথে প্রতিক্রিয়া জানানো উচিত:

HTTP প্রতিক্রিয়া রেসপন্স বডি (JSON) পুনরুদ্ধারযোগ্য ত্রুটি?
200 {} N/A
4XX {"বার্তা: ফ্রি ফর্ম ত্রুটি পাঠ্য, অনুরোধে কী ভুল ছিল তা বর্ণনা করে"} না
5XX {"বার্তা: বিরতিহীন প্রত্যাহারযোগ্য ত্রুটি ঐচ্ছিক বার্তা"} হ্যাঁ

ডুপ্লিকেট

একটি সিঙ্গেল লিড ঠিক একবার ডেলিভারির নিশ্চয়তা দেওয়া হয় না, তাই লিড হ্যান্ডলিং ওয়েবহুকের ডুপ্লিকেটগুলিকে সুন্দরভাবে পরিচালনা করা উচিত।