Мы представляем вам прекрасное API для доступа к функционалу расширения Giftmio
С его помощью вы сможете встроить кэшбэк в свое расширение и выгодно его монетизировать
Подать заявку для доступа к API
Реализовано несколько возможностей использования API веб-мастерами в расширении - каталог кампаний, api поиска возможности кэшбэкапо ссылкам и api для возможности узнать, зарегистрирован ли пользователь в giftmio. Авторизация происходит по, токену который выдается лично для веб-мастера Admitad.

В расширении нужно сгенерировать для каждого пользователя уникальный uuid v4 и передавать его в ссылку.

  1. Каталог рекламных кампаний (рекламодателей с кэшбэком) - GET
https://giftmio.com/api/extension/v1/<uuid>/catalog/ Можно передавать опционально параметры limit, offset, search, country . Примеры для пользователя с uuid="790402d2-0406-45fb-88d0-d06a8eb520d8":

без фильтра:

curl --request GET \
  --url https://giftmio.com/api/extension/v1/790402d2-0406-45fb-88d0-d06a8eb520d8/catalog/ \
  --header 'authorization: Token <token>'
с фильтром:

curl --request GET \
  --url 'https://giftmio.com/api/extension/v1/790402d2-0406-45fb-88d0-d06a8eb520d8/catalog/?limit=10&offset=20&country=DE&country=FR' \
  --header 'authorization: Token <token>'
или поиск:

curl --request GET \
  --url 'https://giftmio.com/api/extension/v1/790402d2-0406-45fb-88d0-d06a8eb520d8/catalog/?search=allegro' \
  --header 'authorization: Token <token>'
ответы:

{
	"count": 28967,
	"next": "http://giftmio.com/api/extension/v1/790402d2-0406-45fb-88d0-d06a8eb520d8/catalog/?limit=15&offset=15",
	"previous": null,
	"limit": 15,
	"offset": 0,
	"results": [
		{
			"offer_id": "7a470a38-06ed-4efc-a71e-7a78be1729cc",
			"name": "OneTravel",
			"image": "https://cdn.giftmio.com/offer/29081-f6c74a279c495249.svg",
			"link": "https://giftmio.com/offer/onetravel/",
			"traffic_url": "https://rzekl.com/g/ndskfhsx7d3f495cd53ff212f8373f/?subid=790402d2-0406-45fb-88d0-d06a8eb520d8",
			"cashback_size": "12.5 USD",
			"countries": [
				"CA",
				"US"
			],
			"domains": [
				"onetravel.com"
			]
		},
        ...
    ]
}
offer_id - внутренний индификатор в giftmio
link - ссылка на карточку кампании в giftmio
traffic_url - аффилиантая ссылка для пользователя с uuid="790402d2-0406-45fb-88d0-d06a8eb520d8"
countries - страны где работает кампания, иногда мы не можем определить и там будет пустой список или “00” - это значит все страны
domains - домены кампании
2. Поиск наличие возможности кэшбэка по ссылкам - POST
https://giftmio.com/api/extension/v1/<uuid>/mass_search/ можно передать список ссылок для которых нужно найти кэшбэки и аффилиировать данные ссылки, пример:

curl --request POST \
  --url https://giftmio.com/api/extension/v1/790402d2-0406-45fb-88d0-d06a8eb520d8/mass_search/ \
  --header 'Content-Type: application/json' \
  --header 'authorization: Token <token>' \
  --data '{
	"urls": [
		"https://www.nike.sa/en/metcon-1-og/NKFQ1854-C.html",
		"https://allegro.pl/oferta/kfd-premium-creatine-500-g-kreatyna-monohydrat-zielone-jablko-15745249131"
	]
}'
В ответе для каждой ссылки мы пытаемся найти кэшбэк кампанию, параметры кампании такие же как и в каталоге, только в traffic_url еще будет диплинк на ссылку по которой шел поиск:

[
	{
		"url": "https://www.nike.sa/en/metcon-1-og/NKFQ1854-C.html",
		"offer": null
	},
	{
		"url": "https://allegro.pl/oferta/kfd-premium-creatine-500-g-kreatyna-monohydrat-zielone-jablko-15745249131",
		"offer": {
			"offer_id": "a4268fe6-5d8d-4240-a7c5-1cd7c6746597",
			"name": "Allegro",
			"image": "https://cdn.giftmio.com/offer/a5e7294bc4e2472bfc21e38c3e75afd1.gif",
			"link": "https://giftmio.com/offer/allegro/",
			"traffic_url": "https://tatrck.com/redir/clickGate.php?u=u68EH62H&p=DA76emCJ4o&m=30&url=https%3A%2F%2Fallegro.pl%2Foferta%2Fkfd-premium-creatine-500-g-kreatyna-monohydrat-zielone-jablko-15745249131&s=790402d2-0406-45fb-88d0-d06a8eb520d8",
			"cashback_size": "1.45%",
			"countries": [
				"PL"
			],
			"domains": [
				"allegro.pl"
			]
		}
	}
]
3. Узнать, зарегистрирован ли пользователь по uuid в giftmio - GET
https://giftmio.com/api/extension/v1/<uuid>/profile/:

curl --request GET \
  --url https://giftmio.com/api/extension/v1/790402d2-0406-45fb-88d0-d06a8eb520d8/profile/ \
  --header 'authorization: Token <token>'
ответ:

{
	"is_registered": true,
	"public_uuids": [
		"790402d2-0406-45fb-88d0-d06a8eb520d8"
	]
}
public_uuids - список всех uuid привязанных к аккаунту.
Для правильной атрибуции пользователей из расширения нужно передать их uuid в ссылку на регистрацию/логин в сервисе giftmio:

https://giftmio.com/sso/login/?ex_uuid=<uuid>
https://giftmio.com/sso/register/?ex_uuid=<uuid>
Например для пользователя с uuid="790402d2-0406-45fb-88d0-d06a8eb520d8" ссылки будут:

https://giftmio.com/sso/login/?ex_uuid=790402d2-0406-45fb-88d0-d06a8eb520d8
https://giftmio.com/sso/register/?ex_uuid=790402d2-0406-45fb-88d0-d06a8eb520d8
Одному пользователю в giftmio можно привязать несколько uuid, например у него на нескольких устройствах установлено расширении и там сгенерены разные uuid. Сейчас не обязательна регистрация в giftmio, даже если пользователь не зарегистрирован то мы отдаем уже аффилиатные ссылки для uuid его расширения и пользователь может делать заказы и они будут попадать на этот uuid в giftmio.

После регистрации или логина в уже существующий аккаунт мы привязываем uuid расширения к нашему аккаунту и все заказы которые были или будут сделаны по аффилиатным ссылкам с uuid расширения будут попадать в привязанный аккаунт.

Перед тем как дать ссылку на логин/регистрацию нужно запросить любой из наших апи - в этот момент происходит привязка uuid к веб-мастеру и далее мы можем определить что именно данный веб-мастер привел этого пользователя в giftmio.

Вознаграждения веб-мастера будет получать только за новые регистрации пользователей в giftmio их действия.

Для получения доступа к апи нам нужен логин веб-мастера в admitad, его площадка и должна быть подключена кампания Giftmio [Lifetime] Many GEOs.
Privacy Policy