TikTok अभियान रिपोर्टिंग सार्वजनिक पोस्ट मैट्रिक्स के साथ

TL;DR:

• TikTok अभियान रिपोर्टिंग एक उपयोगकर्ता-परिभाषित सूची के साथ शुरू होती है। किसी एकत्रित रिकॉर्ड से मेल खाने से पहले अभियान खातों और पोस्ट आईडी की सूची बनाएं।
• एक अभियान पोस्ट का एकत्रित नमूने में अस्तित्व होना आवश्यक है। गायब पोस्ट को शून्य प्रदर्शन में परिवर्तित करने के बजाय अनुपयुक्त सूची प्रविष्टियों को स्पष्ट रखें।
• टाइमस्टैम्प किए गए स्नैपशॉट संचयी काउंटर को डेल्टा में परिवर्तित करते हैं। जब दोनों रिकॉर्डों में समान पोस्ट आईडी और मैट्रिक हो, तो एक पोस्ट के पहले देखे गए मूल्य को उसके बाद देखे गए मूल्य से घटाएं।
• सार्वजनिक संलग्नता का अर्थ आश्रय नहीं है। प्ले, लाइक, टिप्पणी, साझा, संग्रह, और पुनःप्रकाशन की गिनती अद्वितीय पहुंच, बिक्री, या ROI को प्रमाणित नहीं करती है।
• वितरण अभियान का आकार दिखाता है। कुलों के साथ मध्य, रेंज, और शीर्ष-पोस्ट साझा रिपोर्ट करें।
• शुरू करने के लिए स्वतंत्र। नए Scrapeless खातों में मुफ्त क्रेडिट शामिल हैं; Scrapeless डैशबोर्ड में एक खाता बनाएं।

Introduction: अभियान सदस्यता स्पष्ट होनी चाहिए

सार्वजनिक पोस्ट मैट्रिक्स एक संकीर्ण प्रश्न का उत्तर देते हैं: एक ज्ञात पोस्ट के लिए एक रिकॉर्ड किए गए समय पर कौन से काउंटर दृश्य थे? ये यह पहचान नहीं करते कि किसने पोस्ट देखा, किसने उत्पाद खरीदा, या कौन सी इंटरैक्शन ने एक रूपांतरण का कारण बनाया।

यह गाइड उस सीमा के चारों ओर TikTok अभियान रिपोर्टिंग बनाती है। एक उपयोगकर्ता भाग लेने वाले खातों और पोस्ट आईडी प्रदान करता है, पाइपलाइन उन आईडी को एकत्रित सार्वजनिक पोस्ट नमूनों के खिलाफ मेल करती है, और बार-बार स्नैपशॉट मैट्रिक डेल्टा उत्पन्न करते हैं। अंतिम रिपोर्ट मेल खा रहे पोस्ट, अनुपयुक्त सूची प्रविष्टियों, संचयी मूल्यों, और अंतराल परिवर्तनों को अलग करती है।

पोस्ट संग्रह से पहले के खाता-समाधान कदम के लिए, TikTok प्रोफ़ाइल स्क्रैपर गाइड देखें।

Pipeline at a Glance

एक सार्वजनिक-पोस्ट अभियान रिपोर्ट के छह चरण हैं:

1. अभियान सूची और रिपोर्टिंग सीमाओं को परिभाषित करें।
2. प्रत्येक सूचीबद्ध सार्वजनिक खाते को sec_uid पर हल करें।
3. प्रत्येक खाते के लिए सीमित पोस्ट नमूना एकत्र करें।
4. एकत्रित वस्तुओं को प्रदान किए गए अभियान पोस्ट आईडी से मेल करें।
5. टाइमस्टैम्प किए गए मैट्रिक स्नैपशॉट सहेजें और तुलनीय डेल्टा की गणना करें।
6. मेल खा रहे कवरेज, वितरण, और उल्लेखनीय पोस्ट का सारांश बनाएं।

