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üğü özgün İngilizce metinlerdir.
Okuma araçları9 araç
list_tiktok_advertisers
Okuma1 krediTikTok ad accounts (advertisers) reachable with the connected TikTok Ads token: id, name, currency, timezone, status. Read only; returns connected=false when no account is linked.
Bu araç parametre almaz.
list_tiktok_campaigns
Okuma1 krediTikTok campaigns of the connected ad account: campaign_id, name, objective_type, budget, budget_mode, operation_status. Use campaign_id values for the other tiktok tools.
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idsİsteğe bağlı | array<string> | — |
statusİsteğe bağlı | string | primary status filter, e.g. STATUS_DELIVERY_OK, STATUS_DISABLE |
list_tiktok_ad_groups
Okuma1 krediTikTok ad groups with budget, bid, optimisation goal, targeting (locations, ages, gender, languages, interests, audiences), placements, schedule and dayparting.
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idsİsteğe bağlı | array<string> | — |
adgroup_idsİsteğe bağlı | array<string> | — |
list_tiktok_ads
Okuma1 krediTikTok ads: ad_id, name, ad group, status, format, text, video_id, landing page, call to action.
| 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> | — |
tiktok_performance_report
Okuma2 krediTikTok performance by campaign, ad group or ad for a date range: spend, impressions, clicks, CTR, CPM, CPC, conversions, cost per conversion, conversion rate, ROAS where available; optional daily breakdown and totals. Real data only; connected=false when no account.
| 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 | one row per day (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> | — |
list_tiktok_audiences
Okuma1 krediCustom and lookalike audiences of the TikTok ad account: audience_id, name, type, size (cover_num), validity. Use audience_ids in update_tiktok_ad_group to assign them.
Bu araç parametre almaz.
list_tiktok_videos
Okuma1 krediVideos in the TikTok ad account's asset library: video_id, file name, duration, size, preview and cover URLs. Use video_id in create_tiktok_ad or create_tiktok_whatsapp_campaign; add new videos from a public URL with upload_tiktok_video.
| Parametre | Tip | Açıklama |
|---|---|---|
video_idsİsteğe bağlı | array<string> | — |
get_tiktok_video_cover
Okuma1 krediSuggested cover frames for a TikTok library video (file/video/suggestcover): id, preview url (valid one hour), size. Upload the chosen url with upload_tiktok_image to use it as the ad cover (image_ids). Read only.
| Parametre | Tip | Açıklama |
|---|---|---|
video_idZorunlu | string | — |
countİsteğe bağlı | integer (1–10) | — |
search_tiktok_targeting
Okuma1 krediTurn targeting names into TikTok ids: 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, cities and provinces), region (tool/region → targetable countries for the objective). Read only.
| Parametre | Tip | Açıklama |
|---|---|---|
typeZorunlu | interest | behavior | interest_keyword | location | region | — |
queryZorunlu | string | name to look up, e.g. fashion, moda, Istanbul, Turkey |
languageİsteğe bağlı | string | names language for interest/behavior/interest_keyword, e.g. tr, en (default: conversation language) |
objective_typeİsteğe bağlı | string | for location/region: campaign objective, default TRAFFIC; LEAD_GENERATION for WhatsApp ads |
promotion_typeİsteğe bağlı | string | for location/region; default WEBSITE, or LEAD_GEN_CLICK_TO_SOCIAL_MEDIA_APP_MESSAGE with LEAD_GENERATION |
placementsİsteğe bağlı | array<string> | default PLACEMENT_TIKTOK |
region_codesİsteğe bağlı | array<string> | location: filter by country code, e.g. 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) | — |
Yazma araçları13 araç
upload_tiktok_video
Yazma2 krediUpload a video to the TikTok ad account's asset library from a public URL (file/video/ad/upload, UPLOAD_BY_URL). Preview and approval first; the new video_id is returned in the action result.
| Parametre | Tip | Açıklama |
|---|---|---|
video_urlZorunlu | string | public http(s) URL of an mp4/mov/mpeg/avi file (ideally under 10 MB for URL uploads) |
file_nameİsteğe bağlı | string | 1-100 chars, unique in the account; default: URL file name + timestamp |
auto_fixİsteğe bağlı | boolean | let TikTok detect and fix low resolution / wrong aspect ratio |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
upload_tiktok_image
Yazma2 krediUpload an image (image ad or video cover) to the TikTok asset library from a public URL (file/image/ad/upload, UPLOAD_BY_URL). Preview and approval first; the image_id is returned in the action result.
| Parametre | Tip | Açıklama |
|---|---|---|
image_urlZorunlu | string | public http(s) URL of a JPG/PNG (max 1440x2560 total pixels) |
file_nameİsteğe bağlı | string | 1-100 chars, unique in the account; default: URL file name + timestamp |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_tiktok_campaign
Yazma2 krediCreate a TikTok campaign end to end (campaign + ad group, optionally the ad) as a paused draft. Writes a ledger draft and opens an approval item with a preview; sent to TikTok only after approval and only with a connected account.
| 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 | account currency |
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 | — |
audienceİsteğe bağlı | object | countries (ISO list), age_min, age_max, genders ([1]=male, [2]=female), tiktok_location_ids, tiktok_interest_ids |
ad_groupİsteğe bağlı | object | optional ad group overrides; defaults: automatic placement, from now, smooth pacing |
adİsteğe bağlı | object | optional ad; needs a library video_id |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_tiktok_ad_group
Yazma2 krediCreate a TikTok ad group under a campaign with budget, bid, targeting, placements, schedule and dayparting. Preview and approval first; created paused unless operation_status=ENABLE.
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idZorunlu | string | TikTok campaign_id |
nameZorunlu | string | — |
budgetZorunlu | number | daily budget, account currency |
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 |
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 location ids (Turkey 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> | language codes, e.g. 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); sets SCHEDULE_START_END |
daypartingİsteğe bağlı | string | 336 chars of 0/1: 7 days x 48 half-hours starting Monday 00:00 |
pixel_idİsteğe bağlı | string | — |
optimization_eventİsteğe bağlı | string | e.g. 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> | from search_tiktok_targeting(type=interest_keyword) |
actionsİsteğe bağlı | array<object> | behaviour targeting: [{action_scene: VIDEO_RELATED|CREATOR_RELATED|HASHTAG_RELATED, action_period: 0|7|15, video_user_actions: [...], action_category_ids: [ids from search_tiktok_targeting(type=behavior)]}] |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_tiktok_ad
Yazma2 krediCreate a TikTok ad in an ad group from a library video (or Spark post). Preview and approval first.
| Parametre | Tip | Açıklama |
|---|---|---|
adgroup_idZorunlu | string | — |
ad_nameİsteğe bağlı | string | — |
ad_textZorunlu | string | 1-100 chars |
video_idİsteğe bağlı | string | from list_tiktok_videos |
image_idsİsteğe bağlı | array<string> | cover image ids / image ad |
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 post id |
deeplinkİsteğe bağlı | string | — |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
update_tiktok_campaign_budget
Yazma2 krediChange the budget of one or more TikTok campaigns. Goes through preview and approval; the ledger is updated only when TikTok accepts.
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idsZorunlu | array<string> | TikTok campaign ids (or one Tecrube campaign id) |
amountZorunlu | number | account currency |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
update_tiktok_campaign_status
Yazma2 krediPause (DISABLE) or enable (ENABLE) TikTok campaigns. Preview and approval first.
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idsZorunlu | array<string> | — |
operation_statusZorunlu | ENABLE | DISABLE | — |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
update_tiktok_ad_group
Yazma2 krediUpdate one or many TikTok ad groups at once: budget, bid (bid_type/bid_price), targeting (locations, ages, gender, languages, interests, audiences), schedule and dayparting, comment/share settings. Placements and budget mode cannot change after creation (TikTok rule). Preview and approval first.
| 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 location ids (Turkey 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> | language codes, e.g. 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); sets SCHEDULE_START_END |
daypartingİsteğe bağlı | string | 336 chars of 0/1: 7 days x 48 half-hours starting Monday 00:00 |
pixel_idİsteğe bağlı | string | — |
optimization_eventİsteğe bağlı | string | e.g. 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> | from search_tiktok_targeting(type=interest_keyword) |
actionsİsteğe bağlı | array<object> | behaviour targeting: [{action_scene: VIDEO_RELATED|CREATOR_RELATED|HASHTAG_RELATED, action_period: 0|7|15, video_user_actions: [...], action_category_ids: [ids from search_tiktok_targeting(type=behavior)]}] |
changesİsteğe bağlı | object | any adgroup/update fields as a map |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
update_tiktok_ad_group_status
Yazma2 krediPause or enable TikTok ad groups (e.g. the ones whose CPA is above target). Preview and approval first.
| Parametre | Tip | Açıklama |
|---|---|---|
adgroup_idsZorunlu | array<string> | — |
operation_statusZorunlu | ENABLE | DISABLE | — |
reasonİsteğe bağlı | string | — |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
update_tiktok_ad_status
Yazma2 krediPause or enable TikTok ads (e.g. a fatigued creative). Preview and approval first.
| Parametre | Tip | Açıklama |
|---|---|---|
ad_idsZorunlu | array<string> | — |
operation_statusZorunlu | ENABLE | DISABLE | — |
reasonİsteğe bağlı | string | — |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_tiktok_custom_audience
Yazma2 krediCreate a rule-based TikTok custom audience from pixel, app or engagement events (e.g. added to cart in the last 30 days but did not purchase). Preview and approval first; the audience needs hours to populate.
| 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 | pixel/app event to include, e.g. AddToCart, CompletePayment, ViewContent |
exclude_eventİsteğe bağlı | string | event to exclude, e.g. CompletePayment for cart abandoners |
pixel_idİsteğe bağlı | string | — |
event_source_idsİsteğe bağlı | array<string> | pixel ids / app ids / ad group ids depending on audience_type |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_tiktok_lookalike_audience
Yazma2 krediCreate a TikTok lookalike audience from a custom audience (TikTok sizes: NARROW ≈ closest, BALANCED, BROAD). Preview and approval first.
| 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> | — |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_tiktok_whatsapp_campaign
Yazma2 krediCreate a TikTok ad that opens a WhatsApp chat (click-to-WhatsApp): LEAD_GENERATION campaign, ad group with optimisation location Instant Messaging App (WhatsApp) on TikTok placement, and a video ad whose cover is taken from the video automatically. chat_link builds the wa.me link from the phone number; website URLs are refused. Everything is created paused; preview and approval first.
| Parametre | Tip | Açıklama |
|---|---|---|
nameZorunlu | string | — |
phone_numberZorunlu | string | WhatsApp business number with country code, e.g. +90 532 000 00 00 (national format starting with 0 is rejected) |
daily_budgetZorunlu | number | ad group daily budget, account currency (TikTok minimum ≈ USD 20 equivalent) |
video_idZorunlu | string | library video (list_tiktok_videos / upload_tiktok_video) |
ad_textZorunlu | string | 1-100 chars |
connection_methodİsteğe bağlı | chat_link | native | chat_link: wa.me link built from the number (CLICK only, no extra setup); native: number connected to TikTok's message management tool (CLICK or allowlisted CONVERSATION) |
prefilled_messageİsteğe bağlı | string | chat_link only: text pre-filled in WhatsApp; must name the offer or service in the ad, generic greetings are rejected |
optimization_goalİsteğe bağlı | CLICK | CONVERSATION | — |
phone_region_codeİsteğe bağlı | string | native only, when the calling code is shared (e.g. US for +1) |
message_event_set_idİsteğe bağlı | string | native + CONVERSATION only, when the number matches no event set |
image_idsİsteğe bağlı | array<string> | cover image id; omitted = the video's own cover is fetched and uploaded automatically |
call_to_actionİsteğe bağlı | string | default SEND_MESSAGE (CALL_NOW not allowed) |
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 list), age_min (18+), age_max, genders ([1]=male, [2]=female), tiktok_location_ids, tiktok_interest_ids |
ad_groupİsteğe bağlı | object | optional ad group targeting/schedule overrides; placements, promotion type and search results are fixed for messaging ads |
landing_page_urlİsteğe bağlı | string | NOT accepted: a messaging ad group has no website destination; give phone_number instead |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.