Kısaca: Bir ajans kendi yasal adıyla bir kez kaydolur ve her müşterinin adını Üyelere görünen ad alanına girerek müşterileri adına reklam verir. Ödemeyi ajans yapar, bakiyeleri ajans tutar ve faturaları ajans alır. Geliştiriciler, Reklam Portalı'ndan alınan API anahtarlarıyla Agilis REST API (https://ads.agilis.dating) üzerinden fırsat ve etkinlik oluşturup yönetebilir; test anahtarları ücretsizdir ve üyelere hiçbir zaman gösterilmez.
Ajanslar için
- Ajansı kaydedin ve bunu ajansın kendi yasal adıyla yapın. → Nasıl kaydolunur?
- Bir fırsat veya etkinlik oluştururken müşterinizin adını Üyelere görünen ad alanına girin. Üyeler sizin adınızı değil, müşterinin adını görür.
- Bir müşteri adına reklam verebilmek için o müşteriden yetki almış olmanız gerekir. Reklam Şartları ve Koşulları bu konudaki sorumluluğu ajansa yükler.
Ödemeyi kim yapar, faturayı kim alır?
- Ödeme, ajansınızın hesabından ve ajansınızın fatura para biriminde yapılır.
- Ajansınızdaki her kişinin kendi bakiyesi vardır ve ödemelerini bu bakiyeden yapar. Kuruluş bakiyesi bunların toplamıdır. → Bakiyeler nasıl işler?
- Faturalar ve sonuçlar ajansınızın adına düzenlenir ve her ödeme için bir fatura kesilir; böylece her müşterinize ayrıca fatura kesebilirsiniz.
- Her müşterinin harcamalarını ayrı tutmak için her müşteriye ayrı bir fırsat veya etkinlik kullanın ve müşteriye o fırsatın ya da etkinliğin faturasına göre fatura kesin.
Ekip rolleri
Kuruluş Yöneticileri ve Reklamverenler Reklam Portalı'nda, Geliştiriciler ise API üzerinden çalışır. Geliştiriciler Reklam Portalı'nda fırsat veya etkinlik oluşturamaz; ancak API anahtarlarıyla bunları API üzerinden oluşturabilir, yayınlayabilir ve ödemelerini yapabilir. Anahtarlarının nasıl kullanıldığından işletmeniz sorumludur. Tablonun tamamı Ekip rolleri ve izinler sayfasındadır.
Agilis REST API
- Temel URL: https://ads.agilis.dating
- Başvuru belgeleri: www.agilis.dating/api-doc (cURL, Python, Node.js ve PHP örnekleri ve bir API asistanıyla)
- Makine tarafından okunabilir: OpenAPI 3.1 www.agilis.dating/openapi.json adresinde, Markdown www.agilis.dating/api-doc.md adresinde, yapay zekâ araçları için tam metin ise www.agilis.dating/llms-full.txt adresinde
- Fırsatlar: kategorilerinizi ve ilgi alanlarını listeleyin; bir fırsatı oluşturmadan önce fiyatını hesaplayın; fırsat oluşturun, listeleyin, duraklatın, sürdürün ve silin; her fırsatın sonuçlarını görüntüleyin
- Etkinlikler: etkinlikleri önizleyin, yayınlayın, listeleyin, düzenleyin, yeniden planlayın, iptal edin ve silin; her etkinliğin sonuçlarını görüntüleyin
API anahtarı alın
- Reklam Portalı'na Kuruluş Yöneticisi veya Geliştirici olarak giriş yapın.
- Sayfanın üstündeki geçiş düğmesiyle Test modu ya da Canlı mod arasında seçim yapın.
- API anahtarları → Yeni anahtar oluştur bölümüne gidin; anahtara bir ad ve isterseniz bir son kullanma tarihi verin.
- Anahtarı hemen kopyalayın. Anahtarı bir daha göremezsiniz.
Test anahtarları pk_test_ ile, canlı anahtarlar pk_live_ ile başlar. Her kişi her modda en fazla 10 anahtara sahip olabilir. Yenile anahtarı anında değiştirir; bu nedenle önce sistemlerinizi güncelleyin. Anahtarı x-api-key istek başlığında gönderin: x-api-key: pk_test_….
Güvenle geliştirin
pk_test_anahtarıyla geliştirip test edin: test fırsatları ve etkinlikleri ücretsizdir ve üyelere hiçbir zaman gösterilmez.- Bir fırsatı oluşturmadan önce fiyat tahmini uç noktasıyla fiyatını hesaplayın.
- Anahtarları kod depolarından ve tarayıcılardan uzak tutun; API'yi sunucunuzdan çağırın.
Sorular
Bir ajans tek bir hesaptan birden fazla müşteriyi yönetebilir mi?
Evet. Ajansı bir kez kaydedin ve her fırsatta veya etkinlikte müşterinin adını belirtin.
Her müşteri için ayrı fatura alınabilir mi?
Faturalar ajansınız adına, her ödeme için bir tane olacak şekilde düzenlenir. Müşterilerinize bu faturalara göre fatura kesin.
Deneme ortamı (sandbox) var mı?
Evet. pk_test_ anahtarlarıyla kullanılan Test modu eksiksiz bir deneme ortamıdır. Hiçbir ücret alınmaz ve üyelere hiçbir şey gösterilmez.
Yapay zekâ kodlama araçlarını bağlayabilir miyim?
Evet. Aracınızı www.agilis.dating/api-doc.md veya www.agilis.dating/openapi.json adresine yönlendirin.