सूची इस रिपोर्ट के लिए आश्रय सदस्यता को परिभाषित करती है। स्क्रैपर यह पता नहीं लगाता है कि कौन-से पोस्ट अभियान में शामिल हैं, और केवल एक उल्लेख या हैशटैग के आधार पर किसी पोस्ट को नहीं जोड़ा जाना चाहिए जब तक कि रिपोर्टिंग नियम इसके लिए न कहें।

Prerequisites

• एक Scrapeless खाता और Scrapeless डैशबोर्ड से API टोकन
• एक अभियान सूची जिसमें खाता उपयोगकर्ता नाम और सटीक पोस्ट आईडी शामिल हो
• एक निश्चित संग्रह नीति और डेल्टा के लिए कम से कम दो टाइमस्टैम्पेड अवलोकन
• नीचे के कोड के लिए SCRAPELESS_API_KEY के रूप में एक लाइव टोकन निर्यातित

उदाहरण में एक आवश्यकताओं का अंतर है क्योंकि यह पाठक के API क्रेडेंशियल, अभियान सूची, और लाइव सार्वजनिक पोस्ट पर निर्भर करता है। कोई नमूना आउटपुट एक वास्तविक अभियान परिणाम के रूप में प्रस्तुत नहीं किया गया है।

Stage 1: Build the Campaign Roster

सूची रिपोर्ट के लिए नियंत्रण तालिका है। प्रत्येक पंक्ति में एक अभियान आईडी, सार्वजनिक उपयोगकर्ता नाम, पोस्ट आईडी, अपेक्षित पोस्ट URL (यदि ज्ञात हो), यदि अभियान टीम द्वारा प्रदान की गई, तो नियोजित प्रकाशन तिथि, और एक मानव-पढ़ने योग्य लेबल होना चाहिए।

पोस्ट आईडी को स्ट्रिंग के रूप में रखें। बड़े पहचानकर्ता स्प्रेडशीट या एनालिटिक्स उपकरणों में संख्याओं में परिवर्तित होने पर सटीकता खो सकते हैं।

सूची आवश्यक और वैकल्पिक पोस्ट को भी भेदना चाहिए। एक आवश्यक पोस्ट जो एकत्रित नमूने में नहीं है, उसे unmatched स्थिति और एक समीक्षा नोट की आवश्यकता है; उसके मैट्रिक्स अज्ञात हैं, शून्य नहीं।

Stage 2: Collect Public Posts for Listed Accounts

संग्रह पथ scraper.tiktok.user.detail का उपयोग करके unique_id को sec_uid में हल करता है, इसके बाद सार्वजनिक पोस्ट अनुरोध के लिए scraper.tiktok.user.work का उपयोग करता है। पोस्ट अनुरोध cursor और count का समर्थन करता है, और इसकी प्रतिक्रिया में items एरे होता है।

तुलनीय खातों के लिए समान अनुरोधित संख्या का उपयोग करें, लेकिन प्रत्येक के लिए लौटाई गई संख्या की रिपोर्ट करें। उपलब्ध दस्तावेज़ कर्सर इनपुट की पुष्टि करते हैं बिना एक सार्वभौमिक पूर्ण-इतिहास लूप स्थापित किए। यदि कोई अभियान पोस्ट एकत्रित नमूने के बाहर है, तो उसे अनमैचेड के रूप में चिह्नित करें और केवल वर्तमान प्रतिक्रिया और दस्तावेज में सत्यापित एक निरंतरता नियम के माध्यम से संग्रह का विस्तार करें।

प्रत्येक संग्रह रन को अपनी स्वयं की UTC टाइमस्टैम्प की आवश्यकता होती है। पोस्ट-स्तरीय मैट्रिक्स को पुनर्निर्माण करने के लिए वह कच्चा अभिनेता प्रतिक्रिया उस रन के तहत संग्रहीत करें यदि रिपोर्ट लॉजिक बदलता है।

Scrapeless के साथ स्क्रैपिंग शुरू करें

