Sınır bildirimlerini ayarlama

Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin. bilgi

Giriş

Para kazanma sınırları kontrolü politikası kullanılarak para kazanmayla ilgili sınırların uygulanması başlıklı makalede açıklandığı gibi, para kazanmayla ilgili sınırlar belirleyebilirsiniz. Ayrıca, bir sınıra yaklaşıldığında veya sınıra ulaşıldığında geliştiricileri ve/veya kuruluşunuzdaki kullanıcıları uyaran otomatik bildirimler ayarlayabilirsiniz.

Örtülü sınırların yanı sıra özel sınırlar için de otomatik bildirimler ayarlayabilirsiniz. Örneğin, sistem, ön ödemeli geliştiricileriniz için ön ödemeli bakiyeleri olan örtülü bir sınır belirler. Geliştiricileriniz ön ödemeli bakiyelerine yaklaştığında veya bu bakiyeye ulaştığında bildirim almalarını sağlamak için otomatik bildirimleri ayarlayabilirsiniz.

Araç Kutusu

Yönetim kullanıcı arayüzünü veya para kazanma API'sini kullanarak sınırlar için otomatik bildirimler ayarlayabilirsiniz. Kullanıcı arayüzünü kullanıyorsanız Bildirimler sayfasında otomatik bildirimleri ayarlarsınız.

API'yi kullanıyorsanız para kazanma tarafından sağlanan bir bildirim şablonunu düzenleyerek sınırlar için otomatik bildirimler ayarlarsınız. Ardından, düzenlenen şablon tarafından sağlanan bildirimin gönderilmesine neden olan koşulu belirtirsiniz.

