Saltar al contenido
Tecrübetecrube.com
Herramientas del asistente · Configuración y campañas

Herramientas de TikTok Ads

Gestión de campañas, grupos de anuncios y anuncios, subida de vídeo/imagen, públicos e informes de rendimiento.

Los nombres y descripciones se generan directamente desde el código del servidor; las descripciones son la traducción del texto que ve el asistente, los nombres de herramientas y parámetros no cambian.

Herramientas de lectura27 herramientas

list_tiktok_advertisers

Lectura1 créditos

Cuentas publicitarias de TikTok (advertisers) accesibles con el token de TikTok Ads conectado: id, nombre, moneda, zona horaria, estado. Solo lectura; devuelve connected=false si no hay cuenta vinculada.

Esta herramienta no recibe parámetros.

list_tiktok_campaigns

Lectura1 créditos

Campañas de TikTok de la cuenta publicitaria conectada: campaign_id, nombre, objective_type, presupuesto, budget_mode, operation_status (activada / desactivada) y secondary_status (estado de entrega de TikTok). Usa los valores de campaign_id en las demás herramientas tiktok.

ParámetroTipoDescripción
campaign_idsOpcionalarray<string>—
statusOpcionalSTATUS_DELIVERY_OK | STATUS_NOT_DELIVERY | STATUS_DISABLE | STATUS_DELETE | STATUS_NOT_DELETE | STATUS_ALLfiltro de estado principal, p. ej. STATUS_DELIVERY_OK, STATUS_DISABLE
advertiser_idOpcionalstringoptional: 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

Lectura1 créditos

Grupos de anuncios de TikTok con presupuesto, puja, objetivo de optimización, segmentación (ubicaciones, edades, género, idiomas, intereses, audiencias), ubicaciones de anuncio, calendario y franjas horarias.

ParámetroTipoDescripción
campaign_idsOpcionalarray<string>—
adgroup_idsOpcionalarray<string>—
advertiser_idOpcionalstringoptional: 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

Lectura1 créditos

Anuncios de TikTok: ad_id, nombre, grupo de anuncios, estado (operation_status, secondary_status), formato, texto, video_id, página de destino, llamada a la acción. Los anuncios que no superaron la revisión, o solo en parte, incluyen además review: el estado de revisión de TikTok, los motivos de rechazo y la sugerencia, y las ubicaciones, localizaciones y edades en las que están bloqueados.

ParámetroTipoDescripción
campaign_idsOpcionalarray<string>—
adgroup_idsOpcionalarray<string>—
ad_idsOpcionalarray<string>—
advertiser_idOpcionalstringoptional: 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

Lectura2 créditos

Rendimiento de TikTok por campaña, grupo de anuncios o anuncio para un rango de fechas: gasto, impresiones, clics, CTR, CPM, CPC, conversiones, coste por conversión, tasa de conversión, ROAS cuando esté disponible; desglose diario y totales opcionales. Solo datos reales; connected=false si no hay cuenta.

ParámetroTipoDescripción
levelOpcionalcampaign | ad_group | ad—
daysOpcionalinteger (1–365)—
start_dateOpcionalstring—
end_dateOpcionalstring—
dailyOpcionalbooleanuna fila por día (stat_time_day)
campaign_idsOpcionalarray<string>—
adgroup_idsOpcionalarray<string>—
ad_idsOpcionalarray<string>—
advertiser_idOpcionalstringoptional: 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

Lectura1 créditos

Audiencias personalizadas y similares de la cuenta publicitaria de TikTok: audience_id, nombre, tipo, tamaño (cover_num), validez. Usa audience_ids en update_tiktok_ad_group para asignarlas.

ParámetroTipoDescripción
advertiser_idOpcionalstringoptional: 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

Lectura1 créditos

Vídeos de la biblioteca de recursos de la cuenta publicitaria de TikTok: video_id, nombre de archivo, duración, tamaño, URL de vista previa y portada. Usa video_id en create_tiktok_ad o create_tiktok_whatsapp_campaign; añade vídeos nuevos desde una URL pública con upload_tiktok_video.

ParámetroTipoDescripción
video_idsOpcionalarray<string>—
limitOpcionalinteger (1–500)newest first (default 500)
advertiser_idOpcionalstringoptional: 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

Lectura1 créditos

Fotogramas de portada sugeridos para un vídeo de la biblioteca de TikTok (file/video/suggestcover): id, url de vista previa (válida una hora), tamaño. Sube la url elegida con upload_tiktok_image para usarla como portada del anuncio (image_ids). Solo lectura.

ParámetroTipoDescripción
video_idObligatoriostring—
countOpcionalinteger (1–10)—
advertiser_idOpcionalstringoptional: 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

Lectura1 créditos

Convierte nombres de segmentación en ids de TikTok: 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, ciudades y provincias), region (tool/region → países segmentables para el objetivo). Solo lectura.

