ChatGPT Ads API Nasıl Kullanılır? Advertiser API ile Kampanya Otomasyonu, Raporlama ve Entegrasyon Rehberi

ChatGPT Ads kampanyalarını yalnızca Ads Manager arayüzünden yönetmek zorunda değilsiniz. Çok sayıda kampanya yöneten ajanslar, e-ticaret işletmeleri, SaaS şirketleri ve kendi reklam yönetim sistemini geliştirmek isteyen işletmeler için ChatGPT Ads Advertiser API programatik reklam yönetimi imkânı sunar.

OpenAI'nin güncel Ads geliştirici dokümantasyonuna göre Advertiser API kullanılarak:

• Kampanyalar oluşturulabilir ve yönetilebilir.
• Reklam grupları oluşturulabilir.
• Reklamlar yüklenebilir ve güncellenebilir.
• Reklam görselleri API üzerinden yüklenebilir.
• Product Feed kampanyaları yönetilebilir.
• Custom Audiences yönetilebilir.
• Conversion tracking kaynakları yapılandırılabilir.
• Performans ve conversion raporları alınabilir.
• Toplu kampanya işlemleri yapılabilir.
• Hesap değişiklikleri Audit Logs üzerinden takip edilebilir.

Kısaca: Ads Manager reklamları manuel olarak yönetmenizi sağlar. ChatGPT Ads Advertiser API ise aynı reklam operasyonlarının önemli bölümünü kendi yazılımınız, otomasyonunuz veya ajans sisteminiz üzerinden programatik olarak yönetmenize yardımcı olur.

ChatGPT Ads hesabınızı henüz oluşturmadıysanız önce şu rehberimizi inceleyebilirsiniz:

ChatGPT Ads Hesabı Nasıl Açılır? Ads Manager Kurulumu, Doğrulama ve Faturalandırma Rehberi

ChatGPT Ads API Nedir?

ChatGPT Ads Advertiser API, reklamverenlerin Ads Manager'daki reklam kaynaklarını programatik olarak oluşturmasına, yönetmesine ve raporlamasına olanak sağlayan OpenAI reklam API'sidir.

API özellikle şu işlemler için kullanılabilir:

• Campaign oluşturma
• Campaign güncelleme
• Campaign pause veya activate işlemleri
• Ad Group oluşturma
• Teklif yapılandırma
• Context Hints ekleme
• Ad oluşturma
• Reklam görseli yükleme
• Product Feed yönetimi
• Audience yönetimi
• Conversion configuration
• Performance reporting
• Bulk operations
• Audit logging

Bu sayede reklam yönetimi doğrudan işletmenin kendi:

• CRM sistemine,
• E-ticaret paneline,
• Ajans yönetim yazılımına,
• BI sistemine,
• Raporlama dashboard'una

entegre edilebilir.

ChatGPT Ads API ile OpenAI API Aynı Şey mi?

Hayır.

Bu iki API tamamen farklı amaçlara sahiptir.

API	Temel Amaç
OpenAI API	GPT modelleri, yapay zekâ uygulamaları ve geliştirici ürünleri
ChatGPT Ads Advertiser API	ChatGPT Ads kampanyalarını ve reklam kaynaklarını yönetmek

Örneğin:

api.openai.com

üzerindeki genel OpenAI API ile:

api.ads.openai.com

üzerindeki Ads API aynı sistem değildir.

OpenAI API anahtarınızı ChatGPT Ads kampanyalarını yönetmek için kullanamazsınız. Ads API için reklam hesabına bağlı Advertiser API anahtarı gerekir.

Advertiser API ile Conversions API Aynı Şey mi?

Hayır.

Bu da oldukça önemli bir ayrımdır.

Advertiser API

Reklam operasyonunu yönetir:

• Campaign
• Ad Group
• Ad
• Audience
• Feed
• Reporting

Conversions API

Server-side conversion event'lerini gönderir:

• Purchase
• Lead
• Registration
• Trial
• Subscription

Yani:

Advertiser API = Reklam yönetimi
Conversions API = Dönüşüm measurement

Conversions API rehberimiz:

ChatGPT Ads Conversions API Kurulumu Nasıl Yapılır? Server-Side Dönüşüm Takibi, Event ID ve Deduplication Rehberi

ChatGPT Ads API Kimler İçin Uygun?

API özellikle manuel Ads Manager operasyonu büyümeye başladığında değer kazanır.

Örneğin:

• Çok sayıda müşteri hesabı yöneten ajanslar
• Yüzlerce reklam oluşturan e-ticaret şirketleri
• Çok ülkeli reklamverenler
• Birden fazla ürün veya hizmet kampanyası yöneten markalar
• Kendi reklam yönetim panelini geliştiren şirketler
• Otomatik bütçe veya raporlama sistemleri kurmak isteyen ekipler
• Reklam performansını data warehouse'a aktarmak isteyen işletmeler

Advertiser API'den daha fazla faydalanabilir.

Küçük İşletmeler ChatGPT Ads API Kullanmalı mı?

Her reklamverenin API kullanması gerekmez.

Örneğin:

• 2–3 kampanya yönetiyorsanız,
• Ayda yalnızca birkaç reklam değiştiriyorsanız,
• Özel raporlama veya otomasyon ihtiyacınız yoksa

Ads Manager arayüzü yeterli olabilir.

API daha çok:

Tekrarlanan manuel operasyonları otomatikleştirmek gerektiğinde

anlamlı hale gelir.

ChatGPT Ads Advertiser API Kullanmak İçin Neler Gerekiyor?

Temel olarak:

• Aktif ChatGPT Ads hesabı
• Advertiser API Key
• API isteklerini çalıştıracak backend veya server ortamı
• Reklam hesabına gerekli erişim

gerekir.

API anahtarı Ads Manager içerisindeki Settings bölümünden oluşturulabilir.

