Kampanyalar (Çapraz Tanıtım)

Kampanyalar, çapraz tanıtım motorudur: Uygulama Ayrıntıları bölümünde açıklanan "Reklam Yer Tutucuları için Reklam Birimleri → Çapraz Tanıtım" eşlemesini kullanarak kendi uygulamalarınızdan birinin reklamını başka bir uygulamanızda göstermenizi sağlar.

Kampanya Listesi

Kampanyalar sayfası (/campaigns), oluşturduğunuz tüm kampanyaları bir tabloda listeler: satır numarası, Başlık, Hedef Uygulama (iki satırda gösterilen ad ve paket adı), Kampanya Türü (şu anda her zaman "Çapraz Tanıtım" — Ağ Reklamcılığı, tür seçicide kavramsal olarak bulunur ancak seçenek olarak sunulmaz), Durum ve Öncelik (her ikisi de renkli rozetlerle gösterilir ve sıralanabilir), Başlangıç Tarihi, Bitiş Tarihi, Oluşturulma Zamanı, Güncellenme Zamanı (son ikisi de sıralanabilir) ve İşlemler (Düzenle ve Sil).

Listeyi Kampanya Durumu, Öncelik veya Hedeflenen Marka ile filtreleyebilirsiniz; bunların her biri dinamik bir çoklu seçim alanıdır. Bir kampanyayı düzenlediğinizde (kalem simgeli işlem), aşağıda açıklanan sihirbaz düzenleme modunda açılır. Silme işlemi önce onay ister ve geri alınamaz.

+ Oluştur düğmesi, yalnızca planınız bir çapraz tanıtım kampanyası daha oluşturmanıza izin veriyorsa kullanılabilir (canCreateCampaign()). Planınızın kampanya sınırına ulaştıysanız bu düğmenin yerine kullanım bilgisi ("X/Y kampanya kullanıldı") ve Abonelik sayfasına yönlendiren bir "🔒 Planı Yükselt" bağlantısı gösterilir.

Kampanya Oluşturma veya Düzenleme — Sihirbaz

+ Oluştur düğmesine tıkladığınızda (veya mevcut bir kampanyayı düzenlediğinizde) adım adım ilerleyen bir sihirbaz açılır. Sihirbaz dört değil, beş adımdan oluşur — mevcut bir kampanya düzenlenirken ilk adım otomatik olarak atlandığından adım sayısını eksik saymak kolaydır (kampanya oluşturulduktan sonra türü değiştirilemez). Her adımda aynı "önce taslak, sonra kaydet" yaklaşımı uygulanır: Bir adımı doldururken yaptığınız değişiklikler yalnızca o adımın yerel bileşen durumunda tutulur. Kaydet türünde bir düğmeye tıklayıp ilgili API çağrısı başarıyla tamamlanana kadar sihirbazın paylaşılan bağlamına hiçbir şey yazılmaz ve sunucuya hiçbir şey kalıcı olarak kaydedilmez. Kaydedilmemiş değişikliklerle sayfadan ayrılmaya çalışırsanız "Kaydedilmemiş değişiklikleriniz var. Ayrılmak istediğinizden emin misiniz?" onayı (Evet, ayrıl / Kal) çalışmanızı kaybetmenizi önler.

Adım 1 — Kampanya Türünü Seçin

Seçilebilen tek bir kart vardır: Çapraz Tanıtım ("Kendi uygulamalarınızı diğer uygulamalarınızın kullanıcılarına tanıtın"). Gerçekte kullanılabilen tek seçenek budur — altyapı kodunda gelecekte kullanılmak üzere yer tutucu olarak ikinci bir "Ağ Reklamcılığı" türü bulunur, ancak şu anda kullanıcı arayüzünde seçilemez. İleri düğmesine tıklamak bir sonraki adıma geçmenizi sağlar. Adım 2'ye kadar hiçbir şey oluşturulmadığı için bu adım tek başına sunucuya çağrı yapmaz. Düzenleme modunda bu adım tamamen atlanır — sihirbaz, mevcut kampanyanın türü sabitlenmiş olarak doğrudan Adım 2'de açılır.

Adım 2 — Kampanya Ayarları

Bu adım hem kampanyayı oluşturur (oluşturma modunda ilk kayıtta) hem de temel ayarlarını düzenler (düzenleme modunda). Alanlar:

