jsonscraper
الأسواق
العودة إلى المجلة

التحقق من ملفات IG قبل الحملة الإعلانية: تقرير بالفروقات باستخدام Python

استخرج المعلومات العامة عن الحسابات الواردة في الموجز، وأنشئ جدولًا بالاستثناءات قبل إطلاق الحملة

السياسة التحريرية الإبلاغ عن خطأ

يساعد التحقق من حسابات IG قبل إطلاق الحملة على اكتشاف الأخطاء في قائمة مواضع الإعلان ما دام إصلاحها سهلًا. فقد يتضمن الموجز خطأً مطبعيًا في اسم مستخدم، أو حسابًا مكررًا، أو ملفًا شخصيًا بعدد متابعين غير متوقع. فيما يلي برنامج Python صغير يطلب بيانات عامة لكل اسم مستخدم، ويقارن الاستجابة بشروطك، ويحفظ الصفوف التي يمكن التحقق منها في ملف CSV.

ما النتيجة التي ستحصل عليها

يُدخل البرنامج ملف CSV يضم قائمة الحسابات والقيم المتوقعة الاختيارية. وينتج صفًا مستقلًا لكل اسم مستخدم تتم معالجته، يتضمن حالة الطلب واسم الملف الشخصي وعلامة التحقق وعدد المتابعين والمنشورات والحسابات التي يتابعها، فضلًا عن قائمة موجزة بالفروقات المكتشفة.

المقال: التحقق من ملفات IG قبل الحملة الإعلانية: تقرير بالفروقات باستخدام Python
الملخص: إذا تضمن الموجز أسماء حسابات خاطئة أو مسافات زائدة أو ملفًا شخصيًا غير مناسب، فقد لا يكتشف الفريق ذلك إلا بعد إعداد الحملة. نوضح كيفية التحقق من أسماء مستخدمي IG عبر نقطة النهاية الموثقة في jsonscraper، وتصدير الفروقات المرصودة إلى ملف CSV.
دور الصورة: غلاف — الفكرة الأساسية
القسم: ما النتيجة التي ستحصل عليها
الموضوع المرئي: صورة تحريرية «
يجمع التقرير حقول الملف الشخصي التي جرى التحقق منها وملاحظات للمراجعة اليدوية قبل إطلاق الحملة.© jsonscraper · أُنشئت باستخدام الذكاء الاصطناعي

يفيد هذا التقرير المسوّق الذي يطابق بيانات المتعاقدين مع الموجز، والمطوّر الذي ينشئ فحصًا داخليًا ضمن مهمة دورية. وهو يتحقق من حقول محددة في الملف الشخصي العام وقت الطلب؛ أما الحكم اليدوي على مدى ملاءمة الحساب للحملة فيبقى من مسؤولية الفريق.

ما الحقول التي يمكن التحقق منها

تقبل نقطة النهاية الموثقة في IG API، وهي /v1/user/by/username، المعامل الإلزامي username. وفي صيغة الاستجابة المرصودة، توجد بيانات الملف الشخصي في الكائن ig؛ ومن الحقول التي أُعيدت: username وfull_name وis_private وis_verified وmedia_count وfollower_count وfollowing_count وbiography. قد لا تتوفر جميع الحقول دائمًا، لذا يسجل البرنامج أدناه القيم المفقودة فارغة ولا يحولها إلى أصفار. وترد قائمة نقاط النهاية وأسماء المعاملات في مرجع IG API.

يكون التحقق أوضح ما يكون عند استخدام شروط يمكن تحديدها صراحةً: أن يكون الملف الشخصي عامًا، وأن يقع عدد المتابعين ضمن نطاق محدد، وأن تطابق علامة التحقق ما يطلبه الموجز. ويمكن حفظ النبذة لمراجعتها لاحقًا، لكن مقارنة نصها آليًا مع التوجه التسويقي تتطلب معيارًا منفصلًا.

إعداد ملف الإدخال

أنشئ ملف profiles.csv بترميز UTF-8. ويتضمن الحد الأدنى اسم المستخدم فقط؛ واترك الحقول المتوقعة الإضافية فارغة إذا لم يحدد الموجز شرطًا لها:

username,min_followers,max_followers,verified
brand_example,5000,50000,false
creator_example,10000,,true

يحدد الحقلان min_followers وmax_followers حدود التحقق. ويقبل الحقل verified القيمة true أو false. ويمكن تحديد الشروط المنطبقة فقط لكل ملف شخصي.