API key oluşturulduktan sonra güvenli server ortamında saklanmalıdır.

Advertiser API Key Nedir?

Advertiser API Key, yazılımınızın belirli ChatGPT Ads reklam hesabına API üzerinden erişmesini sağlayan kimlik doğrulama anahtarıdır.

OpenAI'nin güncel sisteminde her Ads API key belirli bir reklam hesabına bağlıdır.

Bu nedenle ajans birden fazla müşterinin reklam hesabını yönetiyorsa:

Her müşteri hesabı için o hesaba ait API key kullanılmalıdır.

Bir müşterinin API key'i başka müşterinin reklam hesabını yönetmek için kullanılmamalıdır.

Advertiser API Key Nerede Saklanmalı?

API anahtarı yalnızca server tarafında saklanmalıdır.

Örneğin:

• Secret Manager
• Server environment variable
• Encrypted credential storage

kullanılabilir.

Şuralara yazılmamalıdır:

• Frontend JavaScript
• HTML
• Mobil uygulama içerisinde açık kod
• Public GitHub repository
• Paylaşılan dokümanlar

API key bir reklam hesabının yönetim yetkisini taşıyan hassas credential'dır.

ChatGPT Ads API Base URL Nedir?

Advertiser API için temel URL:

https://api.ads.openai.com/v1

şeklindedir.

API isteklerinde:

Authorization: Bearer OPENAI_ADS_API_KEY

header'ı kullanılır.

API Key Çalışıyor mu Nasıl Test Edilir?

İlk yapılması gereken işlemlerden biri reklam hesabını sorgulamaktır.

Örnek:

curl -X GET "https://api.ads.openai.com/v1/ad_account" \
  -H "Authorization: Bearer $OPENAI_ADS_API_KEY"

Başarılı response içerisinde:

• Ad Account ID
• Hesap adı
• Currency
• Timezone
• Account Status
• Review Status

gibi bilgiler bulunabilir.

API otomasyonuna başlamadan önce doğru reklam hesabına bağlı olduğunuzu mutlaka doğrulayın.

Account Active Görünüyorsa Reklam Vermeye Hazır mı?

Her zaman değil.

OpenAI'nin güncel API belgelerinde hesabın:

status = active

göstermesinin devam eden bir account review olmadığı anlamına gelmeyebileceği belirtilmektedir.

Bu nedenle ayrıca:

• Account Review
• Business Verification
• Billing

durumları da kontrol edilmelidir.

ChatGPT Ads API Kampanya Yapısı Nasıl?

API yapısı Ads Manager ile aynı temel reklam hiyerarşisini kullanır:

Ad Account
↓
Campaign
↓
Ad Group
↓
Ad

Ad Account

Reklamveren hesabıdır.

Campaign

Genellikle:

• Objective
• Budget
• Schedule
• Coğrafi hedefleme
• Platform hedefleme
• Audience inclusion / exclusion
• Conversion configuration

campaign seviyesinde yönetilir.

Ad Group

Genellikle:

• Bid configuration
• Context Hints
• Audience bid multiplier
• Product selection

ad group seviyesinde bulunur.

Ad

Reklamın:

• Başlığı
• Body metni
• Görseli
• Landing page URL'si

ad seviyesinde tanımlanır.

ChatGPT Ads API ile Kampanya Oluşturulabilir mi?

Evet.

Advertiser API:

POST /campaigns

endpoint'i üzerinden campaign oluşturmayı destekler.

Kampanyada:

• Campaign name
• Description
• Start date
• End date
• Status
• Budget
• Targeting
• Bidding type
• Conversion settings

gibi alanlar yapılandırılabilir.

Kampanyaları Önce Paused Oluşturmak Mantıklı mı?

Evet, özellikle API otomasyonlarında güçlü şekilde önerilebilir.

Örneğin otomasyon:

1. Campaign oluşturur.
2. Ad Group oluşturur.
3. Ads oluşturur.
4. Preview kontrol edilir.
5. Targeting kontrol edilir.
6. Bütçe kontrol edilir.
7. Daha sonra campaign activate edilir.

şeklinde tasarlanabilir.

Böylece yanlış bütçe veya yanlış hedeflemeyle reklamın otomatik olarak yayına çıkma riski azaltılabilir.

Idempotency-Key Nedir?

API otomasyonlarında en önemli kavramlardan biri Idempotency-Key yapısıdır.

Network problemi nedeniyle campaign oluşturma request'inin başarılı olup olmadığını bilemeyebilirsiniz.

Aynı request'i tekrar gönderirseniz yanlış tasarlanmış sistem:

Campaign 1
Campaign 2

şeklinde iki kampanya oluşturabilir.

OpenAI desteklenen create endpoint'lerinde Idempotency-Key kullanımına izin verir.

Örnek

Idempotency-Key: sam-campaign-0001

Aynı create request network hatası nedeniyle tekrar gönderilecekse:

• Aynı Idempotency-Key
• Aynı request body

kullanılmalıdır.

Yeni kaynak oluşturuyorsanız yeni Idempotency-Key kullanın. Aynı işlemi retry ediyorsanız aynı key'i kullanın.

Aynı Idempotency-Key ile Farklı Request Gönderirsem Ne Olur?

Aynı key farklı bir request body ile tekrar kullanılırsa conflict hatası oluşabilir.

Bu nedenle sisteminizde idempotency key'in:

• İşleme bağlı,
• Tekrar kullanılabilir,
• Loglanabilir

şekilde tasarlanması gerekir.

ChatGPT Ads API ile Ad Group Oluşturulabilir mi?

Evet.

Endpoint:

POST /ad_groups

üzerinden reklam grubu oluşturulabilir.

Ad Group içerisinde:

• Campaign ID
• Name
• Description
• Context Hints
• Status
• Bidding Configuration

tanımlanabilir.

Context Hints API Üzerinden Eklenebilir mi?

Evet.

