Tecrübetecrube.com
Referencia de herramientas — Anuncios

TikTok Ads tools

Campaign, ad group and ad management, video/image upload, audiences and performance reports.

Los nombres y descripciones se generan directamente desde el código del servidor; las descripciones son el texto original en inglés que ve el asistente.

Herramientas de lectura9 herramientas

list_tiktok_advertisers

Lectura1 créditos

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

Esta herramienta no recibe parámetros.

list_tiktok_campaigns

Lectura1 créditos

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

ParámetroTipoDescripción
campaign_idsOpcionalarray<string>—
statusOpcionalstringprimary status filter, e.g. STATUS_DELIVERY_OK, STATUS_DISABLE

list_tiktok_ad_groups

Lectura1 créditos

TikTok ad groups with budget, bid, optimisation goal, targeting (locations, ages, gender, languages, interests, audiences), placements, schedule and dayparting.

ParámetroTipoDescripción
campaign_idsOpcionalarray<string>—
adgroup_idsOpcionalarray<string>—

list_tiktok_ads

Lectura1 créditos

TikTok ads: ad_id, name, ad group, status, format, text, video_id, landing page, call to action.

ParámetroTipoDescripción
campaign_idsOpcionalarray<string>—
adgroup_idsOpcionalarray<string>—
ad_idsOpcionalarray<string>—

tiktok_performance_report

Lectura2 créditos

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

ParámetroTipoDescripción
levelOpcionalcampaign | ad_group | ad—
daysOpcionalinteger (1–365)—
start_dateOpcionalstring—
end_dateOpcionalstring—
dailyOpcionalbooleanone row per day (stat_time_day)
campaign_idsOpcionalarray<string>—
adgroup_idsOpcionalarray<string>—
ad_idsOpcionalarray<string>—

list_tiktok_audiences

Lectura1 créditos

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

Esta herramienta no recibe parámetros.

list_tiktok_videos

Lectura1 créditos

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

ParámetroTipoDescripción
video_idsOpcionalarray<string>—

get_tiktok_video_cover

Lectura1 créditos

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

ParámetroTipoDescripción
video_idObligatoriostring—
countOpcionalinteger (1–10)—

search_tiktok_targeting

Lectura1 créditos

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

ParámetroTipoDescripción
typeObligatoriointerest | behavior | interest_keyword | location | region—
queryObligatoriostringname to look up, e.g. fashion, moda, Istanbul, Turkey
languageOpcionalstringnames language for interest/behavior/interest_keyword, e.g. tr, en (default: conversation language)
objective_typeOpcionalstringfor location/region: campaign objective, default TRAFFIC; LEAD_GENERATION for WhatsApp ads
promotion_typeOpcionalstringfor location/region; default WEBSITE, or LEAD_GEN_CLICK_TO_SOCIAL_MEDIA_APP_MESSAGE with LEAD_GENERATION
placementsOpcionalarray<string>default PLACEMENT_TIKTOK
region_codesOpcionalarray<string>location: filter by country code, e.g. TR
geo_typesOpcionalarray<string>location: COUNTRY | PROVINCE | CITY | DISTRICT | DMA | ZIP_CODE
limitOpcionalinteger (1–100)—

Herramientas de escritura13 herramientas

upload_tiktok_video

Escritura2 créditos

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

ParámetroTipoDescripción
video_urlObligatoriostringpublic http(s) URL of an mp4/mov/mpeg/avi file (ideally under 10 MB for URL uploads)
file_nameOpcionalstring1-100 chars, unique in the account; default: URL file name + timestamp
auto_fixOpcionalbooleanlet TikTok detect and fix low resolution / wrong aspect ratio

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

upload_tiktok_image

Escritura2 créditos

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

ParámetroTipoDescripción
image_urlObligatoriostringpublic http(s) URL of a JPG/PNG (max 1440x2560 total pixels)
file_nameOpcionalstring1-100 chars, unique in the account; default: URL file name + timestamp

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

create_tiktok_campaign

Escritura2 créditos

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

ParámetroTipoDescripción
nameObligatoriostring—
objective_typeObligatorioTRAFFIC | WEB_CONVERSIONS | REACH | VIDEO_VIEWS | LEAD_GENERATION | APP_PROMOTION | PRODUCT_SALES—
daily_budgetOpcionalnumberaccount currency
budget_modeOpcionalBUDGET_MODE_DAY | BUDGET_MODE_TOTAL | BUDGET_MODE_INFINITE—
goalOpcionalstring—
pixel_idOpcionalstring—
audienceOpcionalobjectcountries (ISO list), age_min, age_max, genders ([1]=male, [2]=female), tiktok_location_ids, tiktok_interest_ids
ad_groupOpcionalobjectoptional ad group overrides; defaults: automatic placement, from now, smooth pacing
adOpcionalobjectoptional ad; needs a library video_id

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

create_tiktok_ad_group

Escritura2 créditos

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

