OpenAI Ads dönüşüm ölçümünde gönderilen her event iki şeyi netleştirmek zorunda: hangi standart event olduğu ve hangi veri şeklini (data type) taşıdığı. Platform on bir standart event ve dört veri şekli tanımlar; doğru ölçüm, her aksiyonu doğru event’e ve doğru şekle bağlamaktan geçer. Bu referans, hangi event’in ne zaman gönderileceğini ve her şeklin alanlarını listeler.
Event adı aksiyonun ne olduğunu, veri şekli ise o aksiyonun hangi alanları taşıdığını belirler. İkisi birbirine bağlıdır: order_created her zaman contents şeklini, lead_created her zaman customer_action şeklini kullanır.
Standart Event’ler
On bir standart event, dört veri şeklinden birine bağlanır. Aşağıdaki tablo her event’in adını, kullandığı şekli ve ne zaman gönderileceğini verir1.
| Event | Veri şekli (type) | Ne zaman |
|---|---|---|
page_viewed | contents | Önemli bir sayfa görüntülenir |
contents_viewed | contents | Ürün, ilan, içerik ya da birim görüntülenir |
items_added | contents | Sepete, pakete ya da seçime öğe eklenir |
checkout_started | contents | Ödeme akışı başlar |
order_created | contents | Satın alma tamamlanır |
lead_created | customer_action | Lead formu gönderilir ya da iletişim istenir |
registration_completed | customer_action | Hesap ya da etkinlik kaydı tamamlanır |
appointment_scheduled | customer_action | Toplantı, demo ya da görüşme planlanır |
subscription_created | plan_enrollment | Ücretli abonelik başlar |
trial_started | plan_enrollment | Ücretsiz deneme başlar |
custom | custom | Taksonomide olmayan, tanımlı bir aksiyon |
checkout_started ile order_created ayrımına dikkat etmek gerekir: biri ödeme akışının başlangıcını, diğeri tamamlanan satın almayı işaretler. İkisini karıştırmak dönüşüm sayımını bozar.
Dört Veri Şekli
Her event’in data nesnesi, type alanında şeklin adını taşır ve o şekle özgü alanları kullanır. Aşağıdaki tablo dört şeklin alanlarını ve zorunluluk durumlarını verir1.
Şekil (type) | Alanlar | Notlar |
|---|---|---|
contents | amount, currency, contents[] | Ürün ve sipariş event’leri |
customer_action | amount, currency | Lead, kayıt ve randevu event’leri |
plan_enrollment | plan_id, amount, currency, contents[] | Abonelik ve trial event’leri |
custom | plan_id, amount, currency, contents[] | Taksonomi dışı aksiyonlar |
Her şekilde type alanı zorunludur ve şeklin adını taşır. amount ve plan_id opsiyoneldir; currency ise koşulludur, yani amount gönderildiğinde zorunlu olur. customer_action en dar şekildir: ürün listesi (contents[]) ya da plan_id taşımaz, yalnızca isteğe bağlı bir tutar alır.
contents[] Dizisindeki Öğeler
contents[] dizisindeki her öğe bir ürün ya da içerik birimini tanımlar. Tüm alanlar opsiyoneldir; yalnızca elde olan gönderilir1.
| Alan | Açıklama |
|---|---|
id | Ürün ya da içerik kimliği |
name | Ürün ya da içerik adı |
content_type | Birim türü (product, page vb.) |
quantity | Adet (tam sayı) |
amount | Öğe başına tutar (minor unit, tam sayı) |
currency | Öğe para birimi |
Parasal Değer ve Para Birimi
Parasal değerler her yerde aynı kurala uyar: belirtilen para biriminin ISO 4217 minor unit cinsinden tam sayı olarak gönderilir. 129,99 USD 12999 olur, kuruş ya da sent ayrımı ondalıkla değil minor unit ile ifade edilir. İkinci kural bunu tamamlar: amount gönderilirse currency de zorunludur1. Yani bir tutar göndermek, para birimini de göndermeyi gerektirir.
Minor unit ve para birimi hatalarının ayrıntıları ayrı bir yazının konusu; burada kuralın taksonominin her şeklinde aynı olduğunu belirtmek yeterli.
Custom Event’ler
Taksonomideki on standart event bir aksiyonu karşılamıyorsa custom kullanılır ve custom_event_name ile adlandırılır. Custom ad 1-64 karakter uzunluğundadır; küçük harf, rakam, alt çizgi ve tire içerebilir. Standart bir event adı custom_event_name olarak yeniden kullanılamaz1. Custom şekli, standart şekillerin alanlarını (plan_id, amount, currency, contents[]) kullanabildiği için taksonomi dışı aksiyonları da yapılandırılmış veriyle gönderme imkânı verir.
Önce standart event, sonra custom
Bir aksiyon için standart bir event varsa onu kullanmak, custom event’e göre daha iyi raporlanır ve platformun beklediği şekle doğal oturur. custom yalnızca taksonominin karşılamadığı, gerçekten özel aksiyonlar için ayrılmalı. Her özel ihtiyaç için custom üretmek, standart event’lerin sağladığı tutarlılığı kaybettirir.
Sonraki Adımlar
Event ve şekil eşleşmesi netleştiğinde sıra, bu event’lerin pixel ve Conversions API üzerinden nasıl gönderileceğine ve para birimi gönderiminde sık yapılan hatalara gelir. Taksonomi doğru kurulduğunda hem tarayıcı hem sunucu tarafı aynı dili konuşur ve dönüşümler tutarlı sayılır.
Footnotes
-
Supported events (OpenAI Developers) — standart event taksonomisi ve her event’in veri tipi (appointment_scheduled/lead_created/registration_completed = customer_action; checkout_started/contents_viewed/items_added/order_created/page_viewed = contents; subscription_created/trial_started = plan_enrollment; custom), dört veri şekli ve alanları (contents/customer_action/plan_enrollment/custom; Content nesnesi id/name/content_type/quantity/amount/currency), minor units kuralı (“Send monetary values as integers in the standard ISO 4217 minor unit for the currency code you provide.”), amount varsa currency zorunlu (“If you include an
amount, also include acurrency.”), custom event adlandırma (1-64 karakter, küçük harf/rakam/alt çizgi/tire, standart ad tekrar kullanılamaz). ↩ ↩2 ↩3 ↩4 ↩5
- 01 On bir standart event var; her biri dört veri şeklinden birine bağlı: contents, customer_action, plan_enrollment, custom.
- 02 contents şekli ürün/sipariş event'lerinde (amount + currency + contents[]); customer_action lead/kayıt event'lerinde (yalnızca amount + currency).
- 03 plan_enrollment abonelik ve trial event'lerinde kullanılır ve plan_id taşıyabilir; custom şekli taksonomi dışı aksiyonlar için.
- 04 Parasal değer ISO 4217 minor unit cinsinden tam sayı: 25,99 USD için 2599. amount gönderilirse currency zorunlu.
- 05 custom event adı 1-64 karakter, küçük harf, rakam, alt çizgi veya tire; standart event adı tekrar kullanılamaz.
+ OpenAI Ads kaç standart event tanımlar?
On bir standart event vardır: page_viewed, contents_viewed, items_added, checkout_started, order_created, lead_created, registration_completed, appointment_scheduled, subscription_created, trial_started ve custom. İlk beşi contents şeklini, lead_created/registration_completed/appointment_scheduled customer_action şeklini, subscription_created/trial_started plan_enrollment şeklini kullanır; custom ise taksonomide olmayan aksiyonlar içindir.
+ Veri şekilleri (data type) nelerdir?
Dört şekil var: contents (amount, currency, contents[]), customer_action (amount, currency), plan_enrollment (plan_id, amount, currency, contents[]) ve custom (plan_id, amount, currency, contents[]). Her şeklin type alanı zorunludur ve şeklin adını taşır.
+ Parasal değer nasıl gönderilir?
Parasal değerler, belirtilen para biriminin ISO 4217 minor unit cinsinden tam sayı olarak gönderilir. Örneğin 129,99 USD için 12999. amount alanı gönderilirse currency alanı da zorunlu olur.
+ custom event adı hangi kurallara uyar?
custom event adı 1-64 karakter uzunluğundadır; küçük harf, rakam, alt çizgi ve tire içerebilir. Standart bir event adı custom_event_name olarak yeniden kullanılamaz.