Ad Group oluşturulurken:

"context_hints": [
  "small business CRM",
  "sales pipeline management"
]

gibi değerler gönderilebilir.

Ancak Context Hints'i exact-match keyword listesi gibi kullanmak doğru değildir.

Context Hints hakkında:

ChatGPT Ads Hedefleme Nasıl Yapılır? Context Hints ve Reklam Stratejisi

API ile Teklif Belirlenebilir mi?

Evet.

Ad Group içerisindeki:

bidding_config

alanı üzerinden teklif yapılandırması yapılabilir.

Campaign objective'e göre:

• Impression
• Click
• Conversion

bazlı yapılandırmalar kullanılabilir.

Teklif değerleri API'de genellikle account currency'nin mikro birimleri üzerinden gönderilir.

Micros Nedir?

Reklam API'lerinde parasal değerlerin floating-point hata oluşturmadan işlenmesi için mikro birimler kullanılabilir.

Örneğin:

1 para birimi = 1.000.000 micros

şeklinde düşünülebilir.

Örneğin maksimum teklif:

2,00

ise API'de:

2000000

şeklinde temsil edilebilir.

Kullandığınız reklam hesabının para birimini mutlaka kontrol edin.

ChatGPT Ads API ile Reklam Oluşturulabilir mi?

Evet.

Yeni reklam:

POST /ads

endpoint'i üzerinden oluşturulabilir.

Standart Chat Card reklamında:

• Ad Group ID
• Internal Ad Name
• Status
• Title
• Body
• Target URL
• File ID

gibi bilgiler gönderilir.

ChatGPT Ads API Reklam Başlığı Sınırı Nedir?

Güncel Advertiser API dokümantasyonunda standart Chat Card creative için:

• Title: 3–50 karakter
• Body: maksimum 100 karakter

sınırları belirtilmektedir.

API otomasyonu geliştirirken metin üretim sistemi bu limitleri göndermeden önce doğrulamalıdır.

API'nin hata vermesini beklemek yerine reklam metinlerini uygulamanız içinde önceden validate edin.

Reklam Görseli API Üzerinden Yüklenebilir mi?

Evet.

Advertiser API:

POST /upload

endpoint'i üzerinden reklam görsellerinin yüklenmesini destekler.

İki temel yöntem bulunmaktadır.

1. Image URL

Uzak URL'deki görsel sisteme yüklenebilir.

{
  "image_url": "https://example.com/reklam.jpg"
}

2. Binary Upload

Dosya doğrudan multipart form-data olarak gönderilebilir.

Başarılı işlem sonucunda:

file_id

alınır.

Daha sonra reklam creative oluşturulurken bu file ID kullanılır.

Aynı Görsel Birden Fazla Reklamda Kullanılabilir mi?

Evet.

Upload endpoint'inden dönen file_id yeniden kullanılabilir.

Böylece aynı görsel her reklam oluşturulduğunda tekrar yüklenmek zorunda değildir.

Ajans otomasyonunda örneğin:

Creative Library → File ID → Ads

yapısı kurulabilir.

API Üzerinden Reklam Önizlemesi Alınabilir mi?

Evet.

Mevcut reklam için:

POST /ads/{ad_id}/preview

endpoint'i kullanılabilir.

OpenAI'nin güncel dokümantasyonuna göre oluşturulan preview bağlantısı yaklaşık 24 saat geçerlidir.

Ajans workflow'unda bu özellik:

1. Reklam API ile oluşturulur.
2. Preview oluşturulur.
3. Müşteriye veya ekibe gönderilir.
4. Onay alınır.
5. Reklam activate edilir.

şeklinde kullanılabilir.

Preview Reklamın Yayınlanmaya Uygun Olduğunu Garanti Eder mi?

Hayır.

Preview reklamın görünümünü kontrol etmek içindir.

Tek başına:

• Policy approval
• Targeting eligibility
• Billing
• Account review
• Serving eligibility

garantisi sağlamaz.

Reklam yayını sorunları hakkında:

ChatGPT Ads Reklamlar Neden Yayınlanmıyor? Not Serving, Onay ve Sorun Giderme Rehberi

API Üzerinden Reklam Review Status Görülebilir mi?

Evet.

Ad objesinde:

review_status

alanı bulunur.

Güncel durumlar:

• in_review
• rejected
• approved

olabilir.

Bu sayede otomasyon:

Reklam reddedildi → ilgili ekibe bildirim gönder

gibi workflow'lar çalıştırabilir.

API ile Reklam Pause Edilebilir mi?

Evet.

Örneğin:

POST /ads/{ad_id}/pause

kullanılabilir.

Benzer şekilde:

• Activate
• Pause
• Archive

işlemleri desteklenmektedir.

Archive işlemi yapılırken dikkat edilmelidir çünkü arşivleme geri alınamayan bir durum olabilir.

ChatGPT Ads API ile Product Feed Yönetilebilir mi?

Evet.

Advertiser API product feed tabanlı reklam kampanyalarının kurulmasını ve yönetilmesini destekler.

Temel yapı:

Product Feed
↓
Campaign
↓
Ad Group + Product Set
↓
Product Ad Template

şeklindedir.

Ürün feed'i kampanyaları özellikle:

• Geniş kataloglu e-ticaret
• Sık fiyat değişen ürünler
• Sık stok değişen kataloglar
• Çok sayıda SKU

için kullanılabilir.

Product Feed rehberimiz:

ChatGPT Ads ile E-Ticaret Reklamları Nasıl Verilir? Ürün Feed Rehberi

API ile Product Filter Kullanılabilir mi?

Evet.

Ad Group seviyesinde product set oluşturularak ürünler feed özelliklerine göre filtrelenebilir.

Örneğin:

• Marka
• Fiyat
• Kategori
• Feed attribute

üzerinden filtreleme yapılabilir.

Bu sayede örneğin:

Sadece belirli markadaki ve belirli fiyatın altındaki ürünler

ayrı reklam grubunda kullanılabilir.

ChatGPT Ads API ile Custom Audiences Yönetilebilir mi?

Evet.

API üzerinden Custom Audience oluşturulabilir ve mevcut audience üyelikleri güncellenebilir.

Güncel API:

• Add
• Remove
• Replace
• Merge

işlemlerini desteklemektedir.

Audience verileri:

• E-posta
• Telefon
• Hash edilmiş tanımlayıcılar
• GAID

gibi desteklenen identifier'lardan oluşturulabilir.

Custom Audiences rehberimiz:

ChatGPT Ads Remarketing Nasıl Yapılır? Custom Audiences ve Yeniden Hedefleme Rehberi

Custom Audience API Güncellemeleri Mevcut Campaign ID'yi Değiştirir mi?

Audience üyeleri add veya remove işlemleriyle güncellenirken audience ID korunabilir.

Böylece kampanyanın kullandığı audience referansını değiştirmeden müşteri listesini güncel tutmak mümkün olabilir.

Örneğin günlük otomasyon:

CRM → Son müşterileri audience exclusion listesine ekle

şeklinde çalışabilir.

Custom Audience Bid Multiplier API ile Ayarlanabilir mi?

Evet.

Uygun audience'larda Ad Group bidding configuration içerisinde audience bid multiplier kullanılabilir.

Güncel API sınırında multiplier:

0.1× – 10×

aralığında tanımlanabilir.

Bu özellik her audience veya kullanım senaryosu için uygun olmak zorunda değildir.

ChatGPT Ads API ile Raporlama Yapılabilir mi?

Evet.

Advertiser API'nin Insights API yapısı reklam performansını programatik olarak çekmenizi sağlar.

Raporlama şu seviyelerde yapılabilir:

• Ad Account
• Campaign
• Ad Group
• Ad

Insights API Hangi Metrikleri Verebilir?

İstenen rapora göre:

• Impressions
• Clicks
• Spend
• CTR
• Conversion
• Ürün performansı
• Segment sonuçları

gibi veriler alınabilir.

Örneğin günlük campaign performansı:

Campaign → Date → Impressions → Clicks → Spend → CTR

şeklinde çekilebilir.

API ile Günlük Rapor Otomasyonu Kurulabilir mi?

Evet.

Örneğin her sabah çalışan sistem:

1. Insights API'yi çağırır.
2. Dünkü kampanya verilerini alır.
3. Database'e kaydeder.
4. GA4 veya CRM verisiyle birleştirir.
5. Looker Studio veya özel dashboard'a gönderir.

şeklinde çalışabilir.

Bu özellikle ajanslarda manuel Excel raporlamasını önemli ölçüde azaltabilir.

API ile Ülke Bazlı Performans Görülebilir mi?

Evet.

Insights API raporları uygun segmentler kullanılarak:

• Country
• Device
• Platform
• Product

gibi kırılımlara ayrılabilir.

Örneğin aynı campaign'in:

Türkiye → Spend / Clicks / CTR

ve:

Almanya → Spend / Clicks / CTR

performansı ayrı incelenebilir.

ChatGPT Ads API Attribution Window Seçilebilir mi?

Evet.

OpenAI'nin güncel Insights API yapısında rapor sorgularında:

• Click attribution window
• View-through attribution window
• Attribution time basis

seçilebilir.

Güncel varsayılan değerler ayrı ayrı:

• 30 günlük click window
• 1 günlük view window
• Ad-event time

olarak uygulanabilir.

Attribution rehberimiz:

ChatGPT Ads Attribution Nasıl Çalışır? Dönüşüm Penceresi, Satış ve ROAS Rehberi

API Raporundaki Conversion ile Eski Raporlar Neden Farklı Olabilir?

Attribution window veya view-through reporting seçenekleri değiştiğinde conversion toplamları farklılaşabilir.

Bu nedenle BI sisteminizde:

• Attribution window
• Time basis
• Timezone

ayarlarını açık şekilde kaydetmek önemlidir.

Aynı tarih aralığı tek başına aynı rapor anlamına gelmez. Attribution ayarları da aynı olmalıdır.

Product Performance API Üzerinden Alınabilir mi?

Evet.

Product-feed campaign'lerde product segment kullanılarak:

• Feed ID
• Item ID
• Product Title
• Impressions
• Clicks
• Spend
• CTR

gibi metrikler ürün seviyesinde alınabilir.

Bu sayede binlerce ürün bulunan kataloglarda hangi ürünlerin reklam bütçesi tükettiği ve hangilerinin etkileşim ürettiği otomatik analiz edilebilir.

ChatGPT Ads API ile Bulk İşlem Yapılabilir mi?

Evet.

Çok sayıda Campaign, Ad Group veya Ad oluşturmak ve güncellemek için Bulk Mutation Jobs kullanılabilir.

OpenAI'nin güncel API belgelerine göre tek bulk job:

• En fazla 1.000 operasyon
• En fazla 16 MiB request body

içerebilir.

Bu özellikle:

• Ajans hesap geçişleri
• Çok sayıda ürün kampanyası
• Toplu bütçe değişiklikleri
• Toplu pause işlemleri

için kullanılabilir.

Bulk API Senkron mu Çalışıyor?

Hayır.

Bulk mutation job asenkron şekilde işlenebilir.

Genel süreç:

1. Bulk job oluşturulur.
2. Job ID alınır.
3. Job status sorgulanır.
4. Completed, partially failed veya failed durumu beklenir.
5. Operation sonuçları tek tek okunur.

Bir bulk job tamamlandı diye bütün operasyonların başarıyla gerçekleştiği varsayılmamalıdır.

Bulk Job İçinde Bir İşlem Başarısız Olursa Ne Olur?

Bulk API:

• Partial failure açıkken ilgili olmayan işlemlerin devam etmesine,
• Partial failure kapalıyken bazı sonraki işlemlerin skipped olmasına

izin verebilir.

Başarılı işlemler otomatik olarak rollback edilmez.

Bu nedenle job sonucunda her operation:

• Created
• Updated
• Validated
• Failed
• Skipped

olarak ayrı kontrol edilmelidir.

Toplu yükleme rehberimiz:

ChatGPT Ads Toplu Yükleme Nasıl Yapılır? CSV ile Kampanya Yönetimi Rehberi

Bulk API Önce Test Edilebilir mi?

Evet.

Bulk mutation job içerisinde:

validate_only

kullanılarak işlemler gerçek hesaba uygulanmadan önce validation yapılabilir.

Özellikle büyük operasyonlarda şu akış daha güvenlidir:

Validate → Sonuçları Kontrol Et → Gerçek Job Oluştur

Advertiser API Rate Limit Nedir?

OpenAI'nin güncel Advertiser API dokümantasyonunda hem reklam hesabı hem de IP bazlı limitler uygulanmaktadır.

Güncel temel sınırlar:

Limit	Değer
Endpoint başına	600 request / dakika
Genel	1.200 request / dakika

İsteklerin hem:

• Ad Account
• IP Address

limitleri içerisinde kalması gerekir.

Bulk job creation için ayrıca reklam hesabı başına:

10 request / 10 saniye

seviyesinde ayrı bir limit bulunmaktadır.

Rate Limit'e Takılırsam Ne Yapmalıyım?

API entegrasyonu:

• Request batching
• Queue sistemi
• Exponential backoff
• Retry-after bilgisi
• Cache

kullanılarak tasarlanabilir.

Özellikle raporlama sisteminde her reklam için ayrı request yapmak yerine uygun aggregation endpoint'leri kullanılmalıdır.

ChatGPT Ads API Pagination Nasıl Çalışıyor?

Çok sayıda Campaign veya Ad bulunan hesaplarda response bütün kayıtları tek seferde döndürmeyebilir.

API cursor-based pagination kullanabilir.

Response içerisinde:

• first_id
• last_id
• has_more

gibi alanlar bulunabilir.

Bir sonraki sayfayı almak için:

after

cursor'ı kullanılabilir.

Raporlama otomasyonunda yalnızca ilk sayfayı okuyup işlemi tamamlamayın. has_more kontrol edilmelidir.

ChatGPT Ads API Audit Logs Nedir?

Audit Logs, reklam hesabında yapılan değişikliklerin geçmişini programatik olarak incelemenizi sağlar.

Örneğin:

• Campaign budget değişti.
• Ad pause edildi.
• Ad Group güncellendi.
• Campaign adı değiştirildi.

gibi işlemler Audit Logs içerisinde görüntülenebilir.

Endpoint:

GET /audit_logs

Audit Logs Ajanslar İçin Neden Önemli?

Bir reklam hesabını birden fazla kişi veya otomasyon yönetiyorsa:

Bu kampanyanın bütçesini kim değiştirdi?

sorusuna cevap vermek zor olabilir.

Audit Logs:

• Actor ID
• Resource
• Değişiklik
• Timestamp

gibi bilgileri incelemeye yardımcı olabilir.

Bu özellikle:

• Ajanslar
• Enterprise reklamverenler
• Otomatik optimizasyon sistemleri

için önemlidir.

Audit Logs Filtrelenebilir mi?

Evet.

Örneğin:

• Campaign ID
• Ad Group ID
• Ad ID
• Actor ID
• Tarih aralığı

üzerinden loglar filtrelenebilir.

Bu sayede yalnızca belirli campaign ile ilgili değişiklikleri çekmek mümkündür.

Audit Logs OAuth ile Kullanılabilir mi?

Güncel API dokümantasyonuna göre Audit Logs endpoint'i Ads API key authentication kullanır ve Ads OAuth access token kabul etmez.

Bu nedenle kullandığınız authentication yöntemine göre endpoint gereksinimlerini ayrıca kontrol etmelisiniz.

ChatGPT Ads API ile Otomatik Bütçe Yönetimi Yapılabilir mi?

Teknik olarak campaign verilerini okuyup budget update endpoint'lerini kullanarak otomasyon kurulabilir.

Örneğin sistem:

1. Dünkü performansı çeker.
2. Cost per Conversion hesaplar.
3. Belirlenen iş kurallarını kontrol eder.
4. Bütçe değişiklik önerisi oluşturur.
5. Onay sonrasında API ile bütçeyi günceller.

şeklinde çalışabilir.

Ancak tamamen kontrolsüz:

CPA düşük → bütçeyi otomatik iki katına çıkar

gibi sistemler risklidir.

Özellikle:

• Reporting delay
• Attribution
• Conversion hacmi
• Stok
• Lead kalitesi

dikkate alınmalıdır.

API ile Otomatik Kampanya Durdurma Yapılabilir mi?

Evet.

Örneğin işletme şu kuralı oluşturabilir:

Campaign 50.000 TL harcadı ve hiç conversion oluşturmadıysa insan onayına gönder.

Onay sonrası campaign pause edilebilir.

Ancak otomasyon:

• Spend reporting gecikmesini,
• Conversion attribution gecikmesini,
• Minimum data threshold'u

hesaba katmalıdır.

ChatGPT Ads API ile Otomatik Kreatif Üretimi Yapılabilir mi?

Advertiser API reklamı programatik olarak oluşturabilir ancak reklam metninin veya görselinin nasıl üretildiği reklamverenin kendi sistemine bağlıdır.

Örneğin:

Ürün Verisi → Kreatif Sistemi → İnsan Onayı → Advertiser API → ChatGPT Ads

workflow'u kurulabilir.

Ancak reklamların:

• Doğru,
• Politikaya uygun,
• Landing page ile tutarlı

olması gerekir.

