POST şeması
Webhook'a gönderilen POST isteği, aşağıdaki gibi JSON biçiminde olur: şema:
Webhook Proto yükü
// 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;
}
Alan açıklaması
| Alan | Açıklama | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
lead_id |
Belirli bir potansiyel müşteriyi tanımlayan benzersiz dize.
İşleme yönelik öneri: Potansiyel müşterileri tekilleştirmek için bunu kullanın. alındı. Bu kimlik tüm formlarda benzersiz olacaktır. Bildirme sırasında belirli bir hizmet talebiyle ilgili sorunlar varsa bu kimlik gerekli olacaktır. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
api_version |
Bu potansiyel müşteri şemasının ait olduğu API sürümü. Bu özellik şu durumlarda kullanılır: ve şu an için yoksayılabilir. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
form_id |
Google Ads'de yapılandırılan her formun benzersiz kimliği. Mevcut ürün
kampanya düzeyinde form ekleme (reklam grubuna veya reklama ekleme yerine)
düzeyleri).
Çıkarımlar: Potansiyel müşteriler yalnızca İstemcilerin işlemek için 8 bayt tam sayı kullanması gerekir. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
campaign_id |
Reklamın Google Ads kampanya kimliği veya satır öğesi kimliği (Display &Video 360)
potansiyel müşteri formu ekli.
İstemcilerin, işlemesi için 8 baytlık bir tam sayı kullanması gerekir. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
adgroup_id |
Google Ads reklam grubu kimliği, belirli bir reklamı
reklam grubuna atanır. (Video ve keşif kaynaklı potansiyel müşteriler için kullanılabilir
yalnızca reklamlar)
İstemcilerin, işlemesi için 8 baytlık bir tam sayı kullanması gerekir. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
creative_id |
Google Ads reklam öğesi kimliği,
reklam grubuna atanır. (Video ve keşif kaynaklı potansiyel müşteriler için kullanılabilir
yalnızca reklamlar)
İstemcilerin, işlemesi için 8 baytlık bir tam sayı kullanması gerekir. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
gcl_id |
Google tıklaması ID, bir reklamın her bir tıklamasını izlemek için kullanılan benzersiz bir parametredir. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
google_key |
Her formla birlikte reklamveren tarafından yapılandırılan bir anahtar.
Öneriyi kullanma: Alınan bir hizmet talebini işlemeden önce
web kancası için, |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
is_test |
Bu alanda "isteğe bağlı" değeri var anlamsal açıdan kullanır. Değer doğruysa bunu değerlendirin test lideri olması gerekir. Değer false (yanlış) ise veya alan yoksa, geçerli bir üretim lideri olarak belirlemeniz gerekir. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
user_column_data |
Kullanıcı tarafından gönderilen verileri ileten yinelenen bir anahtar/değer çifti.
|
Potansiyel müşteri işlemleri
Potansiyel müşteri işleyiciler aşağıdaki HTTP kodlarıyla yanıt vermelidir:
| HTTP Yanıtı | Yanıt gövdesi (JSON) | Geri alınabilir bir hata mı? |
|---|---|---|
200 |
{} | Yok |
4XX |
{"mesaj: Serbest biçimli hata metni, istekte neyin yanlış olduğunu açıklayan"} | Hayır |
5XX |
{"message: Aralıklı yeniden izlenebilir hata isteğe bağlı mesajı"} | Evet |
Yinelenen kişiler
Tek bir hizmet talebinin tam olarak bir kez teslim edileceği garanti edilmez. yinelemeleri ayrıntılı bir şekilde ele almalıdır.