Scrapeless के साथ अपने वेब स्क्रैपिंग और ऑटोमेशन वर्कफ़्लो को पावर करें!
आज ही साइन अप करें और $5 का मुफ्त क्रेडिट प्राप्त करें — कोई क्रेडिट कार्ड आवश्यक नहीं।
अपने मुफ्त क्रेडिट को Scrapeless Dashboard में तुरंत प्राप्त करें।

चरण 3: बिना gaps को छिपाए पोस्ट मिलाना

जहां संभव हो, वहां सटीक स्ट्रिंग पोस्ट आईडी पर मिलाएं। URL समीक्षकों की मदद कर सकते हैं, लेकिन URL पार्सिंग को एक स्थिर पहचानकर्ता को बदलने के लिए प्रयोग नहीं किया जाना चाहिए जब दोनों उपलब्ध हों।

मिलान तालिका को हर रोस्टर पंक्ति को बनाए रखना चाहिए:

यह पुनर्निर्धारण चरण अभियान संचालन और सार्वजनिक डेटा संग्रह के बीच ऑडिट ट्रेल है। यह डैशबोर्ड को चुपचाप एक आवश्यक पोस्ट को गिराने या एक असंबंधित को जोड़ने से रोकता है क्योंकि इसने एक समान हैशटैग का उपयोग किया।

चरण 4: समय-चिह्नित मेट्रिक स्नैपशॉट्स को संग्रहित करें

एक स्नैपशॉट पंक्ति में अभियान आईडी, पोस्ट आईडी, खाते, पोस्ट URL, संग्रहण समय, निर्माण समय, और प्रतिक्रिया में मौजूद प्रत्येक सार्वजनिक काउंटर शामिल होना चाहिए। गायब फ़ील्ड को शून्य के बजाय शून्य के रूप में सहेजें।

SQLite एक कॉम्पैक्ट स्थानीय इतिहास के लिए अच्छी तरह से काम करता है क्योंकि एक समग्र कुंजी डुप्लिकेट अवलोकनों को रोक सकती है। SQLite CREATE TABLE दस्तावेज़ प्राथमिक कुंजी और तालिका सीमाओं का वर्णन करता है जो प्रत्येक पोस्ट और संग्रहण समय के लिए एक पंक्ति को लागू कर सकता है।

CREATE TABLE IF NOT EXISTS campaign_post_snapshots (
    campaign_id TEXT NOT NULL,
    post_id TEXT NOT NULL,
    collected_at TEXT NOT NULL,
    account TEXT NOT NULL,
    post_url TEXT,
    play_count INTEGER,
    like_count INTEGER,
    comment_count INTEGER,
    share_count INTEGER,
    collect_count INTEGER,
    repost_count INTEGER,
    PRIMARY KEY (campaign_id, post_id, collected_at)
);

यह स्थानीय योजना का कोई बाहरी पूर्वापेक्षा नहीं है और इसे एक API क्रेडेंशियल उपलब्ध होने से पहले परीक्षण किया जा सकता है। नीचे दिया गया संग्रहण कोड समान तालिका बनाता है और मिलाए गए रिकॉर्ड्स को सम्मिलित करता है।

चरण 5: डेल्टास और प्रदर्शन वितरण की गणना करें

एक मेट्रिक डेल्टा समान पोस्ट और फ़ील्ड के लिए बाद में देखे गए मान को पहले देखे गए मान से घटाकर प्राप्त किया जाता है। इसे केवल तभी गणना करें जब दोनों मान मौजूद हों। यदि एक प्लेटफ़ॉर्म सुधार या फ़ील्ड रीसेट एक नकारात्मक परिणाम produces करता है, तो इसे शून्य में फिर से लिखने के बजाय समीक्षा के लिए बनाए रखें।