ParámetroTipoDescripción
typeObligatoriointerest | behavior | interest_keyword | location | region—
queryObligatoriostringnombre a buscar, p. ej. fashion, moda, Istanbul, Turkey
languageOpcionalstringidioma de los nombres para interest/behavior/interest_keyword, p. ej. tr, en (por defecto: idioma de la conversación)
objective_typeOpcionalstringpara location/region: objetivo de campaña, por defecto TRAFFIC; LEAD_GENERATION para anuncios de WhatsApp
promotion_typeOpcionalstringpara location/region; por defecto WEBSITE, o LEAD_GEN_CLICK_TO_SOCIAL_MEDIA_APP_MESSAGE con LEAD_GENERATION
placementsOpcionalarray<string>por defecto PLACEMENT_TIKTOK
region_codesOpcionalarray<string>location: filtrar por código de país, p. ej. TR
geo_typesOpcionalarray<string>location: COUNTRY | PROVINCE | CITY | DISTRICT | DMA | ZIP_CODE
limitOpcionalinteger (1–100)—
advertiser_idOpcionalstringoptional: 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

Lectura1 créditos

Identidades publicitarias de la cuenta de TikTok (identity/get): identity_id, identity_type, nombre visible, nombre de usuario y si se pueden obtener publicaciones. Pasa identity_id/identity_type a create_tiktok_ad o list_tiktok_posts. Solo lectura.

ParámetroTipoDescripción
identity_typeOpcionalCUSTOMIZED_USER | AUTH_CODE | TT_USER | BC_AUTH_TT—
identity_bc_idOpcionalstringobligatorio con BC_AUTH_TT
advertiser_idOpcionalstringoptional: 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

Lectura1 créditos

Píxeles de conversión de TikTok de la cuenta publicitaria (pixel/list): pixel_id, pixel_code, nombre, modo de configuración y eventos registrados. Usa pixel_id para grupos de anuncios de conversión y pixel_code para send_tiktok_conversion_event. Solo lectura.

ParámetroTipoDescripción
advertiser_idOpcionalstringoptional: 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

Lectura1 créditos

Plantillas de mensajes de bienvenida para anuncios de Mensaje directo de TikTok (creative/auto_message/get): auto_message_id, título, saludo, preguntas sugeridas y estado de revisión. Pasa auto_message_id a create_tiktok_ad. Solo lectura.

ParámetroTipoDescripción
advertiser_idOpcionalstringoptional: 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

Lectura1 créditos

Formularios instantáneos de clientes potenciales de TikTok de la cuenta publicitaria (page/get, LEAD_GEN): page_id, título, estado, fecha de creación/actualización/publicación y URL de vista previa. Solo lectura.

ParámetroTipoDescripción
advertiser_idOpcionalstringoptional: 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

Lectura1 créditos

Campos de preguntas de un formulario instantáneo de clientes potenciales de TikTok (page/field/get): claves, etiquetas y tipos de campo, además de los metadatos del formulario, para leer bien las respuestas recogidas. Solo lectura.

ParámetroTipoDescripción
page_idObligatoriostringid del formulario instantáneo de list_tiktok_lead_forms
advertiser_idOpcionalstringoptional: 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

Lectura2 créditos

Descarga los clientes potenciales recogidos por un formulario instantáneo o un anuncio de clientes potenciales de TikTok (page/lead/task + page/lead/task/download; si llega un ZIP se extrae su CSV). Abre la tarea de descarga, la consulta durante unos segundos y, cuando está lista, devuelve un resumen que protege la privacidad: total de filas, nombres de las preguntas y las primeras filas (limit, por defecto 20) con id del cliente potencial, fecha de creación, ids de anuncio, grupo de anuncios, campaña y formulario, y respuestas ENMASCARADAS (nombres reducidos a iniciales; correos, teléfonos e IBAN enmascarados). El CSV completo sin enmascarar se guarda en el área privada de archivos de la cuenta y solo se devuelve como download_url, un enlace firmado válido 15 minutos (el archivo guardado se conserva 30 días y después se borra): da el enlace al usuario y nunca pegues el contenido del archivo en el chat; si el archivo no se puede guardar, solo se devuelve el resumen enmascarado. Si TikTok aún prepara el archivo, devuelve task_id: vuelve a llamar con el mismo page_id/ad_id y ese task_id. region: dónde se publicaron los anuncios (eu = EEE/Suiza/Reino Unido, us, other). Solo los administradores de la cuenta publicitaria pueden descargar. Datos personales: úsalos solo dentro del consentimiento dado en el formulario. Solo lectura.