Yapay Zekâ ile Binlerce Reklam Otomatik Oluşturmak Doğru mu?

Teknik olarak otomasyon büyük hacim sağlayabilir ancak kalite kontrolü olmadan binlerce reklam üretmek doğru strateji değildir.

Riskler:

• Yanlış ürün bilgisi
• Uydurma fayda
• Yanlış fiyat
• Policy ihlali
• Yanlış landing page
• Duplicate kreatif

olabilir.

API ölçek sağlar; doğruluk sorumluluğunu ortadan kaldırmaz.

ChatGPT Ads API ile Ajans Paneli Yapılabilir mi?

Evet.

Ajanslar kendi yönetim sistemlerinde örneğin:

• Müşteri hesapları
• Campaign performansı
• Spend
• Conversions
• Reklam review durumu
• Budget
• Creative preview

gibi bilgileri tek dashboard altında toplayabilir.

Ancak her müşteri için:

• Ayrı Ads Account
• Ayrı API credential
• Ayrı billing

yapısının korunması hesap güvenliği ve sahipliği açısından daha sağlıklı olabilir.

Ajanslar Müşteri API Key'lerini Nasıl Yönetmeli?

Her müşteri credential'ı:

• Şifreli saklanmalı.
• Birbirinden ayrılmalı.
• Loglarda gösterilmemeli.
• Müşteriler arasında paylaşılmamalıdır.

OpenAI'nin API Partner Setup rehberi de müşteri reklam hesabına ait API key'in ilgili müşteri hesabı için kullanılmasını belirtmektedir.

ChatGPT Ads API ile CRM Entegrasyonu Kurulabilir mi?

Evet.

Örneğin:

CRM → Custom Audience API

ve:

Advertiser API → Campaign Performance → CRM

entegrasyonları kurulabilir.

HubSpot kullanan işletmeler için doğrudan ChatGPT Ads entegrasyonu da bulunmaktadır:

ChatGPT Ads HubSpot Entegrasyonu Nasıl Yapılır? CRM, Lead, Workflow ve Satış Takibi Rehberi

ChatGPT Ads API ile Shopify Entegrasyonu Yapılabilir mi?

Shopify için OpenAI'nin doğrudan partner entegrasyonu bulunmaktadır.

Özel e-ticaret altyapısı veya daha gelişmiş workflow gereken durumlarda:

• Advertiser API
• Product Feed API
• Conversions API

birlikte kullanılabilir.

Shopify rehberi:

ChatGPT Ads Shopify Entegrasyonu Nasıl Yapılır? Ürün Kataloğu, Pixel, Kampanya ve Satış Takibi Rehberi

Advertiser API ile Google Analytics Birleştirilebilir mi?

Evet.

Örneğin veri pipeline'ı:

ChatGPT Ads Insights API
+
GA4 Data
+
CRM Sales Data
↓
Data Warehouse / Dashboard

şeklinde kurulabilir.

Böylece:

• Spend
• Clicks
• Sessions
• Lead
• Sales
• Revenue

tek raporda analiz edilebilir.

ChatGPT Ads API ile Looker Studio Dashboard Yapılabilir mi?

Evet.

Advertiser API verileri:

• Database
• Google Sheets
• BigQuery
• Özel connector

üzerinden Looker Studio'ya aktarılabilir.

Ancak API'den her dashboard açıldığında canlı yüzlerce request yapmak yerine veriyi periyodik olarak database'e aktarmak daha sağlıklı olabilir.

Advertiser API ile Hangi Otomasyonlar Yapılabilir?

Örnek kullanım senaryoları:

Günlük Performans Raporu

Her sabah API → Kampanya verisi → Dashboard

Reklam Review Takibi

Rejected Ad → Slack / E-posta bildirimi

Bütçe Alarmı

Spend belirlenen seviyeye ulaştı → Uyarı

Audience Güncelleme

Yeni müşteriler → Existing Customer Exclusion Audience

Ürün Reklamları

Product Feed → Product Campaign

Ajans Müşteri Paneli

Birden fazla Ads Account → Tek raporlama dashboard'u

API ile Her Şeyi Tamamen Otomatikleştirmek Doğru mu?

Her zaman değil.

En sağlıklı reklam operasyonlarından biri:

Automation + Human Approval

modelidir.

Örneğin otomasyon:

• Campaign oluşturur.
• Reklamları paused olarak ekler.
• Preview üretir.
• Validation yapar.

ancak:

• Bütçe
• Reklam metni
• Landing page
• Final activate

insan tarafından kontrol edilir.

ChatGPT Ads API Güvenlik Kontrol Listesi

• API key server-side saklanıyor mu?
• Credential public repository'de bulunuyor mu?
• Her müşteri için ayrı API key kullanılıyor mu?
• API key loglara yazılıyor mu?
• Environment variable güvenli mi?
• Idempotency-Key kullanılıyor mu?
• Rate limit handling var mı?
• Retry sistemi kontrollü mü?
• Pagination tamamen okunuyor mu?
• Bulk job sonuçları tek tek kontrol ediliyor mu?
• Audit Logs tutuluyor mu?
• Campaign önce paused oluşturuluyor mu?
• Reklam preview kontrolü yapılıyor mu?
• API response hataları loglanıyor mu?
• Conversion API key ile Ads API key birbirinden ayrılıyor mu?

ChatGPT Ads API Geliştirme Kontrol Listesi

