Skip to end of metadata
Go to start of metadata

Описание

Если форма размещена на страницах сайта, созданного в сервисе LPgenerator, то данные клиента, заполнившего форму, можно передать в Altcraft Platform. Так, вы можете создать профиль для нового клиента или обновить данные уже существующего.

Чтобы подключить формы LPGenerator к аккаунту Altcraft, перейдите в личный кабинет LPGenerator. Кликните "Действия" для выбранной страницы, а затем выберите "Центр оптимизации конверсии".


После этого в блоке "Интеграции" в разделе "Другие сервисы" выберите Webhook.

Описание работы Webhook на стороне сервиса: https://lpgenerator.ru/blog/2018/04/03/webhook-samostoyatelnaya-integraciya-storonnih-servisov/


Настройка Webhook интеграции

Добавьте новый Webhook и укажите следующие данные:

URL: https://example.com/api/v1.1/integrations/lpgenerator/profile_import

Дополнительные поля:

ПараметрТипПримерОбязательныйОписание
tokenstringabcdefghijklmnqrstuvwxyzДаAPI токен для доступа к Altcraft
db_idstring1ДаИдентификатор базы данных для импорта
matchingstring

email
phone
custom

НетТип поиска профиля в Altcraft для обновления: по email или телефону
из полей данных или подписок профиля, - или по значению дополнительного поля профиля Altcraft.
field_namestringcustom_IDНетИмя кастомного поля БД Altcraft при matching : custom. В форме
сбора данных для поиска нужно поле с таким же именем. Например - custom_ID
resource_idstring3НетПри передаче контактных данных (email или phone) профилям будет добавляться
подписка на указанный ресурс. 



Поля LPGenerator по умолчанию

Ниже приведены неизменяемые системные поля запроса, передаваемого в Altcraft. 

ПараметрТипПримерОписание
idstring"777777"ID формы сбора данных
meta_dataJSON object"meta_data" : {...}Метаданные. Используются для автоопределения IP,
геолокации подписчиков, браузера и операционной системы.
utm_dataJSON object"utm_data" : {...}Предопределенные данные utm (часто пусто).
lead_dataJSON object"lead_data" : {...}Данные подписчика из формы сбора.

Добавление формы сбора данных

В конструкторе страниц добавьте форму:


По двойному клику на область формы откроется редактор полей формы. Добавьте необходимые поля и укажите их название для отображения на сайте. 

Отметьте опцию "Отправить в crm", а в поле "Название в crm" укажите название соответствующего поля в базе данных Altcraft. Для кастомных полей укажите те же названия полей, которые использовали в платформе, учитывая регистр. Список системных полей профиля Altcraft, таких как Имя или Email, доступен по этой ссылке .

Сохраните настройки и опубликуйте форму, чтобы начать передавать данные.

Примеры структуры запросов

Импорт подписчика по email-адресу:

{
	"id": 77777777,
	"lead_data": {
		"email": "qwerty@dron.ff",
	},
	"meta_data": {
		"HTTP_USER_AGENT": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/67.0.3396.99 Safari/537.36",
		"LANGUAGE": "en-US",
		"form_name": "форма 1",
		"from": "Страница 107570 (Первый вариант)",
		"page_id": 1642169,
		"user_ip": "96.123.123.123",
		"variant_id": 1935651
	},
	"utm_data": {}
    "db_id": "2", 
    "resource_id": "2", 
    "matching": "email",
    "token": "abcdefghijklmnqrstuvwxyz"
}

Обновление полей подписчика с подпиской на ресурс (с поиском подписчика по кастомному полю custom_ID):

{
	"id": 27773744,
	"lead_data": {
		"email": "ytrewq@dron.ff",
        "custom_ID": "Bagdasaryan"
	},
	"meta_data": {
		"HTTP_USER_AGENT": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/67.0.3396.99 Safari/537.36",
		"LANGUAGE": "en-US",
		"form_name": "форма 1",
		"from": "Страница 207571",
		"page_id": 1642169,
		"user_ip": "96.123.123.123",
		"variant_id": 1935651
	},
	"utm_data": {}
    "db_id": "2", 
    "resource_id": "2", 
    "matching": "custom",
    "field_name": "custom_ID",
    "token": "abcdefghijklmnqrstuvwxyz"
}

Импорт подписчика с передачей статуса подписки:

{
	"db_id": "75",
	"id": 64368040,
	"workflow_id": 4,
	"trigger_id": 1,
	"field_for_APIContent": "any data",
	"lead_data": {
		"_status": 0,
		"_fname": "By phone (explicitly) After",
		"phone": "+234257929700231073",
		"New_field_5": 6.2,
		"subscriptions" : [ 
			{
				"resource_id" : 5,
				"channel" : 2,
				"channel_sid" : "sms",
				"phone_data" : {
				"phone" : "+234257929700231073",
				"md5" : "33890b49c501f101965c6ac4fb01e409"
				},
				"priority" : 0,
				"status" : 2,
				"hash_id" : "ceffaf99",
				"is_delete" : false
			}
		]
	},
	"matching": "phone",
	"meta_data": {
		"HTTP_USER_AGENT": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/67.0.3396.99 Safari/537.36",
		"LANGUAGE": "en-US",
		"form_name": "\\u0444\\u043e\\u0440\\u043c\\u0430 1",
		"from": "\\u0421\\u0442\\u0440\\u0430\\u043d\\u0438\\u0446\\u0430 518658 (\\u041f\\u0435\\u0440\\u0432\\u044b\\u0439 \\u0432\\u0430\\u0440\\u0438\\u0430\\u043d\\u0442)",
		"page_id": 1623331,
		"user_ip": "94.231.119.122",
		"variant_id": 1937033
	},
	"resource_id": "5",
	"token": "a3c31d8a15714531afebfd1541eeba41",
	"utm_data": {}
}
ПолеЗначениеОбазательноеОписание
workflow_idидентификатор сценарияНетДобавить профиль в сценарий сразу после импорта профиля
trigger_idидентификатор триггерной кампанииНетЗапустить триггерную кампанию сразу после испорта профиля
_status

0 - Подписан

1 - Отписан

2 - Жалобщик

3 - Hardbounced

4 - Не подтвержден

5 - Приостановлен

6 - Не валиден

НетГлобальная подписка профиля
statusНетСтатус подписки на определенный ресурс




  • No labels