İçeriğe geç
Tecrübetecrube.com
Asistan araçları · Kurulum ve kampanya

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 kredi

Bağ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 kredi

OpenAI 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.

ParametreTipAçıklama
ad_account_idİsteğe bağlıstringadacct_… — yalnızca birden fazla ChatGPT Ads hesabı bağlıysa gerekir
statusİsteğe bağlıactive | paused | archived—
nameİsteğe bağlıstringkampanya adına göre filtrele (en az 3 karakter)

openai_ads_performance_report

Okuma2 kredi

ChatGPT 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.

ParametreTipAçıklama
ad_account_idİsteğe bağlıstringadacct_… — 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ıstringYYYY-MM-DD
end_dateİsteğe bağlıstringYYYY-MM-DD
dailyİsteğe bağlıboolean—
campaign_idsİsteğe bağlıarray<string>—

chatgpt_ads_details

Okuma1 kredi

Tek 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.

ParametreTipAçıklama
ad_account_idİsteğe bağlıstringadacct_… — yalnızca birden fazla ChatGPT Ads hesabı bağlıysa gerekir
idZorunlustringcmpn_…, 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 kredi

Kampanya konum hedeflemesi için ChatGPT Ads konum id'lerini (ülkeler, bölgeler, pazarlar, posta kodları) ada göre bulur. Salt okunur.

ParametreTipAçıklama
ad_account_idİsteğe bağlıstringadacct_… — yalnızca birden fazla ChatGPT Ads hesabı bağlıysa gerekir
queryZorunlustring—
limitİsteğe bağlıinteger (1–100)—

chatgpt_ads_insights

Okuma2 kredi

OpenAI 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.

ParametreTipAçıklama
ad_account_idİsteğe bağlıstringadacct_… — yalnızca birden fazla ChatGPT Ads hesabı bağlıysa gerekir
scope_idİsteğe bağlıstringraporu 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ıstringYYYY-MM-DD
end_dateİsteğe bağlıstringYYYY-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ıbooleansıfır gösterimli satırları ekler (segmentsiz)
conversionsİsteğe bağlıbooleandö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 kredi

ChatGPT Ads hesap harcama limitleri: tarih aralığı pencereleri ve yinelenen günlük limitler; şimdiye kadarki harcama ve neyin düzenlenebileceğiyle. Salt okunur.

ParametreTipAçıklama
ad_account_idİsteğe bağlıstringadacct_… — yalnızca birden fazla ChatGPT Ads hesabı bağlıysa gerekir

chatgpt_ads_conversion_setup

Okuma1 kredi

ChatGPT 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.

ParametreTipAçıklama
ad_account_idİsteğe bağlıstringadacct_… — yalnızca birden fazla ChatGPT Ads hesabı bağlıysa gerekir
check_recent_eventsİsteğe bağlıboolean—

chatgpt_ads_ad_preview

Okuma1 kredi

Mevcut 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.

ParametreTipAçıklama
ad_account_idİsteğe bağlıstringadacct_… — yalnızca birden fazla ChatGPT Ads hesabı bağlıysa gerekir
ad_idZorunlustring—

list_chatgpt_ads_custom_audiences

Okuma1 kredi

Reklam hesabının ChatGPT Ads özel kitlelerini listeler: kimlik, ad, durum ve sürüm. Yalnız okur.

ParametreTipAçıklama
ad_account_idİsteğe bağlıstringadacct_… — required only when several ChatGPT Ads accounts are connected

diagnose_chatgpt_ads_delivery

Okuma2 kredi

ChatGPT 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.

ParametreTipAçıklama
ad_account_idİsteğe bağlıstringadacct_… — 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 kredi

Bir 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.

ParametreTipAçıklama
ad_account_idİsteğe bağlıstringadacct_… — yalnızca birden fazla ChatGPT Ads hesabı bağlıysa gerekir
campaign_idZorunlustringcmpn_…
statusZorunlupause | 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 kredi

Bir 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.

