> ## Documentation Index
> Fetch the complete documentation index at: https://docs.convertixapp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Integración con TikTok

> Guía para conectar TikTok Ads con Convertix usando Events API.

TikTok Ads permite medir y optimizar el rendimiento de tus anuncios mediante la integración con Convertix. Esta guía explica cómo configurar la conexión usando la [Events API de TikTok](https://ads.tiktok.com/help/article/web-attribution?lang=es).

Realizarás 2 pasos principales:

* Crear un Data Source en TikTok Events Manager
* Configurar la integración en Convertix

Tiempo estimado: 10-15 minutos.

<Note>
  Necesitas una cuenta de TikTok Ads con permisos para crear Data Sources en Events Manager.
</Note>

## Crear un Data Source en TikTok Events Manager

<Steps>
  <Step title="Acceder a Events Manager">
    Ve a [https://ads.tiktok.com/](https://ads.tiktok.com/) e inicia sesión con tu cuenta de TikTok Ads.

    Luego navega a la sección de Events Manager: [https://ads.tiktok.com/i18n/events\_manager](https://ads.tiktok.com/i18n/events_manager)

    Haz clic en el botón "Connect Data Source" para crear un nuevo Data Source.

    <img src="https://mintcdn.com/convertix/Ia7qM3AHG9mkgcbN/images/tiktok/tiktok-create-data-source-1.png?fit=max&auto=format&n=Ia7qM3AHG9mkgcbN&q=85&s=713278624f1ce41cde91f5219f0d5a12" alt="TikTok Events Manager - Connect Data Source" title="TikTok Events Manager" style={{ width: "78%" }} width="1680" height="878" data-path="images/tiktok/tiktok-create-data-source-1.png" />
  </Step>

  <Step title="Seleccionar tipo Web">
    Selecciona la opción "Web" como tipo de Data Source.

    <img src="https://mintcdn.com/convertix/Ia7qM3AHG9mkgcbN/images/tiktok/tiktok-create-data-source-2.png?fit=max&auto=format&n=Ia7qM3AHG9mkgcbN&q=85&s=ca7cfc65e19fc94ddcdbfda1b32149d4" alt="TikTok Events Manager - Seleccionar Web" title="TikTok Events Manager" style={{ width: "78%" }} width="880" height="586" data-path="images/tiktok/tiktok-create-data-source-2.png" />
  </Step>

  <Step title="Omitir configuración de sitio web">
    En la pantalla "Add your website", selecciona "Skip" para continuar sin configurar el sitio web en este paso.

    <img src="https://mintcdn.com/convertix/Ia7qM3AHG9mkgcbN/images/tiktok/tiktok-create-data-source-3.png?fit=max&auto=format&n=Ia7qM3AHG9mkgcbN&q=85&s=79cd6e638a4b5b8641e50db05cc06b73" alt="TikTok Events Manager - Skip website" title="TikTok Events Manager" style={{ width: "78%" }} width="559" height="370" data-path="images/tiktok/tiktok-create-data-source-3.png" />
  </Step>

  <Step title="Elegir configuración manual">
    En "Choose a data connection method", selecciona "Manual Setup".

    <img src="https://mintcdn.com/convertix/Ia7qM3AHG9mkgcbN/images/tiktok/tiktok-create-data-source-4.png?fit=max&auto=format&n=Ia7qM3AHG9mkgcbN&q=85&s=1d82fa374c67de0abe2412a7675e2243" alt="TikTok Events Manager - Manual Setup" title="TikTok Events Manager" style={{ width: "78%" }} width="559" height="398" data-path="images/tiktok/tiktok-create-data-source-4.png" />
  </Step>

  <Step title="Seleccionar Events API">
    En "Choose a manual connection method", selecciona la opción "Events API".

    <img src="https://mintcdn.com/convertix/Ia7qM3AHG9mkgcbN/images/tiktok/tiktok-create-data-source-5.png?fit=max&auto=format&n=Ia7qM3AHG9mkgcbN&q=85&s=c9b5dd3b2f3958fe69dc6836afcdc0de" alt="TikTok Events Manager - Events API" title="TikTok Events Manager" style={{ width: "78%" }} width="890" height="697" data-path="images/tiktok/tiktok-create-data-source-5.png" />
  </Step>

  <Step title="Crear el Pixel">
    Completa el nombre del pixel y haz clic en "Create".

    <img src="https://mintcdn.com/convertix/Ia7qM3AHG9mkgcbN/images/tiktok/tiktok-create-data-source-6.png?fit=max&auto=format&n=Ia7qM3AHG9mkgcbN&q=85&s=0a01028b99ca621637b52869a2eff160" alt="TikTok Events Manager - Create Pixel" title="TikTok Events Manager" style={{ width: "78%" }} width="955" height="675" data-path="images/tiktok/tiktok-create-data-source-6.png" />
  </Step>

  <Step title="Configurar eventos del funnel">
    Esta es una parte importante que requiere atención. Por defecto, TikTok mostrará muchos eventos que no necesitamos.

    Elimina los eventos que no necesites y asegúrate de tener solo estos 4 eventos configurados:

    * **View Content**
    * **Click Button**
    * **Contact**
    * **Purchase**

    Para cada evento, configura los siguientes parámetros (deja el resto vacío):

    <AccordionGroup>
      <Accordion title="View Content y Click Button">
        **Event parameters:**

        * `event_id`

        **Events API Only:**

        * `event_time`
        * `URL`

        **Customer information parameters - General:**

        * `external_id`

        **Customer information parameters - Events API Only:**

        * `ttclid`
        * `ip`
        * `user_agent`
      </Accordion>

      <Accordion title="Contact">
        **Event parameters:**

        * `event_id`

        **Events API Only:**

        * `event_time`
        * `URL`

        **Customer information parameters - General:**

        * `external_id`
        * `phone`

        **Customer information parameters - Events API Only:**

        * `ttclid`
        * `ip`
        * `user_agent`
      </Accordion>

      <Accordion title="Purchase">
        **Event parameters:**

        * `event_id`
        * `currency`
        * `value`

        **Events API Only:**

        * `event_time`
        * `URL`

        **Customer information parameters - General:**

        * `external_id`
        * `phone`

        **Customer information parameters - Events API Only:**

        * `ttclid`
        * `ip`
        * `user_agent`
      </Accordion>
    </AccordionGroup>

    <img src="https://mintcdn.com/convertix/Ia7qM3AHG9mkgcbN/images/tiktok/tiktok-create-data-source-7.png?fit=max&auto=format&n=Ia7qM3AHG9mkgcbN&q=85&s=2cfa8a3f1a16be0f37da36095b22cfe2" alt="TikTok Events Manager - Configurar eventos" title="TikTok Events Manager" style={{ width: "78%" }} width="955" height="675" data-path="images/tiktok/tiktok-create-data-source-7.png" />
  </Step>

  <Step title="Obtener Pixel ID y Access Token">
    En la pantalla "Implement Events API", verás el **Pixel ID** generado y podrás generar el **Access Token**.

    <Warning>
      Guarda el Pixel ID y el Access Token en un lugar seguro. Los necesitarás para configurar la integración en Convertix. Si no los guardas ahora, puedes volver a generarlos desde Events Manager en cualquier momento.
    </Warning>

    <img src="https://mintcdn.com/convertix/Ia7qM3AHG9mkgcbN/images/tiktok/tiktok-create-data-source-8.png?fit=max&auto=format&n=Ia7qM3AHG9mkgcbN&q=85&s=c6f2ce20a0936d54824b26a9bbdbb13a" alt="TikTok Events Manager - Pixel ID y Access Token" title="TikTok Events Manager" style={{ width: "78%" }} width="955" height="675" data-path="images/tiktok/tiktok-create-data-source-8.png" />
  </Step>

  <Step title="Obtener código de prueba">
    Para probar que todo funciona correctamente, haz clic en "Go to Test Events".

    <img src="https://mintcdn.com/convertix/Ia7qM3AHG9mkgcbN/images/tiktok/tiktok-create-data-source-9.png?fit=max&auto=format&n=Ia7qM3AHG9mkgcbN&q=85&s=4cda269a640d0b54ebe2878d8e4d8d4b" alt="TikTok Events Manager - Go to Test Events" title="TikTok Events Manager" style={{ width: "78%" }} width="955" height="675" data-path="images/tiktok/tiktok-create-data-source-9.png" />

    En la pantalla de "Test Events", copia el código de prueba que usarás en Convertix para enviar eventos de prueba a TikTok.

    <img src="https://mintcdn.com/convertix/Ia7qM3AHG9mkgcbN/images/tiktok/tiktok-create-data-source-10.png?fit=max&auto=format&n=Ia7qM3AHG9mkgcbN&q=85&s=272337c1b26fe1f1e1c378f3ec99f692" alt="TikTok Events Manager - Test Events" title="TikTok Events Manager" style={{ width: "78%" }} width="1910" height="927" data-path="images/tiktok/tiktok-create-data-source-10.png" />
  </Step>
</Steps>

## Configurar la integración en Convertix

<Steps>
  <Step title="Crear una nueva landing page">
    En Convertix, crea una nueva landing page donde configurarás la integración con TikTok.

    Primero vamos a la seccion de Páginas y vamos a crear una nueva landing page.

    <img src="https://mintcdn.com/convertix/Ia7qM3AHG9mkgcbN/images/tiktok/tiktok-convertix-landing-page-1.png?fit=max&auto=format&n=Ia7qM3AHG9mkgcbN&q=85&s=f5786f0528472da7126d56b13f308a61" alt="Convertix - Crear landing page" title="Convertix Landing Page" style={{ width: "78%" }} width="1910" height="927" data-path="images/tiktok/tiktok-convertix-landing-page-1.png" />
  </Step>

  <Step title="Configurar Pixel ID y Access Token">
    Ve a la sección de Settings de la landing page y pega el **Pixel ID** y el **Access Token** que obtuviste en TikTok Events Manager y clickeamos en "Publicar"

    <img src="https://mintcdn.com/convertix/Ia7qM3AHG9mkgcbN/images/tiktok/tiktok-convertix-landing-page-2.png?fit=max&auto=format&n=Ia7qM3AHG9mkgcbN&q=85&s=b1da0a972dbc815ec3cea61af07a3c7e" alt="Convertix - Configurar TikTok" title="Convertix Landing Page" style={{ width: "78%" }} width="1910" height="927" data-path="images/tiktok/tiktok-convertix-landing-page-2.png" />
  </Step>

  <Step title="Probar la integración">
    Después de publicar la página, en la misma sección de Settings pega el código de prueba que copiaste de TikTok y elige un evento de prueba para verificar que todo funciona correctamente.

    <img src="https://mintcdn.com/convertix/Ia7qM3AHG9mkgcbN/images/tiktok/tiktok-convertix-landing-page-3.png?fit=max&auto=format&n=Ia7qM3AHG9mkgcbN&q=85&s=a1ed34b491d378f4e2da4ecd11a1c187" alt="Convertix - Probar eventos" title="Convertix Landing Page" style={{ width: "40%" }} width="272" height="451" data-path="images/tiktok/tiktok-convertix-landing-page-3.png" />

    Vuelve a TikTok Events Manager y verifica que los eventos de prueba aparezcan correctamente.

    <img src="https://mintcdn.com/convertix/Ia7qM3AHG9mkgcbN/images/tiktok/tiktok-create-data-source-14.png?fit=max&auto=format&n=Ia7qM3AHG9mkgcbN&q=85&s=2ebedada47373bfa6a3d20c4a6e840b0" alt="TikTok Events Manager - Verificar eventos" title="TikTok Events Manager" style={{ width: "70%" }} width="1712" height="836" data-path="images/tiktok/tiktok-create-data-source-14.png" />
  </Step>
</Steps>

<Note>
  ¡Listo! La integración está configurada. Ahora puedes usar esta landing page en tus campañas de TikTok Ads.
</Note>

## Cómo funciona la integración

Cuando configures tus anuncios de TikTok Ads para que apunten a la landing page creada en Convertix, el sistema funcionará de la siguiente manera:

<Steps>
  <Step title="Usuario hace clic en el anuncio">
    Cuando un usuario hace clic en tu anuncio de TikTok, se redirige a la landing page de Convertix.
  </Step>

  <Step title="TikTok genera un ID único">
    TikTok genera automáticamente un ID único (`ttclid`) que identifica a ese usuario específico.
  </Step>

  <Step title="Convertix envía eventos">
    Convertix usa este ID para identificar al usuario y enviar todos los eventos que se generen en la landing page directamente a TikTok.
  </Step>
</Steps>

## Eventos que se envían a TikTok

Convertix envía automáticamente los siguientes eventos a TikTok:

* **View Content**: Se envía cuando el usuario entra a la landing page
* **Click Button**: Se envía cuando el usuario hace clic en el botón de WhatsApp
* **Contact**: Se envía cuando el usuario envía el primer mensaje a WhatsApp
* **Purchase**: Se envía cuando el usuario envía un comprobante de pago a WhatsApp

<Note>
  Estos eventos te permiten medir el rendimiento de tus anuncios y optimizar tus campañas de TikTok Ads basándote en conversiones reales.
</Note>