// 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
用於識別特定待開發客戶的專屬字串。
處理建議:可用來簡化待開發客戶
。這個 ID 是「所有」表單的專屬名稱。報告時
與特定待開發客戶相關的問題,就必須提供這個 ID。
api_version
此待開發客戶結構定義所屬的 API 版本。這會在遷移至新結構定義時使用,目前可以忽略。
form_id
在 Google Ads 中設定的每份表單專屬 ID。目前產品允許
附加含有廣告活動層級的表單 (而非附加至廣告群組或廣告)
層級)。
影響:只能區隔待開發客戶 form_id
(例如在廣告活動層級提供)。
用戶端需要使用 8 位元組整數來處理。
campaign_id
附加的待開發客戶表單。
用戶端需要使用 8 位元組整數來處理。
adgroup_id
Google Ads 廣告群組 ID 可用來區分
廣告群組中的所有廣告群組。(適用於影片和探索廣告帶來的待開發客戶
廣告)
用戶端需要使用 8 位元組整數來處理。
creative_id
Google Ads 廣告素材 ID 可用來區分
新增一個廣告素材(適用於影片和探索廣告帶來的待開發客戶
廣告)