Prebid.js Razılıq İdarəetməsi: Naşirlər üçün Header Bidding Quraşdırma Təlimatı
Header bidding, tələb tərəfdaşlarının paralel rəqabət apararaq naşirlərin CPM-lərini artırır — lakin bu tərəfdaşların hər biri kukiləri yerləşdirməzdən, barmaq izi götürməzdən və ya piksel işə salmadan əvvəl etibarlı razılıq siqnalına ehtiyac duyur. Onlarla min sayt tərəfindən istifadə edilən faktiki açıq mənbəli header bidding sarğısı olan Prebid.js, CMP-nizi hər auksiona bağlayan Razılıq İdarəetmə moduluyla gəlir. Onu səhv konfiqurasiya etsəniz ya razılıq almadan məlumat sızdırarsınız (tənzimləyici risk) ya da hərracçıları onlara lazım olan siqnaldan məhrum edərsiniz (gəlir riski). Bu təlimat naşirləri istehsal səviyyəsindəki quraşdırma prosesindən keçirir.
Niyə Prebid.js Razılıq İdarəetmə Moduluna Ehtiyac Duyur
Prebid.js auksiyonu işə düşəndə sarğı konfiqurasiya edilmiş hər hərracçı adapterinə paralel sorğular göndərir. Hər adapter təklif sorğusuna istifadəçinin razılıq sətirini daxil etməlidir — tcfeu (AB/Böyük Britaniya üçün TCF v2.2), usp (CCPA/CPRA) və getdikcə daha çox gpp (bir neçə ABŞ əyalətini əhatə edən IAB Global Privacy Platform sətri). Bu siqnallar olmadan, aşağı axımdakı SSP-lər və DSP-lər ya istifadəçini imtina etmiş kimi qəbul etməli, ya da təklifi tamamilə rədd etməli, ya da — ən pis halda — məlumatları qeyri-qanuni emal etməlidir.
Prebid Razılıq İdarəetmə modulu CMP-niz ilə təklif sorğusu boru kəməri arasında yerləşir. Standart CMP API-ni çağırır (__tcfapi, __uspapi, __gppapi), razılıq sətirini gözləyir və sonra onu avtomatik olaraq hər adapterin təklif sorğusu yüküne yeridır. Həmçinin GDPR tətbiqini aktivləşdirdiyiniz zaman məqsədə əsaslanan keçid nöqtələrini tətbiq edir, müvafiq TCF məqsədlərini qazanmayan istifadəçilər üçün yaddaşa giriş və hərracçı icrasını bloklayır.
Əsas Modulu Quraşdırma və Konfiqurasiya
Prebid.js hər naşir üçün docs.prebid.org/download.html saytından hazırlanır. Xüsusi qurmanızı yaratdığınız zaman "Razılıq İdarəetməsi" altındakı üç modul əhəmiyyət daşıyır:
- consentManagementTcf — AB, Böyük Britaniya və İsveçrə trafikinin TCF v2.2 sətirlərini idarə edir.
- consentManagementUsp — köhnə CCPA/CPRA ABŞ Məxfilik Sətirini idarə edir (hələ də bir çox DSP tərəfindən tələb olunur).
- consentManagementGpp — IAB GPP sətirini idarə edir, Google, TTD və əsas SSP-lər tərəfindən indi tələb olunan irəliyə baxan standart.
Qlobal trafik xidmət göstərirsinizsə, üçünü də daxil edin. Qurma CDN-ə çatdıqdan sonra Prebid quraşdırma skriptinizdə modulları konfiqurasiya edin:
TCF v2.2 konfiqurasiyası
TCF bloku Prebid-ə hansı CMP API-ni çağıracağını, sətir üçün nə qədər gözləyəcəyini və zaman aşımında nə edəcəyini bildirir. Tipik istehsal konfiqurasiyası cmpApi: 'iab', timeout: 8000 (8 saniyə — yavaş CMP banner yüklənməsi üçün kifayət qədər uzun) və defaultGdprScope: true qoyur ki, naməlum yurisdiksiyalardakı istifadəçilər əksi sübuta qədər əhatə daxilindəki kimi qəbul edilsin. actionTimeout-u ayrıca tənzimləmək, istifadəçi bannerlə hələ qarşılıqlı əlaqəyə girməyəndə Prebid-in nə qədər gözlədiyini idarə edir — onu mülayim saxlamaq, ziyarətçi banneri nəzərə almadıqda boş bir reklam yuvası yaranmasının qarşısını alır.
ABŞ Məxfiliyi və GPP
USP sadədir: modulu aktivləşdirin və Prebid __uspapi-dən dörd simvollu sətri oxuyur. GPP daha incədir, çünki GPP sətri çoxsaylı bölmə ID-lərini daşıya bilər (TCF EU, US National, US California, US Colorado, US Virginia və s.). Prebid tam sətiri avtomatik ötürür, lakin hərracçılar xüsusi bölmələri yoxlayır. CMP-nizin hər istifadəçinin yurisdiksiyas üçün düzgün GPP bölmələrini yaydığından əmin olun — Kaliforniyalı bir istifadəçiyə yalnız US National bölməsini yaradan səhv konfiqurasiya edilmiş CMP, CPRA-uyğun DSP-lərin təklifi rədd etməsinə səbəb olacaq.
GDPR Tətbiqini Aktivləşdirmə (Məqsədə Əsaslanan Keçid Nöqtələri)
Defolt olaraq, razılıq modulu TCF sətirini ötürür lakin heç nəyi bloklamır. Prebid-in TCF məqsədlərini faktiki olaraq tətbiq etməsi üçün gdprEnforcement qayda dəstini aktivləşdirin. Çox sayda quraşdırma səhvinin baş verdiyi yer buradır — və uyğun ilə uyğun olmayan header bidding yığımı arasındakı fərqin yaşandığı yer.
Standart qayda dəsti müvafiq məqsəddə razılıq olmadıqda dörd fəaliyyəti bloklayır:
- storage — Məqsəd 1-ə (saxlama və giriş) bağlıdır. Rədd edildikdə, Prebid hərracçıların kuki və localStorage-a oxumasını və yazmasını qarşısını alır.
- basicAds — Məqsəd 2-yə (əsas reklamlar) bağlıdır. Rədd edildikdə, hərracçı auksiondan tamamilə çıxarılır.
- measurement — Məqsəd 7-yə bağlıdır. Analitika adapterlərinə təsir edir.
- transmitPreciseGeo — Xüsusi Xüsusiyyət 1-ə bağlıdır. Rədd edildikdə, Prebid təklif sorğularından dəqiq coğrafi məlumatı çıxarır.
Hər qaydada enforcePurpose: true, enforceVendor: true və vendorExceptions siyahısını qoyursunuz. Satıcı istisnaları siyahısı kritikdir: siyahıya aldığınız hər hərracçının açıq TCF satıcı razılığı olmadan belə iştirak etməsinə icazə verilir, ayrıca hüquqi əsasınız olduğu əsasında (məsələn, müqavilə axınıyla birləşdirilmiş qanuni maraq). Bunu az istifadin — həddindən artıq geniş istisnalar, tənzimləyicilərin naşirləri cərimələməyə başladığı tam nümunədir.
Naşirlərə Gəlir və ya Uyğunluğa Başa Gələn Ümumi Tələlər
Zaman aşımı çox az qoyulub
timeout CMP-nin banner render vaxtından qısa olarsa, Prebid heç bir razılıq sətiri olmadan davam edir. Hərracçılar bunu razılıq yoxluğu kimi qəbul edir və təklifi rədd edir. CMP-nin tcfapi('addEventListener') ilk çağırış gecikməsini 95-ci persentildə ölçün və Prebid zaman aşımını onun üzərindəki dəyərə qoyun. 8000 ms təhlükəsiz bir defoltdur; 3000 ms, bannerlərin lokallaşdırılması üçün vaxt tələb etdiyi bazalara xidmət edirsinizsə risklidir.
ABŞ trafikində GPP inteqrasiyasının olmaması
Əsas SSP-lər və DSP-lər (Google AdX, TTD, Magnite, PubMatic) artıq ABŞ imtina tətbiqi üçün GPP sətiri tələb edir. Yalnız köhnə USP sətiri yayırsınızsa, bu DSP-lər inventarınızı getdikcə daha çox endirimli qiymətləndirəcək və ya atlayacaq. Təklif cavablarınızı yoxlayın: 2026-cı ildə ABŞ trafikindəki kəskin CPM düşüşü çox vaxt itkin GPP siqnalıdır.
SPA naviqasiyasında köhnə razılıq sətirləri
Marşrut dəyişikliklərindəki Prebid auksionlarını yenidən tetikleyen tək-səhifəli proqramlar pbjs.refreshUserIds() çağırmalı və ən son TCF sətirinin gətirilməsini təmin etməlidir. Önbelleğe alınmış 30 dəqiqəlik köhnə bir sətir saytınız paylaşılan sessiyalardan istifadə edirsə əvvəlki istifadəçinin seçimlərini daşıya bilər.
Analitika üçün vendorExceptions-ın olmaması
Naşirlər çox vaxt Prebid Analytics adapterlərinin (Google Analytics, server tərəfli hesabat) TCF Məqsədi 7 altında measurement keçidine tabe olduğunu unudur. Gəlir hesabatları üçün bunlara etibar edirsinizsə, onları ölçmə qaydasının satıcı istisnaları altında açıq şəkildə siyahıya alın və ya razılıq olmayan trafikdəki məlumat boşluğunu qəbul edin.
İstehsaldan Əvvəl Quraşdırmanızı Test Etmə
Prebid.js brauzer konsolunda pbjs.getConfig('consentManagement')-i ortaya qoyur. Aktiv konfiqurasiyasının niyyətinizlə uyğunlaşdığını yoxlayın. Sonra hər təklif sorğusuna əlavə edilmiş razılıq sətirini yoxlamaq üçün Chrome Prebid.js Professor genişləndirilməsini və ya pbjs.getEvents()-i istifadə edin. Üç ssenarini yoxlayın: tam razılıq vermiş istifadəçi, "Hamısını Rədd Et" düyməsini sıxmış istifadəçi və bannerlə əlaqə qurmadan onu bağlamış istifadəçi. Hər biri təklif sorğusu yükündə fərqli müşahidə edilə bilən davranış əmələ gətirməlidir.
VPN və ya CMP-nin coğrafi konum ləğv bayrağından istifadə edərək coğrafi ərazilərdə eyni yoxlamaları aparın. AB trafikinin TCF sətiri verməsi və gdprEnforcement-i tetiklemesi gərəkdir; Kaliforniya trafikinin USP və GPP sətiri verməsi gərəkdir; yurisdiksiyadan bilinməyən trafikinin defaultGdprScope parametrinizə hörmət etməsi gərəkdir.
Hər Şeyi Bir Yerə Gətirmək
Düzgün konfigurasiya edilmiş Prebid Razılıq İdarəetmə yığımı eyni anda üç şey edir: hərracçılarınızı etibarlı razılıq siqnallarıyla təmin edir (CPM-ləri qoruyaraq), sarğı səviyyəsindəki TCF və ABŞ imtina qaydalarını tətbiq edir (tənzimləyici riskin azaldılması) və tənzimləyici header bidding quraşdırmanızın istifadəçi seçiminə necə hörmət etdiyini soruşanda sizə tək audit nöqtəsi verir. Zaman aşımlarını düşünərək tənzimləmək, ABŞ trafikinin yanında USP ilə birlikdə GPP-ni aktivləşdirmək, rüblük vendorExceptions siyahınızı nəzərdən keçirmək üçün vaxt ayırın — bunu yanlış almanın dəyəri həm cərimələrlə, həm də itirilmiş proqramatik gəlirlə ölçülür.