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

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 kredi

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

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

ParametreTipAçı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_ALLbirincil durum filtresi, ör. STATUS_DELIVERY_OK, STATUS_DISABLE
advertiser_idİsteğe bağlıstringoptional: 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 kredi

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

ParametreTipAçıklama
campaign_idsİsteğe bağlıarray<string>—
adgroup_idsİsteğe bağlıarray<string>—
advertiser_idİsteğe bağlıstringoptional: 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 kredi

TikTok 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ı.

ParametreTipAçı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ıstringoptional: 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 kredi

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

ParametreTipAçı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ıbooleangü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ıstringoptional: 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 kredi

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

ParametreTipAçıklama
advertiser_idİsteğe bağlıstringoptional: 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 kredi

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

ParametreTipAçı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ıstringoptional: 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 kredi

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

ParametreTipAçıklama
video_idZorunlustring—
countİsteğe bağlıinteger (1–10)—
advertiser_idİsteğe bağlıstringoptional: 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 kredi

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

ParametreTipAçıklama
typeZorunluinterest | behavior | interest_keyword | location | region—
queryZorunlustringaranacak ad, ör. fashion, moda, Istanbul, Turkey
languageİsteğe bağlıstringinterest/behavior/interest_keyword için ad dili, ör. tr, en (varsayılan: sohbet dili)
objective_typeİsteğe bağlıstringlocation/region için: kampanya hedefi, varsayılan TRAFFIC; WhatsApp reklamları için LEAD_GENERATION
promotion_typeİsteğe bağlıstringlocation/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ıstringoptional: 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 kredi

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

ParametreTipAçıklama
identity_typeİsteğe bağlıCUSTOMIZED_USER | AUTH_CODE | TT_USER | BC_AUTH_TT—
identity_bc_idİsteğe bağlıstringBC_AUTH_TT ile zorunlu
advertiser_idİsteğe bağlıstringoptional: 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 kredi

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

ParametreTipAçıklama
advertiser_idİsteğe bağlıstringoptional: 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 kredi

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

ParametreTipAçıklama
advertiser_idİsteğe bağlıstringoptional: 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 kredi

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

ParametreTipAçıklama
advertiser_idİsteğe bağlıstringoptional: 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 kredi

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

ParametreTipAçıklama
page_idZorunlustringlist_tiktok_lead_forms'tan anında form id'si
advertiser_idİsteğe bağlıstringoptional: 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 kredi

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

ParametreTipAçıklama
page_idİsteğe bağlıstringlist_tiktok_lead_forms'tan anında form id'si (ya da ad_id verin)
ad_idİsteğe bağlıstringpotansiyel müşteri reklamının id'si; form yerine o reklamın lead'lerini indirir
task_idİsteğe bağlıstringhâlâ RUNNING olan önceki bir çağrının döndürdüğü görev id'si
regionİsteğe bağlıeu | us | otherreklamları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ıstringoptional: 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 kredi

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

ParametreTipAçıklama
advertiser_idİsteğe bağlıstringoptional: 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 kredi

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

ParametreTipAçıklama
advertiser_idİsteğe bağlıstringoptional: 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 kredi

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

ParametreTipAçıklama
levelİsteğe bağlıcampaign | adgroup | advarsayılan campaign
advertiser_idİsteğe bağlıstringoptional: 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 kredi

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

ParametreTipAçıklama
identity_idZorunlustring—
identity_typeİsteğe bağlıTT_USER | BC_AUTH_TT | AUTH_CODEvarsayılan TT_USER
identity_bc_idİsteğe bağlıstringBC_AUTH_TT ile zorunlu
limitİsteğe bağlıinteger (1–100)varsayılan 20
advertiser_idİsteğe bağlıstringoptional: 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 kredi

TikTok'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.

ParametreTipAçı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ıstringoptional: 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 kredi

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

ParametreTipAçıklama
metricsZorunluarray<string>TikTok metrik adları, ör. spend, impressions, clicks, conversion, complete_payment_roas
dimensionsZorunluarray<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ıbooleantarih 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ıstringoptional: 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 kredi

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

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

ParametreTipAçıklama
bc_idİsteğe bağlıstringBusiness Center id'si (list_tiktok_business_centers); token tek bir Business Center'a erişiyorsa isteğe bağlı

list_tiktok_bc_pixels

Okuma1 kredi

Bir TikTok Business Center'da tutulan pikseller (bc/asset/get, PIXEL), reklam hesaplarının genelinde. Salt okunur.

ParametreTipAçıklama
bc_idİsteğe bağlıstringBusiness Center id'si (list_tiktok_business_centers); token tek bir Business Center'a erişiyorsa isteğe bağlı

