Zum Hauptinhalt springen

View-Skript-Konfiguration

Diese Seite beschreibt die Konfigurationsparameter für das view-Skript bei der Aufgabenerstellung.

Übersicht​

Das view-Skript öffnet einen Beitrag auf TikTok oder Instagram und sieht ihn für eine konfigurierbare Dauer an — nützlich zur Steigerung der Wiedergabezeit / der Impressionen. Wenn Sie über die API mehrere Ziel-Beitrags-URLs angeben, wird für jede URL eine Aufgabe erstellt. Sie können den Ausführungszeitpunkt jeder Aufgabe mit dem start_time-Parameter steuern.

Skript-Konfiguration (script_config)​

Das script_config-Objekt enthält die Konfigurationsparameter für das View-Skript. Nachfolgend sind die verfügbaren Parameter aufgeführt:

Parameter​

ParameterTypErforderlichStandardBeschreibung
target_post_urlsstring[]Yes*[]Array von Ziel-Beitrags-URLs zum Ansehen (eine Aufgabe pro URL)
target_post_urlstringYes*""Einzelne Ziel-Beitrags-URL oder mehrere URLs, getrennt durch Zeilenumbrüche/Kommas
view_durationintegerNo10Sekunden, die der Beitrag angesehen wird
view_durationsinteger[]No—[min, max]-Bereich in Sekunden; ein Zufallswert in diesem Bereich wird verwendet. Hat Vorrang vor view_duration
hinweis

Es muss entweder das target_post_urls-Array oder die target_post_url-Zeichenkette angegeben werden. Wenn beide angegeben sind, hat target_post_urls Vorrang.

Aufgabenerstellung

Bei mehreren Ziel-Beitrags-URLs erstellt die API eine Aufgabe pro URL. Beispiel: Bei 3 Beitrags-URLs und 2 Geräten werden 6 Aufgaben erstellt. Verwenden Sie den start_time-Parameter, um die Startzeit der Aufgaben zu steuern.

Beispiele​

Einen Beitrag ansehen​

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"
    }
  }'

Beitrag mit fixer Ansehdauer ansehen​

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
    }
  }'

Beitrag mit zufälliger Ansehdauer ansehen​

Eine zufällige Wiedergabezeit zwischen 15 und 45 Sekunden pro Aufgabe:

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]
    }
  }'

Beiträge per Benutzernamen-Liste ansehen​

View-Aufgaben direkt für bestimmte Konten erstellen:

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
    }
  }'

Instagram-Beispiel​

Dieselbe API funktioniert auch für Instagram-Beiträge und -Reels:

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]
    }
  }'

Antwort​

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

Beitrags-URL-Formate​

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/

Best Practices​

  1. Ansehdauer variieren: Bevorzugen Sie view_durations gegenüber einem fixen view_duration, damit jeder Aufruf natürlicher wirkt.

  2. Aufgaben planen: Verwenden Sie den start_time-Parameter, um Aufrufe zeitlich zu verteilen.

  3. Multi-Account-Modus nutzen: Aktivieren Sie enable_multi_account, um Beiträge mit mehreren Konten auf demselben Gerät anzusehen.

Fehlercodes​

CodeDescription
40001Fehlende Ziel-Beitrags-URL
40003Skript wird über API nicht unterstützt
40301API-Zugang erfordert Pro+-Plan

Siehe auch​