Хөрвүүлэлтийн API-ууд

Зорилгуудаа хөтчөөс бус, манай серверээс Meta, LinkedIn, TikTok болон Google Ads руу мэдээлнэ үү. Зөвхөн тухайн сүлжээний өөрийн тохируулсан товшилтын танигчаар тааруулна.

1. Яагаад сервер талаас гэж?

Хөтчийн пиксел хөрвүүлэлт мэдээлэхээсээ өмнө гурван зүйлийг давах ёстой: зар хориглогч, хяналтаас сэргийлэх тохиргоо, мөн пиксел ажиллахаас өмнө зочин табаа хаах. Сервер талын дуудлага хөтөч дотор огт явагддаггүй тул гурвууланг давдаг.

MousePlayer таны аль нэг зорилгод хүрснийг аль хэдийн мэддэг. Зорилго үүнд зориулагдсан. Хөрвүүлэлтийн API-ууд тэр баримтыг манай серверээс зар сурталчилгааны сүлжээ рүү л дамжуулна.

Энэ нь таны пикселийг орлохгүй. Хэвээр үлдээнэ үү. Сүлжээ бүр хоёр эх үүсвэрийн давхардлыг арилгадаг бөгөөд бид үүнд хэрэгтэй танигчдыг илгээдэг.

2. Бид юу илгээдэг, юуг хэзээ ч илгээдэггүй вэ

Эдгээр дуудлагад зочныг таних цорын ганц зүйл нь сүлжээний өөрийн тохируулсан cookie эсвэл товшилтын танигч юм. Тухайн хүний тухай өөр юу ч манай серверээс гарахгүй.

СүлжээАшиглах танигчХаанаас ирэх вэ
Meta_fbp, _fbcMeta пикселийн тохируулсан нэгдүгээр талын cookie-ууд
LinkedInli_fat_idLinkedIn Insight Tag-ийн тохируулсан нэгдүгээр талын cookie
TikTok_ttp, ttclid_ttp нь cookie, ttclid нь зарын товшилтын URL-ээс ирнэ
Google Adsgclid, wbraid, gbraidЗарын товшилтын URL-ээс, эсвэл дараа нь _gcl_aw cookie-оос
Microsoft AdvertisingmsclkidЗарын товшилтын URL-ээс, эсвэл UET шошгын бичсэн _uetmsclkid cookie-оос

Хэзээ ч илгээхгүй: цахим шуудангийн хаяг, утасны дугаар, нэр эсвэл IP хаяг — хэшлэсэн хэлбэрээр ч илгээхгүй. Зочинд товшилтын танигч байхгүй бол юу ч илгээхгүй. Тааруулах боломжгүй хөрвүүлэлт нь танд үнэн зөв тооллогоос бага үнэ цэнтэй.

Зөвхөн зөвшөөрөлтэй

Эдгээр дуудлага бүр бичлэгтэй ижил зөвшөөрлийн хаалганы цаана байна. Зөвшөөрөлгүй сеанс төслийн тохиргооны унтраалгаас үл хамааран хөрвүүлэлтийн тайлан үүсгэхгүй.

3. Google Ads нэг бус, гурван танигчтай

Энэ нь хүмүүсийг гайхшруулдаг тул шууд тайлбарлая. Google нэг зарын товшилтод gclid ашигладаг. Apple-ийн хяналтаас сэргийлэх хамгаалалт нэг товшилтыг хамааруулах боломжгүй болговол Google оронд нь wbraid эсвэл gbraid илгээдэг бөгөөд эдгээр нь товшилтын бүлгийг илэрхийлнэ.

Гурвыг зэрэг ашиглах боломжгүй. Хоёрыг агуулсан хөрвүүлэлтийг Google татгалздаг. Бид яг нэгийг илгээдэг бөгөөд хэд хэд байвал gclid хамгийн нарийн тул давуу эрхтэй.

URL-д зөвхөн нэг удаа байна

Танигч зар дээр товшсоны дараах зөвхөн эхний хуудасны хаягт харагдана. Дараа нь Google шошго үүнийг _gcl_aw cookie-д хадгална. Бид cookie-г нөөц эх сурвалжаар уншдаг. Үүнгүйгээр зочлолтын гурав дахь хуудсан дахь хөрвүүлэлт ямар ч танигч олохгүй.

4. Тохируулах

Meta, LinkedIn болон TikTok

Тус бүр хоёр талбартай: пиксел эсвэл хөрвүүлэлтийн дүрмийн ID, сүлжээний өөрийн интерфэйст үүсгэх хандалтын токен. Хоёуланг AES-256-GCM-ээр шифрлэж хадгалах бөгөөд хадгалсны дараа дахин харуулахгүй.

Google Ads-д зургаа хэрэгтэй