ParámetroTipoDescripción
campaign_idObligatoriostringTikTok campaign_id
nameObligatoriostring—
budgetObligatorionumberdaily budget, account currency
budget_modeOpcionalBUDGET_MODE_DAY | BUDGET_MODE_TOTAL—
placement_typeOpcionalPLACEMENT_TYPE_AUTOMATIC | PLACEMENT_TYPE_NORMAL—
placementsOpcionalarray<string>PLACEMENT_TIKTOK | PLACEMENT_PANGLE | PLACEMENT_GLOBAL_APP_BUNDLE
promotion_typeOpcionalstringWEBSITE | APP_ANDROID | APP_IOS | LEAD_GENERATION
operation_statusOpcionalENABLE | DISABLE—
optimization_goalOpcionalstringCLICK | CONVERT | REACH | VIDEO_VIEW | LEAD | ENGAGEMENT
billing_eventOpcionalstringCPC | CPM | OCPM | CPV
bid_typeOpcionalstringBID_TYPE_NO_BID | BID_TYPE_CUSTOM
bid_priceOpcionalnumber—
conversion_bid_priceOpcionalnumber—
pacingOpcionalPACING_MODE_SMOOTH | PACING_MODE_FAST—
location_idsOpcionalarray<string>TikTok location ids (Turkey 298795, US 6252001, UK 2635167, DE 2921044)
age_groupsOpcionalarray<string>AGE_13_17 | AGE_18_24 | AGE_25_34 | AGE_35_44 | AGE_45_54 | AGE_55_100
genderOpcionalGENDER_UNLIMITED | GENDER_MALE | GENDER_FEMALE—
languagesOpcionalarray<string>language codes, e.g. tr, en
interest_category_idsOpcionalarray<string>—
operating_systemsOpcionalarray<string>ANDROID | IOS
audience_idsOpcionalarray<string>—
excluded_audience_idsOpcionalarray<string>—
schedule_start_timeOpcionalstringYYYY-MM-DD HH:MM:SS (UTC)
schedule_end_timeOpcionalstringYYYY-MM-DD HH:MM:SS (UTC); sets SCHEDULE_START_END
daypartingOpcionalstring336 chars of 0/1: 7 days x 48 half-hours starting Monday 00:00
pixel_idOpcionalstring—
optimization_eventOpcionalstringe.g. COMPLETE_PAYMENT, ON_WEB_CART, FORM
comment_disabledOpcionalboolean—
share_disabledOpcionalboolean—
search_result_enabledOpcionalboolean—
interest_keyword_idsOpcionalarray<string>from search_tiktok_targeting(type=interest_keyword)
actionsOpcionalarray<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)]}]

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

create_tiktok_ad

Escritura2 créditos

Create a TikTok ad in an ad group from a library video (or Spark post). Preview and approval first.

ParámetroTipoDescripción
adgroup_idObligatoriostring—
ad_nameOpcionalstring—
ad_textObligatoriostring1-100 chars
video_idOpcionalstringfrom list_tiktok_videos
image_idsOpcionalarray<string>cover image ids / image ad
ad_formatOpcionalSINGLE_VIDEO | SINGLE_IMAGE | CAROUSEL—
landing_page_urlOpcionalstring—
call_to_actionOpcionalstringLEARN_MORE | SHOP_NOW | SIGN_UP | CONTACT_US | DOWNLOAD …
identity_idOpcionalstring—
identity_typeOpcionalstringCUSTOMIZED_USER | TT_USER | BC_AUTH_TT
display_nameOpcionalstring—
tiktok_item_idOpcionalstringSpark Ads post id
deeplinkOpcionalstring—

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

update_tiktok_campaign_budget

Escritura2 créditos

Change the budget of one or more TikTok campaigns. Goes through preview and approval; the ledger is updated only when TikTok accepts.

ParámetroTipoDescripción
campaign_idsObligatorioarray<string>TikTok campaign ids (or one Tecrube campaign id)
amountObligatorionumberaccount currency

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

update_tiktok_campaign_status

Escritura2 créditos

Pause (DISABLE) or enable (ENABLE) TikTok campaigns. Preview and approval first.

ParámetroTipoDescripción
campaign_idsObligatorioarray<string>—
operation_statusObligatorioENABLE | DISABLE—

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

update_tiktok_ad_group

Escritura2 créditos

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