ParámetroTipoDescripción
page_idOpcionalstringid del formulario instantáneo de list_tiktok_lead_forms (o indica ad_id)
ad_idOpcionalstringid del anuncio de clientes potenciales; descarga los clientes potenciales de ese anuncio en lugar de un formulario
task_idOpcionalstringid de tarea devuelto por una llamada anterior que seguía en RUNNING
regionOpcionaleu | us | otherdónde se segmentaron los anuncios: eu = EEE/Suiza/Reino Unido, us = Estados Unidos, other (por defecto) = el resto
limitOpcionalinteger (1–100)filas de la vista previa enmascarada (por defecto 20); la lista completa solo está en el archivo de descarga
advertiser_idOpcionalstringoptional: 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

Lectura1 créditos

Portafolios de creatividades de la cuenta publicitaria de TikTok (creative/portfolio/list): id del portafolio, tipo (tarjeta de visualización, tarjeta de descarga, código regalo…), URL de vista previa y ajustes principales. Solo lectura.

ParámetroTipoDescripción
advertiser_idOpcionalstringoptional: 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

Lectura1 créditos

Tiendas de TikTok Shop vinculadas a la cuenta publicitaria (gmv_max/store/list) con disponibilidad de GMV Max, estado, rol, Business Center que autoriza y regiones segmentables. Solo lectura.

ParámetroTipoDescripción
advertiser_idOpcionalstringoptional: 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

Lectura1 créditos