Google онцгой бөгөөд шалтгааныг эхлэхээсээ өмнө мэдвэл зохино: нөгөө гурваас ялгаатай нь Google энгийн хандалтын токен олгодоггүй. Хандалт OAuth болон шинэчлэх токеноор явагдаж, Ads API нэмэлтээр дараахыг шаарддаг: хөгжүүлэгчийн токен.

ТалбарХаанаас олох вэ
Харилцагчийн IDGoogle Ads-ийн баруун дээд хэсэгт. Зөвхөн цифр, зураасгүй.
Хөрвүүлэлтийн үйлдлийн IDЗорилго болон хөрвүүлэлтүүдээс, дараа нь үүнийг тооцохыг хүссэн үйлдлээс.
Хөгжүүлэгчийн токенТаны Google Ads менежер бүртгэлийн API Center.
OAuth хэрэглэгчийн ID ба нууцGoogle Cloud Console, Credentials, «desktop app» төрлийн OAuth хэрэглэгч.
Шинэчлэх токенТа үүнийг дараах хамрах хүрээнд нэг удаа өөрөө үүсгэнэ: adwords.

LinkedIn хоёр замтай бөгөөд богино нь танд хэрэгтэй

Campaign Manager дотор: Data, Signals Manager, Direct API, Generate access token. Энэ нь өөрийн өгөгдлөө илгээдэг зар сурталчилгаа явуулагчдын зам юм. Хөгжүүлэгчийн апп, хянан батлах үйл явц хэрэггүй. Токены хугацаа дуусахгүй бөгөөд Campaign Manager хоёр дахь удаа харуулахгүй тул шууд хуулж авна уу.

Нөгөө зам нь LinkedIn Developer Portal-аар хүсдэг хөгжүүлэгчийн апп бөгөөд олон зар сурталчилгаа явуулагчийн өмнөөс илгээдэг платформуудад зориулагдсан. Компанийн хуудсыг баталгаажуулах, зөвшөөрсөн хэрэглээний тохиолдол шаарддаг. Энд эдгээрийн аль нь ч хэрэггүй.

Microsoft Advertising бол хялбар нь

Google Ads-ийн дараа OAuth, хөгжүүлэгчийн токен, зөвшөөрөх алхам гэсэн ижил төвөгтэйг хүлээж магадгүй. Харин эсрэгээрээ: хоёр талбар. Хөтчид аль хэдийн ашигладаг UET шошгын ID, мөн Microsoft Advertising-ийн UET шошгоны «Use Conversions API», «Copy Token»-оос хуулах токен. Хүсэлт гаргах зүйлгүй.

Хөтчийн шошготойгоо ижил шошгын ID ашиглана уу. Ингэснээр Microsoft сервер талын болон хөтчийн үйл явдлыг хоёр бус, нэг хөрвүүлэлт гэж танина.

Хөгжүүлэгчийн токенд Google-ийн зөвшөөрөл хэрэгтэй («Basic access») бөгөөд хэдэн өдөр шаардагдана. Энэ нь нэг минутад дуусгаж болохгүй цорын ганц алхам тул эхлээд эхлүүлнэ үү. Бид Google нууц үгийг тань хэзээ ч харахгүй. Зөвхөн шинэчлэх токен хардаг бөгөөд та хүссэн үедээ хүчингүй болгож болно.

5. Хөрвүүлэлтийг хэзээ мэдээлэх вэ

Зорилго болон сеанс бүрд яг нэг удаа. MousePlayer дуудлага илгээхээс өмнө давхардлыг арилгана. Өгөгдөл нэмэлт ID агуулдаг тул сүлжээ өөрийн талд дахин давхардлыг арилгаж болно. Сагсанд таван бараа нэмсэн зочин тав бус, нэг хөрвүүлэлт үүсгэнэ.

Зарын бүртгэлдээ юу харах вэ

Хөрвүүлэлт нь таны зорилгын нэр, тохируулсан бол үнэ цэн болон валют, мөн болсон цагийг агуулна. Ердийн ажиллагаанд нэг минутын дотор ирнэ.

Юу ч ирэхгүй бол

  • Товшилтын танигчгүй. Зочин тухайн сүлжээний зараар ирээгүй эсвэл пиксел cookie тохируулахаас өмнө ирсэн. Юу ч илгээхгүй. Энэ нь алдаа бус, хэвийн байдал.
  • Зөвшөөрөлгүй. Хаалга түрүүлж үйлчилсэн.
  • Сүлжээ дуудлагыг хүлээж авсан ч хөрвүүлэлтийг татгалзсан. Google, TikTok болон бусад хэд хэдэн сүлжээ HTTP 200 гэж хариулаад хариуны биед алдаа оруулдаг. Бид зөвхөн төлөв бус, биеийг уншдаг бөгөөд шалтгаан нь дамжуулалтын бүртгэлд харагдана.

Энд нэрлэсэн бүх худалдааны тэмдэг тус тусын эзэмшигчид харьяалагдана. MousePlayer эдгээр үйлчилгээ үзүүлэгчтэй бизнесийн харилцаагүй.