Reklāmguvumu API

1. Kāpēc vispār izmantot servera pusi?

Lai pārlūka pikselis varētu paziņot par reklāmguvumu, tam vispirms jāiztur trīs šķēršļi: reklāmu bloķētājs, izsekošanas novēršanas iestatījums un apmeklētājs, kurš aizver cilni pirms pikseļa nostrādes. Servera puses izsaukums iztur visus trīs, jo tas nemaz nenotiek pārlūkā.

MousePlayer jau zina, kad sasniegts kāds no jūsu mērķiem — tam mērķi ir paredzēti. Reklāmguvumu API vienkārši pārsūta šo faktu no mūsu servera uz reklāmas tīklu.

2. Ko nosūtām un ko nekad nesūtām

Vienīgais, kas šajos izsaukumos identificē apmeklētāju, ir sīkdatne vai klikšķa identifikators, ko iestatījis pats tīkls. Nekas cits par personu neatstāj mūsu serveri.

Tīkls	Izmantotais identifikators	Tā avots
Meta	_fbp, _fbc	Pirmās puses sīkdatnes, ko iestatījis Meta pikselis
LinkedIn	li_fat_id	Pirmās puses sīkdatne, ko iestatījis LinkedIn Insight Tag
TikTok	_ttp, ttclid	_ttp ir sīkdatne, ttclid nāk no reklāmas klikšķa URL
Google Ads	gclid, wbraid, gbraid	No reklāmas klikšķa URL vai vēlāk no _gcl_aw sīkdatnes
Microsoft Advertising	msclkid	No reklāmas klikšķa URL vai no _uetmsclkid sīkdatnes, ko ieraksta UET tags

Tikai ar piekrišanu

Katram no šiem izsaukumiem piemēro to pašu piekrišanas pārbaudi kā pašai ierakstīšanai. Sesija bez piekrišanas nerada reklāmguvuma paziņojumu neatkarīgi no slēdža jūsu projekta iestatījumos.

3. Google Ads ir trīs identifikatori, nevis viens

Tas cilvēkus pārsteidz, tāpēc to ir vērts pateikt skaidri. Google izmanto gclid vienam reklāmas klikšķim. Ja Apple izsekošanas novēršana neļauj attiecināt atsevišķu klikšķi, Google tā vietā nosūta wbraid vai gbraid, kas apzīmē klikšķu grupu.

Šie trīs ir savstarpēji izslēdzoši — Google noraida reklāmguvumu ar diviem identifikatoriem. Nosūtām tieši vienu, un gclid ir prioritārs, ja ir vairāki, jo tas ir visprecīzākais.

URL tie ir tikai vienu reizi

Identifikators adresē parādās tikai pirmajā lapā pēc reklāmas klikšķa. Pēc tam Google tags to saglabā _gcl_aw sīkdatnē. Mēs nolasām sīkdatni kā rezerves variantu — bez tās reklāmguvumam apmeklējuma trešajā lapā nebūtu atrodams neviens identifikators.

4. Iestatīšana

Meta, LinkedIn un TikTok

Katram divi lauki: pikseļa vai reklāmguvuma kārtulas ID un piekļuves žetons, ko izveidojat paša tīkla saskarnē. Abi tiek glabāti šifrēti ar AES-256-GCM un pēc saglabāšanas vairs netiek parādīti.

Google Ads vajadzīgi seši

Google ir izņēmums, un iemeslu vērts zināt pirms sākšanas: atšķirībā no pārējiem trim Google neizsniedz vienkāršu piekļuves žetonu. Piekļuve notiek caur OAuth ar atsvaidzināšanas žetonu, un Ads API papildus prasa izstrādātāja žetonu.

Lauks	Kur to atrast
Klienta ID	Google Ads augšējā labajā stūrī. Tikai cipari, bez defisēm.
Reklāmguvuma darbības ID	Sadaļā Mērķi un reklāmguvumi, pēc tam darbība, kurai to vēlaties uzskaitīt.
Izstrādātāja žetons	Jūsu Google Ads pārziņa konta API centrā.
OAuth klienta ID un noslēpums	Google Cloud Console, Piekļuves dati, OAuth klients ar tipu „darbvirsmas lietotne“.
Atsvaidzināšanas žetons	To vienreiz ģenerējat paši tvērumam adwords.

LinkedIn ir divi ceļi, un jums vajag īso

Campaign Manager sadaļā: Dati, Signālu pārvaldnieks, Tiešais API, Ģenerēt piekļuves žetonu. Tas ir ceļš reklāmdevējiem, kuri sūta savus datus, — bez izstrādātāja lietotnes un pārskatīšanas. Žetonam nav derīguma termiņa, un Campaign Manager to otrreiz neparādīs, tāpēc nokopējiet to uzreiz.

Otrs ceļš — izstrādātāja lietotne, ko piesaka LinkedIn Developer Portal, — pastāv platformām, kas sūta datus daudzu reklāmdevēju vārdā. Tam vajadzīga uzņēmuma lapas pārbaude un apstiprināts lietojuma gadījums, un šeit nekas no tā nav nepieciešams.

Microsoft Advertising iestatīšana ir vienkārša

Pēc Google Ads sagaidāt tādu pašu sarežģītību — OAuth, izstrādātāja žetonu, apstiprināšanu. Ir pretēji: divi lauki. UET taga ID, ko jau izmantojat pārlūkā, un žetons, ko nokopējat Microsoft Advertising sadaļā zem UET taga, „Izmantot Conversions API“, „Kopēt žetonu“. Nekas nav jāpiesaka.

Izmantojiet to pašu taga ID kā pārlūka tagam. Tas ļauj Microsoft atpazīt servera puses notikumu un pārlūka notikumu kā vienu reklāmguvumu, nevis divus.

5. Kad tiek ziņots par reklāmguvumu

Tieši vienu reizi katram mērķim un sesijai. MousePlayer novērš atkārtošanos pirms izsaukuma nosūtīšanas, un nosūtāmajos datos papildus ir ID, lai tīkls varētu atkārtoti novērst dublikātus savā pusē. Apmeklētājs, kas pievieno grozam piecas preces, rada vienu reklāmguvumu, nevis piecus.

Ko redzēsiet savā reklāmu kontā

Reklāmguvums ietver jūsu mērķa nosaukumu, tā vērtību un valūtu, ja tā ir iestatīta, un notikuma laiku. Parastā darbībā tas pienāk minūtes laikā.

Ja nekas nepienāk

• Nav klikšķa identifikatora. Apmeklētājs neatnāca caur šā tīkla reklāmu vai ieradās, pirms pikselis iestatīja sīkdatni. Nekas netiek nosūtīts — tā ir paredzētā darbība, nevis kļūda.
• Nav piekrišanas. Vispirms nostrādāja piekrišanas pārbaude.
• Tīkls pieņēma izsaukumu, bet noraidīja reklāmguvumu. Google, TikTok un vairāki citi atbild ar HTTP 200 un kļūdu atbildes saturā. Mēs nolasām saturu, nevis tikai statusu, un iemesls parādās piegādes žurnālā.