طلب البيانات وإنشاء التقرير

ثبّت مكتبة requests واضبط المفتاح في بيئة العملية بدلًا من وضعه في الملف المصدري. ويكون الأمر على macOS أو Linux كما يلي:

المقال: التحقق من ملفات IG قبل الحملة الإعلانية: تقرير بالفروقات باستخدام Python
الملخص: إذا تضمن الموجز أسماء حسابات خاطئة أو مسافات زائدة أو ملفًا شخصيًا غير مناسب، فقد لا يكتشف الفريق ذلك إلا بعد إعداد الحملة. نوضح كيفية التحقق من أسماء مستخدمي IG عبر نقطة النهاية الموثقة في jsonscraper، وتصدير الفروقات المرصودة إلى ملف CSV.
دور الصورة: رسم توضيحي داعم 2 — جانب محدد مختلف
القسم: طلب البيانات وإنشاء التقرير
الموضوع المرئي: مخطط يوضح المسار من قائمة الحسابات في CSV إلى التقرير الذي تبقى فيه الحقول الفارغة فارغة، وتُعلّم فيه المطابقات للقواعد على نحو منفصل
يوضح المخطط المسار من ملف CSV الذي يضم قائمة الحسابات إلى التقرير، مع إبقاء الحقول الفارغة كما هي وتمييز حالات مطابقة القواعد على حدة.© jsonscraper · رسم توضيحي مُنشأ بالذكاء الاصطناعي
python -m pip install requests
export JSONSCRAPER_INSTAGRAM_LICENSE_KEY='ваш-ключ'

احفظ البرنامج النصي أدناه باسم check_profiles.py. يستخدم Python 3.8 أو أحدث، ويتحقق من حالة استجابة HTTP، ويقرأ حمولة البيانات ig على نحو منفصل، ثم ينشئ الملف profile_check.csv. يُمرر المفتاح باعتباره معامل استعلام license_key، وفقًا لما توضحه وثائق الخدمة.

import csv
import os
import sys
from typing import Dict, List, Optional

import requests

API_URL = "https://ig.jsonscraper.com/v1/user/by/username"
API_KEY = os.environ.get("JSONSCRAPER_INSTAGRAM_LICENSE_KEY")

if not API_KEY:
    raise SystemExit("Задайте JSONSCRAPER_INSTAGRAM_LICENSE_KEY")


def parse_bool(value: str) -> Optional[bool]:
    normalized = value.strip().lower()
    if normalized in ("true", "1", "yes", "да"):
        return True
    if normalized in ("false", "0", "no", "нет"):
        return False
    return None


def check_row(row: Dict[str, str]) -> Dict[str, str]:
    username = row.get("username", "").strip().lstrip("@")
    result = {
        "requested_username": username,
        "status": "",
        "returned_username": "",
        "full_name": "",
        "is_private": "",
        "is_verified": "",
        "follower_count": "",
        "media_count": "",
        "following_count": "",
        "biography": "",
        "issues": "",
    }

    if not username:
        result["status"] = "skipped_empty_username"
        result["issues"] = "empty_username"
        return result

    try:
        response = requests.get(
            API_URL,
            params={"license_key": API_KEY, "username": username},
            timeout=30,
        )
        response.raise_for_status()
        payload = response.json()
    except (requests.RequestException, ValueError) as exc:
        result["status"] = "request_error"
        result["issues"] = type(exc).__name__
        return result

    if payload.get("status") != "ok":
        result["status"] = "api_error"
        result["issues"] = "unexpected_outer_status"
        return result

    profile = payload.get("ig")
    if not isinstance(profile, dict):
        result["status"] = "missing_profile_data"
        result["issues"] = "missing_ig_object"
        return result

    result["status"] = "ok"
    fields = (
        "username", "full_name", "is_private", "is_verified",
        "follower_count", "media_count", "following_count", "biography",
    )
    for field in fields:
        value = profile.get(field)
        if value is not None:
            result["returned_username" if field == "username" else field] = str(value)

    issues: List[str] = []
    private = profile.get("is_private")
    if private is True:
        issues.append("private_profile")

    followers = profile.get("follower_count")
    if isinstance(followers, int):
        minimum = row.get("min_followers", "").strip()
        maximum = row.get("max_followers", "").strip()
        if minimum:
            try:
                if followers < int(minimum):
                    issues.append("below_min_followers")
            except ValueError:
                issues.append("invalid_min_followers_rule")
        if maximum:
            try:
                if followers > int(maximum):
                    issues.append("above_max_followers")
            except ValueError:
                issues.append("invalid_max_followers_rule")
    elif row.get("min_followers", "").strip() or row.get("max_followers", "").strip():
        issues.append("follower_count_unavailable")

    expected_verified = parse_bool(row.get("verified", ""))
    actual_verified = profile.get("is_verified")
    if expected_verified is not None and isinstance(actual_verified, bool):
        if actual_verified != expected_verified:
            issues.append("verified_flag_mismatch")
    elif row.get("verified", "").strip():
        issues.append("verified_value_unavailable_or_invalid")

    result["issues"] = ";".join(issues)
    return result