• Kampanya Durumu anahtarı — yalnızca düzenleme modunda. Aktif ve Duraklatıldı durumları arasında geçiş yapar (her iki yönde de onay iletişim kutusu gösterilir: "Kampanya etkinleştirilsin mi?" / "Kampanya duraklatılsın mı?"). Bir kampanyayı etkinleştirmeye çalıştığınızda, kaydetmeden önce kampanyada en az bir reklam kreatifi bulunduğu ve bu kreatiflerden en az birinin aktif olduğu kontrol edilir. Bu koşullar sağlanmazsa "Kampanya etkinleştirilemiyor — lütfen önce en az bir reklam kreatifi ekleyin" veya "...en az bir reklam kreatifi aktif durumda olmalıdır" mesajıyla işlem engellenir ve anahtarın durumu değişmez.
• Kampanya Başlığı — zorunlu metin alanı.
• Marka Seçin — markalarınızı içeren zorunlu açılır liste. Uygulama listesi markaya bağlı olduğundan, markayı değiştirmek "Tanıtılacak Uygulama" seçimini temizler.
• Tanıtılacak Uygulama — seçilen markaya göre doldurulan zorunlu açılır liste; marka seçilene kadar devre dışıdır.
• Kampanya Önceliği — seçilebilir üç yuvarlatılmış düğme olarak gösterilen Yüksek / Orta / Düşük; varsayılan değer Orta'dır.
• Kampanya Başlangıcı — "Hemen" veya belirli bir tarih. Tarih seçerseniz geçmişte olamaz (bugünün tarihine göre kontrol edilir). Ancak düzenleme modunda, kayıtlı tarihi değiştirmediyseniz geçmiş tarih kontrolü atlanır.
• Kampanya Bitişi — "Yok (Bitiş tarihi yok)" veya belirli bir tarih. Aynı geçmişte olmama kuralına ek olarak bitiş tarihinin başlangıç tarihinden sonra olduğu da kontrol edilir.

Aktifken alanların kilitlenmesi: Bir kampanya Aktif olduğunda Marka, Tanıtılacak Uygulama veya Başlangıç tarihi/Hemen ayarını artık değiştiremezsiniz — bu alanlar kısa bir açıklama notuyla devre dışı bırakılır ("...kampanya aktifken değiştirilemez"). Başlığı, önceliği ve bitiş tarihini değiştirebilir, ayrıca anahtarı kullanarak kampanyayı duraklatabilirsiniz.

Kaydetme işlemi (oluşturma modunda Kaydet ve İleri; düzenleme modunda Kaydet), başlığı, hedef uygulamayı, kampanya türünü, önceliği, hesaplanan başlangıç/bitiş tarihlerini ve düzenleme modunda durumu sunucuya gönderir. İlk oluşturma sırasında yanıttaki mevcut yayınlama/bölge verileri (varsa), Adım 3'ün başlangıç durumunu önceden doldurmak için kullanılır. Bu bilgilerin sihirbazın paylaşılan bağlamına yazılması, yalnızca API çağrısı başarıyla tamamlandıktan sonra gerçekleşir.

Adım 3 — Hedefleme

Hedefleme, aynı adımı ve aynı Kaydet düğmesini paylaşan iki bağımsız alt bölümden oluşur: Yayınlama (kampanyayı hangi markalarınızın/uygulamalarınızın göstereceği) ve Bölgeler (kampanyanın hangi ülkelerde yayınlanacağı).

Yayınlama. Onay kutusu listeleri üzerinden şu seçeneklerden birini belirlersiniz:

• Tüm Markalar — kampanyanın, sonradan eklenenler dahil, sahip olduğunuz tüm marka ve uygulamalarda gösterilebileceğini belirten tek bir ana onay kutusu.
• Belirli markalar — her birinin kendi uygulama alt listesi bulunan, kaydırılabilir bir listeden bir veya daha fazla marka seçersiniz. Seçili bir marka içinde uygulamaları tek tek işaretleyebilir veya o markanın "Tümü (gelecekte eklenecekler dahil)" kutusunu işaretleyerek markanın tüm mevcut ve gelecekteki uygulamalarını tek tek seçmeden dahil edebilirsiniz.

Güncel hedeflemenizi bir bakışta görebilmeniz için "Seçilen Markalar" ve "Seçilen Uygulamalar" özeti, onay kutusu listelerinin üzerinde etiketler halinde gösterilir.

