iBILLBOARD
kullanıcı eşleştirme API açıklaması
iBILLBOARD
kullanıcı eşleştirme API açıklaması
Kullanıcı eşleştirmenin amacı
Desteklenen kullanıcı eşleştirme mekanizmaları
Kullanıcı eşleştirme, iBILLBOARD kullanıcı ID numarası ile birlikte iş ortağının kullanıcı numarası hakkında bilgi depolamak için kullanılır; böylece sunucudan sunucuya iletişimin
gerçekleştiği her an iş ortağının kullanıcı ID numarası, iş ortağına gönderilebilir. Bu durum tipik olarak iBILLBOARD’dan teklif verme isteğinin demand partner’a gönderildiği teklif verme süreci sırasında gerçekleşir. Demand partnerın, kullanıcının tarayıcısına ve dolayısıyla çerezlerine (cookies) erişimi olmadığı için, bu mekanizma iş ortağı tarafında kullanıcının bir biçimde belirlenebilmesi açısından gereklidir.
İş ortağı tarafından tetiklenen kullanıcı eşleştirme işlemi
Kullanıcı eşleştirmeyi başlatmak için tercih edilen yöntem budur. İş ortağının iBILLBOARD ekibi tarafından sağlanan bir kullanıcı eşleştirme pikselini aşağıdaki gibi eklemesi gerekir:
Piksel url örneği:
http://bbnaut.bbelements.com/match/partnerName?partneruid=PARTNER_USER_
ID&cburl=http://partner.domain.com/partner_path/?partner_param_name=IBB_USER_ID
“PartnerName” parametresi, demand partner’ın iBILLBOARD sisteminde yaratılan adına göre değiştirilecektir. Dolayısıyla ‘XYZ’ adlı iş ortağının url’si her zaman şöyle başlayacaktır:
http://bbnaut.bbelements.com/match/XYZ
İş ortağının, makro PARTNER_USER_ID numarasını iş ortağının sistemindeki gerçek ID numarası olarak genişletmesi gerekir.
iBILLBOARD, kullanıcı ID numarasının değişkenler grubunu kendi tarafında depolayacaktır.
İş ortağı isteğe bağlı olarak url kodlu bir cburl parametresini iş ortağının sistemine ekleyebilir;
iBILLBOARD tarafında başarılı bir eşleşme sağlandığında callback olarak çağrılacaktır. iBILLBOARD, makro IBB_USER_ID numarasını kullanıcının iBILLBOARD sistemindeki gerçek ID numarası olarak genişletecektir. Böylece, iş ortağı kullanıcı ID numarasının değişkenler grubunu kendi tarafında da depolayabilir.
SSL (https) kullanıcı eşleştirme
Kullanıcı eşleştirme URL’sinin SSL versiyonu da bulunmaktadır. Bunun için http yerine https koymak yeterli olacaktır.
iBILLBOARD tarafından tetiklenen kullanıcı eşleştirme
iBILLBOARD sisteminde gerekiyorsa iBILLBOARD tarafından tetiklenen kullanıcı eşleştirme de kullanılabilir. Böyle bir gereksinim varsa, lütfen daha ayrıntılı bilgi için bizimle iletişime geçin.
Önemli notlar
iBILLBOARD tarafındaki mantık şöyledir: Eğer kullanıcı çerezde (cookie) iBILBBOARD ID numarasını kullanmadıysa, callback url’yi ÇAĞIRMAYIZ.
Bunun nedeni, kayıp cookie ID numaralarını kurtarmak için özel bir kullanıcı ID numaraları hizmeti kullanmamız ve yeni bir çerez üretmek yerine kayıp olanı kurtarana kadar eşleştirmeyi ertelemenin daha güvenli olmasıdır. Başka bir deyişle, iş ortağının bir iBILLBOARD kullanıcı ID numarası yoksa, kullanıcı eşleştirme testleri sonuçta callback yerine 1x1 piksel verecektir.
Böyle bir durumda iş ortağı, ID çerezini (cookie) tarayıcısına eklemek için http://bbnaut.bbele- ments.com/s/co/98765 url’sini kullanabilir (değer 98765). Böylece callback URL’yi verilen değerle çağırmak suretiyle test başarıyla sonuçlandırılabilir.