list_tiktok_asset_groups

Okuma1 kredi

Bir TikTok Business Center'ın varlık grupları (bc/asset_group/list): asset_group_id ve ad. Salt okunur.

ParametreTipAçıklama
bc_idİsteğe bağlıstringBusiness Center id'si (list_tiktok_business_centers); token tek bir Business Center'a erişiyorsa isteğe bağlı

tiktok_advertiser_qualification

Okuma1 kredi

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

ParametreTipAçıklama
bc_idİsteğe bağlıstringBusiness 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ıstringyalnızca bu reklam hesabına ait yeterlilikleri tut
verifiedİsteğe bağlıbooleandoğrulanmış / doğrulanmamış olarak filtrele

tiktok_change_history

Okuma2 kredi

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

ParametreTipAçıklama
bc_idİsteğe bağlıstringBusiness 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ıstringYYYY-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ıstringALL (varsayılan) | USER | ASSET | … TikTok'un tanımladığı şekilde
limitİsteğe bağlıinteger (1–500)—
advertiser_idİsteğe bağlıstringoptional: 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 kredi

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

ParametreTipAçıklama
advertiser_idZorunlustring—

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

upload_tiktok_video

Yazma2 kredi

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

ParametreTipAçıklama
video_urlZorunlustringmp4/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ıstring1-100 karakter, hesapta benzersiz; varsayılan: URL dosya adı + zaman damgası
auto_fixİsteğe bağlıbooleandüşük çözünürlüğü / yanlış en-boy oranını TikTok tespit edip düzeltsin
advertiser_idİsteğe bağlıstringoptional: 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 kredi

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

ParametreTipAçıklama
image_urlZorunlustringJPG/PNG dosyasının herkese açık http(s) URL'si (en fazla 1440x2560 toplam piksel)
file_nameİsteğe bağlıstring1-100 karakter, hesapta benzersiz; varsayılan: URL dosya adı + zaman damgası
advertiser_idİsteğe bağlıstringoptional: 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 kredi

Uç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.

ParametreTipAçıklama
nameZorunlustring—
objective_typeZorunluTRAFFIC | WEB_CONVERSIONS | REACH | VIDEO_VIEWS | LEAD_GENERATION | APP_PROMOTION | PRODUCT_SALES—
daily_budgetİsteğe bağlınumberhesap 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_SHOPPRODUCT_SALES campaigns only
audienceİsteğe bağlıobjectcountries (ISO listesi), age_min, age_max, genders ([1]=erkek, [2]=kadın), tiktok_location_ids, tiktok_interest_ids
ad_groupİsteğe bağlıobjectisteğe bağlı reklam grubu ayarları; varsayılanlar: otomatik yerleşim, şu andan itibaren, dengeli hız
adİsteğe bağlıobjectisteğe bağlı reklam; kitaplıktan bir video_id gerekir
advertiser_idİsteğe bağlıstringoptional: 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 kredi

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

ParametreTipAçıklama
campaign_idZorunlustringTikTok campaign_id
nameZorunlustring—
budgetZorunlunumbergü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ıstringWEBSITE | APP_ANDROID | APP_IOS | LEAD_GENERATION
app_idİsteğe bağlıstringapp promotion only
identity_idİsteğe bağlıstring—
identity_typeİsteğe bağlıstringCUSTOMIZED_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ıstringCLICK | CONVERT | REACH | VIDEO_VIEW | LEAD | ENGAGEMENT
billing_eventİsteğe bağlıstringCPC | CPM | OCPM | CPV
bid_typeİsteğe bağlıstringBID_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ıstringYYYY-MM-DD HH:MM:SS (UTC)
schedule_end_timeİsteğe bağlıstringYYYY-MM-DD HH:MM:SS (UTC); SCHEDULE_START_END ayarlar
daypartingİsteğe bağlıstring336 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ıstringe.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ıintegermax impressions per user within frequency_schedule days
frequency_scheduleİsteğe bağlıintegerfrequency cap window in days
brand_safety_typeİsteğe bağlıstringNO_BRAND_SAFETY | STANDARD_INVENTORY | LIMITED_INVENTORY | EXPANDED_INVENTORY
blocked_pangle_app_idsİsteğe bağlıarray<string>—
targeting_expansionİsteğe bağlıobjecte.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ıstringoptional: 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 kredi

Bir reklam grubunda kitaplık videosundan (ya da Spark gönderisinden) TikTok reklamı oluşturur. Önce önizleme ve onay.