• Ads Manager hesabı hazır mı?
• Advertiser API key oluşturuldu mu?
• GET /ad_account ile bağlantı test edildi mi?
• Account currency kontrol edildi mi?
• Timezone kontrol edildi mi?
• Review status kontrol edildi mi?
• Campaign mimarisi belirlendi mi?
• Budget formatı doğrulandı mı?
• Micros dönüşümü doğru mu?
• Targeting doğrulandı mı?
• Ad Group bidding configuration doğru mu?
• Context Hints doğru mu?
• Creative title limitleri kontrol edildi mi?
• Body karakter sınırı kontrol edildi mi?
• Image upload çalışıyor mu?
• Preview oluşturuluyor mu?
• Review status takip ediliyor mu?
• Idempotency tasarımı hazır mı?
• Pagination destekleniyor mu?
• Rate limit handling hazır mı?
• Bulk operation gerekiyorsa test edildi mi?
• Audit Logs izleniyor mu?
• Insights reporting test edildi mi?
• Attribution ayarları raporlarda sabitlendi mi?
• Campaign activation öncesinde insan kontrolü var mı?

En önemli kural: Advertiser API'yi yalnızca reklamları daha hızlı oluşturmak için değil, daha kontrollü, ölçülebilir ve ölçeklenebilir reklam operasyonu kurmak için kullanın.

Örnek ChatGPT Ads API Ajans Workflow'u

Bir reklam ajansının API ile kampanya kurulumunu örnek alalım.

1. Müşteri Onboarding

Müşteri ChatGPT Ads hesabını oluşturur.

2. API Key

Müşteri reklam hesabına ait Advertiser API key güvenli şekilde sisteme tanımlanır.

3. Account Validation

Ajans sistemi:

• Account ID
• Currency
• Timezone
• Review Status

bilgilerini API'den kontrol eder.

4. Campaign Draft

Campaign paused durumda oluşturulur.

5. Ad Groups

Kullanıcı ihtiyaçlarına göre reklam grupları oluşturulur.

6. Creatives

Görseller upload endpoint'i üzerinden yüklenir.

7. Ads

Title, body ve target URL ile reklamlar oluşturulur.

8. Preview

Reklam preview linkleri oluşturulur.

9. Müşteri Onayı

Ajans panelinden müşteri reklamı inceler.

10. Activate

Onaylanan campaign ve ads yayına alınır.

11. Reporting

Insights API her gün performansı çeker.

12. Optimization

Ajans uzmanı:

• Spend
• CPC
• Conversions
• Lead kalitesi

üzerinden optimizasyon yapar.

Örnek E-Ticaret API Workflow'u

Product Database
↓
Product Feed
↓
Advertiser API
↓
Product Campaign
↓
Insights API
↓
Product Performance
↓
Conversions API
↓
Purchase Measurement

Bu yapıda ürün kataloğu, kampanya yönetimi, performans ve purchase measurement tek otomasyon zincirinde birleştirilebilir.

ChatGPT Ads API Kampanya Optimizasyonunda Nasıl Kullanılır?

Advertiser API optimizasyonun kendisi değildir.

API:

• Veriyi getirir.
• Kaynakları değiştirir.
• Otomasyonu uygular.

Ancak:

Hangi kampanyanın bütçesi artırılmalı?

gibi ticari kararın temelinde:

• Conversion
• CPA
• ROAS
• Lead kalitesi
• Müşteri değeri

bulunmalıdır.

Kampanya optimizasyonu rehberi:

ChatGPT Ads Kampanya Optimizasyonu Nasıl Yapılır? Bütçe, Teklif ve Performans Rehberi

ChatGPT Ads API'nin Avantajları Nelerdir?

• Tekrarlayan manuel işleri azaltır.
• Çok sayıda kampanyanın yönetimini kolaylaştırır.
• Ajans operasyonlarını ölçeklendirebilir.
• Özel raporlama sistemleri kurulmasını sağlar.
• CRM ve BI entegrasyonlarını kolaylaştırır.
• Product Feed operasyonlarını otomatikleştirebilir.
• Audience listelerinin düzenli güncellenmesini sağlar.
• Campaign review ve durum takibini otomatikleştirebilir.
• Audit Logs ile değişiklik takibi sağlar.

ChatGPT Ads API'nin Dezavantajları Nelerdir?

API kullanımı ek teknik sorumluluk getirir.

• Backend geliştirme gerekir.
• Credential güvenliği gerekir.
• Rate limit yönetimi gerekir.
• Retry ve idempotency mantığı gerekir.
• API değişikliklerinin takip edilmesi gerekir.
• Yanlış otomasyon büyük ölçekli hatalara neden olabilir.

Bu nedenle birkaç küçük kampanya için özel API entegrasyonu geliştirmek her zaman ekonomik olmayabilir.

Advertiser API Kullanmak Reklam Performansını Artırır mı?

Tek başına hayır.

API reklamların:

• Daha hızlı,
• Daha düzenli,
• Daha ölçeklenebilir

yönetilmesini sağlar.

Ancak performans yine:

• Teklif
• Bütçe
• Reklam alaka düzeyi
• Context Hints
• Kreatif
• Landing page
• Conversion rate

gibi faktörlere bağlıdır.

Advertiser API bir optimizasyon hilesi değil, reklam operasyon altyapısıdır.

SAM Medya ile ChatGPT Ads API ve Reklam Otomasyonu

ChatGPT Ads Advertiser API özellikle reklam operasyonu büyüyen işletmeler ve ajanslar için önemli bir otomasyon altyapısı sağlayabilir.

Ancak sağlıklı API entegrasyonunda yalnızca campaign oluşturmak yeterli değildir.

Aynı sistem içerisinde:

• Credential güvenliği
• Campaign architecture
• Idempotency
• Bulk operations
• Audit Logs
• Reporting
• Pixel
• Conversions API
• CRM
• Analytics

birlikte değerlendirilmelidir.

SAM Medya olarak ChatGPT Ads çalışmalarında:

• Advertiser API entegrasyon planlaması
• Ads Manager hesap yapısı
• Campaign otomasyonu
• Ad Group otomasyonu
• Reklam oluşturma workflow'u
• Creative upload süreçleri
• Product Feed entegrasyonu
• Custom Audience otomasyonu
• Bulk campaign işlemleri
• Insights API raporlaması
• Audit Logs
• OpenAI Pixel
• Conversions API
• UTM ve GA4
• CRM entegrasyonu
• Ajans dashboard yapısı
• Performans raporlama

