Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Schema POST
La richiesta POST inviata all'webhook sarà in formato JSON con lo schema seguente:
Payload del protocollo webhook
// 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];}
Descrizione del campo
Campo
Descrizione
lead_id
Stringa univoca che identifica un determinato lead.
Consiglio per la gestione:utilizza questa opzione per eliminare i duplicati dei lead ricevuti. Questo valore sarà univoco in tutti i moduli. Quando segnali
problemi relativi a un lead specifico, questo ID sarà obbligatorio.
api_version
Versione dell'API a cui appartiene questo schema di lead. Verrà utilizzato durante la migrazione a un nuovo schema e per il momento può essere ignorato.
form_id
ID univoco per ogni modulo configurato in Google Ads. Il prodotto attuale consente di collegare un modulo a livello di campagna (anziché a livello di gruppo di annunci o di annuncio).
Implicazioni:i lead possono essere suddivisi solo a livello di form_id (ovvero a livello di campagna).
I client devono utilizzare un numero intero di 8 byte per l'elaborazione.
campaign_id
L'ID campagna o elemento pubblicitario Google Ads (Display & Video 360) del
modulo per i lead allegato.
I client devono utilizzare un numero intero di 8 byte per l'elaborazione.
adgroup_id
L'ID gruppo di annunci Google Ads viene utilizzato per distinguere il gruppo di annunci specifico nella campagna. (disponibile solo per i lead provenienti dagli annunci video e discovery)
I client devono utilizzare un numero intero di 8 byte per l'elaborazione.
creative_id
L'ID creatività Google Ads viene utilizzato per distinguere la creatività specifica nel gruppo di annunci. (disponibile solo per i lead provenienti dagli annunci video e discovery)
I client devono utilizzare un numero intero di 8 byte per l'elaborazione.
gcl_id
ID clic
Google, un parametro univoco utilizzato per monitorare ogni clic su un annuncio.
google_key
Una chiave configurata dall'inserzionista con ogni modulo.
Consiglio per la gestione: prima di elaborare un lead ricevuto tramite webhook, la convalida di google_key è la stessa della configurazione in Google Ads per avere maggiori garanzie sulla validità del lead. Mantieni
questa chiave riservata e aggiornala in Google Ads se hai motivo di ritenere
che sia stata divulgata a livello generale.
is_test
Questo campo ha una semantica "facoltativa". Se il valore è true, tratta questo lead come lead di test. Se il valore è falso o se il campo non è presente, considera
questo lead come lead di produzione valido.
user_column_data
Una tupla chiave-valore ripetuta che trasmette i dati inviati dall'utente.
user_column_data.column_id: tipo di dati inviati dall'utente.
User_column_data.column_value: per ogni tipo di dati,
verrà inserito un tipo di valore in base al tipo di dati. Tutti i nostri
tipi di dati attuali hanno il valore
user_column_data.string_value.
user_column_data.column_name: testo leggibile da una persona del
tipo di dati inviato dall'utente. Questo campo potrebbe non essere sempre compilato. Utilizza column_id .
user_column_data.column_id
Contenuto di User_column_data.string_value
user_column_data.column_name (deprecato)
"FULL_NAME"
Nome completo dell'utente.
"Nome completo"
"FIRST_NAME"
Nome dell'utente.
"Nome"
"LAST_NAME"
Cognome dell'utente.
"Cognome"
"EMAIL"
Email dell'utente.
"Email utente"
"PHONE_NUMBER"
Numero di telefono dell'utente in formato E.164, ad esempio "+11234567890".
"Telefono utente"
"POSTAL_CODE"
Codice postale dell'utente.
"Codice postale"
"COMPANY_NAME"
Nome dell'azienda dell'utente.
"Nome dell'azienda"
"JOB_TITLE"
Qualifica dell'utente.
"Job Title"
"WORK_EMAIL"
Indirizzo email di lavoro dell'utente.
"Indirizzo email di lavoro"
"WORK_PHONE"
Numero di telefono di lavoro dell'utente.
"Telefono di lavoro"
"STREET_ADDRESS"
Indirizzo dell'utente.
"Indirizzo"
"CITTÀ"
Città dell'utente.
"Città"
"REGION"
Regione dell'utente.
"Regione"
"COUNTRY"
Paese dell'utente.
"Paese"
"VEHICLE_MODEL"
Quale modello ti interessa?
N/D
"VEHICLE_TYPE"
Quale tipo di veicolo ti interessa?
N/D
"PREFERRED_DEALERSHIP"
Seleziona il tuo concessionario preferito
N/D
"VEHICLE_PURCHASE_TIMELINE"
Quando intendi acquistare un veicolo?
N/D
"VEHICLE_CONDITION"
Ti interessa un veicolo nuovo o usato?
N/D
"VEHICLE_OWNERSHIP"
Possiedi un veicolo?
"N/A"
"VEHICLE_PAYMENT_TYPE"
Che tipo di proprietà del veicolo ti interessa?
N/D
"COMPANY_SIZE"
Quali sono le dimensioni della tua azienda?
N/D
"ANNUAL_SALES"
Qual è il tuo volume annuale di vendite?
N/D
"YEARS_IN_BUSINESS"
Da quanti anni eserciti la tua attività?
N/D
"JOB_DEPARTMENT"
In quale reparto lavori?
N/D
"JOB_ROLE"
Qual è il tuo ruolo professionale?
N/D
"EDUCATION_PROGRAM"
Quale programma ti interessa?
N/D
"EDUCATION_COURSE"
Quale corso ti interessa?
N/D
"PRODUCT"
Quale prodotto ti interessa?
N/D
"SERVICE"
Quale servizio ti interessa?
N/D
"OFFER"
Quale offerta ti interessa?
N/D
"CATEGORY"
Quale categoria ti interessa?
N/D
"PREFERRED_CONTACT_METHOD"
Seleziona il tuo metodo di contatto preferito
N/D
"PREFERRED_LOCATION"
Seleziona la tua località preferita
N/D
"PREFERRED_CONTACT_TIME"
Qual è l'orario migliore per contattarti?
N/D
"PURCHASE_TIMELINE"
Quando intendi effettuare un acquisto?
N/D
"YEARS_OF_EXPERIENCE"
Quanti anni di esperienza lavorativa hai accumulato?
N/D
"JOB_INDUSTRY"
In quale settore lavori?
N/D
"LEVEL_OF_EDUCATION"
Qual è il livello di istruzione più elevato che hai conseguito?
N/D
"PROPERTY_TYPE"
Quale tipo di immobile stai cercando?
N/D
"REALTOR_HELP_GOAL"
Per cosa vuoi chiedere aiuto a un agente immobiliare?
N/D
"PROPERTY_COMMUNITY"
Quale community ti interessa?
N/D
"PRICE_RANGE"
Quale fascia di prezzo stai cercando?
N/D
"NUMBER_OF_BEDROOMS"
Di quante stanze da letto hai bisogno?
N/D
"FURNISHED_PROPERTY"
Stai cercando un immobile completamente arredato?
N/D
"PETS_ALLOWED_PROPERTY"
Stai cercando immobili in cui sono ammessi animali domestici?
N/D
"NEXT_PLANNED_PURCHASE"
Qual è il prossimo prodotto che intendi acquistare?
N/D
"EVENT_SIGNUP_INTEREST"
Vuoi registrarti a un evento?
N/D
"PREFERRED_SHOPPING_PLACES"
Dove ti interessa fare acquisti?
N/D
"FAVORITE_BRAND"
Qual è il tuo brand preferito?
N/D
"TRANSPORTATION_COMMERCIAL_LICENSE_TYPE"
Quale tipo di licenza commerciale valida possiedi?
N/D
"EVENT_BOOKING_INTEREST"
Ti interessa prenotare un evento?
N/D
"DESTINATION_COUNTRY"
Qual è il paese di destinazione?
N/D
"DESTINATION_CITY"
Qual è la città di destinazione?
N/D
"DEPARTURE_COUNTRY"
Qual è il paese di partenza?
N/D
"DEPARTURE_CITY"
Qual è la città di partenza?
N/D
"DEPARTURE_DATE"
Qual è la data di partenza?
N/D
"RETURN_DATE"
Qual è la data di ritorno?
N/D
"NUMBER_OF_TRAVELERS"
Quante persone viaggiano con te?
N/D
"TRAVEL_BUDGET"
Qual è il tuo budget per il viaggio?
N/D
"TRAVEL_ACCOMMODATION"
Dove vuoi soggiornare durante il viaggio?
N/D
asset_group_id
Questo campo viene compilato solo per le campagne Performance Max.
Indica l'ID del contenitore che contiene il modulo per i lead.
I client devono utilizzare un numero intero di 8 byte per l'elaborazione.
lead_stage
Indica la fase del lead al momento della sua invio. Questo campo è utile per monitorare la fase della canalizzazione / lo stato di conversione di un lead.
Gestione dei lead
I gestori dei lead devono rispondere con i seguenti codici HTTP:
Non è garantito che un singolo lead venga inviato esattamente una volta, pertanto l'webhook per la gestione dei lead deve gestire i duplicati in modo appropriato.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-02-11 UTC."],[],[]]