ParametreTipAçıklama
adgroup_idZorunlustring—
ad_nameİsteğe bağlıstring—
ad_textZorunlustring1-100 karakter
video_idİsteğe bağlıstringlist_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ıstringLEARN_MORE | SHOP_NOW | SIGN_UP | CONTACT_US | DOWNLOAD …
identity_idİsteğe bağlıstring—
identity_typeİsteğe bağlıstringCUSTOMIZED_USER | TT_USER | BC_AUTH_TT
display_nameİsteğe bağlıstring—
tiktok_item_idİsteğe bağlıstringSpark Ads gönderi id'si
deeplinkİsteğe bağlıstring—
auto_message_idİsteğe bağlıstringwelcome message for Direct Message ads (list_tiktok_auto_messages / create_tiktok_auto_message)
identity_bc_idİsteğe bağlıstringBusiness Center id when identity_type is BC_AUTH_TT
operation_statusİsteğe bağlıENABLE | DISABLEDISABLE creates the ad paused; default ENABLE
advertiser_idİsteğe bağlıstringoptional: 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 kredi

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

ParametreTipAçıklama
campaign_idsZorunluarray<string>TikTok kampanya id'leri (ya da bir Tecrube kampanya id'si)
amountZorunlunumberhesap para birimi
campaign_idİsteğe bağlıstringAlias of campaign_ids (single id)
currencyİsteğe bağlıstringoptional ISO check; must equal the ad account currency
advertiser_idİsteğe bağlıstringoptional: 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 kredi

TikTok kampanyalarını duraklatır (DISABLE) ya da etkinleştirir (ENABLE). Önce önizleme ve onay.

ParametreTipAçıklama
campaign_idsZorunluarray<string>—
operation_statusZorunluENABLE | DISABLE | DELETEDELETE is permanent; only when the user explicitly asked
campaign_idİsteğe bağlıstringAlias of campaign_ids (single id)
advertiser_idİsteğe bağlıstringoptional: 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 kredi

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

ParametreTipAçıklama
adgroup_idsZorunluarray<string>—
adgroup_nameİsteğe bağlıstring—
budgetİsteğe bağlınumber—
optimization_goalİsteğe bağlıstringCLICK | CONVERT | REACH | VIDEO_VIEW | LEAD | ENGAGEMENT
billing_eventİsteğe bağlıstringCPC | CPM | OCPM | CPV
bid_typeİsteğe bağlıstringBID_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ıstringYYYY-MM-DD HH:MM:SS (UTC)
schedule_end_timeİsteğe bağlıstringYYYY-MM-DD HH:MM:SS (UTC); SCHEDULE_START_END ayarlar
daypartingİsteğe bağlıstring336 karakter 0/1: Pazartesi 00:00'dan başlayan 7 gün x 48 yarım saat
pixel_idİsteğe bağlıstringFixed 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ıstringe.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ıintegermax impressions per user within frequency_schedule days
frequency_scheduleİsteğe bağlıintegerfrequency cap window in days
brand_safety_typeİsteğe bağlıstringNO_BRAND_SAFETY | STANDARD_INVENTORY | LIMITED_INVENTORY | EXPANDED_INVENTORY
blocked_pangle_app_idsİsteğe bağlıarray<string>—
targeting_expansionİsteğe bağlıobjecte.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ıobjectadgroup/update alanlarının herhangi biri, sözlük olarak
adgroup_idİsteğe bağlıstringAlias 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ıstringNot changeable after creation (TikTok rule); rejected with an explanation
budget_modeİsteğe bağlıstringNot changeable after creation (TikTok rule); rejected with an explanation
advertiser_idİsteğe bağlıstringoptional: 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 kredi

