Skip to main content
Bu sayfa @whop/elements@1.10.0 ve @whop/elements-react@1.10.0 sürümlerini belgeler.
v1.0.0 sürümünden beri.

Deneme alanı

Öğeleri örnek verilerle bir araya getirin. Kontrolleri kullanın, öğe ekleyip düzenleyin ve olayların canlı olarak tetiklenmesini izleyin:

Seçenekler

Bunları whop.ads.create({ … }) fonksiyonuna veya React’te <Ads> üzerinde props olarak iletin.
string
Reklamlarının okunacağı, biz_ önekli Whop hesap kimliği. Zorunludur; bu bir reklam hesabı kimliği değildir. Varsayılan: "".
string
Bu tanıtıcı altındaki her yüzeyin okuma ve yazma için kullandığı kapsamlı bir token. Öğe başına bir değil, tüm tanıtıcı için tek bir token oluşturun. Bağlayacağınız her öğenin kapsamlarını belirleyin, bunları tek bir token üzerinde isteyin ve burada ayarlayın; tanıtıcı bu tek kimlik bilgisini her öğenin çerçevesine yansıtır, bu nedenle yüzey başına ikinci bir token hiçbir şey kazandırmaz ve size bir yerine birkaç son kullanma tarihi takip ettirir. Token’ı sunucunuzda POST /api/v1/access_tokens ile oluşturun ve süresi dolmadan önce update({ accessToken }) ile yenisini ayarlayın. Her şeyi bağlamak için ad_campaign:read/:create, ad_group:read, ad:read, stats:read, tablonun satır işlemlerinin kullandığı :update/:delete kapsamları, campaign-creator öğesinin çalıştırdığı piksel kontrolleri için company:basic:read ve bir reklam harcaması kartı eklemek için payment:charge ile user:email:read gerekir; faturalandırma yuvaları kayıtlı kartları ve harcanabilir cüzdanları member:payment_methods:read ile listeler. Daha az yüzey bağlamak daha az kapsam gerektirebilir; yine de tek token üzerinde. Atlanırsa çağrılar, yalnızca aynı kaynakta yanıt veren görüntüleyenin kendi oturumunu taşır.
Raporlama table öğesinin tıklama ve sonuç sayılarının sitenizde nereye bağlandığı; genellikle tracking ad alanının people ve events öğelerini bağladığınız sayfalar. people ve events mutlak temel URL’lerdir (https://…); tablo, bu öğelerin props olarak aldığı aynı sorgu parametrelerini ekler (?source=whop:adcamp_…:*&event=…&from=…&to=…), böylece hedef sayfa öğesini doğrudan URL’sinden doldurabilir. Göreli bir URL öğe çerçevesine göre çözümleneceğinden ayarlanmamış kabul edilir; ayarlanmamış bağlantılar sayıları düz rakamlar olarak gösterir. Varsayılan: {}.
Appearance
Bu grubun öğeleri için görsel özelleştirme. Genel WhopElements({ appearance }) ayarını geçersiz kılar. update({ appearance }) ile canlı olarak değiştirin.
WhopElementsLocale
Bu grubun öğe arayüz metinleri için yerel ayar. Genel yapılandırmayı geçersiz kılmak için uygulamanın derlenmiş yerel ayarlarından birine ayarlayın. Diğer tüm değerler varsayılan yerel ayara geri döner.

Olaylar

Geri çağırmaları create seçeneklerinde veya React props’larında iletin.

onBillingChanged

Hesabın reklam harcaması ödeme yöntemleri değişti ve değişiklik kaydedildi. Yuva değerleri yöntem kimliklerinin kendisidir: kart için payt_…, bakiye için ldgr_…; boş bir backup hiçbirinin ayarlanmadığı anlamına gelir.
object

onLoadingChange

Gruplanmış yükleme durumu değiştiğinde çalışır. Bağlı herhangi bir öğe hâlâ yükleniyorken değer true olur.
boolean

Yöntemler

Bunları whop.ads.create({ … }) veya useAds() ile alınan Ads tanıtıcısı üzerinde çağırın.

update

Yeni tanıtıcı seçeneklerini bağlı her öğeyle birleştirir. React’te bunun yerine ad alanı props’larını değiştirin. Parametreler
Partial<AdsOptions>
gerekli

destroy

Bu tanıtıcının oluşturduğu her öğeyi ve alt denetleyiciyi yok eder, denetleyici çerçevesini kaldırır ve aboneliklerini serbest bırakır. Birden fazla kez çağırabilirsiniz, ancak yok edilmiş bir tanıtıcı diğer tüm çağrıları reddeder; baştan başlamak için yeni bir tanıtıcı oluşturun. Sağlayıcı bağlantısı kaldırıldığında React grubu otomatik olarak kaldırır.

Öğeler

Bu grubun bağladığı öğeler. Her birinin kendi sayfası vardır:

Raporlama

Bir reklam hesabının raporlaması: bir zaman aralığında, hangi düzeye daraltırsanız o düzeyde, ne harcadığı ve karşılığında ne geldiği. chart, table veya her ikisini bağlayın; aynı zaman aralığını, aynı atıf kuralını ve aynı seçimi okurlar, böylece yan yana iki yüzey gösterdikleri şey konusunda asla çelişmez. ads tanıtıcısının links yapılandırması, tablonun tıklama ve sonuç sayılarını kendi sayfalarınıza, yani tracking ad alanının people ve events öğelerini bağladığınız sayfalara bağlar. (alt denetleyici, 3 öğe)

BillingSetupElement

Reklam harcamasının hangi ödeme yöntemlerinden faturalandırılacağı: önce kullanılan bir birincil yöntem ve başarısız olduğunda kullanılacak isteğe bağlı bir yedek. Her ikisi de hesapta zaten kayıtlı yöntemler arasından seçilir ve birini seçmek onu hemen kaydeder; ayrı bir gönderme adımı yoktur. Kart eklemek, sayfanızın üzerinde bir kart formu açar ve onu isteyen yuvaya geri döner. Hesabın bir bakiyesi varsa, bakiye kartlarının yanında görünür.

CampaignCreatorElement

Reklam kampanyası oluşturucu: hedef ve bütçe, hedeflemeleri ve zamanlamalarıyla reklam grupları ve kreatifleriyle reklamların kendisi; başlatmaya kadar tüm akış. Yeni bir kampanya oluşturmak için boş açılır veya campaignId ilettiğinizde mevcut bir kampanyada açılır. Piksel denetleyicisini de çalıştırır: bir başlatma, reklam grubunun dönüşüm olayının hedef URL’de etkin olmasına bağlıdır ve eksik bir kurulumu düzeltmek için pixel-setup sihirbazı bu öğenin içinde açılır. Bir başlatma ayrıca hesabın Whop Ads sözleşmesini imzalamış olmasına bağlıdır: imzalamadıysa tanıtıcı oluşturucunun üzerinde ads-agreement açar ve imzalandıktan sonra başlatma devam eder. Bütçeler hesabın ads_reporting_currency para biriminde (raporlarının zaten kullandığı para birimi) girilir ve gösterilir, güncel döviz kuruyla USD’ye çevrilerek USD üzerinden faturalandırılır. ads tanıtıcısında ayarladığınız tek token, öğe başına ayrı bir token kullanmak yerine kampanya kapsamlarının yanında piksel kapsamlarını da (ad_campaign:create ve company:basic:read) taşımalıdır.

AdsAgreementElement

Bir hesap için Whop Ads Services and Payment Authorization Agreement sözleşmesini imzalar. Hesabın reklam harcaması faturalandırmasını kaydetmek sözleşmeyi açar; yetkili bir temsilci imzalayana kadar hiçbir kampanya başlatılamaz. İmzalayan kişi tam yasal adını ve isteğe bağlı olarak unvanını yazar, koşulları kabul eder ve yazılan imza sözleşmeyle birlikte dosyalanır. İmzalandıktan sonra bu öğe kimin ve ne zaman imzaladığını gösterir; faturalandırma kurulmadan önce imzalanacak bir şey yoktur ve bunu belirtir. Bir başlatma imza gerektirdiğinde campaign-creator bunu oluşturucunun üzerinde kendiliğinden açar; bu nedenle bunu yalnızca imzalamayı önceden sunmak için (örneğin bir ayarlar veya onboarding sayfasında) kendiniz bağlayın.