Bölgeler. Kampanyanın hangi ülkelerde yayınlanacağını sınırlamak (veya sınırlamamak) için kullanılan, "Tümünü Seç" kısayoluna sahip çoklu ülke seçim alanıdır. Sınırlama getirmezseniz kampanya tüm bölgelerde yayınlanır. Bu bölge seçici, kılavuzun ilerleyen bölümlerinde açıklanan, adlandırılmış Bölge Grupları özelliğinden bilinçli olarak ayrı tutulmuştur — kaydedilmiş/yeniden kullanılabilir bir grup değil, kampanyaya özel, adsız ve basit bir ülke seçimidir. (Dinamik ülke listesi sunucudan yüklenemezse burada 16 ülkeden oluşan daha küçük bir yedek liste kullanılır; bu nedenle bu seçicinin yedek seçenek listesi, Bölge Grupları'ndakinden daha kısadır.)

Her iki alt bölüm de sihirbazın geri kalanıyla aynı taslak/kaydet davranışını kullanır: Kaydet (veya Kaydet ve İleri) düğmesine tıklayana kadar değişiklikler yerel olarak kalır. Tıkladığınızda Yayınlama ve Bölgeler, kendi API çağrılarıyla ayrı ayrı kalıcı olarak kaydedilir ve ancak bundan sonra sihirbazın paylaşılan durumuyla birleştirilir.

Adım 4 — Reklam Kreatifleri

Kampanya yayınlandığında gösterilecek reklam kreatiflerini burada yüklersiniz.

Yeni reklam kreatifleri ekleme. Tablo biçimindeki "Yeni Reklam Kreatifleri Ekle" formu, tek seferde bir veya daha fazla satır eklemenizi sağlar (+ Reklam Kreatifi Ekle bağlantısı yeni bir boş satır ekler; çöp kutusu simgesi satırı kaldırır). Her satırda şunlar bulunur:

• Görsel — yüklemek için boş kareye tıklayın. Kabul edilen biçimler: JPEG, PNG, JPG, GIF, WebP; maksimum boyut 10MB. Bu koşulları karşılamayan dosyalar, alanın yanında gösterilen belirli bir hatayla reddedilir (yanlış biçim veya gerçek boyutu gösteren "Maks. 10MB (X.XXMB)").
• Ad — zorunlu metin.
• Hedef URL — zorunludur; geçerli bir http:// veya https:// URL'si olmalıdır, yazarken anlık olarak kontrol edilir.
• Reklam Türü — interstitial, banner, native, rewarded veya appOpen (reklam birimleri için diğer bölümlerde kullanılan aynı beş biçim).

Kaydet ve İleri (oluşturma modu) veya Kaydet (düzenleme modu) düğmesine tıkladığınızda boş olmayan her satır doğrulanır, her görsel yüklenir ve ardından her reklam kreatifi API üzerinden oluşturulur. Kaydedilenler listesine yalnızca başarıyla oluşturulan kreatifler eklenir. Kaydedilemeyenler olursa kaçının başarısız olduğunu görür ve yeniden deneyebilirsiniz. Oluşturma modunda bu adımdan ayrılabilmek için en az bir reklam kreatifi gereklidir.

Kaydedilen reklam kreatifleri listesi. Önceden kaydedilmiş kreatifler, yeni ekleme formunun üzerinde kart listesi olarak görünür. Her kartta küçük resim (büyütmek için tıklayın), ad, reklam türü, hedef URL, açma/kapatma anahtarıyla birlikte Aktif/Pasif durum rozeti, düzenleme (kalem) düğmesi ve silme (çöp kutusu) düğmesi bulunur.

• Bir reklam kreatifi kampanyanın tek aktif kreatifiyse, durumunu pasif olarak değiştirmek engellenir ("En az bir reklam kreatifi aktif kalmalıdır"). Diğer tüm durumlarda basit bir "Reklam kreatifi etkinleştirilsin/devre dışı bırakılsın mı?" onayı istenir.
• Düzenleme (kalem) düğmesi, yalnızca o kreatif için kendi Kaydet/İptal düğmeleri olan bir satır içi düzenleme formu açar (ad, görsel, hedef URL — reklam türü sabittir).
• Silme işlemi, kreatifi kalıcı olarak kaldırmadan önce "Bu işlemi geri alamayacaksınız!" uyarısıyla onay ister.

Adım 5 — Kampanyayı Gözden Geçirin

Adım 2–4'te girilen tüm bilgilerin salt okunur özeti: Kampanya Durumu, Başlık, Tür, Marka, Tanıtılacak Uygulama, Öncelik, Başlangıç Tarihi, Bitiş Tarihi, tek satırlık Hedefleme özeti (ör. "Tüm markalar · Tüm uygulamalar" veya marka bazında döküm), seçilen Bölgeler (etiketler veya "Tüm bölgeler") ve küçük resimleri, adları, hedef URL'leri ve reklam türü rozetleriyle birlikte tüm Reklam Kreatifleri listesi.

Yalnızca oluşturma modunda, bu adımın en üstünde kullanılabilir bir Durum anahtarı (Aktif/Duraklatıldı) da bulunur — burada Adım 2'deki etkinleştirme kuralları geçerlidir (hiç reklam kreatifi olmayan veya aktif kreatifi bulunmayan bir kampanya etkinleştirilmez ve "Kampanya Etkinleştirilemiyor" mesajı gösterilir). Düzenleme modunda ise durum, salt okunur bir rozet olarak gösterilir — durumu buradan değil, Adım 2'deki anahtardan değiştirirsiniz.

Bitir düğmesine tıklamak sizi Kampanyalar listesine geri götürür. Düzenleme modunda önce kısa bir "Kampanya başarıyla kaydedildi" onayı görürsünüz. Oluşturma modunda ise her adım ilerledikçe zaten kaydedildiğinden ek bir onay gösterilmeden doğrudan listeye dönülür.

---