TikTok reklam gruplarını duraklatır ya da etkinleştirir (ör. CPA'sı hedefin üstünde olanlar). Önce önizleme ve onay.

ParametreTipAçıklama
adgroup_idsZorunluarray<string>—
operation_statusZorunluENABLE | DISABLE | DELETEDELETE is permanent; only when the user explicitly asked
reasonİsteğe bağlıstring—
adgroup_idİsteğe bağlıstringAlias of adgroup_ids (single id)
advertiser_idİsteğe bağlıstringoptional: 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 kredi

TikTok reklamlarını duraklatır ya da etkinleştirir (ör. yorulmuş bir kreatif). Önce önizleme ve onay.

ParametreTipAçıklama
ad_idsZorunluarray<string>—
operation_statusZorunluENABLE | DISABLE | DELETEDELETE is permanent; only when the user explicitly asked
reasonİsteğe bağlıstring—
ad_idİsteğe bağlıstringAlias of ad_ids (single id)
advertiser_idİsteğe bağlıstringoptional: 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 kredi

Piksel, 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.

ParametreTipAçıklama
nameZorunlustring—
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ıstringdahil edilecek piksel/uygulama olayı, ör. AddToCart, CompletePayment, ViewContent
exclude_eventİsteğe bağlıstringhariç 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ıstringoptional: 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 kredi

TikTok özel ya da benzer kitlelerini kalıcı olarak siler. Kullanıcı istediğinde uygulanır, geri alınamaz.

ParametreTipAçıklama
audience_idsZorunluarray<string>ids from list_tiktok_audiences
advertiser_idİsteğe bağlıstringoptional: 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 kredi

Bir özel kitleden TikTok benzer kitlesi oluşturur (TikTok boyutları: NARROW ≈ en yakın, BALANCED, BROAD). Önce önizleme ve onay.

ParametreTipAçıklama
nameZorunlustring—
source_audience_idZorunlustring—
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ıstringoptional: 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 kredi

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

ParametreTipAçıklama
nameZorunlustring—
phone_numberZorunlustringülke koduyla WhatsApp işletme numarası, ör. +90 532 000 00 00 (0 ile başlayan ulusal biçim reddedilir)
daily_budgetZorunlunumberreklam grubu günlük bütçesi, hesap para birimi (TikTok minimumu ≈ 20 USD karşılığı)
video_idZorunlustringkitaplık videosu (list_tiktok_videos / upload_tiktok_video)
ad_textZorunlustring1-100 karakter
connection_methodİsteğe bağlıchat_link | nativechat_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ıstringyalnı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ıstringyalnızca native, ülke kodu paylaşımlıysa (ör. +1 için US)
message_event_set_idİsteğe bağlıstringyalnı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ıstringvarsayı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ıstringCUSTOMIZED_USER | TT_USER | BC_AUTH_TT
display_nameİsteğe bağlıstring—
goalİsteğe bağlıstring—
audienceİsteğe bağlıobjectcountries (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ıobjectisteğ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ıstringKABUL EDİLMEZ: mesajlaşma reklam grubunun web sitesi hedefi yoktur; bunun yerine phone_number verin
website_urlİsteğe bağlıstringNOT accepted (same rule as landing_page_url); rejected with an explanation
advertiser_idİsteğe bağlıstringoptional: 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 kredi

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

ParametreTipAçıklama
campaign_idZorunlustringTikTok campaign_id ya da Tecrübe kampanya id'si
nameZorunlustring—
advertiser_idİsteğe bağlıstringoptional: 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 kredi

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

ParametreTipAçıklama
ad_idZorunlustring—
adgroup_idİsteğe bağlıstringisteğe bağlı; verilmezse reklamdan okunur
ad_nameİsteğe bağlıstring—
ad_textİsteğe bağlıstring1-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ıstringoptional: 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 kredi

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

ParametreTipAçıklama
titleZorunlustringşablon adı
contentZorunlustringselamlama
suggested_questionsZorunluarray<object>—
advertiser_idİsteğe bağlıstringoptional: 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.

ParametreTipAçıklama
display_nameZorunlustring—
image_uriİsteğe bağlıstringupload_tiktok_image'dan kare bir avatarın image_id'si
advertiser_idİsteğe bağlıstringoptional: 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 kredi

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

ParametreTipAçıklama
nameZorunlustring—
advertiser_idİsteğe bağlıstringoptional: 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 kredi

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

ParametreTipAçıklama
nameZorunlustring—
identifiersZorunluarray<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 | AAIDvarsayılan EMAIL
retention_daysİsteğe bağlıinteger (1–365)—
advertiser_idİsteğe bağlıstringoptional: 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 kredi

TikTok ö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.

ParametreTipAçıklama
audience_idsZorunluarray<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ıstringoptional: 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 kredi

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

ParametreTipAçıklama
object_typeZorunluCAMPAIGN | ADGROUP—
object_idZorunlustring—
operationİsteğe bağlılist | add | deletevarsayı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_WORDadd için; varsayılan BROAD_WORD
advertiser_idİsteğe bağlıstringoptional: 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 kredi

TikTok'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.

ParametreTipAçıklama
pixel_codeZorunlustringlist_tiktok_pixels çıktısından
event_nameZorunlustringstandart 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ıstringaçılış URL'sindeki TikTok tıklama id'si
valueİsteğe bağlınumber—
currencyİsteğe bağlıstringISO 4217, value ile zorunlu
event_idİsteğe bağlıstringtarayıcı pikseliyle paylaşılan tekilleştirme anahtarı
test_event_codeİsteğe bağlıstringfrom Events Manager › Test Events; the event is only shown there
urlİsteğe bağlıstringolayın gerçekleştiği sayfa
advertiser_idİsteğe bağlıstringoptional: 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.