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éditosCuentas 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éditosCampañ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ámetro | Tipo | Descripción |
|---|---|---|
campaign_idsOpcional | array<string> | — |
statusOpcional | STATUS_DELIVERY_OK | STATUS_NOT_DELIVERY | STATUS_DISABLE | STATUS_DELETE | STATUS_NOT_DELETE | STATUS_ALL | filtro de estado principal, p. ej. STATUS_DELIVERY_OK, STATUS_DISABLE |
advertiser_idOpcional | string | optional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change |
list_tiktok_ad_groups
Lectura1 créditosGrupos 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ámetro | Tipo | Descripción |
|---|---|---|
campaign_idsOpcional | array<string> | — |
adgroup_idsOpcional | array<string> | — |
advertiser_idOpcional | string | optional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change |
list_tiktok_ads
Lectura1 créditosAnuncios 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ámetro | Tipo | Descripción |
|---|---|---|
campaign_idsOpcional | array<string> | — |
adgroup_idsOpcional | array<string> | — |
ad_idsOpcional | array<string> | — |
advertiser_idOpcional | string | optional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change |
tiktok_performance_report
Lectura2 créditosRendimiento 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ámetro | Tipo | Descripción |
|---|---|---|
levelOpcional | campaign | ad_group | ad | — |
daysOpcional | integer (1–365) | — |
start_dateOpcional | string | — |
end_dateOpcional | string | — |
dailyOpcional | boolean | una fila por día (stat_time_day) |
campaign_idsOpcional | array<string> | — |
adgroup_idsOpcional | array<string> | — |
ad_idsOpcional | array<string> | — |
advertiser_idOpcional | string | optional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change |
list_tiktok_audiences
Lectura1 créditosAudiencias 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ámetro | Tipo | Descripción |
|---|---|---|
advertiser_idOpcional | string | optional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change |
list_tiktok_videos
Lectura1 créditosVí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ámetro | Tipo | Descripción |
|---|---|---|
video_idsOpcional | array<string> | — |
limitOpcional | integer (1–500) | newest first (default 500) |
advertiser_idOpcional | string | optional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change |
get_tiktok_video_cover
Lectura1 créditosFotogramas 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ámetro | Tipo | Descripción |
|---|---|---|
video_idObligatorio | string | — |
countOpcional | integer (1–10) | — |
advertiser_idOpcional | string | optional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change |
search_tiktok_targeting
Lectura1 créditosConvierte 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ámetro | Tipo | Descripción |
|---|---|---|
typeObligatorio | interest | behavior | interest_keyword | location | region | — |
queryObligatorio | string | nombre a buscar, p. ej. fashion, moda, Istanbul, Turkey |
languageOpcional | string | idioma de los nombres para interest/behavior/interest_keyword, p. ej. tr, en (por defecto: idioma de la conversación) |
objective_typeOpcional | string | para location/region: objetivo de campaña, por defecto TRAFFIC; LEAD_GENERATION para anuncios de WhatsApp |
promotion_typeOpcional | string | para location/region; por defecto WEBSITE, o LEAD_GEN_CLICK_TO_SOCIAL_MEDIA_APP_MESSAGE con LEAD_GENERATION |
placementsOpcional | array<string> | por defecto PLACEMENT_TIKTOK |
region_codesOpcional | array<string> | location: filtrar por código de país, p. ej. TR |
geo_typesOpcional | array<string> | location: COUNTRY | PROVINCE | CITY | DISTRICT | DMA | ZIP_CODE |
limitOpcional | integer (1–100) | — |
advertiser_idOpcional | string | optional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change |
list_tiktok_identities
Lectura1 créditosIdentidades 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ámetro | Tipo | Descripción |
|---|---|---|
identity_typeOpcional | CUSTOMIZED_USER | AUTH_CODE | TT_USER | BC_AUTH_TT | — |
identity_bc_idOpcional | string | obligatorio con BC_AUTH_TT |
advertiser_idOpcional | string | optional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change |
list_tiktok_pixels
Lectura1 créditosPí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ámetro | Tipo | Descripción |
|---|---|---|
advertiser_idOpcional | string | optional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change |
list_tiktok_auto_messages
Lectura1 créditosPlantillas 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ámetro | Tipo | Descripción |
|---|---|---|
advertiser_idOpcional | string | optional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change |
list_tiktok_lead_forms
Lectura1 créditosFormularios 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ámetro | Tipo | Descripción |
|---|---|---|
advertiser_idOpcional | string | optional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change |
get_tiktok_lead_form_fields
Lectura1 créditosCampos 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ámetro | Tipo | Descripción |
|---|---|---|
page_idObligatorio | string | id del formulario instantáneo de list_tiktok_lead_forms |
advertiser_idOpcional | string | optional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change |
download_tiktok_leads
Lectura2 créditosDescarga 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ámetro | Tipo | Descripción |
|---|---|---|
page_idOpcional | string | id del formulario instantáneo de list_tiktok_lead_forms (o indica ad_id) |
ad_idOpcional | string | id del anuncio de clientes potenciales; descarga los clientes potenciales de ese anuncio en lugar de un formulario |
task_idOpcional | string | id de tarea devuelto por una llamada anterior que seguía en RUNNING |
regionOpcional | eu | us | other | dónde se segmentaron los anuncios: eu = EEE/Suiza/Reino Unido, us = Estados Unidos, other (por defecto) = el resto |
limitOpcional | integer (1–100) | filas de la vista previa enmascarada (por defecto 20); la lista completa solo está en el archivo de descarga |
advertiser_idOpcional | string | optional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change |
list_tiktok_creative_portfolios
Lectura1 créditosPortafolios 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ámetro | Tipo | Descripción |
|---|---|---|
advertiser_idOpcional | string | optional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change |
list_tiktok_gmv_max_stores
Lectura1 créditosTiendas 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ámetro | Tipo | Descripción |
|---|---|---|
advertiser_idOpcional | string | optional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change |
list_tiktok_smart_plus
Lectura1 créditosCampañ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ámetro | Tipo | Descripción |
|---|---|---|
levelOpcional | campaign | adgroup | ad | por defecto campaign |
advertiser_idOpcional | string | optional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change |
list_tiktok_posts
Lectura1 créditosPublicaciones 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ámetro | Tipo | Descripción |
|---|---|---|
identity_idObligatorio | string | — |
identity_typeOpcional | TT_USER | BC_AUTH_TT | AUTH_CODE | por defecto TT_USER |
identity_bc_idOpcional | string | obligatorio con BC_AUTH_TT |
limitOpcional | integer (1–100) | por defecto 20 |
advertiser_idOpcional | string | optional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change |
tiktok_recommendations
Lectura2 créditosDiagnó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ámetro | Tipo | Descripción |
|---|---|---|
adgroup_idsOpcional | array<string> | hasta 20; por defecto: TikTok elige los grupos de anuncios con diagnósticos |
issue_categoriesOpcional | array<string> | CREATIVE | BID_AND_BUDGET | EVENT_TRACK |
advertiser_idOpcional | string | optional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change |
tiktok_report_query
Lectura2 créditosInforme 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ámetro | Tipo | Descripción |
|---|---|---|
metricsObligatorio | array<string> | nombres de métricas de TikTok, p. ej. spend, impressions, clicks, conversion, complete_payment_roas |
dimensionsObligatorio | array<string> | p. ej. campaign_id, adgroup_id, ad_id, stat_time_day, country_code, gender, age |
report_typeOpcional | BASIC | AUDIENCE | PLAYABLE_MATERIAL | CATALOG | BC | TT_SHOP | — |
data_levelOpcional | string | p. ej. AUCTION_CAMPAIGN, AUCTION_ADGROUP, AUCTION_AD, AUCTION_ADVERTISER |
daysOpcional | integer (1–365) | — |
start_dateOpcional | string | — |
end_dateOpcional | string | — |
lifetimeOpcional | boolean | totales de toda la vida en lugar de un rango de fechas |
filteringOpcional | array<object> | filtros de TikTok: [{field_name, filter_type, filter_value}] |
limitOpcional | integer (1–5000) | — |
advertiser_idOpcional | string | optional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change |
list_tiktok_business_centers
Lectura1 créditosBusiness 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éditosCuentas 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ámetro | Tipo | Descripción |
|---|---|---|
bc_idOpcional | string | id del Business Center (list_tiktok_business_centers); opcional si el token solo alcanza un Business Center |
list_tiktok_bc_pixels
Lectura1 créditosPíxeles guardados en un Business Center de TikTok (bc/asset/get, PIXEL) en todas sus cuentas publicitarias. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
bc_idOpcional | string | id del Business Center (list_tiktok_business_centers); opcional si el token solo alcanza un Business Center |
list_tiktok_asset_groups
Lectura1 créditosGrupos de activos de un Business Center de TikTok (bc/asset_group/list): asset_group_id y nombre. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
bc_idOpcional | string | id del Business Center (list_tiktok_business_centers); opcional si el token solo alcanza un Business Center |
tiktok_advertiser_qualification
Lectura1 créditosCalificaciones 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ámetro | Tipo | Descripción |
|---|---|---|
bc_idOpcional | string | id del Business Center (list_tiktok_business_centers); opcional cuando el token solo llega a un Business Center |
advertiser_idOpcional | string | conservar solo las calificaciones de esta cuenta publicitaria |
verifiedOpcional | boolean | filtrar verificadas / no verificadas |
tiktok_change_history
Lectura2 créditosRegistro 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ámetro | Tipo | Descripción |
|---|---|---|
bc_idOpcional | string | id del Business Center (list_tiktok_business_centers); opcional cuando el token solo llega a un Business Center |
start_dateOpcional | string | YYYY-MM-DD (UTC); por defecto: últimos 7 días |
end_dateOpcional | string | — |
daysOpcional | integer (1–365) | — |
activity_typeOpcional | string | ALL (por defecto) | USER | ASSET | … según los define TikTok |
limitOpcional | integer (1–500) | — |
advertiser_idOpcional | string | optional: 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éditosChoose 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ámetro | Tipo | Descripción |
|---|---|---|
advertiser_idObligatorio | string | — |
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éditosSube 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ámetro | Tipo | Descripción |
|---|---|---|
video_urlObligatorio | string | URL http(s) pública de un archivo mp4/mov/mpeg/avi (idealmente menos de 10 MB para subidas por URL) |
file_nameOpcional | string | 1-100 caracteres, único en la cuenta; por defecto: nombre del archivo de la URL + marca de tiempo |
auto_fixOpcional | boolean | dejar que TikTok detecte y corrija la baja resolución / relación de aspecto incorrecta |
advertiser_idOpcional | string | optional: 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éditosSube 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ámetro | Tipo | Descripción |
|---|---|---|
image_urlObligatorio | string | URL http(s) pública de un JPG/PNG (máx. 1440x2560 píxeles en total) |
file_nameOpcional | string | 1-100 caracteres, único en la cuenta; por defecto: nombre del archivo de la URL + marca de tiempo |
advertiser_idOpcional | string | optional: 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éditosCrea 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ámetro | Tipo | Descripción |
|---|---|---|
nameObligatorio | string | — |
objective_typeObligatorio | TRAFFIC | WEB_CONVERSIONS | REACH | VIDEO_VIEWS | LEAD_GENERATION | APP_PROMOTION | PRODUCT_SALES | — |
daily_budgetOpcional | number | moneda de la cuenta |
budget_modeOpcional | BUDGET_MODE_DAY | BUDGET_MODE_TOTAL | BUDGET_MODE_INFINITE | — |
goalOpcional | string | — |
pixel_idOpcional | string | — |
sales_destinationOpcional | WEBSITE | APP | WEB_AND_APP | TIKTOK_SHOP | PRODUCT_SALES campaigns only |
audienceOpcional | object | countries (lista ISO), age_min, age_max, genders ([1]=hombre, [2]=mujer), tiktok_location_ids, tiktok_interest_ids |
ad_groupOpcional | object | ajustes opcionales del grupo de anuncios; por defecto: ubicación automática, desde ahora, ritmo uniforme |
adOpcional | object | anuncio opcional; necesita un video_id de la biblioteca |
advertiser_idOpcional | string | optional: 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éditosCrea 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ámetro | Tipo | Descripción |
|---|---|---|
campaign_idObligatorio | string | campaign_id de TikTok |
nameObligatorio | string | — |
budgetObligatorio | number | presupuesto diario, moneda de la cuenta |
budget_modeOpcional | BUDGET_MODE_DAY | BUDGET_MODE_TOTAL | — |
placement_typeOpcional | PLACEMENT_TYPE_AUTOMATIC | PLACEMENT_TYPE_NORMAL | — |
placementsOpcional | array<string> | PLACEMENT_TIKTOK | PLACEMENT_PANGLE | PLACEMENT_GLOBAL_APP_BUNDLE |
promotion_typeOpcional | string | WEBSITE | APP_ANDROID | APP_IOS | LEAD_GENERATION |
app_idOpcional | string | app promotion only |
identity_idOpcional | string | — |
identity_typeOpcional | string | CUSTOMIZED_USER | TT_USER | BC_AUTH_TT |
secondary_optimization_eventOpcional | string | — |
operation_statusOpcional | ENABLE | DISABLE | — |
optimization_goalOpcional | string | CLICK | CONVERT | REACH | VIDEO_VIEW | LEAD | ENGAGEMENT |
billing_eventOpcional | string | CPC | CPM | OCPM | CPV |
bid_typeOpcional | string | BID_TYPE_NO_BID | BID_TYPE_CUSTOM |
bid_priceOpcional | number | — |
conversion_bid_priceOpcional | number | — |
pacingOpcional | PACING_MODE_SMOOTH | PACING_MODE_FAST | — |
location_idsOpcional | array<string> | ids de ubicación de TikTok (Turquía 298795, US 6252001, UK 2635167, DE 2921044) |
age_groupsOpcional | array<string> | AGE_13_17 | AGE_18_24 | AGE_25_34 | AGE_35_44 | AGE_45_54 | AGE_55_100 |
genderOpcional | GENDER_UNLIMITED | GENDER_MALE | GENDER_FEMALE | — |
languagesOpcional | array<string> | códigos de idioma, p. ej. tr, en |
interest_category_idsOpcional | array<string> | — |
operating_systemsOpcional | array<string> | ANDROID | IOS |
audience_idsOpcional | array<string> | — |
excluded_audience_idsOpcional | array<string> | — |
schedule_start_timeOpcional | string | YYYY-MM-DD HH:MM:SS (UTC) |
schedule_end_timeOpcional | string | YYYY-MM-DD HH:MM:SS (UTC); establece SCHEDULE_START_END |
daypartingOpcional | string | 336 caracteres 0/1: 7 días x 48 medias horas empezando el lunes a las 00:00 |
pixel_idOpcional | string | — |
optimization_eventOpcional | string | p. ej. COMPLETE_PAYMENT, ON_WEB_CART, FORM |
comment_disabledOpcional | boolean | — |
share_disabledOpcional | boolean | — |
search_result_enabledOpcional | boolean | — |
interest_keyword_idsOpcional | array<string> | de search_tiktok_targeting(type=interest_keyword) |
actionsOpcional | array<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_typeOpcional | string | e.g. DEFAULT, MIN, PACING, VO_MIN_ROAS |
roas_bidOpcional | number | — |
zipcode_idsOpcional | array<string> | from search_tiktok_targeting(type=location) |
device_model_idsOpcional | array<string> | — |
device_price_rangesOpcional | array<number> | price range bounds, e.g. [0, 250] |
network_typesOpcional | array<string> | WIFI | 2G | 3G | 4G | 5G |
carrier_idsOpcional | array<string> | — |
schedule_typeOpcional | SCHEDULE_FROM_NOW | SCHEDULE_START_END | — |
saved_audience_idOpcional | string | — |
frequencyOpcional | integer | max impressions per user within frequency_schedule days |
frequency_scheduleOpcional | integer | frequency cap window in days |
brand_safety_typeOpcional | string | NO_BRAND_SAFETY | STANDARD_INVENTORY | LIMITED_INVENTORY | EXPANDED_INVENTORY |
blocked_pangle_app_idsOpcional | array<string> | — |
targeting_expansionOpcional | object | e.g. {expansion_enabled: true} |
household_incomeOpcional | array<string> | e.g. TOP5, TOP10, TOP10_25, TOP25_50 |
spending_powerOpcional | ALL | HIGH | — |
exclude_age_under_eighteenOpcional | boolean | — |
advertiser_idOpcional | string | optional: 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éditosCrea 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ámetro | Tipo | Descripción |
|---|---|---|
adgroup_idObligatorio | string | — |
ad_nameOpcional | string | — |
ad_textObligatorio | string | 1-100 caracteres |
video_idOpcional | string | de list_tiktok_videos |
image_idsOpcional | array<string> | ids de imagen de portada / anuncio de imagen |
ad_formatOpcional | SINGLE_VIDEO | SINGLE_IMAGE | CAROUSEL | — |
landing_page_urlOpcional | string | — |
call_to_actionOpcional | string | LEARN_MORE | SHOP_NOW | SIGN_UP | CONTACT_US | DOWNLOAD … |
identity_idOpcional | string | — |
identity_typeOpcional | string | CUSTOMIZED_USER | TT_USER | BC_AUTH_TT |
display_nameOpcional | string | — |
tiktok_item_idOpcional | string | id de publicación de Spark Ads |
deeplinkOpcional | string | — |
auto_message_idOpcional | string | welcome message for Direct Message ads (list_tiktok_auto_messages / create_tiktok_auto_message) |
identity_bc_idOpcional | string | Business Center id when identity_type is BC_AUTH_TT |
operation_statusOpcional | ENABLE | DISABLE | DISABLE creates the ad paused; default ENABLE |
advertiser_idOpcional | string | optional: 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éditosCambia 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ámetro | Tipo | Descripción |
|---|---|---|
campaign_idsObligatorio | array<string> | ids de campaña de TikTok (o un id de campaña de Tecrube) |
amountObligatorio | number | moneda de la cuenta |
campaign_idOpcional | string | Alias of campaign_ids (single id) |
currencyOpcional | string | optional ISO check; must equal the ad account currency |
advertiser_idOpcional | string | optional: 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éditosPausa (DISABLE) o activa (ENABLE) campañas de TikTok. Primero vista previa y aprobación.
| Parámetro | Tipo | Descripción |
|---|---|---|
campaign_idsObligatorio | array<string> | — |
operation_statusObligatorio | ENABLE | DISABLE | DELETE | DELETE is permanent; only when the user explicitly asked |
campaign_idOpcional | string | Alias of campaign_ids (single id) |
advertiser_idOpcional | string | optional: 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éditosActualiza 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ámetro | Tipo | Descripción |
|---|---|---|
adgroup_idsObligatorio | array<string> | — |
adgroup_nameOpcional | string | — |
budgetOpcional | number | — |
optimization_goalOpcional | string | CLICK | CONVERT | REACH | VIDEO_VIEW | LEAD | ENGAGEMENT |
billing_eventOpcional | string | CPC | CPM | OCPM | CPV |
bid_typeOpcional | string | BID_TYPE_NO_BID | BID_TYPE_CUSTOM |
bid_priceOpcional | number | — |
conversion_bid_priceOpcional | number | — |
pacingOpcional | PACING_MODE_SMOOTH | PACING_MODE_FAST | — |
location_idsOpcional | array<string> | ids de ubicación de TikTok (Turquía 298795, US 6252001, UK 2635167, DE 2921044) |
age_groupsOpcional | array<string> | AGE_13_17 | AGE_18_24 | AGE_25_34 | AGE_35_44 | AGE_45_54 | AGE_55_100 |
genderOpcional | GENDER_UNLIMITED | GENDER_MALE | GENDER_FEMALE | — |
languagesOpcional | array<string> | códigos de idioma, p. ej. tr, en |
interest_category_idsOpcional | array<string> | — |
operating_systemsOpcional | array<string> | ANDROID | IOS |
audience_idsOpcional | array<string> | — |
excluded_audience_idsOpcional | array<string> | — |
schedule_start_timeOpcional | string | YYYY-MM-DD HH:MM:SS (UTC) |
schedule_end_timeOpcional | string | YYYY-MM-DD HH:MM:SS (UTC); establece SCHEDULE_START_END |
daypartingOpcional | string | 336 caracteres 0/1: 7 días x 48 medias horas empezando el lunes a las 00:00 |
pixel_idOpcional | string | Fixed at creation (defines the ad group's optimisation); rejected with an explanation |
optimization_eventOpcional | string | p. ej. COMPLETE_PAYMENT, ON_WEB_CART, FORM |
comment_disabledOpcional | boolean | — |
share_disabledOpcional | boolean | — |
search_result_enabledOpcional | boolean | — |
interest_keyword_idsOpcional | array<string> | de search_tiktok_targeting(type=interest_keyword) |
actionsOpcional | array<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_typeOpcional | string | e.g. DEFAULT, MIN, PACING, VO_MIN_ROAS |
roas_bidOpcional | number | — |
zipcode_idsOpcional | array<string> | from search_tiktok_targeting(type=location) |
device_model_idsOpcional | array<string> | — |
device_price_rangesOpcional | array<number> | price range bounds, e.g. [0, 250] |
network_typesOpcional | array<string> | WIFI | 2G | 3G | 4G | 5G |
carrier_idsOpcional | array<string> | — |
schedule_typeOpcional | SCHEDULE_FROM_NOW | SCHEDULE_START_END | — |
saved_audience_idOpcional | string | — |
frequencyOpcional | integer | max impressions per user within frequency_schedule days |
frequency_scheduleOpcional | integer | frequency cap window in days |
brand_safety_typeOpcional | string | NO_BRAND_SAFETY | STANDARD_INVENTORY | LIMITED_INVENTORY | EXPANDED_INVENTORY |
blocked_pangle_app_idsOpcional | array<string> | — |
targeting_expansionOpcional | object | e.g. {expansion_enabled: true} |
household_incomeOpcional | array<string> | e.g. TOP5, TOP10, TOP10_25, TOP25_50 |
spending_powerOpcional | ALL | HIGH | — |
exclude_age_under_eighteenOpcional | boolean | — |
changesOpcional | object | cualquier campo de adgroup/update como mapa |
adgroup_idOpcional | string | Alias of adgroup_ids (single id) |
placementsOpcional | array<string> | Not changeable after creation (TikTok rule); rejected with an explanation |
placement_typeOpcional | string | Not changeable after creation (TikTok rule); rejected with an explanation |
budget_modeOpcional | string | Not changeable after creation (TikTok rule); rejected with an explanation |
advertiser_idOpcional | string | optional: 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éditosPausa 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ámetro | Tipo | Descripción |
|---|---|---|
adgroup_idsObligatorio | array<string> | — |
operation_statusObligatorio | ENABLE | DISABLE | DELETE | DELETE is permanent; only when the user explicitly asked |
reasonOpcional | string | — |
adgroup_idOpcional | string | Alias of adgroup_ids (single id) |
advertiser_idOpcional | string | optional: 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éditosPausa o activa anuncios de TikTok (p. ej. una creatividad agotada). Primero vista previa y aprobación.
| Parámetro | Tipo | Descripción |
|---|---|---|
ad_idsObligatorio | array<string> | — |
operation_statusObligatorio | ENABLE | DISABLE | DELETE | DELETE is permanent; only when the user explicitly asked |
reasonOpcional | string | — |
ad_idOpcional | string | Alias of ad_ids (single id) |
advertiser_idOpcional | string | optional: 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éditosCrea 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ámetro | Tipo | Descripción |
|---|---|---|
nameObligatorio | string | — |
audience_typeOpcional | PIXEL | APP | ENGAGEMENT | ENGAGEMENT_ORGANIC_VIDEO | BUSINESS_ACCOUNT | LEAD_GENERATION | TIKTOK_SHOP | — |
retention_daysOpcional | integer (1–365) | — |
eventOpcional | string | evento de píxel/app a incluir, p. ej. AddToCart, CompletePayment, ViewContent |
exclude_eventOpcional | string | evento a excluir, p. ej. CompletePayment para abandonos de carrito |
pixel_idOpcional | string | — |
event_source_idsOpcional | array<string> | ids de píxel / ids de app / ids de grupo de anuncios según audience_type |
advertiser_idOpcional | string | optional: 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éditosElimina de forma permanente audiencias personalizadas o similares de TikTok. Se aplica cuando el usuario lo pide y no se puede deshacer.
| Parámetro | Tipo | Descripción |
|---|---|---|
audience_idsObligatorio | array<string> | ids from list_tiktok_audiences |
advertiser_idOpcional | string | optional: 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éditosCrea 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ámetro | Tipo | Descripción |
|---|---|---|
nameObligatorio | string | — |
source_audience_idObligatorio | string | — |
audience_sizeOpcional | NARROW | BALANCED | BROAD | — |
include_sourceOpcional | boolean | — |
location_idsOpcional | array<string> | — |
placementsOpcional | array<string> | — |
advertiser_idOpcional | string | optional: 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éditosCrea 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ámetro | Tipo | Descripción |
|---|---|---|
nameObligatorio | string | — |
phone_numberObligatorio | string | nú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_budgetObligatorio | number | presupuesto diario del grupo de anuncios, moneda de la cuenta (mínimo de TikTok ≈ equivalente a 20 USD) |
video_idObligatorio | string | vídeo de la biblioteca (list_tiktok_videos / upload_tiktok_video) |
ad_textObligatorio | string | 1-100 caracteres |
connection_methodOpcional | chat_link | native | chat_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_messageOpcional | string | solo chat_link: texto prerrellenado en WhatsApp; debe nombrar la oferta o el servicio del anuncio, los saludos genéricos se rechazan |
optimization_goalOpcional | CLICK | CONVERSATION | — |
phone_region_codeOpcional | string | solo native, cuando el prefijo es compartido (p. ej. US para +1) |
message_event_set_idOpcional | string | solo native + CONVERSATION, cuando el número no coincide con ningún conjunto de eventos |
image_idsOpcional | array<string> | id de imagen de portada; omitido = se obtiene y sube automáticamente la portada del vídeo |
call_to_actionOpcional | string | por defecto SEND_MESSAGE (CALL_NOW no permitido) |
ad_nameOpcional | string | — |
identity_idOpcional | string | — |
identity_typeOpcional | string | CUSTOMIZED_USER | TT_USER | BC_AUTH_TT |
display_nameOpcional | string | — |
goalOpcional | string | — |
audienceOpcional | object | countries (lista ISO), age_min (18+), age_max, genders ([1]=hombre, [2]=mujer), tiktok_location_ids, tiktok_interest_ids |
ad_groupOpcional | object | ajustes 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_urlOpcional | string | NO se acepta: un grupo de anuncios de mensajería no tiene destino web; indica phone_number en su lugar |
website_urlOpcional | string | NOT accepted (same rule as landing_page_url); rejected with an explanation |
advertiser_idOpcional | string | optional: 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éditosRenombra 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ámetro | Tipo | Descripción |
|---|---|---|
campaign_idObligatorio | string | campaign_id de TikTok o id de campaña de Tecrübe |
nameObligatorio | string | — |
advertiser_idOpcional | string | optional: 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éditosEdita 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ámetro | Tipo | Descripción |
|---|---|---|
ad_idObligatorio | string | — |
adgroup_idOpcional | string | opcional; se lee del anuncio si se omite |
ad_nameOpcional | string | — |
ad_textOpcional | string | 1-100 caracteres |
landing_page_urlOpcional | string | — |
call_to_actionOpcional | string | — |
display_nameOpcional | string | — |
advertiser_idOpcional | string | optional: 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éditosCrea 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ámetro | Tipo | Descripción |
|---|---|---|
titleObligatorio | string | nombre de la plantilla |
contentObligatorio | string | saludo |
suggested_questionsObligatorio | array<object> | — |
advertiser_idOpcional | string | optional: 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éditosCrea 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ámetro | Tipo | Descripción |
|---|---|---|
display_nameObligatorio | string | — |
image_uriOpcional | string | image_id de un avatar cuadrado de upload_tiktok_image |
advertiser_idOpcional | string | optional: 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éditosCrea 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ámetro | Tipo | Descripción |
|---|---|---|
nameObligatorio | string | — |
advertiser_idOpcional | string | optional: 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éditosCrea 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ámetro | Tipo | Descripción |
|---|---|---|
nameObligatorio | string | — |
identifiersObligatorio | array<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_typeOpcional | EMAIL | PHONE | IDFA | AAID | por defecto EMAIL |
retention_daysOpcional | integer (1–365) | — |
advertiser_idOpcional | string | optional: 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éditosComparte 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ámetro | Tipo | Descripción |
|---|---|---|
audience_idsObligatorio | array<string> | 1-10 id de audiencias personalizadas |
shared_advertiser_idsOpcional | array<string> | 1-10 cuentas publicitarias del mismo Business Center (opcional al dejar de compartir: todas) |
actionOpcional | share | unshare | — |
advertiser_idOpcional | string | optional: 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éditosPalabras 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ámetro | Tipo | Descripción |
|---|---|---|
object_typeObligatorio | CAMPAIGN | ADGROUP | — |
object_idObligatorio | string | — |
operationOpcional | list | add | delete | por defecto list |
keywordsOpcional | array<string> | para add; máx. 80 caracteres cada una |
keyword_idsOpcional | array<string> | para delete (de operation=list) |
match_typeOpcional | PRECISE_WORD | PHRASE_WORD | BROAD_WORD | para add; por defecto BROAD_WORD |
advertiser_idOpcional | string | optional: 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éditosEnví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ámetro | Tipo | Descripción |
|---|---|---|
pixel_codeObligatorio | string | de list_tiktok_pixels |
event_nameObligatorio | string | evento estándar, p. ej. CompletePayment, SubmitForm, Contact, AddToCart |
emailOpcional | string | — |
phoneOpcional | string | con +prefijo del país |
external_idOpcional | string | — |
ttclidOpcional | string | id de clic de TikTok de la URL de destino |
valueOpcional | number | — |
currencyOpcional | string | ISO 4217, obligatorio con value |
event_idOpcional | string | clave de deduplicación compartida con el píxel del navegador |
test_event_codeOpcional | string | from Events Manager › Test Events; the event is only shown there |
urlOpcional | string | página donde ocurrió el evento |
advertiser_idOpcional | string | optional: 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.