GPP Problemlərini Tutmaq Niyə Çətindir

ABŞ ziyarətçisi məlumatlarının satışından və ya paylaşılmasından imtina etdikdə, bu seçim səhifədəki hər reklam tərəfdaşına çatmalıdır. IAB Global Privacy Platform (GPP) ilə o, yığcam string və bölmə ID-lərinin siyahısı kimi gedir. Hər ikisindən biri yanlışdırsa — çatışmırsa, köhnədirsə və ya yanlış bölməni daşıyırsa — gözlə görünən heç nə pozulmur. Reklamlar yenə yüklənir, banner yenə də yaxşı görünür və problem yalnız sonradan tərəfdaşların opt-out-ları nəzərə almaması və ya inventarınıza daha az təklif verməsi kimi üzə çıxır.

Yaxşı xəbər odur ki, demək olar ki, hər şeyi brauzer konsolundan yoxlaya bilərsiniz. Bu təlimat yoxlamaları canlı səhifədə aparacağımız ardıcıllıqla keçir.

Addım 1: API-nin Mövcud və Hazır Olduğunu Təsdiqləyin

GPP ilə uyğun CMP qlobal __gpp funksiyasını ifşa edir. Səhifənizdə DevTools-u açın və ping əmrini icra edin:

__gpp('ping', function (data) { console.log(data); });

Qaytarılan obyekt bir baxışda çox şey deyir:

• gppVersion — cari implementasiyalarda 1.1 olmalıdır.
• cmpStatus — CMP-nin yüklənib-yüklənmədiyini və ya xətaya rast gəlib-gəlmədiyini göstərir.
• cmpDisplayStatus — bannerin bu ziyarətçi üçün görünən, gizli və ya deaktiv olub-olmadığını göstərir.
• signalStatus — CMP razılıq vəziyyətini müəyyənləşdirdikdən sonra “ready”, hələ qərar verərkən “not ready”.
• supportedAPIs — CMP-nin yarada biləcəyi bölmələr.
• applicableSections — bu ziyarətçiyə hazırda tətbiq olunan bölmə ID-ləri.
• gppString — kodlaşdırılmış string-in özü.

Əgər __gpp undefined-dırsa, CMP stub-ı çatışmır və ya çox gec yüklənir. Stub onu gözləyən hər reklam skriptindən əvvəl yerində olmalıdır, əks halda həmin skriptlər CMP görməyəcək və ya gözləyəcək, ya da siqnalsız davam edəcək.

Addım 2: Tətbiq Olunan Bölməni Yoxlayın

GPP-dəki hər məxfilik çərçivəsinin rəqəmsal bölmə ID-si var. Naşirlərin ən çox rastlaşdıqları 2 (EU TCF v2), 5 (Kanada TCF), 7 (US National, “usnat”) və Kaliforniya, Virciniya, Kolorado, Yuta və Konnektikut kimi ayrı-ayrı ştat bölmələri üçün 8 və sonrakılardır. ABŞ ştatından olan ziyarətçi applicableSections-də adətən Aİ bölməsini deyil, milli və ya müvafiq ştat bölməsini görməlidir.

Bir neçə məkandan test edin. Yayılmış səhv coğrafiyanı banner üçün düzgün aşkar edən, lakin string-ə yenə də defolt bölməni yazan CMP-dir, ya da əksi. VPN və ya CMP-nizin önizləmə alətlərindən istifadə edərək bannerin göstərdiyini applicableSections-in bildirdiyi ilə müqayisə edin.

Addım 3: Bölmə Məlumatlarını Oxuyun

String-i əllə deşifrə etmək əvəzinə, CMP-dən təhlil olunmuş bölməni istəyin:

__gpp('getSection', function (data, success) { console.log(data, success); }, 'usnat');

US National bölməsində opt-out sahələri sadə qaydadan istifadə edir: 0 tətbiq olunmur, 1 istifadəçinin opt-out etdiyi, 2 isə istifadəçinin opt-out etmədiyi mənasına gəlir. Əvvəlcə bu sahələrə diqqət yetirin:

• SaleOptOut və SharingOptOut
• TargetedAdvertisingOptOut
• Hər təcrübə barədə ziyarətçiyə bildiriş verilib-verilmədiyini qeyd edən uyğun notice sahələri

İndi səhifədə opt-out edin — “Do Not Sell or Share” linkinə klikləyin və ya seçimlər mərkəzində parametri dəyişin — və getSection-u yenidən icra edin. Opt-out sahələri 2-dən 1-ə dəyişməlidir. Dəyişmirsə, UI və siqnal sinxron deyil.

Addım 4: Global Privacy Control Yolunu Test Edin

Bir neçə ştat qanunu bizneslərdən Global Privacy Control siqnalını opt-out kimi qəbul etməyi tələb edir. GPC-ni onu dəstəkləyən brauzerdə və ya genişlənmədə aktivləşdirin, konsolda navigator.globalPrivacyControl-un true qaytardığını təsdiqləyin, sonra səhifəni yeni sessiyada yükləyin. Ziyarətçi bannerə toxunmadan müvafiq opt-out sahələrində artıq 1 yazılmalıdır. Bəzi bölmələr seçimin GPC siqnalından gəldiyini göstərən sahə də ehtiva edir.

Addım 5: Yalnız Snapshot-lara Deyil, Event-lərə Baxın

Reklam skriptləri string-i səhifə yüklənəndə bir dəfə oxuyub unutmamalıdır. Tərəfdaşların nə gördüyünü görmək üçün listener qeydiyyatdan keçirin:

__gpp('addEventListener', function (evt) { console.log(evt.eventName, evt.pingData); });

listenerRegistered, signalStatus və sectionChange kimi event-ləri müşahidə etməlisiniz. Ziyarətçi seçimi dəyişdikdə, yenilənmiş string ilə sectionChange event-i ardınca gəlməlidir. Header bidding wrapper-iniz və ya ad server inteqrasiyanız string-i yalnız signalStatus “ready” olmazdan əvvəl oxuyursa, boş və ya köhnə dəyər göndərə bilər.

Addım 6: String-i Reklam Sorğularında İzləyin

Nəhayət, Network tabını açın və reklam sorğularınızı süzün. Bir çox reklam endpoint-i gpp və gpp_sid parametrlərini (string və tətbiq olunan bölmə ID-ləri) qəbul edir. Yoxlayın ki:

1. hər iki parametr ABŞ ziyarətçilərinin sorğularında mövcuddur;
2. string sorğu zamanı ping-in qaytardığı ilə üst-üstə düşür;
3. opt-out-dan sonra sonrakı sorğular keşlənmiş deyil, yeni string daşıyır.

Prebid.js istifadə edirsinizsə, onun razılıq idarəetmə modulunun GPP üçün konfiqurasiya edildiyini təsdiqləyin və wrapper-dən çıxan bid sorğularını, həmçinin yekun ad server çağırışını yoxlayın.

Ümumi Nasazlıq Nümunələri

• Stub reklam teqlərindən sonra yüklənir — tərəfdaşlar heç bir CMP görmür.
• Region üçün yanlış bölmə — ABŞ trafiki üçün Aİ bölməsi göndərilir və ya heç bir bölmə yoxdur.
• UI və siqnal sinxron deyil — keçirici dəyişir, string dəyişmir.
• GPC nəzərə alınmır — brauzer siqnalı heç vaxt opt-out-a çevrilmir.
• Sorğularda köhnə string-lər — wrapper gördüyü ilk dəyəri keşləyir.

Əsas Nəticələr

• ping ilə başlayın: versiya, status, tətbiq olunan bölmələr və string hekayənin çox hissəsini deyir.
• Opt-out sahələrini oxumaq üçün getSection-dan istifadə edin; 1 opt-out, 2 opt-out edilməyib deməkdir.
• Opt-out linkini və GPC-ni ayrı-ayrılıqda test edin və hər ikisinin siqnalı dəyişdirdiyini təsdiqləyin.
• Event-ləri dinləyin və reklam sorğuları string-i oxumazdan əvvəl “ready” siqnalını gözləyin.
• gpp və gpp_sid-i real şəbəkə sorğularında opt-out-dan əvvəl və sonra yoxlayın.