Reklam Kreatifleri
Dragla’nın Reklam Kreatifleri API’si ile uygulamanız ya da kullanıcılarınız için reklam gönderileri oluşturabilirsiniz. Her istekte 12 farklı alternatif ile işinizi şansa bırakmamanızı ve reklam performanslarını en üst seviyeye çıkarmanızı sağlar. Bu dökümantasyon, Reklam Kreatifleri ile gönderi oluşturma işlemlerini adım adım nasıl gerçekleştirebileceğinizi anlatmaktadır.
Başlangıç
API'yi kullanmak için bir API anahtarına ihtiyacınız olacak. Bu API anahtarını almak için (https://app.dragla.co/api) sayfasını ziyaret edin ve kayıt olduktan sonra anahtarınızı edinin. API anahtarınızı aldıktan sonra, bu anahtarı kullanarak API isteklerinizi doğrulayabilirsiniz.
Authorization: X-Api-Key: YOUR_API_KEY
Parametreler
| Property | Data Type | Required | Description | Parameters |
|---|---|---|---|---|
| ProductOrBrandName | String | Zorunlu | Ürün ya da marka adı. | Örnek : Dragla |
| ProductOrBrandDescription | String | Zorunlu | Ürün ya da marka açıklaması. | Örnek : Akıllı gönderi oluşturma platformu. |
| ProductOrBrandType | String | Zorunlu | Ürün ya da marka tipi. | Örnek : Uygulama |
| LogoUrl | String | Zorunlu | Gönderinizdeki logo alanı için kullanılacaktır. | Örnek : https://www.storagesite.com/logo.png |
| Website | String | Zorunlu | Gönderinizdeki website alanı için kullanılacaktır. | Örnek : www.siteniz.com ya da @kullaniciadi |
| Language | String | Zorunlu | Gönderinizin dilini belirtir. | English, Turkish, Espanol, French, German, Italian, Japanese, Korean |
| PostSize | String | Zorunlu | Gönderinizin boyutunu belirler. | square, vertical, story |
| Keywords | String | Opsiyonel | Anahtar kelimeleri belirtir. | Örnek : atatürk, türkiye |
| Audience | String | Opsiyonel | Gönderinizin hedef kitlesini tanımlar. | Örnek : herkes |
| Tone | String | Opsiyonel | Gönderinizin tonunu belirler. | excited, professional, encouraging, dramatic, engaging, creative |
| ColorPalette | Object | Opsiyonel | Gönderilerin renk ayarlarını değiştirir. Gönderilerinizdeki renklerin seçimini Dragla'nın yapay zekasına bırakmak isterseniz bu alanı boş bırakın! |
ColorOne, ColorTwo, ColorThree, ColorFour alanlarının tümü zorunludur. Hex Kodu Olmalıdır! (#ad8b73 gibi...) |
| Images | Array | Opsiyonel | Gönderilerinizdeki resimleri özel olarak eklemek için gerekli alan. Gönderilerinizdeki resimlerin seçimini Dragla'nın yapay zekasına bırakmak isterseniz bu alanı boş bırakın! |
"Index" ve "Url" değerlerini alır. "Index" değeri hangi gönderi için olduğunu belirtir. Örneğin : "Index : 1" ilk gönderideki resimleri değiştireceğiniz anlamına gelir. |
İstek [POST]
Not : Aşağıdaki örnek tam bir istek yapısına sahiptir zorunlu alanlar dışındakileri göndermek zorunda değilsiniz.
Başarılı Cevap
Yaklaşık 30 ile 45 saniye arasında bir dönüş süresi olacaktır. Lütfen dönüş sürelerini göz önüne bulundurun.
Sonuçları alabilmeniz için "creationId" ile aşağıdaki şekilde "GET" işlemini yapmanız gerekmektedir.
Sonuçlar [GET]
Oluşturma işlemi devam ediyorsa "Processing" cevabını alacaksınız.
Görseller oluşturulduysa aşağıda ki gibi başarılı bir cevap alacaksınız.
Hata Kodları
| Code | Name | Description |
|---|---|---|
| 400 | Bad Request | Geçersiz İstek Biçimi. İstek parametrelerinizi kontrol ediniz. |
| 401 | Unauthorized | Yetkisiz kullanıcı. Gönderilen API Anahtarınızı kontrol edin. |
| 404 | Not Found | Belirtilen adres için geçerli bir sonuç bulunamadı. |
| 406 | Not Acceptable | API Anahtarınızı kontrol ediniz. |
| 500 | Server Error | Sunucudaki sorun nedeniyle istek tamamlanamadı! |
