Документация на приложението

Нови сте в ROASaurus? Започнете с ръководството. Ръководствата за настройка по платформи са в помощния център, а кратките отговори – в ЧЗВ.

Как работи ROASaurus

Улавяне. Малък скрипт във вашия магазин записва посещенията на страници, click ID от реклами и UTM параметри за посетителите, които са дали съгласие, на вашия собствен домейн.
Свързване. Когато поръчката бъде платена, ROASaurus я получава от вашия онлайн магазин и я свързва с посетителя и с кликването върху рекламата, което го е довело.
Изпращане. Покупката се изпраща от страна на сървъра към всяка рекламна платформа, която свържете, със същото ID на събитието като пиксела в браузъра, така че платформите запазват само едно копие.
Отчети. Същите поръчки, заедно с вашите разходи и разходите за реклама, се превръщат в отчети за печалба, атрибуция и пожизнена стойност.

Приложението във вашата администрация на Shopify

Приложението ROASaurus се отваря в администрацията на Shopify, без отделен вход. То има пет страници:

Начало	Списъкът за настройка, състоянието на theme app embed, уеб пиксела и вашите връзки, както и числата за последните 30 дни. Оттук новият магазин се свързва със своя акаунт в ROASaurus.
Връзки	Добавяйте, спирайте временно или премахвайте рекламните платформи, които получават вашите събития, например Meta, Google Ads, GA4, TikTok и Pinterest.
Настройка	Настройки на магазина, Shopify Markets и източници на поръчки, точка на продажба (POS) и чернови поръчки, както и скоростта на вашия магазин.
Отчети	Приходи, поръчки, разходи за реклама, MER, нетна печалба и поръчки, свързани с посещение, за 7, 30 или 90 дни, с поръчки, приходи, разходи и ROAS по канали.
План	Вашият план в ROASaurus и линк към пълното приложение, където се управляват плащанията.

Пълното приложение на app.roasaurus.com съдържа всички отчети и настройки: печалба и P&L, атрибуция, пожизнена стойност, анализ на креативите, аудитории, Ask AI и плащания. Отворете го от приложението или влезте директно.

Theme app embed и уеб пиксел

Theme app embed зарежда скрипта на ROASaurus на всяка страница на магазина. Той улавя click ID от реклами, записва ID на посетителя в количката и зарежда пикселите на вашите рекламни платформи в браузъра, след като посетителят приеме маркетинговите бисквитки. Включете го от страницата Начало на приложението, която отваря редактора на темата. Уеб пикселът се инсталира заедно с приложението и проследява стъпките при плащане и покупките.

Разрешения

Приложението иска следните разрешения в Shopify и използва всяко от тях само за посоченото:

Разрешение	Използва се за
`read_orders`	Webhooks за поръчки, печалба и атрибуция.
`read_customers`	Състоянието на съгласието на клиента и клиентски сегменти за аудитории.
`write_pixels, read_customer_events`	Инсталира и стартира уеб пиксела на ROASaurus при плащане.
`read_products, read_inventory`	Разходи за продукти и планове за зареждане.
`read_shopify_payments_disputes`	Чарджбекове в отчетите за печалба.
`read_reports`	Разходи за етикети за доставка от Shopify Shipping.
`read_markets, read_locations`	Пиксели по Market и локации на точки на продажба.

ROASaurus следва настройките за поверителност на клиентите на магазина. Посетител, който откаже маркетинговите бисквитки, не получава ID на посетител и събитията от браузъра му не се изпращат към рекламните платформи. Имената, имейлите, телефонните номера и адресите се хешират със SHA-256, преди да бъдат изпратени към рекламна платформа. Подробности има в ръководството за съгласие, политиката за поверителност и споразумението за обработване на данни.

Деинсталиране

Когато деинсталирате приложението, ROASaurus изтрива своите токени за достъп до вашия магазин и спира изпращането на събития, които все още са били в опашката. 48 часа по-късно, когато Shopify изпрати заявката си за заличаване на данните на магазина, всички записи за магазина се изтриват. Заявките на вашите клиенти да видят или изтрият данните си достигат до ROASaurus чрез compliance webhooks на Shopify и се обработват автоматично.

Други онлайн магазини

ROASaurus работи също с WooCommerce (чрез плъгин), Wix, BigCommerce, Magento, PrestaShop, Shopware, Lightspeed, CCV Shop, Squarespace и Ecwid, както и с всеки бекенд чрез API за поръчки. Вижте помощния център за всяка от тях.

За разработчици

REST API чете отчети и изпраща поръчки и събития с ключ с ограничени права. Webhooks, експортите към хранилище за данни и MCP сървърът за AI клиенти са описани на страниците с функции.

Поддръжка

Пишете на hello@roasaurus.com. Как защитаваме вашите данни, е описано на страницата за сигурност; какво е променено наскоро, ще намерите в списъка с промени.