Armá una biblioteca de ejemplos de UGC de TikTok sin inventar resultados de anuncios

Configuración actual de la Search Task

La entrada guardada de la Task usa las consultas `["ugc ad examples", "product demo ugc", "customer testimonial ad", "unboxing ad"]`, expandQueries `true`, maxExpandedQueries `8`, maxResults `160`, resultsPerQuery `40`, maxPagesPerQuery `2` y searchDistribution `"balanced"`. `queries` es un arreglo de cadenas.

Para ejecutar un piloto acotado, reemplazá todo el arreglo `queries` por una sola cadena declarada. Aplicá estas sustituciones del piloto: expandQueries `false`, maxExpandedQueries `0`, maxResults `2`, resultsPerQuery `2`, maxPagesPerQuery `1` y searchDistribution `"balanced"`.

`maxResults` es un límite compartido de videos únicos guardados. `resultsPerQuery` pone un tope a los videos únicos guardados por término, no a las solicitudes de candidatos. Una distribución equilibrada puede reducir los límites efectivos, sin garantías.

La build 1.1.5 de TikTok Search devuelve campos nativos: `postId`, `postUrl`, `authorId`, `profileHandle`, `publishedAt`, `query`, `rootQuery`, `querySource`, `pageIndex`, `pageRank`, `status`, `statusReason` y `observedAt`. Los valores opcionales pueden ser null o desconocidos.

Los metadatos de la ejecución informan `queriesSearched`, `queryPlans`, `maxResults`, `resultsPerQuery`, `effectiveResultsPerQuery`, `maxPagesPerQuery`, `searchDistribution`, `rowsSaved`, `fieldCoverage`, `candidateItemsSeen`, `rowsAddedBeforeGlobalDedupe`, `duplicatesSkipped`, `invalidCandidatesSkipped`, `stopReason`, `sourceStatusCounts`, `status` y `statusReason`.

`queryPlans` da solo la consulta planificada, la raíz y la fuente. Los estados de intento o de falla son registros del lector, no resultados fabricados por consulta.

Una ejecución de control con una sola consulta devolvió `rowsSaved` 2, `stopReason` `max_results_reached`, `sourceStatusCounts` `{ok:1}`, `status` `ok` y `statusReason` `null`, con fechas de publicación en mayo y agosto. Esto demuestra la salida de metadatos para esa entrada, no campañas en vivo de varias consultas, tendencias ni rendimiento de anuncios. La deduplicación global conserva la pertenencia a una sola consulta. No hay un filtro de fecha nativo.

1. Revisá primero los ejemplos oficiales de anuncios

Si querés ejemplos oficiales de anuncios, empezá por la colección TikTok Top Ads oficial y revisá Cómo usar el panel Top Ads. TikTok indica que Top Ads es una colección de creatividades de anuncios autorizadas por el anunciante. Los usuarios sin sesión ven solo cinco anuncios. Este Actor no extrae el Creative Center ni recolecta sus métricas de rendimiento de anuncios.

2. Ejecutá una Task de búsqueda pública

Reemplazá los términos de ejemplo por una categoría de producto declarada. Conservá los ID originales de las publicaciones públicas, las URL y los momentos de observación. Un término como ugc ad examples puede devolver tutoriales en lugar de una creatividad real. Revisá cada video a mano antes de agregarlo a tu biblioteca.

3. Armá un registro de referencia

Anotá la URL de la fuente, el ID de la publicación, el perfil del creador, la fecha de observación, la categoría y el estado de la evidencia del anuncio. Usá anuncio oficial verificado, estado de anuncio del video público desconocido, o no es una referencia de anuncio, conforme a reglas claras. El texto de una publicación que afirma que es un anuncio pesa menos que una verificación en una página oficial de anuncios.

4. Mirá todo el ejemplo público relevante

Anotá el recurso de apertura, el producto o el problema mostrado, la acción de demostración, la redacción de la afirmación, la evidencia mostrada, el llamado a la acción, el tratamiento visual y los tiempos de los segmentos. Estas son notas manuales de la creatividad, no etiquetas automáticas. Usá una descripción breve de la apertura para respaldar tu referencia de producción.

5. Anotá el contexto de la fuente y los límites

Preguntá si la afirmación necesita una prueba del producto o si la relación con el cliente es real. Tratá los testimonios no verificados como afirmaciones, no como hechos. No copies en tu artículo las palabras pronunciadas en el video original ni descargues y reutilices el video de un creador.

6. Convertí la referencia en un requisito de producción original

Conservá la técnica general, como mostrar una medición antes de una conclusión, pero escribí escenas y palabras nuevas para tu propio producto. No supongas un retorno alto de la inversión publicitaria a partir de me gusta, visualizaciones o listas de anuncios destacados. ROAS significa los ingresos divididos por el gasto en anuncios. La búsqueda pública no te da valores de ingresos ni de gasto.

7. Entregá una fila de la biblioteca y un brief de escena

Conservá el enlace de la fuente para la revisión y anotá los límites del estado del anuncio. Esta es una herramienta de planificación creativa, no un informe de gasto de la competencia, un descargador, una autorización de derechos ni un ranking medido del mejor anuncio.

Ejemplo resuelto

Todos los ejemplos de esta sección son ficción original.

Razonamiento completo

El candidato R1 se encuentra mediante búsqueda pública con el ID de publicación V1, pero carece de evidencia oficial de anuncio, así que lo marcás como public_video_ad_status_unknown. Al mirarlo, aparece una afirmación no respaldada sobre ahorrar la mitad del agua sin un método de prueba. El candidato R2 se encuentra en una página oficial de anuncios y se marca como checked_official_ad, pero no aporta datos de gasto ni de ingresos. El candidato R3 es un creador que enseña a escribir guiones, así que lo marcás como not_an_ad_reference según esta regla de la biblioteca. Estos tres candidatos te dan dos referencias de producción útiles y una referencia de anuncio oficial, y sirven a preguntas de investigación distintas.

Brief de escena original