ParámetroTipoDescripción
adgroup_idsObligatorioarray<string>—
adgroup_nameOpcionalstring—
budgetOpcionalnumber—
optimization_goalOpcionalstringCLICK | CONVERT | REACH | VIDEO_VIEW | LEAD | ENGAGEMENT
billing_eventOpcionalstringCPC | CPM | OCPM | CPV
bid_typeOpcionalstringBID_TYPE_NO_BID | BID_TYPE_CUSTOM
bid_priceOpcionalnumber—
conversion_bid_priceOpcionalnumber—
pacingOpcionalPACING_MODE_SMOOTH | PACING_MODE_FAST—
location_idsOpcionalarray<string>TikTok location ids (Turkey 298795, US 6252001, UK 2635167, DE 2921044)
age_groupsOpcionalarray<string>AGE_13_17 | AGE_18_24 | AGE_25_34 | AGE_35_44 | AGE_45_54 | AGE_55_100
genderOpcionalGENDER_UNLIMITED | GENDER_MALE | GENDER_FEMALE—
languagesOpcionalarray<string>language codes, e.g. tr, en
interest_category_idsOpcionalarray<string>—
operating_systemsOpcionalarray<string>ANDROID | IOS
audience_idsOpcionalarray<string>—
excluded_audience_idsOpcionalarray<string>—
schedule_start_timeOpcionalstringYYYY-MM-DD HH:MM:SS (UTC)
schedule_end_timeOpcionalstringYYYY-MM-DD HH:MM:SS (UTC); sets SCHEDULE_START_END
daypartingOpcionalstring336 chars of 0/1: 7 days x 48 half-hours starting Monday 00:00
pixel_idOpcionalstring—
optimization_eventOpcionalstringe.g. COMPLETE_PAYMENT, ON_WEB_CART, FORM
comment_disabledOpcionalboolean—
share_disabledOpcionalboolean—
search_result_enabledOpcionalboolean—
interest_keyword_idsOpcionalarray<string>from search_tiktok_targeting(type=interest_keyword)
actionsOpcionalarray<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)]}]
changesOpcionalobjectany adgroup/update fields as a map

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

update_tiktok_ad_group_status

Escritura2 créditos

Pause or enable TikTok ad groups (e.g. the ones whose CPA is above target). Preview and approval first.

ParámetroTipoDescripción
adgroup_idsObligatorioarray<string>—
operation_statusObligatorioENABLE | DISABLE—
reasonOpcionalstring—

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

update_tiktok_ad_status

Escritura2 créditos

Pause or enable TikTok ads (e.g. a fatigued creative). Preview and approval first.

ParámetroTipoDescripción
ad_idsObligatorioarray<string>—
operation_statusObligatorioENABLE | DISABLE—
reasonOpcionalstring—

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

create_tiktok_custom_audience

Escritura2 créditos

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

ParámetroTipoDescripción
nameObligatoriostring—
audience_typeOpcionalPIXEL | APP | ENGAGEMENT | ENGAGEMENT_ORGANIC_VIDEO | BUSINESS_ACCOUNT | LEAD_GENERATION | TIKTOK_SHOP—
retention_daysOpcionalinteger (1–365)—
eventOpcionalstringpixel/app event to include, e.g. AddToCart, CompletePayment, ViewContent
exclude_eventOpcionalstringevent to exclude, e.g. CompletePayment for cart abandoners
pixel_idOpcionalstring—
event_source_idsOpcionalarray<string>pixel ids / app ids / ad group ids depending on audience_type

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

create_tiktok_lookalike_audience

Escritura2 créditos

Create a TikTok lookalike audience from a custom audience (TikTok sizes: NARROW ≈ closest, BALANCED, BROAD). Preview and approval first.

ParámetroTipoDescripción
nameObligatoriostring—
source_audience_idObligatoriostring—
audience_sizeOpcionalNARROW | BALANCED | BROAD—
include_sourceOpcionalboolean—
location_idsOpcionalarray<string>—
placementsOpcionalarray<string>—

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

create_tiktok_whatsapp_campaign

Escritura2 créditos

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

ParámetroTipoDescripción
nameObligatoriostring—
phone_numberObligatoriostringWhatsApp business number with country code, e.g. +90 532 000 00 00 (national format starting with 0 is rejected)
daily_budgetObligatorionumberad group daily budget, account currency (TikTok minimum ≈ USD 20 equivalent)
video_idObligatoriostringlibrary video (list_tiktok_videos / upload_tiktok_video)
ad_textObligatoriostring1-100 chars
connection_methodOpcionalchat_link | nativechat_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_messageOpcionalstringchat_link only: text pre-filled in WhatsApp; must name the offer or service in the ad, generic greetings are rejected
optimization_goalOpcionalCLICK | CONVERSATION—
phone_region_codeOpcionalstringnative only, when the calling code is shared (e.g. US for +1)
message_event_set_idOpcionalstringnative + CONVERSATION only, when the number matches no event set
image_idsOpcionalarray<string>cover image id; omitted = the video's own cover is fetched and uploaded automatically
call_to_actionOpcionalstringdefault SEND_MESSAGE (CALL_NOW not allowed)
ad_nameOpcionalstring—
identity_idOpcionalstring—
identity_typeOpcionalstringCUSTOMIZED_USER | TT_USER | BC_AUTH_TT
display_nameOpcionalstring—
goalOpcionalstring—
audienceOpcionalobjectcountries (ISO list), age_min (18+), age_max, genders ([1]=male, [2]=female), tiktok_location_ids, tiktok_interest_ids
ad_groupOpcionalobjectoptional ad group targeting/schedule overrides; placements, promotion type and search results are fixed for messaging ads
landing_page_urlOpcionalstringNOT accepted: a messaging ad group has no website destination; give phone_number instead

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.