TikTok Ads araçları
Kampanya, reklam grubu ve reklam yönetimi, video/görsel yükleme, kitleler ve performans raporları.
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ı27 araç
list_tiktok_advertisers
Okuma1 krediBağlı TikTok Ads belirteciyle erişilebilen TikTok reklam hesapları (advertisers): id, ad, para birimi, saat dilimi, durum. Salt okunur; hesap bağlı değilse connected=false döndürür.
Bu araç parametre almaz.
list_tiktok_campaigns
Okuma1 krediBağlı reklam hesabının TikTok kampanyaları: campaign_id, ad, objective_type, bütçe, budget_mode, operation_status (açık / kapalı) ve secondary_status (TikTok'un yayın durumu). campaign_id değerleri diğer tiktok araçlarında kullanılır.
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idsİsteğe bağlı | array<string> | — |
statusİsteğe bağlı | STATUS_DELIVERY_OK | STATUS_NOT_DELIVERY | STATUS_DISABLE | STATUS_DELETE | STATUS_NOT_DELETE | STATUS_ALL | birincil durum filtresi, ör. STATUS_DELIVERY_OK, STATUS_DISABLE |
advertiser_idİsteğe bağlı | string | optional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change |
list_tiktok_ad_groups
Okuma1 krediTikTok reklam grupları; bütçe, teklif, optimizasyon hedefi, hedefleme (konumlar, yaşlar, cinsiyet, diller, ilgi alanları, kitleler), yerleşimler, zamanlama ve gün içi saat dilimleriyle.
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idsİsteğe bağlı | array<string> | — |
adgroup_idsİsteğe bağlı | array<string> | — |
advertiser_idİsteğe bağlı | string | optional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change |
list_tiktok_ads
Okuma1 krediTikTok reklamları: ad_id, ad, reklam grubu, durum (operation_status, secondary_status), biçim, metin, video_id, açılış sayfası, eylem çağrısı. İncelemeden geçemeyen ya da yalnız kısmen geçen reklamlarda ayrıca review gelir: TikTok'un inceleme durumu, ret nedenleri ve önerisi ile reklamın yasaklandığı yerleşimler, konumlar ve yaş grupları.
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idsİsteğe bağlı | array<string> | — |
adgroup_idsİsteğe bağlı | array<string> | — |
ad_idsİsteğe bağlı | array<string> | — |
advertiser_idİsteğe bağlı | string | optional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change |
tiktok_performance_report
Okuma2 krediBir tarih aralığı için kampanya, reklam grubu ya da reklam bazında TikTok performansı: harcama, gösterim, tıklama, CTR, CPM, CPC, dönüşüm, dönüşüm maliyeti, dönüşüm oranı, varsa ROAS; isteğe bağlı günlük kırılım ve toplamlar. Yalnızca gerçek veri; hesap yoksa connected=false.
| Parametre | Tip | Açıklama |
|---|---|---|
levelİsteğe bağlı | campaign | ad_group | ad | — |
daysİsteğe bağlı | integer (1–365) | — |
start_dateİsteğe bağlı | string | — |
end_dateİsteğe bağlı | string | — |
dailyİsteğe bağlı | boolean | gün başına bir satır (stat_time_day) |
campaign_idsİsteğe bağlı | array<string> | — |
adgroup_idsİsteğe bağlı | array<string> | — |
ad_idsİsteğe bağlı | array<string> | — |
advertiser_idİsteğe bağlı | string | optional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change |
list_tiktok_audiences
Okuma1 krediTikTok reklam hesabının özel ve benzer kitleleri: audience_id, ad, tür, boyut (cover_num), geçerlilik. Atamak için audience_ids değerlerini update_tiktok_ad_group içinde kullanın.
| Parametre | Tip | Açıklama |
|---|---|---|
advertiser_idİsteğe bağlı | string | optional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change |
list_tiktok_videos
Okuma1 krediTikTok reklam hesabının varlık kitaplığındaki videolar: video_id, dosya adı, süre, boyut, önizleme ve kapak URL'leri. video_id create_tiktok_ad ya da create_tiktok_whatsapp_campaign içinde kullanılır; herkese açık bir URL'den yeni video upload_tiktok_video ile eklenir.
| Parametre | Tip | Açıklama |
|---|---|---|
video_idsİsteğe bağlı | array<string> | — |
limitİsteğe bağlı | integer (1–500) | newest first (default 500) |
advertiser_idİsteğe bağlı | string | optional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change |
get_tiktok_video_cover
Okuma1 krediTikTok kitaplık videosu için önerilen kapak kareleri (file/video/suggestcover): id, önizleme url'si (bir saat geçerli), boyut. Seçilen url'yi reklam kapağı (image_ids) olarak kullanmak için upload_tiktok_image ile yükleyin. Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
video_idZorunlu | string | — |
countİsteğe bağlı | integer (1–10) | — |
advertiser_idİsteğe bağlı | string | optional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change |
search_tiktok_targeting
Okuma1 krediHedefleme adlarını TikTok id'lerine çevirir: interest (tool/interest_category → interest_category_ids), behavior (tool/action_category → actions[].action_category_ids), interest_keyword (tool/interest_keyword/recommend → interest_keyword_ids), location (tool/targeting/search → location_ids / zipcode_ids, şehirler ve iller), region (tool/region → hedef için hedeflenebilir ülkeler). Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
typeZorunlu | interest | behavior | interest_keyword | location | region | — |
queryZorunlu | string | aranacak ad, ör. fashion, moda, Istanbul, Turkey |
languageİsteğe bağlı | string | interest/behavior/interest_keyword için ad dili, ör. tr, en (varsayılan: sohbet dili) |
objective_typeİsteğe bağlı | string | location/region için: kampanya hedefi, varsayılan TRAFFIC; WhatsApp reklamları için LEAD_GENERATION |
promotion_typeİsteğe bağlı | string | location/region için; varsayılan WEBSITE ya da LEAD_GENERATION ile LEAD_GEN_CLICK_TO_SOCIAL_MEDIA_APP_MESSAGE |
placementsİsteğe bağlı | array<string> | varsayılan PLACEMENT_TIKTOK |
region_codesİsteğe bağlı | array<string> | location: ülke koduna göre filtre, ör. TR |
geo_typesİsteğe bağlı | array<string> | location: COUNTRY | PROVINCE | CITY | DISTRICT | DMA | ZIP_CODE |
limitİsteğe bağlı | integer (1–100) | — |
advertiser_idİsteğe bağlı | string | optional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change |
list_tiktok_identities
Okuma1 krediTikTok reklam hesabının reklam kimlikleri (identity/get): identity_id, identity_type, görünen ad, kullanıcı adı ve gönderilerin çekilip çekilemeyeceği. identity_id/identity_type'ı create_tiktok_ad ya da list_tiktok_posts'a verin. Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
identity_typeİsteğe bağlı | CUSTOMIZED_USER | AUTH_CODE | TT_USER | BC_AUTH_TT | — |
identity_bc_idİsteğe bağlı | string | BC_AUTH_TT ile zorunlu |
advertiser_idİsteğe bağlı | string | optional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change |
list_tiktok_pixels
Okuma1 krediReklam hesabının TikTok dönüşüm pikselleri (pixel/list): pixel_id, pixel_code, ad, kurulum modu ve izlenen olaylar. Dönüşüm reklam grupları için pixel_id'yi, send_tiktok_conversion_event için pixel_code'u kullanın. Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
advertiser_idİsteğe bağlı | string | optional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change |
list_tiktok_auto_messages
Okuma1 krediTikTok Doğrudan Mesaj reklamları için karşılama mesajı şablonları (creative/auto_message/get): auto_message_id, başlık, selamlama, önerilen sorular ve inceleme durumu. auto_message_id'yi create_tiktok_ad'e verin. Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
advertiser_idİsteğe bağlı | string | optional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change |
list_tiktok_lead_forms
Okuma1 krediReklam hesabının TikTok anında potansiyel müşteri formları (page/get, LEAD_GEN): page_id, başlık, durum, oluşturma/güncelleme/yayın zamanı ve önizleme URL'si. Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
advertiser_idİsteğe bağlı | string | optional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change |
get_tiktok_lead_form_fields
Okuma1 krediBir TikTok anında potansiyel müşteri formunun soru alanları (page/field/get): toplanan yanıtları doğru okumak için alan anahtarları, etiketler ve türler ile form meta verileri. Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
page_idZorunlu | string | list_tiktok_lead_forms'tan anında form id'si |
advertiser_idİsteğe bağlı | string | optional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change |
download_tiktok_leads
Okuma2 krediBir TikTok anında formunun ya da potansiyel müşteri reklamının topladığı lead'leri indirir (page/lead/task + page/lead/task/download; ZIP gelirse içindeki CSV açılır). İndirme görevini açar, birkaç saniye yoklar ve hazır olunca gizliliği koruyan bir özet döndürür: toplam satır, soru adları ve ilk satırlar (limit, varsayılan 20) — lead id, oluşturulma zamanı, reklam, reklam grubu, kampanya ve form kimlikleriyle birlikte MASKELİ cevaplar (adlar baş harfe indirilir; e-posta, telefon ve IBAN maskelenir). Maskesiz tam CSV hesabın özel dosya alanına kaydedilir ve yalnızca 15 dakika geçerli imzalı bir bağlantı (download_url) olarak döner (saklanan dosya 30 gün tutulur, sonra silinir): bağlantıyı kullanıcıya verin, dosya içeriğini sohbete yapıştırmayın; dosya kaydedilemezse yalnızca maskeli özet döner. TikTok dosyayı hâlâ hazırlıyorsa task_id döner: aynı page_id/ad_id ve bu task_id ile yeniden çağırın. region: reklamların yayınlandığı bölge (eu = AEA/İsviçre/BK, us, other). Yalnızca reklam hesabı yöneticileri indirebilir. Kişisel veridir: yalnızca formda verilen izin kapsamında kullanın. Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
page_idİsteğe bağlı | string | list_tiktok_lead_forms'tan anında form id'si (ya da ad_id verin) |
ad_idİsteğe bağlı | string | potansiyel müşteri reklamının id'si; form yerine o reklamın lead'lerini indirir |
task_idİsteğe bağlı | string | hâlâ RUNNING olan önceki bir çağrının döndürdüğü görev id'si |
regionİsteğe bağlı | eu | us | other | reklamların hedeflendiği yer: eu = AEA/İsviçre/BK, us = ABD, other (varsayılan) = diğer her yer |
limitİsteğe bağlı | integer (1–100) | maskeli önizlemedeki satır sayısı (varsayılan 20); tam liste yalnızca indirme dosyasındadır |
advertiser_idİsteğe bağlı | string | optional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change |
list_tiktok_creative_portfolios
Okuma1 krediTikTok reklam hesabının kreatif portföyleri (creative/portfolio/list): portföy id'si, tür (görüntü kartı, indirme kartı, hediye kodu…), önizleme URL'si ve ana ayarlar. Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
advertiser_idİsteğe bağlı | string | optional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change |
list_tiktok_gmv_max_stores
Okuma1 krediReklam hesabına bağlı TikTok Shop mağazaları (gmv_max/store/list): GMV Max uygunluğu, durum, rol, yetkilendiren Business Center ve hedeflenebilir bölgelerle. Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
advertiser_idİsteğe bağlı | string | optional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change |
list_tiktok_smart_plus
Okuma1 krediTikTok reklam hesabının Smart+ (otomatik) kampanyaları, reklam grupları ya da reklamları (smart_plus/*/get). Bunlar list_tiktok_campaigns / _ad_groups / _ads tarafından döndürülmez. Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
levelİsteğe bağlı | campaign | adgroup | ad | varsayılan campaign |
advertiser_idİsteğe bağlı | string | optional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change |
list_tiktok_posts
Okuma1 krediBağlı bir TikTok hesap kimliğinin Spark Ads olarak yayınlanabilecek organik TikTok gönderileri (identity/video/get): tiktok_item_id, metin, durum, süre, kapak ve reklam yetkilendirme durumu. Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
identity_idZorunlu | string | — |
identity_typeİsteğe bağlı | TT_USER | BC_AUTH_TT | AUTH_CODE | varsayılan TT_USER |
identity_bc_idİsteğe bağlı | string | BC_AUTH_TT ile zorunlu |
limitİsteğe bağlı | integer (1–100) | varsayılan 20 |
advertiser_idİsteğe bağlı | string | optional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change |
tiktok_recommendations
Okuma2 krediTikTok'un kendi reklam grubu teşhisleri ve önerileri (tool/diagnosis/get): kreatif yorgunluğu, tahmini artışla teklif ve bütçe önerileri ve olay izleme sorunları. Salt okunur; güncelleme araçlarıyla uygulanır.
| Parametre | Tip | Açıklama |
|---|---|---|
adgroup_idsİsteğe bağlı | array<string> | en fazla 20; varsayılan: TikTok teşhisi olan reklam gruplarını seçer |
issue_categoriesİsteğe bağlı | array<string> | CREATIVE | BID_AND_BUDGET | EVENT_TRACK |
advertiser_idİsteğe bağlı | string | optional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change |
tiktok_report_query
Okuma2 krediSerbest biçimli TikTok raporu (report/integrated/get): desteklenen her metrik ve boyut, rapor türü, veri düzeyi, tarih aralığı ya da tüm zamanlar ve filtreler. Satırlar tam olarak TikTok'un hesapladığı gibi döndürülür. Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
metricsZorunlu | array<string> | TikTok metrik adları, ör. spend, impressions, clicks, conversion, complete_payment_roas |
dimensionsZorunlu | array<string> | ör. campaign_id, adgroup_id, ad_id, stat_time_day, country_code, gender, age |
report_typeİsteğe bağlı | BASIC | AUDIENCE | PLAYABLE_MATERIAL | CATALOG | BC | TT_SHOP | — |
data_levelİsteğe bağlı | string | ör. AUCTION_CAMPAIGN, AUCTION_ADGROUP, AUCTION_AD, AUCTION_ADVERTISER |
daysİsteğe bağlı | integer (1–365) | — |
start_dateİsteğe bağlı | string | — |
end_dateİsteğe bağlı | string | — |
lifetimeİsteğe bağlı | boolean | tarih aralığı yerine tüm zamanların toplamları |
filteringİsteğe bağlı | array<object> | TikTok filtreleri: [{field_name, filter_type, filter_value}] |
limitİsteğe bağlı | integer (1–5000) | — |
advertiser_idİsteğe bağlı | string | optional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change |
list_tiktok_business_centers
Okuma1 krediBağlı token ile erişilebilen TikTok Business Center'lar (bc/get): bc_id, ad, şirket, durum, para birimi, saat dilimi ve rolünüz. Salt okunur.
Bu araç parametre almaz.
list_tiktok_bc_advertisers
Okuma1 krediBir TikTok Business Center içindeki reklam hesapları (bc/asset/get, ADVERTISER): reklamveren id'si, ad, hesap türü, rolünüz ve doğrulama durumu. Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
bc_idİsteğe bağlı | string | Business Center id'si (list_tiktok_business_centers); token tek bir Business Center'a erişiyorsa isteğe bağlı |
list_tiktok_bc_pixels
Okuma1 krediBir TikTok Business Center'da tutulan pikseller (bc/asset/get, PIXEL), reklam hesaplarının genelinde. Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
bc_idİsteğe bağlı | string | Business Center id'si (list_tiktok_business_centers); token tek bir Business Center'a erişiyorsa isteğe bağlı |
list_tiktok_asset_groups
Okuma1 krediBir TikTok Business Center'ın varlık grupları (bc/asset_group/list): asset_group_id ve ad. Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
bc_idİsteğe bağlı | string | Business Center id'si (list_tiktok_business_centers); token tek bir Business Center'a erişiyorsa isteğe bağlı |
tiktok_advertiser_qualification
Okuma1 krediBir TikTok Business Center'daki işletme yeterlilikleri (bc/advertiser/qualification/get): şirket adı, doğrulama durumu, sahip reklam hesabı, bağlı hesap sayısı ve bölge. Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
bc_idİsteğe bağlı | string | Business Center id'si (list_tiktok_business_centers); erişim anahtarı tek bir Business Center'a ulaşıyorsa isteğe bağlı |
advertiser_idİsteğe bağlı | string | yalnızca bu reklam hesabına ait yeterlilikleri tut |
verifiedİsteğe bağlı | boolean | doğrulanmış / doğrulanmamış olarak filtrele |
tiktok_change_history
Okuma2 krediBir TikTok Business Center'ın etkinlik günlüğü (changelog/get): ne zaman, hangi etkinlik türü, işlemi yapanın id'si ve değişiklik metni; en yeniden başlayarak. Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
bc_idİsteğe bağlı | string | Business Center id'si (list_tiktok_business_centers); erişim anahtarı tek bir Business Center'a ulaşıyorsa isteğe bağlı |
start_dateİsteğe bağlı | string | YYYY-MM-DD (UTC); varsayılan: son 7 gün |
end_dateİsteğe bağlı | string | — |
daysİsteğe bağlı | integer (1–365) | — |
activity_typeİsteğe bağlı | string | ALL (varsayılan) | USER | ASSET | … TikTok'un tanımladığı şekilde |
limitİsteğe bağlı | integer (1–500) | — |
advertiser_idİsteğe bağlı | string | optional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change |
Yazma araçları24 araç
select_tiktok_advertiser
Yazma1 krediChoose which TikTok ad account (advertiser) all further TikTok reads and writes use. Per project: with a non-default project selected only that project's advertiser is saved; in the default project the connection's selection changes. Local setting; nothing is changed on TikTok. Switching is always allowed; adding another advertiser on the platform is subject to the plan's ads.accounts.max limit (error=entitlement body with next_plan and upgrade_url).
Bu aracın açıklaması henüz çevrilmedi; asistanın gördüğü özgün İngilizce metin gösteriliyor.
| Parametre | Tip | Açıklama |
|---|---|---|
advertiser_idZorunlu | string | — |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
upload_tiktok_video
Yazma2 krediHerkese açık bir URL'den TikTok reklam hesabının varlık kitaplığına video yükler (file/video/ad/upload, UPLOAD_BY_URL). Önce önizleme ve onay; yeni video_id eylem sonucunda döner.
| Parametre | Tip | Açıklama |
|---|---|---|
video_urlZorunlu | string | mp4/mov/mpeg/avi dosyasının herkese açık http(s) URL'si (URL yüklemelerinde ideal olarak 10 MB altı) |
file_nameİsteğe bağlı | string | 1-100 karakter, hesapta benzersiz; varsayılan: URL dosya adı + zaman damgası |
auto_fixİsteğe bağlı | boolean | düşük çözünürlüğü / yanlış en-boy oranını TikTok tespit edip düzeltsin |
advertiser_idİsteğe bağlı | string | optional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
upload_tiktok_image
Yazma2 krediHerkese açık bir URL'den TikTok varlık kitaplığına görsel (görsel reklam ya da video kapağı) yükler (file/image/ad/upload, UPLOAD_BY_URL). Önce önizleme ve onay; image_id eylem sonucunda döner.
| Parametre | Tip | Açıklama |
|---|---|---|
image_urlZorunlu | string | JPG/PNG dosyasının herkese açık http(s) URL'si (en fazla 1440x2560 toplam piksel) |
file_nameİsteğe bağlı | string | 1-100 karakter, hesapta benzersiz; varsayılan: URL dosya adı + zaman damgası |
advertiser_idİsteğe bağlı | string | optional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_tiktok_campaign
Yazma2 krediUçtan uca TikTok kampanyası (kampanya + reklam grubu, isteğe bağlı reklam) duraklatılmış taslak olarak oluşturur. Deftere taslak yazar ve önizlemeli onay öğesi açar; TikTok'a yalnızca onaydan sonra ve yalnızca bağlı hesapla gönderilir.
| Parametre | Tip | Açıklama |
|---|---|---|
nameZorunlu | string | — |
objective_typeZorunlu | TRAFFIC | WEB_CONVERSIONS | REACH | VIDEO_VIEWS | LEAD_GENERATION | APP_PROMOTION | PRODUCT_SALES | — |
daily_budgetİsteğe bağlı | number | hesap para birimi |
budget_modeİsteğe bağlı | BUDGET_MODE_DAY | BUDGET_MODE_TOTAL | BUDGET_MODE_INFINITE | — |
goalİsteğe bağlı | string | — |
pixel_idİsteğe bağlı | string | — |
sales_destinationİsteğe bağlı | WEBSITE | APP | WEB_AND_APP | TIKTOK_SHOP | PRODUCT_SALES campaigns only |
audienceİsteğe bağlı | object | countries (ISO listesi), age_min, age_max, genders ([1]=erkek, [2]=kadın), tiktok_location_ids, tiktok_interest_ids |
ad_groupİsteğe bağlı | object | isteğe bağlı reklam grubu ayarları; varsayılanlar: otomatik yerleşim, şu andan itibaren, dengeli hız |
adİsteğe bağlı | object | isteğe bağlı reklam; kitaplıktan bir video_id gerekir |
advertiser_idİsteğe bağlı | string | optional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_tiktok_ad_group
Yazma2 krediBir kampanya altında bütçe, teklif, hedefleme, yerleşimler, zamanlama ve gün içi saat dilimleriyle TikTok reklam grubu oluşturur. Önce önizleme ve onay; operation_status=ENABLE verilmedikçe duraklatılmış oluşturulur.
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idZorunlu | string | TikTok campaign_id |
nameZorunlu | string | — |
budgetZorunlu | number | günlük bütçe, hesap para birimi |
budget_modeİsteğe bağlı | BUDGET_MODE_DAY | BUDGET_MODE_TOTAL | — |
placement_typeİsteğe bağlı | PLACEMENT_TYPE_AUTOMATIC | PLACEMENT_TYPE_NORMAL | — |
placementsİsteğe bağlı | array<string> | PLACEMENT_TIKTOK | PLACEMENT_PANGLE | PLACEMENT_GLOBAL_APP_BUNDLE |
promotion_typeİsteğe bağlı | string | WEBSITE | APP_ANDROID | APP_IOS | LEAD_GENERATION |
app_idİsteğe bağlı | string | app promotion only |
identity_idİsteğe bağlı | string | — |
identity_typeİsteğe bağlı | string | CUSTOMIZED_USER | TT_USER | BC_AUTH_TT |
secondary_optimization_eventİsteğe bağlı | string | — |
operation_statusİsteğe bağlı | ENABLE | DISABLE | — |
optimization_goalİsteğe bağlı | string | CLICK | CONVERT | REACH | VIDEO_VIEW | LEAD | ENGAGEMENT |
billing_eventİsteğe bağlı | string | CPC | CPM | OCPM | CPV |
bid_typeİsteğe bağlı | string | BID_TYPE_NO_BID | BID_TYPE_CUSTOM |
bid_priceİsteğe bağlı | number | — |
conversion_bid_priceİsteğe bağlı | number | — |
pacingİsteğe bağlı | PACING_MODE_SMOOTH | PACING_MODE_FAST | — |
location_idsİsteğe bağlı | array<string> | TikTok konum id'leri (Türkiye 298795, US 6252001, UK 2635167, DE 2921044) |
age_groupsİsteğe bağlı | array<string> | AGE_13_17 | AGE_18_24 | AGE_25_34 | AGE_35_44 | AGE_45_54 | AGE_55_100 |
genderİsteğe bağlı | GENDER_UNLIMITED | GENDER_MALE | GENDER_FEMALE | — |
languagesİsteğe bağlı | array<string> | dil kodları, ör. tr, en |
interest_category_idsİsteğe bağlı | array<string> | — |
operating_systemsİsteğe bağlı | array<string> | ANDROID | IOS |
audience_idsİsteğe bağlı | array<string> | — |
excluded_audience_idsİsteğe bağlı | array<string> | — |
schedule_start_timeİsteğe bağlı | string | YYYY-MM-DD HH:MM:SS (UTC) |
schedule_end_timeİsteğe bağlı | string | YYYY-MM-DD HH:MM:SS (UTC); SCHEDULE_START_END ayarlar |
daypartingİsteğe bağlı | string | 336 karakter 0/1: Pazartesi 00:00'dan başlayan 7 gün x 48 yarım saat |
pixel_idİsteğe bağlı | string | — |
optimization_eventİsteğe bağlı | string | ör. COMPLETE_PAYMENT, ON_WEB_CART, FORM |
comment_disabledİsteğe bağlı | boolean | — |
share_disabledİsteğe bağlı | boolean | — |
search_result_enabledİsteğe bağlı | boolean | — |
interest_keyword_idsİsteğe bağlı | array<string> | search_tiktok_targeting(type=interest_keyword) sonucundan |
actionsİsteğe bağlı | array<object> | davranış hedefleme: [{action_scene: VIDEO_RELATED|CREATOR_RELATED|HASHTAG_RELATED, action_period: 0|7|15, video_user_actions: [...], action_category_ids: [search_tiktok_targeting(type=behavior) sonucundaki id'ler]}] |
deep_bid_typeİsteğe bağlı | string | e.g. DEFAULT, MIN, PACING, VO_MIN_ROAS |
roas_bidİsteğe bağlı | number | — |
zipcode_idsİsteğe bağlı | array<string> | from search_tiktok_targeting(type=location) |
device_model_idsİsteğe bağlı | array<string> | — |
device_price_rangesİsteğe bağlı | array<number> | price range bounds, e.g. [0, 250] |
network_typesİsteğe bağlı | array<string> | WIFI | 2G | 3G | 4G | 5G |
carrier_idsİsteğe bağlı | array<string> | — |
schedule_typeİsteğe bağlı | SCHEDULE_FROM_NOW | SCHEDULE_START_END | — |
saved_audience_idİsteğe bağlı | string | — |
frequencyİsteğe bağlı | integer | max impressions per user within frequency_schedule days |
frequency_scheduleİsteğe bağlı | integer | frequency cap window in days |
brand_safety_typeİsteğe bağlı | string | NO_BRAND_SAFETY | STANDARD_INVENTORY | LIMITED_INVENTORY | EXPANDED_INVENTORY |
blocked_pangle_app_idsİsteğe bağlı | array<string> | — |
targeting_expansionİsteğe bağlı | object | e.g. {expansion_enabled: true} |
household_incomeİsteğe bağlı | array<string> | e.g. TOP5, TOP10, TOP10_25, TOP25_50 |
spending_powerİsteğe bağlı | ALL | HIGH | — |
exclude_age_under_eighteenİsteğe bağlı | boolean | — |
advertiser_idİsteğe bağlı | string | optional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_tiktok_ad
Yazma2 krediBir reklam grubunda kitaplık videosundan (ya da Spark gönderisinden) TikTok reklamı oluşturur. Önce önizleme ve onay.
| Parametre | Tip | Açıklama |
|---|---|---|
adgroup_idZorunlu | string | — |
ad_nameİsteğe bağlı | string | — |
ad_textZorunlu | string | 1-100 karakter |
video_idİsteğe bağlı | string | list_tiktok_videos sonucundan |
image_idsİsteğe bağlı | array<string> | kapak görseli id'leri / görsel reklam |
ad_formatİsteğe bağlı | SINGLE_VIDEO | SINGLE_IMAGE | CAROUSEL | — |
landing_page_urlİsteğe bağlı | string | — |
call_to_actionİsteğe bağlı | string | LEARN_MORE | SHOP_NOW | SIGN_UP | CONTACT_US | DOWNLOAD … |
identity_idİsteğe bağlı | string | — |
identity_typeİsteğe bağlı | string | CUSTOMIZED_USER | TT_USER | BC_AUTH_TT |
display_nameİsteğe bağlı | string | — |
tiktok_item_idİsteğe bağlı | string | Spark Ads gönderi id'si |
deeplinkİsteğe bağlı | string | — |
auto_message_idİsteğe bağlı | string | welcome message for Direct Message ads (list_tiktok_auto_messages / create_tiktok_auto_message) |
identity_bc_idİsteğe bağlı | string | Business Center id when identity_type is BC_AUTH_TT |
operation_statusİsteğe bağlı | ENABLE | DISABLE | DISABLE creates the ad paused; default ENABLE |
advertiser_idİsteğe bağlı | string | optional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
update_tiktok_campaign_budget
Yazma2 krediBir ya da daha fazla TikTok kampanyasının bütçesini değiştirir. Önizleme ve onaydan geçer; defter yalnızca TikTok kabul ettiğinde güncellenir.
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idsZorunlu | array<string> | TikTok kampanya id'leri (ya da bir Tecrube kampanya id'si) |
amountZorunlu | number | hesap para birimi |
campaign_idİsteğe bağlı | string | Alias of campaign_ids (single id) |
currencyİsteğe bağlı | string | optional ISO check; must equal the ad account currency |
advertiser_idİsteğe bağlı | string | optional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
update_tiktok_campaign_status
YazmaGeri alınamaz2 krediTikTok kampanyalarını duraklatır (DISABLE) ya da etkinleştirir (ENABLE). Önce önizleme ve onay.
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idsZorunlu | array<string> | — |
operation_statusZorunlu | ENABLE | DISABLE | DELETE | DELETE is permanent; only when the user explicitly asked |
campaign_idİsteğe bağlı | string | Alias of campaign_ids (single id) |
advertiser_idİsteğe bağlı | string | optional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
update_tiktok_ad_group
Yazma2 krediBir ya da birçok TikTok reklam grubunu tek seferde günceller: bütçe, teklif (bid_type/bid_price), hedefleme (konumlar, yaşlar, cinsiyet, diller, ilgi alanları, kitleler), zamanlama ve gün içi saat dilimleri, yorum/paylaşım ayarları. Yerleşimler ve bütçe modu oluşturulduktan sonra değiştirilemez (TikTok kuralı). Önce önizleme ve onay.
| Parametre | Tip | Açıklama |
|---|---|---|
adgroup_idsZorunlu | array<string> | — |
adgroup_nameİsteğe bağlı | string | — |
budgetİsteğe bağlı | number | — |
optimization_goalİsteğe bağlı | string | CLICK | CONVERT | REACH | VIDEO_VIEW | LEAD | ENGAGEMENT |
billing_eventİsteğe bağlı | string | CPC | CPM | OCPM | CPV |
bid_typeİsteğe bağlı | string | BID_TYPE_NO_BID | BID_TYPE_CUSTOM |
bid_priceİsteğe bağlı | number | — |
conversion_bid_priceİsteğe bağlı | number | — |
pacingİsteğe bağlı | PACING_MODE_SMOOTH | PACING_MODE_FAST | — |
location_idsİsteğe bağlı | array<string> | TikTok konum id'leri (Türkiye 298795, US 6252001, UK 2635167, DE 2921044) |
age_groupsİsteğe bağlı | array<string> | AGE_13_17 | AGE_18_24 | AGE_25_34 | AGE_35_44 | AGE_45_54 | AGE_55_100 |
genderİsteğe bağlı | GENDER_UNLIMITED | GENDER_MALE | GENDER_FEMALE | — |
languagesİsteğe bağlı | array<string> | dil kodları, ör. tr, en |
interest_category_idsİsteğe bağlı | array<string> | — |
operating_systemsİsteğe bağlı | array<string> | ANDROID | IOS |
audience_idsİsteğe bağlı | array<string> | — |
excluded_audience_idsİsteğe bağlı | array<string> | — |
schedule_start_timeİsteğe bağlı | string | YYYY-MM-DD HH:MM:SS (UTC) |
schedule_end_timeİsteğe bağlı | string | YYYY-MM-DD HH:MM:SS (UTC); SCHEDULE_START_END ayarlar |
daypartingİsteğe bağlı | string | 336 karakter 0/1: Pazartesi 00:00'dan başlayan 7 gün x 48 yarım saat |
pixel_idİsteğe bağlı | string | Fixed at creation (defines the ad group's optimisation); rejected with an explanation |
optimization_eventİsteğe bağlı | string | ör. COMPLETE_PAYMENT, ON_WEB_CART, FORM |
comment_disabledİsteğe bağlı | boolean | — |
share_disabledİsteğe bağlı | boolean | — |
search_result_enabledİsteğe bağlı | boolean | — |
interest_keyword_idsİsteğe bağlı | array<string> | search_tiktok_targeting(type=interest_keyword) sonucundan |
actionsİsteğe bağlı | array<object> | davranış hedefleme: [{action_scene: VIDEO_RELATED|CREATOR_RELATED|HASHTAG_RELATED, action_period: 0|7|15, video_user_actions: [...], action_category_ids: [search_tiktok_targeting(type=behavior) sonucundaki id'ler]}] |
deep_bid_typeİsteğe bağlı | string | e.g. DEFAULT, MIN, PACING, VO_MIN_ROAS |
roas_bidİsteğe bağlı | number | — |
zipcode_idsİsteğe bağlı | array<string> | from search_tiktok_targeting(type=location) |
device_model_idsİsteğe bağlı | array<string> | — |
device_price_rangesİsteğe bağlı | array<number> | price range bounds, e.g. [0, 250] |
network_typesİsteğe bağlı | array<string> | WIFI | 2G | 3G | 4G | 5G |
carrier_idsİsteğe bağlı | array<string> | — |
schedule_typeİsteğe bağlı | SCHEDULE_FROM_NOW | SCHEDULE_START_END | — |
saved_audience_idİsteğe bağlı | string | — |
frequencyİsteğe bağlı | integer | max impressions per user within frequency_schedule days |
frequency_scheduleİsteğe bağlı | integer | frequency cap window in days |
brand_safety_typeİsteğe bağlı | string | NO_BRAND_SAFETY | STANDARD_INVENTORY | LIMITED_INVENTORY | EXPANDED_INVENTORY |
blocked_pangle_app_idsİsteğe bağlı | array<string> | — |
targeting_expansionİsteğe bağlı | object | e.g. {expansion_enabled: true} |
household_incomeİsteğe bağlı | array<string> | e.g. TOP5, TOP10, TOP10_25, TOP25_50 |
spending_powerİsteğe bağlı | ALL | HIGH | — |
exclude_age_under_eighteenİsteğe bağlı | boolean | — |
changesİsteğe bağlı | object | adgroup/update alanlarının herhangi biri, sözlük olarak |
adgroup_idİsteğe bağlı | string | Alias of adgroup_ids (single id) |
placementsİsteğe bağlı | array<string> | Not changeable after creation (TikTok rule); rejected with an explanation |
placement_typeİsteğe bağlı | string | Not changeable after creation (TikTok rule); rejected with an explanation |
budget_modeİsteğe bağlı | string | Not changeable after creation (TikTok rule); rejected with an explanation |
advertiser_idİsteğe bağlı | string | optional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
update_tiktok_ad_group_status
YazmaGeri alınamaz2 krediTikTok reklam gruplarını duraklatır ya da etkinleştirir (ör. CPA'sı hedefin üstünde olanlar). Önce önizleme ve onay.
| Parametre | Tip | Açıklama |
|---|---|---|
adgroup_idsZorunlu | array<string> | — |
operation_statusZorunlu | ENABLE | DISABLE | DELETE | DELETE is permanent; only when the user explicitly asked |
reasonİsteğe bağlı | string | — |
adgroup_idİsteğe bağlı | string | Alias of adgroup_ids (single id) |
advertiser_idİsteğe bağlı | string | optional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
update_tiktok_ad_status
YazmaGeri alınamaz2 krediTikTok reklamlarını duraklatır ya da etkinleştirir (ör. yorulmuş bir kreatif). Önce önizleme ve onay.
| Parametre | Tip | Açıklama |
|---|---|---|
ad_idsZorunlu | array<string> | — |
operation_statusZorunlu | ENABLE | DISABLE | DELETE | DELETE is permanent; only when the user explicitly asked |
reasonİsteğe bağlı | string | — |
ad_idİsteğe bağlı | string | Alias of ad_ids (single id) |
advertiser_idİsteğe bağlı | string | optional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_tiktok_custom_audience
Yazma2 krediPiksel, uygulama ya da etkileşim olaylarından kural tabanlı TikTok özel kitlesi oluşturur (ör. son 30 günde sepete ekleyip satın almayanlar). Önce önizleme ve onay; kitlenin dolması saatler alır.
| Parametre | Tip | Açıklama |
|---|---|---|
nameZorunlu | string | — |
audience_typeİsteğe bağlı | PIXEL | APP | ENGAGEMENT | ENGAGEMENT_ORGANIC_VIDEO | BUSINESS_ACCOUNT | LEAD_GENERATION | TIKTOK_SHOP | — |
retention_daysİsteğe bağlı | integer (1–365) | — |
eventİsteğe bağlı | string | dahil edilecek piksel/uygulama olayı, ör. AddToCart, CompletePayment, ViewContent |
exclude_eventİsteğe bağlı | string | hariç tutulacak olay, ör. sepeti terk edenler için CompletePayment |
pixel_idİsteğe bağlı | string | — |
event_source_idsİsteğe bağlı | array<string> | audience_type'a göre piksel id'leri / uygulama id'leri / reklam grubu id'leri |
advertiser_idİsteğe bağlı | string | optional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
delete_tiktok_audience
YazmaGeri alınamaz2 krediTikTok özel ya da benzer kitlelerini kalıcı olarak siler. Kullanıcı istediğinde uygulanır, geri alınamaz.
| Parametre | Tip | Açıklama |
|---|---|---|
audience_idsZorunlu | array<string> | ids from list_tiktok_audiences |
advertiser_idİsteğe bağlı | string | optional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_tiktok_lookalike_audience
Yazma2 krediBir özel kitleden TikTok benzer kitlesi oluşturur (TikTok boyutları: NARROW ≈ en yakın, BALANCED, BROAD). Önce önizleme ve onay.
| Parametre | Tip | Açıklama |
|---|---|---|
nameZorunlu | string | — |
source_audience_idZorunlu | string | — |
audience_sizeİsteğe bağlı | NARROW | BALANCED | BROAD | — |
include_sourceİsteğe bağlı | boolean | — |
location_idsİsteğe bağlı | array<string> | — |
placementsİsteğe bağlı | array<string> | — |
advertiser_idİsteğe bağlı | string | optional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_tiktok_whatsapp_campaign
Yazma2 krediWhatsApp sohbeti açan bir TikTok reklamı (click-to-WhatsApp) oluşturur: LEAD_GENERATION kampanyası, TikTok yerleşiminde optimizasyon konumu Anlık Mesajlaşma Uygulaması (WhatsApp) olan reklam grubu ve kapağı videodan otomatik alınan bir video reklam. chat_link, wa.me bağlantısını telefon numarasından kurar; web sitesi URL'leri reddedilir. Her şey duraklatılmış oluşturulur; önce önizleme ve onay.
| Parametre | Tip | Açıklama |
|---|---|---|
nameZorunlu | string | — |
phone_numberZorunlu | string | ülke koduyla WhatsApp işletme numarası, ör. +90 532 000 00 00 (0 ile başlayan ulusal biçim reddedilir) |
daily_budgetZorunlu | number | reklam grubu günlük bütçesi, hesap para birimi (TikTok minimumu ≈ 20 USD karşılığı) |
video_idZorunlu | string | kitaplık videosu (list_tiktok_videos / upload_tiktok_video) |
ad_textZorunlu | string | 1-100 karakter |
connection_methodİsteğe bağlı | chat_link | native | chat_link: numaradan kurulan wa.me bağlantısı (yalnızca CLICK, ek kurulum yok); native: TikTok'un mesaj yönetimi aracına bağlı numara (CLICK ya da izin listesindeki CONVERSATION) |
prefilled_messageİsteğe bağlı | string | yalnızca chat_link: WhatsApp'ta önceden doldurulan metin; reklamdaki teklifi ya da hizmeti adıyla anmalı, genel selamlamalar reddedilir |
optimization_goalİsteğe bağlı | CLICK | CONVERSATION | — |
phone_region_codeİsteğe bağlı | string | yalnızca native, ülke kodu paylaşımlıysa (ör. +1 için US) |
message_event_set_idİsteğe bağlı | string | yalnızca native + CONVERSATION, numara hiçbir olay kümesiyle eşleşmiyorsa |
image_idsİsteğe bağlı | array<string> | kapak görseli id'si; verilmezse videonun kendi kapağı otomatik alınır ve yüklenir |
call_to_actionİsteğe bağlı | string | varsayılan SEND_MESSAGE (CALL_NOW kullanılamaz) |
ad_nameİsteğe bağlı | string | — |
identity_idİsteğe bağlı | string | — |
identity_typeİsteğe bağlı | string | CUSTOMIZED_USER | TT_USER | BC_AUTH_TT |
display_nameİsteğe bağlı | string | — |
goalİsteğe bağlı | string | — |
audienceİsteğe bağlı | object | countries (ISO listesi), age_min (18+), age_max, genders ([1]=erkek, [2]=kadın), tiktok_location_ids, tiktok_interest_ids |
ad_groupİsteğe bağlı | object | isteğe bağlı reklam grubu hedefleme/zamanlama ayarları; mesajlaşma reklamlarında yerleşimler, tanıtım türü ve arama sonuçları sabittir |
landing_page_urlİsteğe bağlı | string | KABUL EDİLMEZ: mesajlaşma reklam grubunun web sitesi hedefi yoktur; bunun yerine phone_number verin |
website_urlİsteğe bağlı | string | NOT accepted (same rule as landing_page_url); rejected with an explanation |
advertiser_idİsteğe bağlı | string | optional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
update_tiktok_campaign
Yazma5 krediBir TikTok kampanyasını yeniden adlandırır (campaign/update); defterdeki ad da güncellenir. Önce önizleme ve onaydan geçer. Bütçe ve durumun kendi araçları vardır.
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idZorunlu | string | TikTok campaign_id ya da Tecrübe kampanya id'si |
nameZorunlu | string | — |
advertiser_idİsteğe bağlı | string | optional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
update_tiktok_ad
Yazma5 krediBir TikTok reklamının metnini yerinde düzenler (ad/update): ad, metin, açılış sayfası, harekete geçirici mesaj ya da görünen ad. Önce mevcut reklam okunur ve diğer tüm alanlar korunur. Önce önizleme ve onaydan geçer.
| Parametre | Tip | Açıklama |
|---|---|---|
ad_idZorunlu | string | — |
adgroup_idİsteğe bağlı | string | isteğe bağlı; verilmezse reklamdan okunur |
ad_nameİsteğe bağlı | string | — |
ad_textİsteğe bağlı | string | 1-100 karakter |
landing_page_urlİsteğe bağlı | string | — |
call_to_actionİsteğe bağlı | string | — |
display_nameİsteğe bağlı | string | — |
advertiser_idİsteğe bağlı | string | optional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_tiktok_auto_message
Yazma2 krediTikTok Doğrudan Mesaj reklamları için karşılama mesajı oluşturur (creative/auto_message/create): bir selamlama ve otomatik yanıtlı 1-3 dokunulabilir soru. Onaydan sonra auto_message_id döndürür.
| Parametre | Tip | Açıklama |
|---|---|---|
titleZorunlu | string | şablon adı |
contentZorunlu | string | selamlama |
suggested_questionsZorunlu | array<object> | — |
advertiser_idİsteğe bağlı | string | optional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_tiktok_identity
Yazma2 krediÖzel bir TikTok reklam kimliği oluşturur (identity/create): Spark dışı reklamlarda gösterilen görünen ad ve avatar. Önce önizleme ve onay; identity_id döndürür.
| Parametre | Tip | Açıklama |
|---|---|---|
display_nameZorunlu | string | — |
image_uriİsteğe bağlı | string | upload_tiktok_image'dan kare bir avatarın image_id'si |
advertiser_idİsteğe bağlı | string | optional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_tiktok_pixel
Yazma2 krediBir TikTok dönüşüm pikseli oluşturur (pixel/create). Önce önizleme ve onay; web sitesine kurulacak pixel_id ve pixel_code değerlerini döndürür.
| Parametre | Tip | Açıklama |
|---|---|---|
nameZorunlu | string | — |
advertiser_idİsteğe bağlı | string | optional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_tiktok_customer_file_audience
Yazma6 krediBir müşteri listesinden TikTok özel kitlesi oluşturur (dmp/custom_audience/file/upload + create). Değerler, herhangi bir şey saklanmadan ya da gönderilmeden önce Tecrübe içinde normalleştirilir ve SHA-256 ile karma hâline getirilir; önizleme yalnızca sayıları gösterir. Önce onay.
| Parametre | Tip | Açıklama |
|---|---|---|
nameZorunlu | string | — |
identifiersZorunlu | array<string> | e-postalar, +ülke kodlu telefonlar ya da cihaz id'leri; SHA-256 ile zaten karma hâline getirilmiş değerler de kabul edilir |
id_typeİsteğe bağlı | EMAIL | PHONE | IDFA | AAID | varsayılan EMAIL |
retention_daysİsteğe bağlı | integer (1–365) | — |
advertiser_idİsteğe bağlı | string | optional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
share_tiktok_audience
Yazma4 krediTikTok özel kitlelerini aynı Business Center'daki diğer reklam hesaplarıyla paylaşır ya da paylaşımı durdurur (dmp/custom_audience/share, /share/cancel). Önce önizleme ve onaydan geçer.
| Parametre | Tip | Açıklama |
|---|---|---|
audience_idsZorunlu | array<string> | 1-10 özel kitle id'si |
shared_advertiser_idsİsteğe bağlı | array<string> | aynı Business Center'daki 1-10 reklam hesabı (paylaşımı kaldırmada isteğe bağlı: tümü) |
actionİsteğe bağlı | share | unshare | — |
advertiser_idİsteğe bağlı | string | optional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
manage_tiktok_search_negative_keywords
Yazma4 krediBir kampanya ya da reklam grubu için TikTok arama reklamlarının negatif anahtar kelimeleri (search_ad/negative_keyword/*): list doğrudan okur; add ve delete önizleme ve onaydan geçer.
| Parametre | Tip | Açıklama |
|---|---|---|
object_typeZorunlu | CAMPAIGN | ADGROUP | — |
object_idZorunlu | string | — |
operationİsteğe bağlı | list | add | delete | varsayılan list |
keywordsİsteğe bağlı | array<string> | add için; her biri en fazla 80 karakter |
keyword_idsİsteğe bağlı | array<string> | delete için (operation=list sonucundan) |
match_typeİsteğe bağlı | PRECISE_WORD | PHRASE_WORD | BROAD_WORD | add için; varsayılan BROAD_WORD |
advertiser_idİsteğe bağlı | string | optional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
send_tiktok_conversion_event
Yazma1 krediTikTok'a sunucu taraflı tek bir web dönüşüm olayı gönderir (Events API 2.0, event/track). E-posta, telefon ve harici id saklanmadan veya gönderilmeden önce SHA-256 ile karma hâline getirilir. Önce önizleme ve onaydan geçer.
| Parametre | Tip | Açıklama |
|---|---|---|
pixel_codeZorunlu | string | list_tiktok_pixels çıktısından |
event_nameZorunlu | string | standart olay, ör. CompletePayment, SubmitForm, Contact, AddToCart |
emailİsteğe bağlı | string | — |
phoneİsteğe bağlı | string | +ülke koduyla |
external_idİsteğe bağlı | string | — |
ttclidİsteğe bağlı | string | açılış URL'sindeki TikTok tıklama id'si |
valueİsteğe bağlı | number | — |
currencyİsteğe bağlı | string | ISO 4217, value ile zorunlu |
event_idİsteğe bağlı | string | tarayıcı pikseliyle paylaşılan tekilleştirme anahtarı |
test_event_codeİsteğe bağlı | string | from Events Manager › Test Events; the event is only shown there |
urlİsteğe bağlı | string | olayın gerçekleştiği sayfa |
advertiser_idİsteğe bağlı | string | optional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.