APIs Trosi
Adroddwch eich nodau i Meta, LinkedIn, TikTok a Google Ads o’n gweinydd yn lle’r porwr – wedi’u paru drwy’r dynodwr clic a osododd y rhwydwaith ei hun yn unig.
1. Pam ar Ochr y Gweinydd o Gwbl?
Mae’n rhaid i bicsel porwr oroesi tri pheth cyn gallu adrodd trosiad: atalydd hysbysebion, gosodiad atal tracio a’r ymwelydd yn cau’r tab cyn i’r picsel danio. Mae galwad ar ochr y gweinydd yn goroesi’r tri, gan nad yw’n digwydd yn y porwr o gwbl.
Mae MousePlayer eisoes yn gwybod pryd y cyrhaeddwyd un o’ch nodau – dyna ddiben nodau. Mae’r APIs Trosi yn syml yn anfon y ffaith honno ymlaen i’r rhwydwaith hysbysebu o’n gweinydd.
Nid yw hyn yn disodli eich picsel. Cadwch ef. Mae pob rhwydwaith yn dad-ddyblygu’r ddau yn erbyn ei gilydd, ac rydym yn anfon y dynodwyr sydd eu hangen ar gyfer hynny.
2. Beth Rydym yn Ei Anfon – a Beth Nad Ydym Byth yn Ei Anfon
Yr unig beth sy’n adnabod yr ymwelydd yn y galwadau hyn yw’r cwci neu ddynodwr clic a osododd y rhwydwaith ei hun. Nid oes dim arall am y person yn gadael ein gweinydd.
| Rhwydwaith | Dynodwr a ddefnyddir | O ble mae’n dod |
|---|---|---|
| Meta | _fbp, _fbc | Cwcis parti cyntaf a osodir gan y picsel Meta |
li_fat_id | Cwci parti cyntaf a osodir gan LinkedIn Insight Tag | |
| TikTok | _ttp, ttclid | _ttp yw cwci, ttclid sy’n dod o URL y clic hysbyseb |
| Google Ads | gclid, wbraid, gbraid | O URL y clic hysbyseb, neu’r cwci _gcl_aw wedyn |
| Microsoft Advertising | msclkid | O URL y clic hysbyseb, neu’r cwci _uetmsclkid y mae tag UET yn ei ysgrifennu |
Ni anfonir byth: cyfeiriad e-bost, rhif ffôn, enw na chyfeiriad IP – hyd yn oed wedi’i stwnsio. Os nad oes dynodwr clic gan ymwelydd, ni anfonir dim o gwbl. Mae trosiad heb ei dargedu’n werth llai i chi na chyfrif cywir.
Dim Ond gyda Chydsyniad
Mae pob un o’r galwadau hyn y tu ôl i’r un porth cydsynio â’r recordiad ei hun. Nid yw sesiwn heb gydsyniad yn cynhyrchu adroddiad trosi, waeth beth fo’r switsh yng ngosodiadau eich prosiect.
3. Mae Gan Google Ads Dri Dynodwr, Nid Un
Mae hyn yn synnu pobl, felly mae’n werth ei nodi’n glir. Mae Google yn defnyddio gclid ar gyfer un clic hysbyseb. Pan fydd atal tracio Apple yn gwneud un clic yn amhosibl ei briodoli, mae Google yn anfon wbraid neu gbraid yn lle hynny, sy’n cynrychioli grŵp o gliciau.
Dim ond un o’r tri a ganiateir – mae Google yn gwrthod trosiad sy’n cynnwys dau. Rydym yn anfon un yn union, ac mae gclid yn ennill pan fo mwy nag un yn bresennol, gan mai hwnnw yw’r mwyaf manwl.
Dim Ond Unwaith Maent yn yr URL
Dim ond ar y dudalen gyntaf ar ôl y clic hysbyseb mae’r dynodwr yn ymddangos yn y cyfeiriad. Yna mae tag Google yn ei storio yn y cwci _gcl_aw. Rydym yn darllen y cwci wrth gefn – hebddo ni fyddai trosiad ar drydedd dudalen yr ymweliad yn canfod dynodwr o gwbl.
4. Ei Osod
Meta, LinkedIn a TikTok
Dau faes yr un: ID y picsel neu’r rheol drosi, a thocyn mynediad rydych yn ei greu yn rhyngwyneb y rhwydwaith ei hun. Cedwir y ddau wedi’u hamgryptio ag AES-256-GCM ac ni chânt eu dangos eto ar ôl cadw.
Mae Angen Chwech ar Google Ads
Google yw’r eithriad, ac mae’n werth gwybod y rheswm cyn dechrau: yn wahanol i’r tri arall, nid yw Google yn rhoi tocyn mynediad syml. Mae mynediad drwy OAuth gyda thocyn adnewyddu, ac mae’r Ads API hefyd yn mynnu tocyn datblygwr.
| Maes | Ble i’w Ganfod |
|---|---|
| ID Cwsmer | Ar y dde uchaf yn Google Ads. Digidau yn unig, heb y cysylltnodau. |
| ID Gweithred Drosi | Nodau a throsiadau, yna’r weithred rydych am gofnodi hyn arni. |
| Tocyn Datblygwr | Eich cyfrif rheolwr Google Ads, API Center. |
| ID a chyfrinach cleient OAuth | Google Cloud Console, Credentials, cleient OAuth o’r math ‘desktop app’. |
| Tocyn Adnewyddu | Rydych yn cynhyrchu hwn eich hun unwaith ar gyfer y cwmpas adwords. |
Mae Dau Lwybr gan LinkedIn, a’r Un Byr Sydd Ei Eisiau Arnoch
Yn Campaign Manager: Data, Signals Manager, Direct API, Generate access token. Dyna’r llwybr ar gyfer hysbysebwyr sy’n anfon eu data eu hunain – dim rhaglen ddatblygwr, dim adolygiad. Nid yw’r tocyn yn dod i ben, ac ni fydd Campaign Manager yn ei ddangos ailwaith, felly copïwch ef ar unwaith.
Mae’r llwybr arall, ap datblygwr y gofynnir amdano drwy Developer Portal LinkedIn, ar gyfer platfformau sy’n anfon ar ran llawer o hysbysebwyr. Mae angen dilysu tudalen cwmni ac achos defnydd wedi’i gymeradwyo arno, ac nid oes angen dim ohono yma.
Microsoft Advertising Yw’r Un Hawdd
Ar ôl Google Ads rydych yn disgwyl yr un baich – OAuth, tocyn datblygwr, cam cymeradwyo. I’r gwrthwyneb: dau faes. Yr ID tag UET rydych eisoes yn ei ddefnyddio yn y porwr, a thocyn rydych yn ei gopïo o Microsoft Advertising o dan y tag UET, ‘Use Conversions API’, ‘Copy Token’. Dim i wneud cais amdano.
Defnyddiwch yr un ID tag â’ch tag porwr. Dyna sy’n gadael i Microsoft adnabod y digwyddiad ar ochr y gweinydd a’r digwyddiad porwr fel un trosiad yn lle dau.
Mae Angen Cymeradwyaeth Google ar y Tocyn Datblygwr (‘Basic access’), ac mae hynny’n cymryd ychydig ddyddiau. Dyma’r un cam na allwch ei orffen mewn munud, felly dechreuwch ef yn gyntaf. Nid ydym byth yn gweld eich cyfrinair Google – dim ond y tocyn adnewyddu, a gallwch ei ddirymu ar unrhyw adeg.
5. Pryd yr Adroddir Trosiad
Unwaith yn union fesul nod a sesiwn. Mae MousePlayer yn dileu dyblygu cyn i’r alwad fynd allan, ac mae’r llwyth hefyd yn cynnwys ID fel y gall y rhwydwaith ddileu dyblygu eilwaith ar ei ochr. Mae ymwelydd sy’n ychwanegu pum eitem at y fasged yn cynhyrchu un trosiad, nid pump.
Beth Fyddwch yn Ei Weld yn Eich Cyfrif Hysbysebu
Mae’r trosiad yn cynnwys enw eich nod, ei werth a’i arian cyfred os ydych wedi gosod un, a’r amser y digwyddodd. Mae’n cyrraedd o fewn munud dan weithrediad arferol.
Os Nad Oes Dim yn Cyrraedd
- Dim dynodwr clic. Ni ddaeth yr ymwelydd drwy hysbyseb o’r rhwydwaith hwnnw, neu cyrhaeddodd cyn i’r picsel osod ei gwci. Ni anfonir dim – disgwylir hyn, nid gwall ydyw.
- Dim cydsyniad. Daeth y porth yn gyntaf.
- Derbyniodd y rhwydwaith yr alwad ond gwrthododd y trosiad. Mae Google, TikTok a sawl un arall yn ateb gyda HTTP 200 a gwall y tu mewn i gorff yr ymateb. Rydym yn darllen y corff, nid dim ond y statws, ac mae’r rheswm yn ymddangos yn y log danfon.
Mae pob nod masnach a enwir yma yn perthyn i’w berchennog priodol. Nid oes gan MousePlayer berthynas fusnes â’r darparwyr hyn.