Esta guía describirá cómo un socio afiliado puede enviar clientes potenciales a Driftrock.
En primer lugar, debe tener una captura de afiliados ya configurado en la plataforma Driftrock para enviar los clientes potenciales a. Esto debe ser configurado por un usuario en la cuenta Driftrock. Vea la guía de Driftrock para configurar una Captura de Afiliado Driftrock aquí.
El usuario de Driftrock también debería haberle proporcionado lo siguiente para ayudarle a construir la petición POST:
- Los campos esperados en una carga útil de ejemplo
- Su ID de afiliado
- Su clave API
Creación de la solicitud POST
Puedeshacer peticiones POST a esta URL:
https://external-apis.driftrock.com/v2/affiliate_event
Cabeceras:
Content-Type: application/json
Accept: application/json
Authorization: Portador xxxx-xxxx-xxxx-xxxx
donde xxxx-xxxx-xxxx-xxxx es una clave api que el cliente le enviará.
Cuerpo:
El cuerpo debe tener formato JSON y contener los campos obligatorios o recomendados:
- event_type [string] (obligatorio): debe ser lead, conversion o action.
- event_name [string] (required): díganos qué etiqueta le gustaría asignar a este evento (ej: Usuario registrado, Vista de página, Compra )
- source_id [string] (obligatorio): es necesario para vincular el evento a la captura que se ha creado. Estará en la carga útil de ejemplo que envía el cliente.
- affiliate_id [string] (obligatorio): es necesario para vincular el evento a uno de los afiliados configurados en el paso "Afiliado" (paso 3) de la captura.
- fields [json] (required) : this is a json field, where you send us the attributes of this event (eg: "fields": {"email": "test@driftrock.com", "question_1": "test answer"} )
- event_id [string] (opcional): puede ser cualquier ID que se utilice en su sistema para identificar de forma exclusiva este evento. Tenga en cuenta que si envía dos eventos con el mismo event_id, estarán vinculados a la misma persona en nuestro sistema.
- person_id [string] (opcional): puede ser cualquier ID que se utilice en su sistema para identificar de forma única a una persona. Tenga en cuenta que si envía dos eventos con el mismo person_id, se vincularán a la misma persona en nuestro sistema.
- ga_client_id [string] (opcional) : es el ID de Google Analytics que puede proporcionarnos para permitirnos extraer información de marketing.
- created_at [string] (opcional): si desea proporcionar una marca de tiempo más precisa para cuando se produjo el evento. Si no se proporciona se establecerá en el momento en que Driftrock recibe el evento, esta es una distinción sutil, pero puede ser importante para su caso de negocio. Esto debe ser pasado en formato ISO8601, (por ejemplo: 2019-12-02T10:00:00.000Z)
Usando la cadena de ejemplo y el ID de afiliado que te habrá enviado el cliente usando Driftrock, el cuerpo debería tener este aspecto como ejemplo:
{
"event_type": "lead",
"event_name": "Lead received",
"source_id": "",
"affiliate_id": "AFFILIATE_ID",
"fields": {
"email_": "...", // required
"last_name": "...", // required
"first_name": "...", // required
"postcode": "..."
}
}
Envíe su primera pista de prueba.
Si su prueba ha tenido éxito, debería ver la siguiente respuesta:
- estado: 200
- payload: {"data": "ok"}
Si su prueba ha fallado, verá la siguiente respuesta:
- estado: 400
- payload: {"error": "..."}
Póngase en contacto con el usuario de Driftrock para confirmar que su iniciativa se ha enviado correctamente.