Kullanıcı arayüzünü kullanarak sınır bildirimlerini ayarlama

  1. Sınır Ekle sayfasının Bildirimler bölümünde Ekle'yi tıklayın. Bildirimler bölümü açılır.

  2. Bildirim için bir düzey seçin. Bu, mutlak bir sayıya veya sınır temelinin yüzdesine dayalı bir eşiktir. Şunu seçin:
    • Büyüktür veya eşittir işareti (?) ya da küçüktür veya eşittir işareti (?)
    • Tam sayı (ondalık basamak yok). Sayısal değeri belirtmek için mutlak veya yüzdelik değeri belirtmek için yüzde. Yüzde sınırları için her zaman sınırı > olarak ayarladığınızdan emin olun. Bu, geliştirici bu yüzde düzeyine ulaştığında veya bu yüzde düzeyini aştığında bildirimin gönderileceği anlamına gelir.

    Örneğin, 100 TL harcama sınırı belirlediyseniz ve bildirimi %90'a eşit veya daha yüksek olarak ayarladıysanız sınırın% 90'ına (90 TL) ulaşıldığında ya da bu sınır aşıldığında bildirim gönderilir.

  3. E-posta Gönder alanında bir veya daha fazla geliştiriciyi ya da kuruluşunuzdaki bir veya daha fazla kullanıcıyı seçin. Bu durumdan etkilenen geliştiricilere veya kullanıcılara bildirim gönderilir.

    E-posta alıcıları: Yalnızca "Herhangi biri" geliştirici sınırı koşulunu ayarlarsanız veya belirli bir geliştiriciyle geliştirici sınırı koşulu ayarlarsanız geliştiricilere bildirim gönderebilirsiniz. "Herhangi biri"ni seçtiyseniz e-posta adresleri listesinde "Seçilen geliştirici (Herhangi biri)" ifadesini görürsünüz. Bu durumda, para kazanma özelliği etkilenen tüm geliştiricilere bildirim gönderir. Belirli bir geliştiriciyi seçtiyseniz e-posta adresleri listesinde "Seçilen geliştirici ({developer_id})" ifadesini görürsünüz (burada {developer_id}, seçilen geliştiricinin kimliğidir). Para kazanma yalnızca ilgili geliştiriciye bildirim gönderir.

    "Herhangi" bir geliştirici sınır koşulu veya belirli bir geliştirici seçmediyseniz E-posta Gönder alanında "Seçilen geliştirici (Herhangi)" ifadesini görmezsiniz. Ancak, kuruluşunuzdaki hangi kullanıcıları bilgilendirmek istediğinizi seçebilirsiniz.

    Yönetici sekmesinde Kuruluş Kullanıcıları'nı seçerek kuruluşunuzdaki kullanıcıların e-posta adreslerini ekleyebilirsiniz.

    E-posta şablonları: E-posta Gönder alanında "Seçilen geliştirici (Herhangi biri)" veya kuruluşunuzdaki kullanıcıların e-posta adreslerini (ya da her ikisini) seçtikten sonra bir e-posta şablonu görürsünüz. Şablonda görünenler şunlara bağlıdır:

    • Bildirimin düzeyi.
    • Sınırın, yürütmeyi durdurma sınırı olup olmadığı.
    • E-postanın kuruluş kullanıcıları, geliştiriciler veya her ikisi için mi gönderildiği.

    Örneğin, aşağıdakilerin tümü doğruysa:

    • Yürütmeyi durdur onay kutusu işaretlenmiş olmalıdır.
    • Bildirim düzeyi% 100 veya sınırdaki tutarla aynı.
    • E-posta yalnızca kuruluş kullanıcılarına yöneliktir.

    Şablon şu şekilde görünür:

    Geliştiricinin şirket adının "XYZ şirketi" olduğunu, "X Paketi" adlı bir API paketi ve "Y Ürünü" adlı bir API ürünü için işlem hacmi sınırının 50 olarak ayarlandığını ve son kullanma tarihinin 30 Eylül 2013 olarak ayarlandığını varsayalım. Gönderilen e-posta iletisi aşağıdaki gibi görünür:

    Developer XYZ company has exceeded their transaction volume limit of 50 transactions for X package, Y product. Their API calls will be blocked till 2013-09-30

    E-posta "Seçilen geliştirici (Herhangi biri)"ye gönderiliyorsa şablon aşağıdaki gibi görünür:

    Her iki şablon da geliştirici adı (varsa), paket adı (varsa) ve ürün adı (varsa) gibi ilgili değişkenleri çözecektir. Şablonun solundaki Düzenle'yi tıklayarak mesajı ihtiyaçlarınıza göre düzenleyebilirsiniz.

    Sınır "Herhangi" veya belirli bir uygulama ve "Herhangi" veya belirli bir kullanıcı içinse şablona uygulamalar ve kullanıcılar için değişkenler de eklemeniz gerekir. Bu işlemi aşağıdaki şekilde yapabilirsiniz:

    • Şablonun solundaki Düzenle'yi tıklayın.
    • ${user.name} user, depending on whether the limit is for application and/or user. ekle

    "Herhangi" veya belirli bir uygulama için düzenlenmiş bir şablon aşağıda gösterilmektedir.

    Yürütmeyi durdur seçeneği işaretlenmemişse veya bildirim düzeyi %100'e eşit ya da daha yüksekse seçilen bir geliştiricinin şablonu şu şekilde görünür:

    Yine, sınır "Herhangi bir" (veya belirli bir) uygulama ya da "Herhangi bir" (veya belirli bir) kullanıcı içinse şablonu düzenlemeniz ve ardından sınırın bir uygulama, bir kullanıcı veya her ikisi için geçerli olmasına bağlı olarak ${application.name} uygulaması ve/veya ${user.name} kullanıcısını eklemeniz gerekir.

    Şablon değişkenleri: E-posta şablonundaki iletiyi düzenlerken aşağıdaki değişkenlerden herhangi birini ekleyebilirsiniz.

    Değişken Açıklama
    ${developer.name}

    Geliştiricinin adı.
    ${developer.legalName}

    Geliştiricinin şirketinin adı.
    ${ratePlan.monetizationPackage.displayName}

    API paketinin adı.
    ${application.name}

    Uygulamanın adı.
    ${USER}

    Kullanıcının adı.
    ${USAGE}

    Mevcut kullanım (toplam gelir veya ödeme ya da hacim).
    ${PERCENT}

    Mevcut kullanımın ulaştığı sınırın yüzdesi.
    ${QUOTA_TYPE}

    Sınırın türü (işlem hacmi, harcama limiti veya ücret riski).
    ${QUOTA_UNIT}

    Sınırın temel birimi: para birimi (harcama sınırı için) veya arama (işlem sınırı için).
    ${QUOTA_LIMIT}

    Sınırın tutarı.
    ${EXPIRY_DATE}

    Sınırın geçerliliğinin sona erdiği veya sıfırlandığı tarih ya da saat.

    Örneğin, herhangi bir geliştirici herhangi bir uygulamadaki herhangi bir paket için belirli bir işlem hacmi yüzdesine ulaştığında bildirim almak istiyorsanız şablonu aşağıdaki gibi düzenleyebilirsiniz:

    ${developer.legalName} has reached a total volume of ${USAGE} on ${ratePlan.monetizationPackage.displayName}. This is ${PERCENT} of the daily/weekly/monthly (state period of limit as appropriate) transaction volume limit of ${QUOTA_LIMIT}.
  4. Gerekirse ek seviyeler için bildirim ekleyin. Eklemek istediğiniz her seviye için Ekle'yi tıklayın. Bu işlem, sayfanın Bildirimler bölümüne bir Düzey, E-posta gönder ve E-posta şablonu alanı ekler. Bildirimleriniz için en fazla 6 seviye ekleyebilirsiniz. Örneğin, bildirimi > %70, %80, %90, %100 olarak ayarlarsanız bu seviyelerin her birine ulaşıldığında bildirim gönderilir.
  5. Tüm bildirimleri ekledikten sonra Kaydet'i (bildirimleri daha sonraki bir tarihte kaydetmek ve yayınlamak için), Kaydet ve Yayınla'yı (şimdi yayınlamak için) veya İptal'i (iptal etmek için) tıklayın.

API'yi kullanarak sınır bildirimleri ayarlama

Para kazanma, çeşitli bildirim türleri için metin sağlayan bir dizi şablon sunar. Bu bildirimler arasında sınır bildirimlerinin yanı sıra geliştiricileri yeni ürünlerin kullanılabilirliği konusunda uyarmak gibi geçici bildirimler de yer alır. Bu şablonların herhangi birini ihtiyaçlarınıza göre uyarlayabilirsiniz. Otomatik sınır bildirimi ayarlamak için önce uygun bir şablonu düzenleyin. Ardından, düzenlenen şablonun sağladığı bildirimin gönderilmesine neden olan koşulu belirtin. Daha fazla bilgi için Bildirim şablonlarını kullanarak bildirim ayarlama başlıklı makaleyi inceleyin.

Sonraki adımlar

Geliştiricileri yeni ürünler, yeni H&K sürümleri veya yeni fiyat planları gibi etkinlikler hakkında uyarmak için otomatik bildirimleri nasıl ayarlayacağınızı öğrenin. Bildirim şablonlarını kullanarak bildirimleri ayarlama başlıklı makaleyi inceleyin.