पोस्ट की तुलना करते समय स्नैपशॉट समय के एक साझा जोड़े का उपयोग करें। 72 घंटों के लिए देखे गए पोस्ट को 6 घंटों के लिए देखे गए पोस्ट के खिलाफ सीधे रैंक नहीं किया जाना चाहिए जब तक कि एक स्पष्ट आयु या अंतराल लेबल न हो।

अभियान सारांश कई दृश्यों से लाभ उठाते हैं:

• रोस्टर पोस्ट द्वारा विभाजित मेल खाता पोस्ट
• नवीनतम संचित मेट्रिक कुल
• सामान्य स्नैपशॉट अंतराल पर प्रति-पोस्ट डेल्टास
• प्रत्येक मेट्रिक के लिए माध्यिका और रेंज
• कुल देखे गए प्रदर्शनों या इंटरैक्शंस का शीर्ष पोस्ट हिस्सा
• शून्य मेट्रिक्स और अमिलित रोस्टर प्रविष्टियों की गणना

Python's आंकड़े मॉड्यूल दस्तावेज़ माध्यिका की गणनाओं को परिभाषित करता है। एक वितरण दृश्य प्रदर्शन को व्यापक या संकेंद्रित दिखाने में मदद करता है, लेकिन यह सार्वजनिक काउंटर्स का वर्णन ही रहता है।

TikTok Ads Manager भुगतान अभियान रिपोर्टिंग के लिए एक अलग पहले-पार्टी वातावरण प्रदान करता है। इसका अभियान प्रदर्शन मार्गदर्शन इस सार्वजनिक-पोस्ट कार्यप्रवाह के साथ नहीं मिलाना चाहिए: डेटा स्रोत, पहुंच, और उपलब्ध मेट्रिक्स भिन्न होते हैं।

चरण 6: Python में रिपोर्टिंग पाइपलाइन को इकट्ठा करें

निम्नलिखित स्क्रिप्ट एक रोस्टर CSV को पढ़ती है, प्रत्येक सूचीबद्ध खाते के लिए सीमित प्रारंभिक नमूना एकत्र करती है, सटीक पोस्ट आईडी को पुनर्निर्धारित करती है, SQLite में मेल खाती स्नैपशॉट को सम्मिलित करती है, और समीक्षा के लिए एक कवरेज फ़ाइल लिखती है।

नोट: नीचे दिया गया कोड SCRAPELESS_API_KEY में एक सक्रिय Scrapeless API टोकन, एक पाठक-सप्लाइड campaign-roster.csv, और एकत्रित नमूनों में दिखाई देने वाले सार्वजनिक अभियान पोस्ट की आवश्यकता है।

import csv
import json
import os
import sqlite3
from datetime import datetime, timezone
from urllib.request import Request, urlopen

ENDPOINT = "https://api.scrapeless.com/api/v1/scraper/request"
TOKEN = os.environ["SCRAPELESS_API_KEY"]
REQUESTED_COUNT = 35


def run_actor(actor, actor_input):
    data = json.dumps({"actor": actor, "input": actor_input}).encode()
    request = Request(
        ENDPOINT,
        data=data,
        headers={"x-api-token": TOKEN, "content-type": "application/json"},
        method="POST",
    )
    with urlopen(request, timeout=60) as response:
        return json.load(response)


with open("campaign-roster.csv", newline="", encoding="utf-8") as roster_file:
    roster = list(csv.DictReader(roster_file))

for row in roster:
    row["username"] = row["username"].lstrip("@")
    row["post_id"] = str(row["post_id"])

collected_at = datetime.now(timezone.utc).isoformat()
items_by_account = {}

for username in sorted({row["username"] for row in roster}):
    profile = run_actor("scraper.tiktok.user.detail", {"unique_id": username})
    response = run_actor(
        "scraper.tiktok.user.work",
        {"sec_uid": profile["sec_uid"], "cursor": "0", "count": REQUESTED_COUNT},
    )
    with open(f"{username}-{collected_at[:10]}-raw.json", "w", encoding="utf-8") as raw_file:
        json.dump(response, raw_file, ensure_ascii=False, indent=2)
    items_by_account[username] = {
        str(item.get("id") or item.get("post_id") or ""): item
        for item in response.get("items") or []
    }