gibi süreçleri birlikte değerlendirebiliriz.

ChatGPT Ads operasyonunuzu Ads Manager'daki manuel işlemlerden daha ölçeklenebilir kampanya, raporlama ve otomasyon altyapısına taşımak için SAM Medya'ya ulaşabilirsiniz.

Profesyonel ChatGPT Ads yönetimi hakkında:

ChatGPT Ads Ajansı Nedir? Profesyonel ChatGPT Reklam Yönetimi Rehberi

ChatGPT Ads API Hakkında Sık Sorulan Sorular

ChatGPT Ads'in resmi API'si var mı?

Evet. OpenAI Advertiser API, ChatGPT Ads kampanyalarının ve reklam kaynaklarının programatik olarak oluşturulmasını, yönetilmesini ve raporlanmasını desteklemektedir.

ChatGPT Ads API ile OpenAI API aynı şey mi?

Hayır. Genel OpenAI API yapay zekâ modelleri için kullanılır. Advertiser API ise ChatGPT Ads reklam hesaplarını ve kampanyalarını yönetmek için geliştirilmiştir.

ChatGPT Ads API ile Conversions API aynı şey mi?

Hayır. Advertiser API campaign, ad group, ad ve reporting gibi reklam operasyonlarını yönetir. Conversions API ise server-side conversion event'leri gönderir.

Advertiser API Key nereden alınır?

OpenAI'nin güncel dokümantasyonuna göre Advertiser API key Ads Manager içerisindeki Settings alanından oluşturulabilir.

Bir API Key birden fazla reklam hesabını yönetebilir mi?

Güncel sistemde Ads API key belirli bir reklam hesabına scoped edilir. Ajanslar her müşteri hesabı için ilgili reklam hesabına ait key'i kullanmalıdır.

ChatGPT Ads API base URL nedir?

Advertiser API istekleri https://api.ads.openai.com/v1 adresine gönderilir.

API ile campaign oluşturabilir miyim?

Evet. Campaign create, retrieve, list, update ve state değişiklikleri Advertiser API üzerinden yapılabilir.

API ile Context Hints eklenebilir mi?

Evet. Ad Group oluşturma ve güncelleme işlemlerinde Context Hints kullanılabilir.

API ile reklam görseli yüklenebilir mi?

Evet. Görseller upload endpoint'i üzerinden image URL veya binary file olarak yüklenebilir ve dönen file ID reklam creative'inde kullanılabilir.

API ile reklam preview oluşturulabilir mi?

Evet. Mevcut reklam için preview endpoint'i kullanılabilir. OpenAI'nin güncel dokümantasyonuna göre preview yaklaşık 24 saat geçerlidir.

API üzerinden reklamın reddedildiğini görebilir miyim?

Evet. Ad object içerisindeki review_status alanı in_review, rejected veya approved gibi durumları gösterebilir.

Advertiser API ile reklam pause edilebilir mi?

Evet. Campaign, Ad Group ve Ad kaynakları uygun state endpoint'leri kullanılarak activate veya pause edilebilir.

ChatGPT Ads API Product Feed destekliyor mu?

Evet. Advertiser API üzerinden product feed tabanlı reklam kampanyaları kurulabilir ve yönetilebilir.

Custom Audiences API üzerinden yönetilebilir mi?

Evet. Audience oluşturma, üye ekleme, çıkarma, replace ve merge işlemleri desteklenmektedir.

API ile ChatGPT Ads performans raporu alınabilir mi?

Evet. Insights API ad account, campaign, ad group ve ad seviyesinde delivery, spend ve conversion performansını programatik olarak raporlayabilir.

Ürün bazında reklam performansı API'den alınabilir mi?

Evet. Product-feed kampanyalarında product segment kullanılarak ürün bazında impression, click, spend ve CTR gibi metrikler alınabilir.

ChatGPT Ads API bulk işlemleri destekliyor mu?

Evet. Bulk mutation jobs çok sayıda campaign, ad group ve ad işlemini asenkron olarak yönetmek için kullanılabilir.

Bir bulk job kaç işlem içerebilir?

OpenAI'nin güncel dokümantasyonuna göre tek job en fazla 1.000 operasyon ve 16 MiB request body içerebilir.

Advertiser API rate limit nedir?

Güncel temel limit endpoint başına 600 request/dakika ve toplam 1.200 request/dakikadır. Limitler hem ad account hem IP açısından uygulanır. Bulk job creation için ayrıca reklam hesabı başına 10 saniyede 10 request sınırı bulunmaktadır.

Idempotency-Key neden önemli?

Create request network problemi nedeniyle tekrar gönderildiğinde aynı kaynağın yanlışlıkla iki kez oluşturulmasını önlemeye yardımcı olur.

ChatGPT Ads API Audit Logs destekliyor mu?

Evet. Audit Logs üzerinden campaign, ad group, ad ve diğer kaynaklarda yapılan değişiklikler incelenebilir.

API ile otomatik bütçe optimizasyonu yapılabilir mi?

Teknik olarak performans verileri okunup bütçe güncellemeleri otomatikleştirilebilir. Ancak reporting delay, attribution ve ticari sonuçlar dikkate alınmadan tamamen kontrolsüz bütçe otomasyonu önerilmez.

ChatGPT Ads API ajanslar için uygun mu?

Evet. Çok sayıda müşteri, campaign ve raporlama süreci bulunan ajanslarda API kampanya operasyonunu ve raporlamayı ölçeklendirmeye yardımcı olabilir.

Advertiser API kullanmak reklam performansını otomatik artırır mı?

Hayır. API reklam operasyonunu otomatikleştirir. Gerçek performans kampanya stratejisi, kreatif, teklif, hedefleme, landing page ve conversion performansına bağlıdır.