Configurazione Script View

Questa pagina documenta i parametri di configurazione dello script view per la creazione di attività.

Panoramica

Lo script view apre un post su TikTok o Instagram e lo guarda per una durata configurabile — utile per aumentare il tempo di visualizzazione/le impression. Quando fornisci più URL di post tramite API, viene creata un'attività per ogni URL. Puoi controllare quando viene eseguita ogni attività usando il parametro start_time.

Configurazione dello Script (script_config)

L'oggetto script_config contiene i parametri dello script view. Di seguito sono elencati i parametri disponibili:

Parametri

Parametro	Tipo	Richiesto	Predefinito	Descrizione
target_post_urls	string[]	Sì*	[]	Array di URL di post da visualizzare (un'attività per URL)
target_post_url	string	Sì*	""	URL singolo o più URL separati da a capo/virgole
view_duration	integer	No	10	Secondi per guardare il post
view_durations	integer[]	No	—	Intervallo [min, max] in secondi; viene usato un valore casuale nell'intervallo. Ha priorità su view_duration

note

È necessario fornire l'array target_post_urls o il string target_post_url. Se vengono forniti entrambi, target_post_urls ha la priorità.

Creazione Attività

Quando vengono forniti più URL, l'API crea un'attività per ogni URL. Ad esempio, 3 URL + 2 dispositivi = 6 attività. Usa il parametro start_time per controllare quando viene eseguita ogni attività.

Esempi

Guardare un Post

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "view",
    "script_config": {
      "target_post_url": "https://www.tiktok.com/@username/video/1234567890"
    }
  }'

Guardare con Durata Fissa

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "view",
    "script_config": {
      "target_post_url": "https://www.tiktok.com/@username/video/1234567890",
      "view_duration": 30
    }
  }'

Guardare con Durata Casuale

Viene utilizzato un tempo di visualizzazione casuale tra 15 e 45 secondi per attività:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "view",
    "script_config": {
      "target_post_urls": [
        "https://www.tiktok.com/@user1/video/111",
        "https://www.tiktok.com/@user2/video/222"
      ],
      "view_durations": [15, 45]
    }
  }'

Guardare per Lista Utenti

Crea attività di visualizzazione per account specifici:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "usernames": ["@my_account1", "@my_account2"],
    "script_name": "view",
    "script_config": {
      "target_post_url": "https://www.tiktok.com/@target/video/123",
      "view_duration": 20
    }
  }'

Esempio Instagram

La stessa API funziona per post e reel di Instagram:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "view",
    "script_config": {
      "target_post_url": "https://www.instagram.com/reel/ABC123/",
      "view_durations": [10, 30]
    }
  }'

Risposta

{
  "code": 0,
  "message": "success",
  "data": {
    "task_ids": [501, 502],
    "created_count": 2
  }
}

Formati URL

TikTok

https://www.tiktok.com/@username/video/1234567890123456
https://vm.tiktok.com/ABCDEFG/

Instagram

https://www.instagram.com/p/ABCDEFGHIJK/
https://www.instagram.com/reel/ABCDEFGHIJK/

Threads

https://www.threads.com/@username/post/ABCDEFGHIJK
https://www.threads.com/t/ABCDEFGHIJK

I link threads.net funzionano anche. Un link /share/ non funziona: il suo codice è un identificatore diverso da quello usato da una pagina di post, quindi viene rifiutato anziché convertito in un URL che non punta a nulla.

Buone Pratiche

1. Varia il tempo di visualizzazione: Preferisci view_durations a un view_duration fisso per rendere ogni visualizzazione più naturale.

2. Pianifica le attività: Usa il parametro start_time per distribuire le visualizzazioni nel tempo.

3. Usa la modalità multi-account: Abilita enable_multi_account per visualizzare post usando più account sullo stesso dispositivo.

Codici di Errore

Codice	Descrizione
40001	URL del post di destinazione mancante
40003	Script non supportato tramite API
40301	L'accesso all'API richiede il piano Pro+

Vedi Anche

• Configurazione Script Like - Mettere mi piace ai post
• Configurazione Script Favorite - Salvare post nei Preferiti
• API di Gestione Attività - Creare, elencare e gestire le attività
• Panoramica dell'API Locale - Panoramica API e avvio rapido