connection = sqlite3.connect("campaign-reporting.db")
connection.execute("""
CREATE TABLE IF NOT EXISTS campaign_post_snapshots (
    campaign_id TEXT NOT NULL,
    post_id TEXT NOT NULL,
    collected_at TEXT NOT NULL,
    account TEXT NOT NULL,
    post_url TEXT,
    play_count INTEGER,
    like_count INTEGER,
    comment_count INTEGER,
    share_count INTEGER,
    collect_count INTEGER,
    repost_count INTEGER,
    PRIMARY KEY (campaign_id, post_id, collected_at)
)
""")

coverage = []
for row in roster:
    item = items_by_account.get(row["username"], {}).get(row["post_id"])
    status = "matched" if item else "unmatched"
    coverage.append({**row, "status": status, "collected_at": collected_at})
    if not item:
        continue
    connection.execute(
        """INSERT OR REPLACE INTO campaign_post_snapshots VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)""",
        (
            row["campaign_id"], row["post_id"], collected_at, row["username"],
            item.get("url") or item.get("post_url"), item.get("play_count"),
            item.get("like_count"), item.get("comment_count"), item.get("share_count"),
            item.get("collect_count"), item.get("repost_count"),
        ),
    )

connection.commit()
connection.close()

with open("campaign-coverage.csv", "w", newline="", encoding="utf-8") as output:
    writer = csv.DictWriter(output, fieldnames=coverage[0].keys())
    writer.writeheader()
    writer.writerows(coverage)

अगले नियोजित अवलोकन समय पर उसी संग्रहण को चलाएं, फिर अभियान आईडी और पोस्ट आईडी द्वारा लगातार स्नैपशॉट पंक्तियों को जोड़ें। परिणाम में केवल उन मेट्रिक मानों के लिए प्रत्येक डेल्टा की गणना करें जो शून्य नहीं हैं, और परिणाम में दो संग्रहण समय चिह्नों को बनाए रखें।

अभियान रिपोर्ट टेम्पलेट

रिपोर्ट को प्रदर्शन से कवरेज को अलग करना चाहिए:

अभियान डेटा को जिम्मेदारी से संभालें

अभियान रिपोर्टिंग सार्वजनिक निर्माताओं के सामग्री को अनुबंधों, आंतरिक लेबलों, या वाणिज्यिक निर्णयों के साथ जोड़ सकती है। रोस्टर और आंतरिक अंकन तक पहुंच को सीमित करें, रखे गए व्यक्तिगत डेटा को न्यूनतम करें, और परिभाषित करें कि श्रेय त्रुटि को कौन सही कर सकता है।

प्रभावक कार्यक्रमों के लिए, FTC का प्रकटीकरण मार्गदर्शन संयुक्त राज्य अमेरिका में प्रकटीकरण जिम्मेदारियों के लिए एक उपयोगी प्रारंभिक संदर्भ है। यह कानूनी सलाह या किसी अन्य क्षेत्राधिकार में लागू नियमों के स्थान पर नहीं है।

Scrapeless प्रोफ़ाइल और पोस्ट अभिनेताओं को Scraping API के माध्यम से प्रदान करता है। खाता गणनाओं और स्नैपशॉट आवृत्ति को चुनने से पहले वर्तमान मूल्य निर्धारण पृष्ठ की समीक्षा करें।

निष्कर्ष: रिपोर्ट करें कि स्नैपशॉट क्या साबित करते हैं

TikTok अभियान रिपोर्टिंग को एक स्पष्ट रोस्टर, सटीक पोस्ट-ID मिलान, समय-बद्ध अवलोकन, और दृश्यमान कवरेज गैप की आवश्यकता होती है। ये नियंत्रण सार्वजनिक काउंटरों को मेल खाते हुए पोस्ट और मीट्रिक परिवर्तनों का अंकेक्षित रिकॉर्ड बनाते हैं जबकि पहुंच, बिक्री, और श्रेय दावों को उनके उचित डेटा स्रोतों में रखते हैं।

