Esquema de POST
La solicitud POST que se envía al webhook estará en formato JSON con el siguiente esquema:
Carga útil de Proto de webhook
// 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;
// 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.
int64 asset_group_id = 11;
}
Descripción del campo
Campo | Descripción | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
lead_id |
Es una cadena única que identifica a un cliente potencial determinado.
Recomendación de manejo: Úsala para anular los duplicados de los clientes potenciales que se reciben. Este valor será único en todos los formularios. Cuando informes problemas relacionados con un cliente potencial específico, se requerirá este ID. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
api_version |
Es la versión de la API a la que pertenece este esquema de clientes potenciales. Se usará cuando se migre a un esquema nuevo y se puede ignorar por el momento. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
form_id |
Es el ID único de cada formulario configurado en Google Ads. El producto actual permite adjuntar un formulario a nivel de la campaña (en lugar de hacerlo a nivel del grupo de anuncios o del anuncio).
Implicaciones: Los clientes potenciales solo se pueden segmentar a nivel de Los clientes deben usar un número entero de 8 bytes para procesar. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
campaign_id |
El ID de la campaña o el ID de línea de pedido (Display & Video 360) del formulario de clientes potenciales adjunto
Los clientes deben usar un número entero de 8 bytes para procesar. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
adgroup_id |
El ID del grupo de anuncios de Google Ads se usa para distinguir el grupo de anuncios específico en la campaña. (Disponible solo para los clientes potenciales de los anuncios de video y discovery)
Los clientes deben usar un número entero de 8 bytes para procesar. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
creative_id |
El ID de la creatividad de Google Ads se usa para distinguir la creatividad específica en el grupo de anuncios. (Disponible solo para los clientes potenciales de los anuncios de video y discovery)
Los clientes deben usar un número entero de 8 bytes para procesar. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
gcl_id |
ID de clic de Google, un parámetro único que se usa para hacer un seguimiento de cada clic en un anuncio. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
google_key |
Es una clave que configura el anunciante con cada formulario.
Recomendación de control: Antes de procesar un cliente potencial recibido a través delwebhook, validar |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
is_test |
Este campo tiene semántica "opcional". Si el valor es verdadero, trata este cliente potencial como cliente potencial de prueba. Si el valor es falso o si el campo no está presente, considera a este cliente potencial como un cliente potencial de producción válido. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
user_column_data |
Es una tupla clave-valor repetida que transmite datos enviados por el usuario.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
asset_group_id |
Este campo solo se propaga para las campañas de máximo rendimiento.
Indica el ID del contenedor que contiene el formulario de clientes potenciales.
Los clientes deben usar un número entero de 8 bytes para procesar. |
Manejo de clientes potenciales
Los controladores de clientes potenciales deben responder con los siguientes códigos HTTP:
Respuesta HTTP | Cuerpo de la respuesta (JSON) | ¿Es un error que se puede reintentar? |
---|---|---|
200 |
{} | N/A |
4XX |
{"message: Texto de error de formato libre que describe el error de la solicitud"} | No |
5XX |
{"message: Intermittent retraible error optional message"} | Sí |
Duplicados
No se garantiza que un solo cliente potencial se publique exactamente una vez, por lo que el webhook de manejo de clientes potenciales debe controlar los duplicados de forma fluida.