OpenAI Ads parasal değeri tek bir biçimde bekler: para biriminin ISO 4217 minor unit değeri cinsinden tam sayı. 25,99 USD 2599, 129,99 USD 12999 olarak gönderilir ve amount varsa currency zorunludur1. Değer gönderiminde yaşanan hataların neredeyse tamamı bu kuralın yanlış uygulanmasından çıkar ve en yaygını ondalık göndermektir, çünkü başka birçok araçta değer ondalıktır.
Bu yazı bu tuzakları tek tek gösterir. Hepsinin ortak noktası ölçek: doğru sayıyı yanlış birimle göndermek, dönüşüm değerini sessizce yüz ya da bin kat kaydırır.
Minor Unit Ölçeği
Minor unit, bir para biriminin alt birimidir: USD için sent, TRY için kuruş. Çoğu para biriminde bu oran 1/100’dür, yani değer yüzle çarpılıp tam sayıya çevrilir. ISO 4217 her para birimi için bu ölçeği tanımlar2. OpenAI Ads’in beklediği biçim de budur: ondalık nokta yok, değer minor unit cinsinden tam sayı.
| Konvansiyon | Birim | 25,99 USD nasıl yazılır |
|---|---|---|
| OpenAI Ads | Tam sayı, minor unit | 2599 |
| Meta CAPI, GA4, Google Ads gtag | Ondalık, major unit | 25.99 |
| Google Ads API (Money tipi: cost, bid) | Tam sayı, × 1.000.000 | 25990000 |
Tablodaki üç değer de aynı parayı ifade eder ama farklı ölçektedir. OpenAI Ads yalnızca ilk satırı kabul eder. Dikkat çeken nokta, ikinci satırın yaygınlığıdır: dönüşüm ölçümünde en sık kullanılan biçim ondalıktır, o yüzden asıl tuzak da oradadır.
Hata 1: Ondalık Göndermek (En Yaygın)
En sık hata, değeri ondalık major unit olarak göndermektir: 25.99. Bunun nedeni alışkanlık: Meta Conversions API, GA4 ve Google Ads gtag dönüşüm değerini ondalık gönderir3. Bu araçlardan birinden gelen biri, OpenAI Ads’e de içgüdüsel olarak 25.99 yazar. Oysa OpenAI Ads tam sayı minor unit bekler; doğrusu 2599. Major unit ile minor unit arasındaki fark yüz kattır, yani 25,99 USD yerine yanlışlıkla 0,2599 USD raporlanabilir.
Hata 2: Sıfır ve Üç Ondalıklı Para Birimleri
“Değeri yüzle çarp” kuralı evrensel değildir. ISO 4217’de minor unit ölçeği para birimine göre değişir2:
- Sıfır ondalıklı (JPY, KRW gibi): minor unit yoktur, değer doğrudan tam sayıdır. 2599 JPY
2599olarak gönderilir,259900değil. Yüzle çarpmak değeri yüz kat şişirir. - Üç ondalıklı (KWD, BHD, OMR): minor unit 1/1000’dir. 1,500 KWD
1500olarak gönderilir. Yüzle çarpmak (150) değeri on kat küçültür.
Yalnızca USD ve EUR ile çalışan bir sistem “her zaman yüzle çarp” varsayımıyla idare edebilir, ama JPY ya da KWD girince bu varsayım kırılır. Para birimi başına minor unit ölçeğini ISO 4217 tablosundan almak gerekir.
Hata 3: currency Olmadan amount
OpenAI Ads dokümantasyonu açıktır: amount gönderilirse currency de zorunludur1. Tutarı para birimi olmadan göndermek event’i eksik bırakır. Aynı şekilde, event seviyesindeki amount ile contents[] içindeki item seviyesi tutarların aynı minor unit ölçeğinde olması gerekir; biri minor unit diğeri ondalıksa toplam tutarsız çıkar.
Hata 4: Google Ads API’sinin Micros Değeri
Bu tuzak yalnızca dar bir kesimi ilgilendirir ama sonucu büyüktür. Google Ads API’si parasal alanları micros cinsinden taşır: 1 birim 1.000.000 micros olarak ifade edilir, yani 25,99 USD 25990000 olur4. Bu ölçek daha çok cost ve bid gibi alanlarda görülür; gtag ile gönderilen dönüşüm değeri ise ondalıktır3. Karışıklık, bir kurulum Google Ads API’sinden micros cinsinden bir değer çekip OpenAI Ads’e olduğu gibi aktardığında çıkar: 2599 yerine 25990000 gider ve tutar on bin kat şişer. İki sistem arasında değer taşıyan her kurulumda ölçek dönüşümünü açıkça yapmak gerekir.
Ölçeği bir kez sabitle
Değer hatalarının kökü neredeyse her zaman ölçek karışıklığıdır. Para değerlerini sistemde tek bir yerde minor unit tam sayıya çeviren bir yardımcı fonksiyon kullanmak, ondalık, micros ve para birimi başına ölçek farklarını tek noktada toplar. Değeri her gönderim yerinde yeniden hesaplamak, tutarsızlığın asıl kaynağıdır.
Sonraki Adımlar
Değer ve para birimi biçimi yerine oturduğunda, OpenAI Ads ölçümünün teknik tarafı büyük ölçüde tamamlanır: event taksonomisi, kimlik eşleştirme, dedup ve değer gönderimi birlikte tutarlı bir kurulum oluşturur. Geriye, bu kurulumu kampanya yönetimi ve raporlama tarafına bağlamak kalır.
Footnotes
-
Supported events (OpenAI Developers) — minor units kuralı ve örneği (“Send monetary values as integers in the standard ISO 4217 minor unit for the currency code you provide, for example
12999for $129.99 withcurrency: \"USD\".”),amounttam sayı ve gönderildiğindecurrencyzorunlu, event seviyesi ilecontents[]item seviyesiamount/currency. ↩ ↩2 - Currency codes and minor units (Adyen Docs) — ISO 4217 minor unit ölçekleri: çoğu para birimi iki ondalık (1/100), JPY gibi para birimleri sıfır ondalık (minor unit yok), KWD/BHD/OMR üç ondalık (1/1000). ↩ ↩2
-
Track transaction-specific conversion values (Google Ads Help) — gtag dönüşüm değeri ondalık gönderilir (“pass the conversion value as a number, using a period as a decimal delimiter”), örnek
'value': 123.05,currencyISO 4217 kodu. ↩ ↩2 -
Money (Google Ads API) — Google Ads API parasal alanları micros cinsinden taşır: 1 birim = 1.000.000 micros, yani 1,23 USD
1230000olarak ifade edilir. ↩
- 01 OpenAI Ads değeri tam sayı minor unit ister: 25,99 USD için 2599. En yaygın hata ondalık (25.99) göndermektir.
- 02 Meta CAPI, GA4 ve Google Ads gtag dönüşüm değeri ondalık major unit kullanır (25.99); OpenAI Ads bu alışkanlığın tersine tam sayı bekler.
- 03 Sıfır ondalıklı para birimleri (JPY, KRW) minor unit içermez: 2599 JPY 2599 olarak gönderilir, 259900 değil. Üç ondalıklı (KWD, BHD, OMR) 1/1000 ölçeklenir.
- 04 Micros yalnızca Google Ads API'sinin Money tipinde geçer (cost, bid; × 1.000.000); dönüşüm değeri gtag'de ondalıktır. Karışıklık API'den değer çekerken çıkar.
- 05 amount gönderilirse currency zorunlu; event seviyesi ile item seviyesi tutarları aynı minor unit ölçeğinde olmalı.
+ OpenAI Ads değeri hangi biçimde ister?
Parasal değer, para biriminin ISO 4217 minor unit cinsinden tam sayı olarak gönderilir. 25,99 USD için 2599, 129,99 USD için 12999 yazılır. amount alanı tam sayıdır ve gönderildiğinde currency alanı da zorunlu olur.
+ Neden ondalık göndermek en sık hata?
Çünkü diğer ölçüm araçlarının çoğu ondalık kullanır: Meta Conversions API, GA4 ve Google Ads gtag dönüşüm değerini ondalık major unit olarak gönderir (25.99). Bu araçlardan birinden gelen biri OpenAI Ads'e de içgüdüsel olarak 25.99 gönderir, oysa OpenAI Ads tam sayı minor unit (2599) bekler. İkisi arasındaki fark yüz kattır.
+ Micros ile minor unit aynı şey mi?
Hayır ve micros çoğu kurulumu ilgilendirmez. Micros, Google Ads API'sinin Money tipinde geçen bir ölçektir (1 birim = 1.000.000 micros) ve daha çok cost, bid gibi alanlarda görülür; gtag ile gönderilen dönüşüm değeri ise ondalıktır. Karışıklık yalnızca Google Ads API'sinden micros cinsinden değer çekip OpenAI Ads'e olduğu gibi aktaran kurulumlarda çıkar; bu durumda değer on bin kat şişer.
+ JPY gibi para birimlerinde değer nasıl gönderilir?
JPY, KRW gibi sıfır ondalıklı para birimlerinin minor unit'i yoktur; değer doğrudan tam sayı olarak gönderilir. 2599 JPY 2599 olarak yazılır, 259900 değil. KWD, BHD, OMR gibi üç ondalıklı para birimleri ise 1/1000 ölçeklenir: 1,500 KWD için 1500.