// Represent user lead data for single columnmessageUserLeadColumnData{// Human-readable text of the field type (e.g.: Full Name, What is your// preferred dealership?). This field might not always be populated.optionalstringcolumn_name=1;// Column value based on column typeoneofcolumn_value{stringstring_value=2;}// Column id. Populated for all types of fields. (e.g.: FULL_NAME)optionalstringcolumn_id=3;}// Message to construct webhook JSON payloadmessageWebhookLead{// Unique id to represent leadoptionalstringlead_id=1;// User inputted data per columnrepeatedUserLeadColumnDatauser_column_data=2;// API versionoptionalstringapi_version=3;// Form id to which lead belonged to.optionalint64form_id=4;// Campaign id that the lead form is associated withoptionalint64campaign_id=5;// Key to be used by advertiser to verify the request// is from Google.optionalstringgoogle_key=6;// Denotes if the lead is a test lead.optionalboolis_test=7;// Click ID for the lead submission.optionalstringgcl_id=8;// Adgroup id which generated the lead.optionalint64adgroup_id=9;// Creative id which generated the lead.optionalint64creative_id=10;// Asset group id represents the container for holding assets, associated// urls, hints and criteria that will be used to select assets and for// optimization. This field is only populated for Performance Max campaigns.int64asset_group_id=11;// Lead stage at the time of delivery.stringlead_stage=12[(datapol.semantic_type)=ST_NOT_REQUIRED];}
필드 설명
필드
설명
lead_id
특정 리드를 식별하는 고유 문자열입니다.
처리 권장사항: 수신된 리드의 중복을 제거하는 데 사용합니다. 이 ID는 모든 양식에서 고유합니다. 특정 리드와 관련된 문제를 신고할 때 이 ID가 필요합니다.
api_version
이 리드 스키마가 속한 API 버전입니다. 새 스키마로 이전할 때 사용되며 지금은 무시해도 됩니다.
form_id
Google Ads에 구성된 각 양식의 고유 ID입니다. 현재 제품에서는 광고 그룹 또는 광고 수준에서 연결하는 대신 캠페인 수준으로 양식을 연결할 수 있습니다.
의미: 리드는 form_id 수준 (즉, 캠페인 수준)에서만 슬라이스할 수 있습니다.
클라이언트는 처리할 때 8바이트 정수를 사용해야 합니다.
campaign_id
첨부된 리드 양식의 Google Ads 캠페인 ID 또는 광고 항목 ID (Display & Video 360)입니다.
클라이언트는 처리할 때 8바이트 정수를 사용해야 합니다.
adgroup_id
Google Ads 광고 그룹 ID는 캠페인의 특정 광고 그룹을 구별하는 데 사용됩니다. (동영상 및 디스커버리 광고에서 발생한 리드에만 사용할 수 있음)
클라이언트는 처리할 때 8바이트 정수를 사용해야 합니다.
creative_id
Google Ads 광고 소재 ID는 광고 그룹에서 특정 광고 소재를 구분하는 데 사용됩니다. (동영상 및 디스커버리 광고에서 발생한 리드에만 사용할 수 있음)
처리 권장사항: webhook을 통해 수신된 리드를 처리하기 전에 google_key를 확인하는 것은 리드가 유효하다는 확신을 높이기 위해 Google Ads에서 구성하는 것과 같습니다. 이 키는 기밀로 유지하고 광범위하게 유출되었다고 생각되는 경우 Google Ads에서 업데이트하세요.
is_test
이 필드는 '선택사항' 시맨틱을 갖습니다. 값이 true이면 이 리드를 테스트 리드로 처리합니다. 값이 false이거나 필드가 없으면 이 리드를 유효한 프로덕션 리드로 처리합니다.
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 를 사용하세요.
[[["이해하기 쉬움","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"]],["최종 업데이트: 2025-02-11(UTC)"],[],[]]