ChatGPT Ads araçları
OpenAI Ads API ile bağlanan ChatGPT reklam hesapları: kampanya listesi, performans raporu, bütçe ve durum değişiklikleri.
Araç adları ve açıklamaları doğrudan sunucu kodundan üretilir; açıklamalar asistanın gördüğü metnin çevirisidir, araç ve parametre adları aynen kalır.
Okuma araçları11 araç
list_openai_ads_accounts
Okuma1 krediBağlı ChatGPT Ads (OpenAI Ads) hesapları: ad_account_id, ad, para birimi, saat dilimi, hesap ve inceleme durumu. Her hesap panelde kendi Ads API anahtarıyla bağlanır. Salt okunur; hesap yoksa connected=false döner.
Bu araç parametre almaz.
list_openai_ads_campaigns
Okuma1 krediOpenAI Ads API'den ChatGPT Ads kampanyaları: id (cmpn_…), ad, durum, günlük veya toplam bütçe (hesap para birimi), teklif türü, zamanlama. Salt okunur; bağlı hesap yoksa connected=false döner.
| Parametre | Tip | Açıklama |
|---|---|---|
ad_account_idİsteğe bağlı | string | adacct_… — yalnızca birden fazla ChatGPT Ads hesabı bağlıysa gerekir |
statusİsteğe bağlı | active | paused | archived | — |
nameİsteğe bağlı | string | kampanya adına göre filtrele (en az 3 karakter) |
openai_ads_performance_report
Okuma2 krediChatGPT Ads yayın raporu (OpenAI Ads insights): hesap saat diliminde bir tarih aralığı için hesap, kampanya, reklam grubu veya reklam başına gösterim, tıklama, harcama, CTR, CPC, CPM; isteğe bağlı olarak gün bazında. Salt okunur; asla sayı uydurmaz.
| Parametre | Tip | Açıklama |
|---|---|---|
ad_account_idİsteğe bağlı | string | adacct_… — yalnızca birden fazla ChatGPT Ads hesabı bağlıysa gerekir |
levelİsteğe bağlı | ad_account | campaign | ad_group | ad | — |
daysİsteğe bağlı | integer (1–365) | — |
start_dateİsteğe bağlı | string | YYYY-MM-DD |
end_dateİsteğe bağlı | string | YYYY-MM-DD |
dailyİsteğe bağlı | boolean | — |
campaign_idsİsteğe bağlı | array<string> | — |
chatgpt_ads_details
Okuma1 krediTek bir ChatGPT Ads kampanyasının (reklam gruplarıyla), reklam grubunun (teklif, bağlam ipuçları, reklamlar) ya da reklamın (kreatif, inceleme) tüm ayrıntıları; OpenAI'ın bildirdiği yayın sorunları dahil. Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
ad_account_idİsteğe bağlı | string | adacct_… — yalnızca birden fazla ChatGPT Ads hesabı bağlıysa gerekir |
idZorunlu | string | cmpn_…, adgrp_… ya da ad_… |
hints_limitİsteğe bağlı | integer (1–2000) | — |
hints_offsetİsteğe bağlı | integer (0–…) | — |
chatgpt_ads_geo_lookup
Okuma1 krediKampanya konum hedeflemesi için ChatGPT Ads konum id'lerini (ülkeler, bölgeler, pazarlar, posta kodları) ada göre bulur. Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
ad_account_idİsteğe bağlı | string | adacct_… — yalnızca birden fazla ChatGPT Ads hesabı bağlıysa gerekir |
queryZorunlu | string | — |
limitİsteğe bağlı | integer (1–100) | — |
chatgpt_ads_insights
Okuma2 krediOpenAI seçenekleriyle ChatGPT Ads yayın raporu: saatlik/günlük/aylık dilimler, ülke/cihaz/platform/ürün kırılımları, sıfır gösterimli satırlar ve dönüşüm metrikleri; hesap ya da tek bir kampanya, reklam grubu veya reklam kapsamında. Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
ad_account_idİsteğe bağlı | string | adacct_… — yalnızca birden fazla ChatGPT Ads hesabı bağlıysa gerekir |
scope_idİsteğe bağlı | string | raporu daraltmak için isteğe bağlı cmpn_/adgrp_/ad_ id'si |
levelİsteğe bağlı | ad_account | campaign | ad_group | ad | — |
daysİsteğe bağlı | integer (1–365) | — |
start_dateİsteğe bağlı | string | YYYY-MM-DD |
end_dateİsteğe bağlı | string | YYYY-MM-DD |
granularityİsteğe bağlı | none | hourly | daily | monthly | — |
segmentİsteğe bağlı | none | country | device | platform | product | — |
include_zeroİsteğe bağlı | boolean | sıfır gösterimli satırları ekler (segmentsiz) |
conversionsİsteğe bağlı | boolean | dönüşümleri, CPA, CVR, ilişkilendirilen satışları ve ROAS'ı ekler |
limitİsteğe bağlı | integer (1–2000) | — |
offsetİsteğe bağlı | integer (0–…) | — |
chatgpt_ads_spend_limits
Okuma1 krediChatGPT Ads hesap harcama limitleri: tarih aralığı pencereleri ve yinelenen günlük limitler; şimdiye kadarki harcama ve neyin düzenlenebileceğiyle. Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
ad_account_idİsteğe bağlı | string | adacct_… — yalnızca birden fazla ChatGPT Ads hesabı bağlıysa gerekir |
chatgpt_ads_conversion_setup
Okuma1 krediChatGPT Ads dönüşüm izleme: pikseller (kaynaklar), dönüşüm olayı ayarları ve bunları kullanan kampanyalar, ayrıca yaklaşık son 15 dakikada alınan olaylar. Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
ad_account_idİsteğe bağlı | string | adacct_… — yalnızca birden fazla ChatGPT Ads hesabı bağlıysa gerekir |
check_recent_eventsİsteğe bağlı | boolean | — |
chatgpt_ads_ad_preview
Okuma1 krediMevcut bir ChatGPT Ads reklamının nasıl göründüğünü (24 saatlik geçici önizleme) inceleme durumu ve OpenAI'ın bildirdiği yayın engelleriyle birlikte gösterir. Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
ad_account_idİsteğe bağlı | string | adacct_… — yalnızca birden fazla ChatGPT Ads hesabı bağlıysa gerekir |
ad_idZorunlu | string | — |
list_chatgpt_ads_custom_audiences
Okuma1 krediReklam hesabının ChatGPT Ads özel kitlelerini listeler: kimlik, ad, durum ve sürüm. Yalnız okur.
| Parametre | Tip | Açıklama |
|---|---|---|
ad_account_idİsteğe bağlı | string | adacct_… — required only when several ChatGPT Ads accounts are connected |
diagnose_chatgpt_ads_delivery
Okuma2 krediChatGPT Ads reklamlarının neden gösterim almadığını açıklar: hesap durumunu ve incelemeleri, harcama limitlerini ve her kampanya, reklam grubu ve reklamı OpenAI yayın sorunları açısından denetler (isteğe bağlı açılış sayfası taramalarıyla); kanıt, düzeltme ve onu uygulayan araçla sıralı bulgular döndürür. Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
ad_account_idİsteğe bağlı | string | adacct_… — yalnızca birden fazla ChatGPT Ads hesabı bağlıysa gerekir |
campaign_idİsteğe bağlı | string | — |
check_landing_pagesİsteğe bağlı | boolean | — |
Yazma araçları14 araç
update_openai_ads_campaign_status
Yazma2 krediBir ChatGPT Ads kampanyasını duraklatır veya etkinleştirir. Bir önizleme ve bir onay öğesi döndürür; OpenAI'de yalnızca onaydan sonra uygulanır ve geri alınabilir. Etkinleştirme, yayını yalnızca OpenAI'nin diğer gereksinimleri (incelemeler, bütçe) karşılandığında başlatır.
| Parametre | Tip | Açıklama |
|---|---|---|
ad_account_idİsteğe bağlı | string | adacct_… — yalnızca birden fazla ChatGPT Ads hesabı bağlıysa gerekir |
campaign_idZorunlu | string | cmpn_… |
statusZorunlu | pause | activate | — |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
update_openai_ads_campaign_budget
Yazma2 krediBir ChatGPT Ads kampanyasının günlük bütçesini ayarlar. Önizleme ve onaydan geçer; değişiklik başına %50'nin veya 24 saat içinde 2 katının üzerindeki artışlar engellenir; geri alma önceki bütçeyi geri yükler. Toplam bütçeli kampanyalar değiştirilmez.
| Parametre | Tip | Açıklama |
|---|---|---|
ad_account_idİsteğe bağlı | string | adacct_… — yalnızca birden fazla ChatGPT Ads hesabı bağlıysa gerekir |
campaign_idZorunlu | string | cmpn_… |
daily_budgetZorunlu | number | hesap para biriminde yeni günlük bütçe (micros değil) |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
connect_chatgpt_ads
Yazma0 krediBir ChatGPT Ads (OpenAI Ads) reklam hesabı bağlar: anahtar olmadan panel yolunu açıklar; api_key ve confirm=true ile anahtar OpenAI'a karşı doğrulanır ve şifreli saklanır (yalnızca sahip/yönetici). Anahtar asla geri yazdırılmaz.
| Parametre | Tip | Açıklama |
|---|---|---|
api_keyİsteğe bağlı | string | tek bir reklam hesabının OpenAI Ads API anahtarı |
confirmİsteğe bağlı | boolean | — |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
manage_chatgpt_ads_accounts
Yazma0 krediBağlı ChatGPT Ads hesaplarını listeler, birini OpenAI'a karşı yeniden denetler (durum, inceleme, para birimi), bağlantısını keser ya da ad_account_id verilmediğinde kullanılan varsayılan hesap yapar. Bağlantıyı kesme ve varsayılan yapma confirm=true gerektirir.
| Parametre | Tip | Açıklama |
|---|---|---|
actionİsteğe bağlı | list | recheck | disconnect | set_default | — |
ad_account_idİsteğe bağlı | string | adacct_… — yalnızca birden fazla ChatGPT Ads hesabı bağlıysa gerekir |
confirmİsteğe bağlı | boolean | — |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_chatgpt_ads_campaign
Yazma8 krediHesap para biriminde günlük ya da toplam bütçe, hedef, konumlar, platformlar, kitleler, zamanlama ve dönüşüm hedefiyle bir ChatGPT Ads kampanyası (her zaman duraklatılmış) oluşturur. Önce önizleme ve onay.
| Parametre | Tip | Açıklama |
|---|---|---|
ad_account_idİsteğe bağlı | string | adacct_… — yalnızca birden fazla ChatGPT Ads hesabı bağlıysa gerekir |
nameZorunlu | string | — |
daily_budgetİsteğe bağlı | number | — |
lifetime_budgetİsteğe bağlı | number | — |
objectiveİsteğe bağlı | impressions | clicks | conversions | — |
descriptionİsteğe bağlı | string | — |
include_locationsİsteğe bağlı | array<string> | chatgpt_ads_geo_lookup'tan konum id'leri |
exclude_locationsİsteğe bağlı | array<string> | chatgpt_ads_geo_lookup'tan konum id'leri |
platformsİsteğe bağlı | array<ios_app | android_app | web | desktop_web | ios_web | android_web> | — |
custom_audience_idsİsteğe bağlı | array<string> | — |
excluded_custom_audience_idsİsteğe bağlı | array<string> | — |
startİsteğe bağlı | string | ISO 8601 tarih-saat (ofset yoksa UTC) |
endİsteğe bağlı | string | ISO 8601 tarih-saat (ofset yoksa UTC) |
conversion_event_setting_idsİsteğe bağlı | array<string> | — |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
update_chatgpt_ads_campaign
Yazma5 krediBir ChatGPT Ads kampanyasını değiştirir: ad, bütçe, konumlar (değiştir / ekle / kaldır), platformlar, zamanlama, dönüşüm olayları ya da durum. %50'nin üzerindeki bütçe artışları engellenir. Önce önizleme ve onaydan geçer.
| Parametre | Tip | Açıklama |
|---|---|---|
ad_account_idİsteğe bağlı | string | adacct_… — yalnızca birden fazla ChatGPT Ads hesabı bağlıysa gerekir |
campaign_idZorunlu | string | — |
nameİsteğe bağlı | string | — |
daily_budgetİsteğe bağlı | number | — |
lifetime_budgetİsteğe bağlı | number | — |
statusİsteğe bağlı | active | paused | — |
include_locationsİsteğe bağlı | array<string> | chatgpt_ads_geo_lookup çıktısındaki konum id'leri |
exclude_locationsİsteğe bağlı | array<string> | chatgpt_ads_geo_lookup çıktısındaki konum id'leri |
locations_modeİsteğe bağlı | replace | add | remove | — |
platformsİsteğe bağlı | array<ios_app | android_app | web | desktop_web | ios_web | android_web> | — |
startİsteğe bağlı | string | ISO 8601 tarih-saat (fark belirtilmezse UTC) |
endİsteğe bağlı | string | ISO 8601 tarih-saat (fark belirtilmezse UTC) |
conversion_event_setting_idsİsteğe bağlı | array<string> | — |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_chatgpt_ads_ad_group
Yazma5 krediBir ChatGPT Ads kampanyası altında teklif stratejisi, maksimum teklif ve bağlam ipuçlarıyla (reklamın ne zaman faydalı olacağı) duraklatılmış bir reklam grubu oluşturur. Olağandışı yüksek teklifler allow_high_bid gerektirir. Önce önizleme ve onay.
| Parametre | Tip | Açıklama |
|---|---|---|
ad_account_idİsteğe bağlı | string | adacct_… — yalnızca birden fazla ChatGPT Ads hesabı bağlıysa gerekir |
campaign_idZorunlu | string | — |
nameZorunlu | string | — |
max_bidİsteğe bağlı | number | hesap para birimi: gösterim faturalamasında CPM, tıklamada CPC, dönüşüm kampanyalarında CPA |
billing_eventİsteğe bağlı | impression | click | — |
strategyİsteğe bağlı | fixed_bid | maximize_clicks | maximize_conversions | — |
allow_high_bidİsteğe bağlı | boolean | — |
context_hintsİsteğe bağlı | array<string> | — |
descriptionİsteğe bağlı | string | — |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
update_chatgpt_ads_ad_group
Yazma5 krediBir ChatGPT Ads reklam grubunun adını, maksimum teklifini, teklif stratejisini ya da bağlam ipuçlarını (değiştir / ekle / kaldır) değiştirir. %50'nin üzerindeki teklif sıçramaları allow_high_bid gerektirir. Önce önizleme ve onaydan geçer.
| Parametre | Tip | Açıklama |
|---|---|---|
ad_account_idİsteğe bağlı | string | adacct_… — yalnızca birden fazla ChatGPT Ads hesabı bağlıysa gerekir |
ad_group_idZorunlu | string | — |
nameİsteğe bağlı | string | — |
max_bidİsteğe bağlı | number | — |
strategyİsteğe bağlı | fixed_bid | maximize_clicks | maximize_conversions | — |
allow_high_bidİsteğe bağlı | boolean | — |
context_hintsİsteğe bağlı | array<string> | — |
hints_modeİsteğe bağlı | replace | add | remove | — |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_chatgpt_ads_ad
Yazma8 krediBir reklam grubunda duraklatılmış bir ChatGPT Ads sohbet kartı reklamı (başlık, gövde metni, hedef, görsel) oluşturur; OpenAI reklamı inceler. Önce önizleme ve onay.
| Parametre | Tip | Açıklama |
|---|---|---|
ad_account_idİsteğe bağlı | string | adacct_… — yalnızca birden fazla ChatGPT Ads hesabı bağlıysa gerekir |
ad_group_idZorunlu | string | — |
nameZorunlu | string | — |
titleZorunlu | string | 3-50 karakter |
bodyZorunlu | string | en fazla 100 karakter |
target_urlZorunlu | string | — |
image_urlİsteğe bağlı | string | herkese açık https görseli; OpenAI kendisi indirir |
file_idİsteğe bağlı | string | — |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
update_chatgpt_ads_ad
Yazma5 krediBir ChatGPT Ads reklamının metnini, hedef adresini ya da görselini değiştirir (kreatifin geri kalanı korunur); değişen kreatif yeniden incelenir. Önce önizleme ve onaydan geçer.
| Parametre | Tip | Açıklama |
|---|---|---|
ad_account_idİsteğe bağlı | string | adacct_… — yalnızca birden fazla ChatGPT Ads hesabı bağlıysa gerekir |
ad_idZorunlu | string | — |
nameİsteğe bağlı | string | — |
titleİsteğe bağlı | string | — |
bodyİsteğe bağlı | string | — |
target_urlİsteğe bağlı | string | — |
image_urlİsteğe bağlı | string | — |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
chatgpt_ads_status
YazmaGeri alınamaz5 krediBir ChatGPT Ads kampanyasını, reklam grubunu ya da reklamı duraklatır, etkinleştirir veya arşivler. Arşivleme geri alınamaz ve her zaman açık onay bekler. Önce önizleme ve onay.
| Parametre | Tip | Açıklama |
|---|---|---|
ad_account_idİsteğe bağlı | string | adacct_… — yalnızca birden fazla ChatGPT Ads hesabı bağlıysa gerekir |
kindİsteğe bağlı | campaign | ad_group | ad | — |
idZorunlu | string | — |
actionZorunlu | pause | activate | archive | — |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_chatgpt_ads_event_setting
Yazma5 krediBir piksel kaynağında ChatGPT Ads dönüşüm olayı ayarı (hangi izlenen olayın dönüşüm sayılacağı) oluşturur; kampanya hedefi olarak kullanılabilir. Önce önizleme ve onay.
| Parametre | Tip | Açıklama |
|---|---|---|
ad_account_idİsteğe bağlı | string | adacct_… — yalnızca birden fazla ChatGPT Ads hesabı bağlıysa gerekir |
nameZorunlu | string | — |
event_typeZorunlu | page_viewed | contents_viewed | items_added | checkout_started | order_created | lead_created | registration_completed | subscription_created | trial_started | appointment_scheduled | plan_enrollment | app_installed | app_opened | custom | — |
source_idZorunlu | string | piksel kaynağı id'si (clidsrc_…) |
custom_event_nameİsteğe bağlı | string | — |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
manage_chatgpt_ads_custom_audience
YazmaGeri alınamaz5 krediBoş ChatGPT Ads özel kitlesi kurar, üye ekler ya da çıkarır, kitleyi arşivler. Yalnız kullanma hakkınız olan birinci taraf veri; e-posta ve telefon gönderilmeden özetlenir. AEA ve İsviçre kampanyalarında kullanılamaz.
| Parametre | Tip | Açıklama |
|---|---|---|
ad_account_idİsteğe bağlı | string | adacct_… — required only when several ChatGPT Ads accounts are connected |
actionZorunlu | create | add | remove | archive | — |
audience_idİsteğe bağlı | string | caud_… (not for create) |
nameİsteğe bağlı | string | — |
descriptionİsteğe bağlı | string | — |
emailsİsteğe bağlı | array<string> | hashed before sending |
phonesİsteğe bağlı | array<string> | +country code; hashed before sending |
gaidsİsteğe bağlı | array<string> | — |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
manage_chatgpt_ads_spend_limit
YazmaGeri alınamaz5 krediBir ChatGPT Ads hesabının harcama sınırını (tarih aralığı penceresi ya da yinelenen günlük sınır) oluşturur, değiştirir veya kaldırır. %50'nin üzerindeki artışlar engellenir; kaldırma işlemleri her zaman açık onay bekler. Önce önizleme ve onaydan geçer.
| Parametre | Tip | Açıklama |
|---|---|---|
ad_account_idİsteğe bağlı | string | adacct_… — yalnızca birden fazla ChatGPT Ads hesabı bağlıysa gerekir |
actionZorunlu | create | update | delete | set_daily | delete_daily | — |
window_idİsteğe bağlı | string | — |
start_dateİsteğe bağlı | string | YYYY-MM-DD, dahil |
end_dateİsteğe bağlı | string | YYYY-MM-DD, hariç |
amountİsteğe bağlı | number | hesap para birimi |
nameİsteğe bağlı | string | — |
io_idİsteğe bağlı | string | — |
no_end_dateİsteğe bağlı | boolean | bitişsiz günlük sınır |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.