क्या आप अभियान मीट्रिक्स रिपोर्ट बनाने के लिए तैयार हैं?

डेटा-मॉडलिंग पैटर्न की तुलना के लिए Scrapeless Discord या Telegram सामुदायिक में शामिल हों। जब अभियान रोस्टर तैयार हो जाए, तो Scrapeless Dashboard में एक खाता बनाएं।

सामान्य प्रश्न

प्रश्न: सार्वजनिक पोस्ट मीट्रिक्स के साथ TikTok अभियान रिपोर्टिंग क्या है?

सार्वजनिक पोस्ट मीट्रिक्स के साथ TikTok अभियान रिपोर्टिंग रिकॉर्ड किए गए समय पर अभियान पोस्ट के एक उपयोगकर्ता द्वारा परिभाषित सेट के लिए दृश्य काउंटरों को ट्रैक करती है। यह उन अवलोकनों और उनके परिवर्तनों को मापती है, न कि अद्वितीय पहुंच, बिक्री, या कारण संबंध।

प्रश्न: कार्यप्रवाह कैसे तय करता है कि कौन से पोस्ट अभियान का हिस्सा हैं?

उपयोगकर्ता-प्रदत्त रोस्टर अभियान सदस्यता तय करता है। पाइपलाइन सटीक पोस्ट IDs का मिलान करती है और प्रदर्शन कुल से छूटे हुए या अप्रत्याशित पोस्ट को बाहर रखती है जब तक कि उनका पुनरावलोकन नहीं किया जाता।

प्रश्न: मीट्रिक स्नैपशॉट और डेल्टा में क्या अंतर है?

स्नैपशॉट एक समय पर देखी गई संचयी सार्वजनिक काउंटर है। डेल्टा एक ही पोस्ट, मीट्रिक, और परिभाषित अंतराल के लिए दो मान्य स्नैपशॉट के बीच का अंतर है।

प्रश्न: क्या प्ले काउंट को अभियान पहुंच के रूप में रिपोर्ट किया जा सकता है?

प्ले काउंट को अद्वितीय अभियान पहुंच के रूप में रिपोर्ट नहीं किया जाना चाहिए। यह एक सार्वजनिक पोस्ट काउंटर है और यह स्थापित नहीं करता कि कितने अलग-अलग लोगों ने सामग्री देखी।

प्रश्न: क्या बिना मेल खाने वाले अभियान पोस्ट को शून्य मीट्रिक्स प्राप्त करनी चाहिए?

बिना मेल खाने वाले अभियान पोस्ट को unmatched स्थिति और शून्य मीट्रिक्स प्राप्त करनी चाहिए। शून्य एक अवलोकित मान को स्पष्ट करेगा जिसे संग्रह ने उत्पन्न नहीं किया।

प्रश्न: क्या कार्यप्रवाह TikTok Ads Manager को प्रतिस्थापित करता है?

सार्वजनिक-पोस्ट कार्यप्रवाह TikTok Ads Manager या अन्य पहले-पक्ष अभियान सिस्टम को प्रतिस्थापित नहीं करता है। यह समर्थित सार्वजनिक पोस्ट क्षेत्रों से एक अलग डेटा सेट उत्पन्न करता है।

प्रश्न: क्या सार्वजनिक अभियान डेटा संग्रह कानूनी है?

कानूनीता क्षेत्राधिकार, उद्देश्य, डेटा, एक्सेस विधि, अनुबंधों, और लागू शर्तों पर निर्भर करती है। आवश्यक सार्वजनिक क्षेत्रों तक संग्रह सीमित करें, आंतरिक रोस्टर डेटा की सुरक्षा करें, और विशेष कार्यक्रम के लिए कानूनी सलाह प्राप्त करें।