ParametreTipAçıklama
ad_account_idİsteğe bağlıstringadacct_… — yalnızca birden fazla ChatGPT Ads hesabı bağlıysa gerekir
campaign_idZorunlustringcmpn_…
daily_budgetZorunlunumberhesap 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 kredi

Bir 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.

ParametreTipAçıklama
api_keyİsteğe bağlıstringtek 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 kredi

Bağ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.

ParametreTipAçıklama
actionİsteğe bağlılist | recheck | disconnect | set_default—
ad_account_idİsteğe bağlıstringadacct_… — 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 kredi

Hesap 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.

ParametreTipAçıklama
ad_account_idİsteğe bağlıstringadacct_… — yalnızca birden fazla ChatGPT Ads hesabı bağlıysa gerekir
nameZorunlustring—
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ıstringISO 8601 tarih-saat (ofset yoksa UTC)
endİsteğe bağlıstringISO 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 kredi

Bir 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.

ParametreTipAçıklama
ad_account_idİsteğe bağlıstringadacct_… — yalnızca birden fazla ChatGPT Ads hesabı bağlıysa gerekir
campaign_idZorunlustring—
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ıstringISO 8601 tarih-saat (fark belirtilmezse UTC)
endİsteğe bağlıstringISO 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 kredi

Bir 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.

ParametreTipAçıklama
ad_account_idİsteğe bağlıstringadacct_… — yalnızca birden fazla ChatGPT Ads hesabı bağlıysa gerekir
campaign_idZorunlustring—
nameZorunlustring—
max_bidİsteğe bağlınumberhesap 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 kredi

Bir 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.

ParametreTipAçıklama
ad_account_idİsteğe bağlıstringadacct_… — yalnızca birden fazla ChatGPT Ads hesabı bağlıysa gerekir
ad_group_idZorunlustring—
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 kredi

Bir 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.

ParametreTipAçıklama
ad_account_idİsteğe bağlıstringadacct_… — yalnızca birden fazla ChatGPT Ads hesabı bağlıysa gerekir
ad_group_idZorunlustring—
nameZorunlustring—
titleZorunlustring3-50 karakter
bodyZorunlustringen fazla 100 karakter
target_urlZorunlustring—
image_urlİsteğe bağlıstringherkese 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 kredi

Bir 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.

ParametreTipAçıklama
ad_account_idİsteğe bağlıstringadacct_… — yalnızca birden fazla ChatGPT Ads hesabı bağlıysa gerekir
ad_idZorunlustring—
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 kredi

Bir 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.

ParametreTipAçıklama
ad_account_idİsteğe bağlıstringadacct_… — yalnızca birden fazla ChatGPT Ads hesabı bağlıysa gerekir
kindİsteğe bağlıcampaign | ad_group | ad—
idZorunlustring—
actionZorunlupause | 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 kredi

Bir 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.

ParametreTipAçıklama
ad_account_idİsteğe bağlıstringadacct_… — yalnızca birden fazla ChatGPT Ads hesabı bağlıysa gerekir
nameZorunlustring—
event_typeZorunlupage_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_idZorunlustringpiksel 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 kredi

Boş 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.

ParametreTipAçıklama
ad_account_idİsteğe bağlıstringadacct_… — required only when several ChatGPT Ads accounts are connected
actionZorunlucreate | add | remove | archive—
audience_idİsteğe bağlıstringcaud_… (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 kredi

Bir 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.

ParametreTipAçıklama
ad_account_idİsteğe bağlıstringadacct_… — yalnızca birden fazla ChatGPT Ads hesabı bağlıysa gerekir
actionZorunlucreate | update | delete | set_daily | delete_daily—
window_idİsteğe bağlıstring—
start_dateİsteğe bağlıstringYYYY-MM-DD, dahil
end_dateİsteğe bağlıstringYYYY-MM-DD, hariç
amountİsteğe bağlınumberhesap para birimi
nameİsteğe bağlıstring—
io_idİsteğe bağlıstring—
no_end_dateİsteğe bağlıbooleanbitiş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.