with open("profiles.csv", newline="", encoding="utf-8-sig") as source:
    rows = list(csv.DictReader(source))

output = [check_row(row) for row in rows]
fieldnames = list(output[0].keys()) if output else [
    "requested_username", "status", "returned_username", "full_name",
    "is_private", "is_verified", "follower_count", "media_count",
    "following_count", "biography", "issues",
]

with open("profile_check.csv", "w", newline="", encoding="utf-8") as destination:
    writer = csv.DictWriter(destination, fieldnames=fieldnames)
    writer.writeheader()
    writer.writerows(output)

print(f"Обработано строк: {len(output)}; отчёт: profile_check.csv")

قراءة الصفوف التي تتضمن فروقات

شغّل python check_profiles.py. وتعني القيمة ok في العمود status أن البرنامج استلم كائن الملف الشخصي المتوقع وتمكن من إنشاء سجل. أما العمود issues فيتضمن القواعد التي جرى التحقق منها فقط، مثل private_profile أو below_min_followers. ويعني خلو العمود من القيم أن الشروط المسجلة لم تكشف فروقات؛ لكنه لا يؤكد جودة المحتوى أو توافقه مع بنود أخرى في العقد.

طابق returned_username مع اسم المستخدم الأصلي، وأحِل biography وfull_name إلى الموظف المسؤول للتحقق من دلالتهما. ويتضمن التقرير أيضًا أخطاء الطلب، وحالة API غير المتوقعة، وغياب الكائن ig؛ فتبقى هذه الصفوف ضمن النتائج لتساعد على التمييز بين العطل التقني ونتيجة التحقق.

تشغيل التحقق بانتظام

يكفي تشغيل البرنامج يدويًا لإجراء تحقق لمرة واحدة. أما في العمليات الدورية، فأضِفه إلى مجدول المهام أو سير عمل CI: حمّل القائمة المحدّثة، ونفّذ الطلبات، واحفظ ملف CSV بوصفه مخرجًا، وأخطر الفريق إذا ظهرت قيم في العمود issues. لا تطبع المفتاح في السجلات؛ واحفظه سرًا ضمن بيئة التشغيل.

إذا كنت تتحقق من الملفات الشخصية نفسها كثيرًا، فيمكن تمرير المعامل cache_timeout لتحديد مدة التخزين المؤقت بالثواني. وتذكر الوثائق أن التخزين المؤقت في IG معطل افتراضيًا؛ وتفعيله ممكن بإسناد قيمة أكبر من صفر إليه، فيظل فعالًا طوال المدة المحددة. لا تضف هذا المعامل إلا إذا كان من المقبول إعادة استخدام الاستجابة خلال الفترة المختارة.

لا تتحقق إلا من البيانات والسيناريوهات التي يحق لك استخدامها. تعامل مع النتيجة على أنها لقطة لاستجابة API محددة، وسجّل تاريخ التشغيل في سجلّك الخاص، وراجع الحدود بالتزامن مع الموجز. لمزيد من التفاصيل حول نقطة النهاية والحقول المتاحة وخيارات التكامل، راجع صفحة IG Scraper API والوثائق الرسمية لنقطة النهاية.

الناس

لم يتم إدراج أي أشخاص لهذه المقالة حتى الآن.

استمر في القراءةكيفية التحقق من العملاء المحتملين على TikTok عبر IG قبل نقلهم إلى CRM
إقرأ المقال التالي

حوّل ما تقرأه إلى تكامل عملي

استكشف واجهات API للبيانات الاجتماعية من jsonscraper واختبر الطلبات وأنشئ سير عملك التالي.

استكشف واجهات API