Studio makrosu çıkışları

Amaç

Çıkış URL'nize Studio bilgileri/makroları ekleyin.

Çözüm

Reklam kimliği gibi Studio bilgilerini bir reklama iki şekilde ekleyebilirsiniz:

• Studio Web kullanıcı arayüzündeki hedef URL'de Studio makrolarını kullanın.

• Reklam öğesi kodunuzda bir sorgu dizesi veya tam URL oluşturarak Studio bilgilerini almak için Studio API'sını kullanın. Daha sonra Enabler.exitQueryString(id, queryString) yöntemini kullanın.

Dinamik çıkış URL'leri kullandığınızda, açılış sayfası farklı bir URL'ye yönlendirebilir. Bu işlem, Studio değil açılış sayfası sunucusu tarafından kontrol edilir.

Kurulum

Studio makrolarını çıkışlara eklemeden önce, kullanılabilir makrolarla ilgili bilgiler ve bunlara denk gelen Studio API'si çağrılarını sunan aşağıdaki grafiğe bakın. Studio parametrelerini reklam öğesi kodunuzda bir çıkış URL'sine doğrudan eklemek isterseniz buna karşılık gelen bir Studio API'sı yöntemi bulunduğundan emin olun. Herhangi bir Studio API'sı yöntemi yoksa Studio bilgilerini çıkış URL'sine alamazsınız.

Studio tarafından desteklenen makrolar

Makro	Studio API'sı yöntemi	Studio reklam sunucusu parametresi
%eadv!	Enabler.getParameter("adv");	reklamveren kimliği
%eaid!	Enabler.getDartAdId();	reklam kimliği
%ebuy!	Enabler.getParameter(“buy”);	kampanya kimliği
%ecid!	Enabler.getDartCreativeId();	reklam öğesi kimliği
%epid!	Enabler.getDartPageId();	yerleşim kimliği
%erid!	Enabler.getDartRenderingId();	oluşturma kimliği
%esid!	Enabler.getDartSiteId();	site kimliği
%n	Kullanılabilir API yok	rastgele sayı
%p	Kullanılabilir API yok	kalıp eşleme
%s	Enabler.getDartSiteName();	site adı

 

Studio bilgileri, yalnızca reklam öğesi yayındaki bir etikette sunulduğunda kullanılabilir. Studio'da önizleme yapıldığında Studio makroları 0 değerini veya çözümlenmemiş makro değerleri döndürür. Eşdeğer Studio API'si yöntemleri, Studio'da önizleme yaparken veya yerel olarak test ederken 0, null ya da "" değerini döndürür.

Reklam öğesi, çıkış URL'lerini bir harici kaynaktan (XML, JSON) alıyor ve URL'ler Studio makro değerleri içeriyorsa reklamın makro değerlerini, reklam öğesi kodunuzda string değiştirme mantığını kullanarak karşılık gelen Studio API'sı yöntemleriyle değiştirmeniz gerekir. Hangi makronun hangi Studio API'si yöntemine karşılık geldiğini bulmak için yukarıdaki tabloyu kullanın. Studio makro değerlerini reklam öğenizin koduna sabit olarak girmeyin.

Studio makro değerleri, reklam öğenizin koduna sabit olarak girilirse bu makro değerleri yayındaki bir etiketin ilgili Studio reklam sunucusu parametreleriyle değiştirilemez. Ayrıca, Studio makro değerleri koda sabit olarak girilirse kullanıcılar reklam öğesini tıkladığında URL'nin Internet Explorer tarayıcılarında bir pop-up engelleyiciyi tetikleme olasılığı vardır. Studio Web arayüzünde veya DCM'de reklam öğenize kodları gömülmüş çıkış URL'lerinin üzerine yazılamaz.

Örnekler

Studio'daki hedef URL'de Studio makrolarını kullanma

Studio makro verilerini içeren açılış sayfası URL'sini Studio'daki Etkinlikler > Çıkışlar sekmesinde bulunan Hedef URL alanına yapıştırın.

Örnek üçüncü taraf yönlendirme URL'si
Bu örnekte makrolar kırmızıyla vurgulanmaktadır.

http://yourdomain.com/clk?aAgencyId=01&aSource=adsrv&aTrackDataExt=
123456;%epid!;%eaid!;%ecid!&migRandom=%n&aTrackFmtExt=client;io;ad;crtv&
aUnencodedDest=http://yourdomain.com

Studio parametrelerini reklam öğesinin kodunda kullanın, ardından Studio'da temel URL'yi girin

1. Kodunuzda Enabler.exit() yöntemini kullanmak yerine Enabler.exitQueryString() yöntemiyle, parametreleri eklemek istediğiniz çıkışı değiştirin. Bu yöntem, Studio'da bir temel URL ayarlamanıza ve reklam öğesi kodunda, parametreleri bu temel URL'ye eklemenize olanak tanır.
2. Studio parametrelerinin her birine karşılık gelen Studio API'sı yöntemlerini, exitQueryString yönteminin ikinci parametresine ekleyin. Kullanabileceğiniz yöntemler, Studio HTML5 SDK'sında listelenmektedir (doğrudan listeye gitmek için sayfada "getDart" terimini arayın). Burada, HTML5 reklam öğeleri için bir JavaScript kodu örneği bulabilirsiniz:

   
   var adIdVar = Enabler.getDartAdId();
   var siteIdVar = Enabler.getDartSiteId();
   
   function exitHandler() {
     Enabler.exitQueryString("my exit", "adid=" + adIdVar + "&siteid=" + siteIdVar);
   }
   
   exitBtn.addEventListener('click', exitHandler, false);

3. Temel URL'yi Etkinlikler > Çıkışlar sekmesinde hedef URL alanına ekleyin.

   Örneğin, temel URL olarak http://yourdomain.com/ adresi kullanıldığında sonuç olarak meydana gelen ve reklamdan tıklamayla gidilen URL (reklam, yayınlanan bir etikette olduğunda) şöyle görünebilir:
   
   http://yourdomain.com/?adid=123456789&siteid=12345