Campañas, grupos de anuncios o anuncios Smart+ (automatizados) de la cuenta publicitaria de TikTok (smart_plus/*/get). list_tiktok_campaigns / _ad_groups / _ads no los devuelven. Solo lectura.

ParámetroTipoDescripción
levelOpcionalcampaign | adgroup | adpor defecto campaign
advertiser_idOpcionalstringoptional: 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

Lectura1 créditos

Publicaciones orgánicas de TikTok de una identidad de cuenta de TikTok vinculada (identity/video/get) que pueden ejecutarse como Spark Ads: tiktok_item_id, texto, estado, duración, portada y estado de autorización publicitaria. Solo lectura.

ParámetroTipoDescripción
identity_idObligatoriostring—
identity_typeOpcionalTT_USER | BC_AUTH_TT | AUTH_CODEpor defecto TT_USER
identity_bc_idOpcionalstringobligatorio con BC_AUTH_TT
limitOpcionalinteger (1–100)por defecto 20
advertiser_idOpcionalstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

tiktok_recommendations

Lectura2 créditos

Diagnósticos y sugerencias propios de TikTok para grupos de anuncios (tool/diagnosis/get): fatiga creativa, sugerencias de puja y presupuesto con mejora estimada y problemas de seguimiento de eventos. Solo lectura; se aplican con las herramientas de actualización.

ParámetroTipoDescripción
adgroup_idsOpcionalarray<string>hasta 20; por defecto: TikTok elige los grupos de anuncios con diagnósticos
issue_categoriesOpcionalarray<string>CREATIVE | BID_AND_BUDGET | EVENT_TRACK
advertiser_idOpcionalstringoptional: 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

Lectura2 créditos

Informe libre de TikTok (report/integrated/get): cualquier métrica y dimensión admitida, tipo de informe, nivel de datos, rango de fechas o vida completa y filtros. Las filas se devuelven exactamente como las calcula TikTok. Solo lectura.

ParámetroTipoDescripción
metricsObligatorioarray<string>nombres de métricas de TikTok, p. ej. spend, impressions, clicks, conversion, complete_payment_roas
dimensionsObligatorioarray<string>p. ej. campaign_id, adgroup_id, ad_id, stat_time_day, country_code, gender, age
report_typeOpcionalBASIC | AUDIENCE | PLAYABLE_MATERIAL | CATALOG | BC | TT_SHOP—
data_levelOpcionalstringp. ej. AUCTION_CAMPAIGN, AUCTION_ADGROUP, AUCTION_AD, AUCTION_ADVERTISER
daysOpcionalinteger (1–365)—
start_dateOpcionalstring—
end_dateOpcionalstring—
lifetimeOpcionalbooleantotales de toda la vida en lugar de un rango de fechas
filteringOpcionalarray<object>filtros de TikTok: [{field_name, filter_type, filter_value}]
limitOpcionalinteger (1–5000)—
advertiser_idOpcionalstringoptional: 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

Lectura1 créditos

Business Centers de TikTok accesibles con el token conectado (bc/get): bc_id, nombre, empresa, estado, moneda, zona horaria y tu rol. Solo lectura.

Esta herramienta no recibe parámetros.

list_tiktok_bc_advertisers

Lectura1 créditos

Cuentas publicitarias dentro de un Business Center de TikTok (bc/asset/get, ADVERTISER): id del anunciante, nombre, tipo de cuenta, tu rol y estado de verificación. Solo lectura.

ParámetroTipoDescripción
bc_idOpcionalstringid del Business Center (list_tiktok_business_centers); opcional si el token solo alcanza un Business Center

list_tiktok_bc_pixels

Lectura1 créditos

Píxeles guardados en un Business Center de TikTok (bc/asset/get, PIXEL) en todas sus cuentas publicitarias. Solo lectura.

ParámetroTipoDescripción
bc_idOpcionalstringid del Business Center (list_tiktok_business_centers); opcional si el token solo alcanza un Business Center

list_tiktok_asset_groups

Lectura1 créditos

Grupos de activos de un Business Center de TikTok (bc/asset_group/list): asset_group_id y nombre. Solo lectura.

ParámetroTipoDescripción
bc_idOpcionalstringid del Business Center (list_tiktok_business_centers); opcional si el token solo alcanza un Business Center

tiktok_advertiser_qualification

Lectura1 créditos

Calificaciones empresariales en un TikTok Business Center (bc/advertiser/qualification/get): nombre de la empresa, estado de verificación, cuenta publicitaria propietaria, número de cuentas vinculadas y región. Solo lectura.

ParámetroTipoDescripción
bc_idOpcionalstringid del Business Center (list_tiktok_business_centers); opcional cuando el token solo llega a un Business Center
advertiser_idOpcionalstringconservar solo las calificaciones de esta cuenta publicitaria
verifiedOpcionalbooleanfiltrar verificadas / no verificadas

tiktok_change_history

Lectura2 créditos

Registro de actividad de un TikTok Business Center (changelog/get): cuándo, qué tipo de actividad, id del operador y el texto del cambio, de lo más reciente a lo más antiguo. Solo lectura.

ParámetroTipoDescripción
bc_idOpcionalstringid del Business Center (list_tiktok_business_centers); opcional cuando el token solo llega a un Business Center
start_dateOpcionalstringYYYY-MM-DD (UTC); por defecto: últimos 7 días
end_dateOpcionalstring—
daysOpcionalinteger (1–365)—
activity_typeOpcionalstringALL (por defecto) | USER | ASSET | … según los define TikTok
limitOpcionalinteger (1–500)—
advertiser_idOpcionalstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

Herramientas de escritura24 herramientas

select_tiktok_advertiser

Escritura1 créditos

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

La descripción de esta herramienta aún no está traducida; se muestra el texto original en inglés que ve el asistente.

ParámetroTipoDescripción
advertiser_idObligatoriostring—

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

upload_tiktok_video

Escritura2 créditos

Sube un vídeo a la biblioteca de recursos de la cuenta publicitaria de TikTok desde una URL pública (file/video/ad/upload, UPLOAD_BY_URL). Primero vista previa y aprobación; el nuevo video_id se devuelve en el resultado de la acción.

ParámetroTipoDescripción
video_urlObligatoriostringURL http(s) pública de un archivo mp4/mov/mpeg/avi (idealmente menos de 10 MB para subidas por URL)
file_nameOpcionalstring1-100 caracteres, único en la cuenta; por defecto: nombre del archivo de la URL + marca de tiempo
auto_fixOpcionalbooleandejar que TikTok detecte y corrija la baja resolución / relación de aspecto incorrecta
advertiser_idOpcionalstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

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

Sube una imagen (anuncio de imagen o portada de vídeo) a la biblioteca de recursos de TikTok desde una URL pública (file/image/ad/upload, UPLOAD_BY_URL). Primero vista previa y aprobación; el image_id se devuelve en el resultado de la acción.

ParámetroTipoDescripción
image_urlObligatoriostringURL http(s) pública de un JPG/PNG (máx. 1440x2560 píxeles en total)
file_nameOpcionalstring1-100 caracteres, único en la cuenta; por defecto: nombre del archivo de la URL + marca de tiempo
advertiser_idOpcionalstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

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

Crea una campaña de TikTok de principio a fin (campaña + grupo de anuncios, opcionalmente el anuncio) como borrador pausado. Escribe un borrador en el libro y abre un elemento de aprobación con vista previa; se envía a TikTok solo tras la aprobación y solo con una cuenta conectada.

ParámetroTipoDescripción
nameObligatoriostring—
objective_typeObligatorioTRAFFIC | WEB_CONVERSIONS | REACH | VIDEO_VIEWS | LEAD_GENERATION | APP_PROMOTION | PRODUCT_SALES—
daily_budgetOpcionalnumbermoneda de la cuenta
budget_modeOpcionalBUDGET_MODE_DAY | BUDGET_MODE_TOTAL | BUDGET_MODE_INFINITE—
goalOpcionalstring—
pixel_idOpcionalstring—
sales_destinationOpcionalWEBSITE | APP | WEB_AND_APP | TIKTOK_SHOPPRODUCT_SALES campaigns only
audienceOpcionalobjectcountries (lista ISO), age_min, age_max, genders ([1]=hombre, [2]=mujer), tiktok_location_ids, tiktok_interest_ids
ad_groupOpcionalobjectajustes opcionales del grupo de anuncios; por defecto: ubicación automática, desde ahora, ritmo uniforme
adOpcionalobjectanuncio opcional; necesita un video_id de la biblioteca
advertiser_idOpcionalstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

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

Crea un grupo de anuncios de TikTok dentro de una campaña con presupuesto, puja, segmentación, ubicaciones, calendario y franjas horarias. Primero vista previa y aprobación; se crea pausado salvo que operation_status=ENABLE.

ParámetroTipoDescripción
campaign_idObligatoriostringcampaign_id de TikTok
nameObligatoriostring—
budgetObligatorionumberpresupuesto diario, moneda de la cuenta
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
app_idOpcionalstringapp promotion only
identity_idOpcionalstring—
identity_typeOpcionalstringCUSTOMIZED_USER | TT_USER | BC_AUTH_TT
secondary_optimization_eventOpcionalstring—
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>ids de ubicación de TikTok (Turquía 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>códigos de idioma, p. ej. 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); establece SCHEDULE_START_END
daypartingOpcionalstring336 caracteres 0/1: 7 días x 48 medias horas empezando el lunes a las 00:00
pixel_idOpcionalstring—
optimization_eventOpcionalstringp. ej. COMPLETE_PAYMENT, ON_WEB_CART, FORM
comment_disabledOpcionalboolean—
share_disabledOpcionalboolean—
search_result_enabledOpcionalboolean—
interest_keyword_idsOpcionalarray<string>de search_tiktok_targeting(type=interest_keyword)
actionsOpcionalarray<object>segmentación por comportamiento: [{action_scene: VIDEO_RELATED|CREATOR_RELATED|HASHTAG_RELATED, action_period: 0|7|15, video_user_actions: [...], action_category_ids: [ids de search_tiktok_targeting(type=behavior)]}]
deep_bid_typeOpcionalstringe.g. DEFAULT, MIN, PACING, VO_MIN_ROAS
roas_bidOpcionalnumber—
zipcode_idsOpcionalarray<string>from search_tiktok_targeting(type=location)
device_model_idsOpcionalarray<string>—
device_price_rangesOpcionalarray<number>price range bounds, e.g. [0, 250]
network_typesOpcionalarray<string>WIFI | 2G | 3G | 4G | 5G
carrier_idsOpcionalarray<string>—
schedule_typeOpcionalSCHEDULE_FROM_NOW | SCHEDULE_START_END—
saved_audience_idOpcionalstring—
frequencyOpcionalintegermax impressions per user within frequency_schedule days
frequency_scheduleOpcionalintegerfrequency cap window in days
brand_safety_typeOpcionalstringNO_BRAND_SAFETY | STANDARD_INVENTORY | LIMITED_INVENTORY | EXPANDED_INVENTORY
blocked_pangle_app_idsOpcionalarray<string>—
targeting_expansionOpcionalobjecte.g. {expansion_enabled: true}
household_incomeOpcionalarray<string>e.g. TOP5, TOP10, TOP10_25, TOP25_50
spending_powerOpcionalALL | HIGH—
exclude_age_under_eighteenOpcionalboolean—
advertiser_idOpcionalstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

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

Crea un anuncio de TikTok en un grupo de anuncios a partir de un vídeo de la biblioteca (o una publicación Spark). Primero vista previa y aprobación.

ParámetroTipoDescripción
adgroup_idObligatoriostring—
ad_nameOpcionalstring—
ad_textObligatoriostring1-100 caracteres
video_idOpcionalstringde list_tiktok_videos
image_idsOpcionalarray<string>ids de imagen de portada / anuncio de imagen
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_idOpcionalstringid de publicación de Spark Ads
deeplinkOpcionalstring—
auto_message_idOpcionalstringwelcome message for Direct Message ads (list_tiktok_auto_messages / create_tiktok_auto_message)
identity_bc_idOpcionalstringBusiness Center id when identity_type is BC_AUTH_TT
operation_statusOpcionalENABLE | DISABLEDISABLE creates the ad paused; default ENABLE
advertiser_idOpcionalstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

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

Cambia el presupuesto de una o varias campañas de TikTok. Pasa por vista previa y aprobación; el libro se actualiza solo cuando TikTok acepta.

ParámetroTipoDescripción
campaign_idsObligatorioarray<string>ids de campaña de TikTok (o un id de campaña de Tecrube)
amountObligatorionumbermoneda de la cuenta
campaign_idOpcionalstringAlias of campaign_ids (single id)
currencyOpcionalstringoptional ISO check; must equal the ad account currency
advertiser_idOpcionalstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

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

EscrituraIrreversible2 créditos

Pausa (DISABLE) o activa (ENABLE) campañas de TikTok. Primero vista previa y aprobación.

ParámetroTipoDescripción
campaign_idsObligatorioarray<string>—
operation_statusObligatorioENABLE | DISABLE | DELETEDELETE is permanent; only when the user explicitly asked
campaign_idOpcionalstringAlias of campaign_ids (single id)
advertiser_idOpcionalstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

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

Actualiza uno o varios grupos de anuncios de TikTok a la vez: presupuesto, puja (bid_type/bid_price), segmentación (ubicaciones, edades, género, idiomas, intereses, audiencias), calendario y franjas horarias, ajustes de comentarios/compartir. Las ubicaciones de anuncio y el modo de presupuesto no pueden cambiar tras la creación (regla de TikTok). Primero vista previa y aprobación.

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>ids de ubicación de TikTok (Turquía 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>códigos de idioma, p. ej. 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); establece SCHEDULE_START_END
daypartingOpcionalstring336 caracteres 0/1: 7 días x 48 medias horas empezando el lunes a las 00:00
pixel_idOpcionalstringFixed at creation (defines the ad group's optimisation); rejected with an explanation
optimization_eventOpcionalstringp. ej. COMPLETE_PAYMENT, ON_WEB_CART, FORM
comment_disabledOpcionalboolean—
share_disabledOpcionalboolean—
search_result_enabledOpcionalboolean—
interest_keyword_idsOpcionalarray<string>de search_tiktok_targeting(type=interest_keyword)
actionsOpcionalarray<object>segmentación por comportamiento: [{action_scene: VIDEO_RELATED|CREATOR_RELATED|HASHTAG_RELATED, action_period: 0|7|15, video_user_actions: [...], action_category_ids: [ids de search_tiktok_targeting(type=behavior)]}]
deep_bid_typeOpcionalstringe.g. DEFAULT, MIN, PACING, VO_MIN_ROAS
roas_bidOpcionalnumber—
zipcode_idsOpcionalarray<string>from search_tiktok_targeting(type=location)
device_model_idsOpcionalarray<string>—
device_price_rangesOpcionalarray<number>price range bounds, e.g. [0, 250]
network_typesOpcionalarray<string>WIFI | 2G | 3G | 4G | 5G
carrier_idsOpcionalarray<string>—
schedule_typeOpcionalSCHEDULE_FROM_NOW | SCHEDULE_START_END—
saved_audience_idOpcionalstring—
frequencyOpcionalintegermax impressions per user within frequency_schedule days
frequency_scheduleOpcionalintegerfrequency cap window in days
brand_safety_typeOpcionalstringNO_BRAND_SAFETY | STANDARD_INVENTORY | LIMITED_INVENTORY | EXPANDED_INVENTORY
blocked_pangle_app_idsOpcionalarray<string>—
targeting_expansionOpcionalobjecte.g. {expansion_enabled: true}
household_incomeOpcionalarray<string>e.g. TOP5, TOP10, TOP10_25, TOP25_50
spending_powerOpcionalALL | HIGH—
exclude_age_under_eighteenOpcionalboolean—
changesOpcionalobjectcualquier campo de adgroup/update como mapa
adgroup_idOpcionalstringAlias of adgroup_ids (single id)
placementsOpcionalarray<string>Not changeable after creation (TikTok rule); rejected with an explanation
placement_typeOpcionalstringNot changeable after creation (TikTok rule); rejected with an explanation
budget_modeOpcionalstringNot changeable after creation (TikTok rule); rejected with an explanation
advertiser_idOpcionalstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

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

EscrituraIrreversible2 créditos

Pausa o activa grupos de anuncios de TikTok (p. ej. los que tienen un CPA por encima del objetivo). Primero vista previa y aprobación.

ParámetroTipoDescripción
adgroup_idsObligatorioarray<string>—
operation_statusObligatorioENABLE | DISABLE | DELETEDELETE is permanent; only when the user explicitly asked
reasonOpcionalstring—
adgroup_idOpcionalstringAlias of adgroup_ids (single id)
advertiser_idOpcionalstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

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

EscrituraIrreversible2 créditos

Pausa o activa anuncios de TikTok (p. ej. una creatividad agotada). Primero vista previa y aprobación.

ParámetroTipoDescripción
ad_idsObligatorioarray<string>—
operation_statusObligatorioENABLE | DISABLE | DELETEDELETE is permanent; only when the user explicitly asked
reasonOpcionalstring—
ad_idOpcionalstringAlias of ad_ids (single id)
advertiser_idOpcionalstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

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

Crea una audiencia personalizada de TikTok basada en reglas a partir de eventos de píxel, app o interacción (p. ej. añadieron al carrito en los últimos 30 días pero no compraron). Primero vista previa y aprobación; la audiencia tarda horas en llenarse.

ParámetroTipoDescripción
nameObligatoriostring—
audience_typeOpcionalPIXEL | APP | ENGAGEMENT | ENGAGEMENT_ORGANIC_VIDEO | BUSINESS_ACCOUNT | LEAD_GENERATION | TIKTOK_SHOP—
retention_daysOpcionalinteger (1–365)—
eventOpcionalstringevento de píxel/app a incluir, p. ej. AddToCart, CompletePayment, ViewContent
exclude_eventOpcionalstringevento a excluir, p. ej. CompletePayment para abandonos de carrito
pixel_idOpcionalstring—
event_source_idsOpcionalarray<string>ids de píxel / ids de app / ids de grupo de anuncios según audience_type
advertiser_idOpcionalstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

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

delete_tiktok_audience

EscrituraIrreversible2 créditos

Elimina de forma permanente audiencias personalizadas o similares de TikTok. Se aplica cuando el usuario lo pide y no se puede deshacer.

ParámetroTipoDescripción
audience_idsObligatorioarray<string>ids from list_tiktok_audiences
advertiser_idOpcionalstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

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

Crea una audiencia similar de TikTok a partir de una audiencia personalizada (tamaños de TikTok: NARROW ≈ más parecida, BALANCED, BROAD). Primero vista previa y aprobación.

ParámetroTipoDescripción
nameObligatoriostring—
source_audience_idObligatoriostring—
audience_sizeOpcionalNARROW | BALANCED | BROAD—
include_sourceOpcionalboolean—
location_idsOpcionalarray<string>—
placementsOpcionalarray<string>—
advertiser_idOpcionalstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

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

Crea un anuncio de TikTok que abre un chat de WhatsApp (click-to-WhatsApp): campaña LEAD_GENERATION, grupo de anuncios con ubicación de optimización Aplicación de mensajería instantánea (WhatsApp) en la ubicación TikTok y un anuncio de vídeo cuya portada se toma automáticamente del vídeo. chat_link construye el enlace wa.me a partir del número de teléfono; se rechazan las URL de sitios web. Todo se crea pausado; primero vista previa y aprobación.

ParámetroTipoDescripción
nameObligatoriostring—
phone_numberObligatoriostringnúmero de WhatsApp Business con código de país, p. ej. +90 532 000 00 00 (se rechaza el formato nacional que empieza por 0)
daily_budgetObligatorionumberpresupuesto diario del grupo de anuncios, moneda de la cuenta (mínimo de TikTok ≈ equivalente a 20 USD)
video_idObligatoriostringvídeo de la biblioteca (list_tiktok_videos / upload_tiktok_video)
ad_textObligatoriostring1-100 caracteres
connection_methodOpcionalchat_link | nativechat_link: enlace wa.me construido desde el número (solo CLICK, sin configuración extra); native: número conectado a la herramienta de gestión de mensajes de TikTok (CLICK o CONVERSATION en lista de permitidos)
prefilled_messageOpcionalstringsolo chat_link: texto prerrellenado en WhatsApp; debe nombrar la oferta o el servicio del anuncio, los saludos genéricos se rechazan
optimization_goalOpcionalCLICK | CONVERSATION—
phone_region_codeOpcionalstringsolo native, cuando el prefijo es compartido (p. ej. US para +1)
message_event_set_idOpcionalstringsolo native + CONVERSATION, cuando el número no coincide con ningún conjunto de eventos
image_idsOpcionalarray<string>id de imagen de portada; omitido = se obtiene y sube automáticamente la portada del vídeo
call_to_actionOpcionalstringpor defecto SEND_MESSAGE (CALL_NOW no permitido)
ad_nameOpcionalstring—
identity_idOpcionalstring—
identity_typeOpcionalstringCUSTOMIZED_USER | TT_USER | BC_AUTH_TT
display_nameOpcionalstring—
goalOpcionalstring—
audienceOpcionalobjectcountries (lista ISO), age_min (18+), age_max, genders ([1]=hombre, [2]=mujer), tiktok_location_ids, tiktok_interest_ids
ad_groupOpcionalobjectajustes opcionales de segmentación/calendario del grupo de anuncios; las ubicaciones, el tipo de promoción y los resultados de búsqueda son fijos en anuncios de mensajería
landing_page_urlOpcionalstringNO se acepta: un grupo de anuncios de mensajería no tiene destino web; indica phone_number en su lugar
website_urlOpcionalstringNOT accepted (same rule as landing_page_url); rejected with an explanation
advertiser_idOpcionalstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

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

update_tiktok_campaign

Escritura5 créditos

Renombra una campaña de TikTok (campaign/update); el nombre en el registro se actualiza también. Primero vista previa y aprobación. El presupuesto y el estado tienen sus propias herramientas.

ParámetroTipoDescripción
campaign_idObligatoriostringcampaign_id de TikTok o id de campaña de Tecrübe
nameObligatoriostring—
advertiser_idOpcionalstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

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

update_tiktok_ad

Escritura5 créditos

Edita en el sitio el texto de un anuncio de TikTok (ad/update): nombre, texto, página de destino, llamada a la acción o nombre visible. Primero se lee el anuncio actual y se conservan todos los demás campos. Primero vista previa y aprobación.

ParámetroTipoDescripción
ad_idObligatoriostring—
adgroup_idOpcionalstringopcional; se lee del anuncio si se omite
ad_nameOpcionalstring—
ad_textOpcionalstring1-100 caracteres
landing_page_urlOpcionalstring—
call_to_actionOpcionalstring—
display_nameOpcionalstring—
advertiser_idOpcionalstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

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

create_tiktok_auto_message

Escritura2 créditos

Crea un mensaje de bienvenida para anuncios de Mensaje directo de TikTok (creative/auto_message/create): un saludo y de 1 a 3 preguntas pulsables con respuestas automáticas. Devuelve auto_message_id tras la aprobación.

ParámetroTipoDescripción
titleObligatoriostringnombre de la plantilla
contentObligatoriostringsaludo
suggested_questionsObligatorioarray<object>—
advertiser_idOpcionalstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

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

create_tiktok_identity

Escritura2 créditos

Crea una identidad publicitaria personalizada de TikTok (identity/create): el nombre visible y el avatar que se muestran en los anuncios que no son Spark. Primero vista previa y aprobación; devuelve identity_id.

ParámetroTipoDescripción
display_nameObligatoriostring—
image_uriOpcionalstringimage_id de un avatar cuadrado de upload_tiktok_image
advertiser_idOpcionalstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

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

create_tiktok_pixel

Escritura2 créditos

Crea un píxel de conversión de TikTok (pixel/create). Primero vista previa y aprobación; devuelve pixel_id y pixel_code para instalarlos en el sitio web.

ParámetroTipoDescripción
nameObligatoriostring—
advertiser_idOpcionalstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

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

create_tiktok_customer_file_audience

Escritura6 créditos

Crea una audiencia personalizada de TikTok a partir de una lista de clientes (dmp/custom_audience/file/upload + create). Los valores se normalizan y se cifran con hash SHA-256 dentro de Tecrübe antes de guardar o enviar nada; la vista previa solo muestra recuentos. Primero aprobación.

ParámetroTipoDescripción
nameObligatoriostring—
identifiersObligatorioarray<string>correos electrónicos, teléfonos con +código de país o id de dispositivo; también se aceptan valores ya cifrados con SHA-256
id_typeOpcionalEMAIL | PHONE | IDFA | AAIDpor defecto EMAIL
retention_daysOpcionalinteger (1–365)—
advertiser_idOpcionalstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

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

share_tiktok_audience

Escritura4 créditos

Comparte audiencias personalizadas de TikTok con otras cuentas publicitarias del mismo Business Center, o deja de compartirlas (dmp/custom_audience/share, /share/cancel). Primero vista previa y aprobación.

ParámetroTipoDescripción
audience_idsObligatorioarray<string>1-10 id de audiencias personalizadas
shared_advertiser_idsOpcionalarray<string>1-10 cuentas publicitarias del mismo Business Center (opcional al dejar de compartir: todas)
actionOpcionalshare | unshare—
advertiser_idOpcionalstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

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

manage_tiktok_search_negative_keywords

Escritura4 créditos

Palabras clave negativas de los anuncios de búsqueda de TikTok de una campaña o grupo de anuncios (search_ad/negative_keyword/*): list lee directamente; add y delete pasan por vista previa y aprobación.

ParámetroTipoDescripción
object_typeObligatorioCAMPAIGN | ADGROUP—
object_idObligatoriostring—
operationOpcionallist | add | deletepor defecto list
keywordsOpcionalarray<string>para add; máx. 80 caracteres cada una
keyword_idsOpcionalarray<string>para delete (de operation=list)
match_typeOpcionalPRECISE_WORD | PHRASE_WORD | BROAD_WORDpara add; por defecto BROAD_WORD
advertiser_idOpcionalstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

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

send_tiktok_conversion_event

Escritura1 créditos

Envía a TikTok un evento de conversión web del lado del servidor (Events API 2.0, event/track). El correo, el teléfono y el id externo se cifran con hash SHA-256 antes de guardarse o enviarse. Primero vista previa y aprobación.

ParámetroTipoDescripción
pixel_codeObligatoriostringde list_tiktok_pixels
event_nameObligatoriostringevento estándar, p. ej. CompletePayment, SubmitForm, Contact, AddToCart
emailOpcionalstring—
phoneOpcionalstringcon +prefijo del país
external_idOpcionalstring—
ttclidOpcionalstringid de clic de TikTok de la URL de destino
valueOpcionalnumber—
currencyOpcionalstringISO 4217, obligatorio con value
event_idOpcionalstringclave de deduplicación compartida con el píxel del navegador
test_event_codeOpcionalstringfrom Events Manager › Test Events; the event is only shown there
urlOpcionalstringpágina donde ocurrió el evento
advertiser_idOpcionalstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

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