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. Ads içine bağlanır. Bir tanıtıcı almak için oluşturun, ardından öğelerini o tanıtıcı üzerinde bağlayın. Alt denetleyiciyi kaldırmak için destroy() çağırın. Yeni bir tanıtıcı almak için yeniden oluşturun.

Önizleme

Bu alt denetleyicinin varsayılan düzeninin örnek verilerle canlı, etkileşimli bir demosu:

Seçenekler

Bunları ads.create('reporting', { … }) fonksiyonuna veya React’te <Reporting> üzerinde props olarak iletin. Üst öğe tarafından enjekte edilen props’lar burada hiçbir zaman görünmez.
string
Her yüzeyin raporladığı zaman aralığı: today, yesterday, last_7_days, last_14_days, last_30_days, last_90_days, all_time veya custom (customRange ile birlikte kullanın). Seçici grafikte bulunur ve bu değeri değiştirir; böylece bir ana bilgisayar zaman aralığını yönetebilir ve periodChanged üzerinden geri okuyabilir. Varsayılan: "last_14_days".Şunlardan biri: "today", "yesterday", "last_7_days", "last_14_days", "last_30_days", "last_90_days", "all_time" veya "custom".
object | null
period değeri custom olduğunda kullanılan, ISO 8601 anları olarak açık zaman aralığı. Aksi takdirde yok sayılır. Varsayılan: null.
"account" | "local"
Raporlanan her rakam için saat dilimi seçimi. Hesabın preferences.ads_scheduling_timezone ayarı için account, görüntüleyenin tarayıcı saat dilimi için local kullanın. Grafiğin sunduğu tek seçenekler bunlardır. Serbest biçimli bir IANA saat dilimi, seçicinin verileri yanlış etiketlemesine neden olabilir ve görüntüleyen seçimi değiştirdiğinde kaybolur. Başka bir saat diliminde raporlamak için hesap ayarını değiştirin. Hesabın bir ayarı yoksa account, görüntüleyenin saat dilimine geri döner. Varsayılan: "account".
string
Dönüştürülen tutarlar için usd veya eur gibi küçük harfli, üç harfli ISO 4217 para birimi kodu. Ayarlanmazsa varsayılan olarak hesabın preferences.ads_reporting_currency değeri kullanılır. Varsayılan: "".
"last_touch" | "first_touch"
Bir alıcının yolculuğundaki hangi temasın atfı aldığı: varsayılan olan last_touch veya first_touch. Her ikisinde de yolculuğun herhangi bir yerindeki bir Whop teması Whop grubunu kazanır; model yalnızca uç noktaları seçer. Seçici tabloda bulunur ve bu değeri değiştirir; böylece bir ana bilgisayar bunu yönetebilir ve attributionModelChanged üzerinden geri okuyabilir. Varsayılan: "last_touch".
string[]
Raporlamayı bu reklam kampanyalarıyla (adcamp_…) sınırlayın. Boş bırakılırsa tüm hesap raporlanır. adGroupIds veya adIds ayarlandığında bunlar tarafından geçersiz kılınır. Kesin bir rakam için tek bir kimlik iletin: raporlama API’si tek bir kaynak yoluna göre kapsamlandırır, bu nedenle birden fazla kimlik verildiğinde grafik yalnızca ilkini raporlar. Varsayılan: [].
string[]
Raporlamayı bu reklam gruplarıyla (adgrp_…) sınırlayın. campaignIds üzerinde önceliklidir. Aynı tek kimlik uyarısı geçerlidir. Varsayılan: [].
string[]
Raporlamayı bu reklamlarla (ad_…) sınırlayın. En dar filtredir; diğer ikisinin üzerinde önceliklidir. Aynı tek kimlik uyarısı geçerlidir. Varsayılan: [].
"ads" | "all" | "businesses" | "campaigns" | "ad-groups"
table öğesinin hangi tabloda açılacağı: campaigns, ad-groups, ads veya trafik kaynağı görünümü için all. all her zaman hesap genelinde raporlar (kaynak serisi yalnızca bu düzeyde vardır); bu nedenle yanında ayarlanan bir filtre tabloyu daraltır ancak grafiği daraltmaz. Varsayılan: "campaigns".
string[] | null
Grafiğin hangi trafiği raporladığı, kaynak yolları olarak: Whop üzerinden satın alınan reklamlar için whop:*, başka yerlerde yayınlanan reklamlar için ext:* ve ext:<platform>:*, organik trafik için referrer:*, direct, other. Varsayılan olan null yalnızca Whop reklamlarını raporlar; [] her kaynağı raporlar; boş olmayan bir dizi yalnızca bunları raporlar. Bu, Whop reklamları içinde daraltma yapan campaignIds ve benzerlerinden FARKLI bir eksendir; harcamadan türetilen oranlar bu değer ne olursa olsun Whop’a atfedilmiş olarak kalır, çünkü harcama yalnızca Whop reklamları satın almıştır. table öğesinin All sekmesi bu değeri değiştirir. Varsayılan: null.

Olaylar

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

onEditRequested

Görüntüleyen bir şeyi düzenlemek istedi: bir satır menüsü, bir taslak satır veya ayrıntılar katmanındaki Edit ad. campaignId her zaman bulunur; adGroupId ve adId bunu tıklanan öğeye daraltır. Yalnızca useCampaignCreator kapalıyken tetiklenir; açıkken bunun yerine oluşturucu sayfanın üzerinde açılır ve bu olay tetiklenmez.
AdsEditTarget

Yöntemler

Bunları ads.create('reporting', { … }) ile alınan alt tanıtıcı üzerinde çağırın.

update

Yeni props ve geri çağırmaları alt denetleyiciyle birleştirir. Parametreler
Partial<ReportingSubOptions>
gerekli

destroy

Alt denetleyiciyi ve öğelerini yok eder, ardından özel yuvasını serbest bırakır. Sonraki bir create("reporting") sıfırdan başlar.

Öğeler

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

ChartElement

Bir hesabın bir zaman aralığındaki performansı; neyin çizileceğini seçmek için bir seçiciyle birlikte: harcama, gösterimler, tıklamalar veya hesabın kaydettiği herhangi bir dönüşüm. Salt okunur.

TableElement

Bir reklam hesabının kampanyaları, reklam grupları ve reklamları, aralarında geçiş yapan sekmelerle tek bir tabloda: alt düzeyi daraltmak için satırlar seçin, arayın, sıralayın, rakamları kırılımlara ayırın, sütunlarınızı seçin ve doğrudan bir satırdan duraklatın, devam ettirin, çoğaltın veya silin. Raporladığı zaman aralığı ve filtrelendiği satırlar tanıtıcıda tutulur, böylece yanına bağlanan bir grafik tam olarak aynı şeyi raporlar.