واجهة برمجة تطبيقات بيانات الإعلانات الأصلية: وصول برمجي إلى الإبداعات الأصلية الملتقطة

إذا حاولت يومًا إجراء تحليل حقيقي على الإعلانات الأصلية، فأنت تعرف الحاجز. الذكاء موجود، لكنه محاصر خلف لوحة تحكم. يمكنك تصفح إبداع واحد في كل مرة، وتفحص حفنة من المعلنين، وربما تصدير ملف CSV يكون قديمًا بالفعل بحلول وقت انتهاء التحميل. ما لا يمكنك فعله هو معاملة بيانات الإعلانات الأصلية بالطريقة التي تعامل بها كل مجموعة بيانات أخرى في مكدسك: الاستعلام عنها، ودمجها، وجدولتها، وتوجيهها إلى نموذج.

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

لسياق الأمر، احتوت لقطة من مجموعة OpenAdLibrary في يونيو 2026 على 589,036 إبداعًا، و5.4 مليون ملاحظة إعلانية، و25,933 معلنًا متميزًا، و926,259 صفحة هبوط ملتقطة عبر 42 شبكة. هذا مقياس تاريخي لما كنا قد جمعناه، وليس حجم سوق الإعلانات الأصلية وليس عددًا حاليًا. وظيفة واجهة برمجة التطبيقات هي تسليمك السجلات التي طلبتها.

ما تُرجعه واجهة برمجة تطبيقات بيانات الإعلانات الأصلية فعليًا#

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

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

الإعلان أعلاه مثال نموذجي لهذا النوع في عمليات الالتقاط لدينا: موعد نهائي، وسلطة غامضة، ورقم بالدولار. كنا قد لاحظناه لمدة 13 يومًا عندما رأيناه آخر مرة. هذا يخبرك بالمدة التي رأيناه فيها، وليس ما إذا كان مربحًا أو ما إذا كان ادعاؤه دقيقًا.

طبقات البيانات الأربع في مجموعة بيانات الإعلانات الأصلية#

فكر في بيانات الإعلانات الأصلية كأربع طبقات متراكمة. بعض الأدوات تظهر الطبقة العلوية فقط. القيمة تتضاعف كلما تعمقت.

القفزة من الطبقة الثانية إلى الرابعة هي اللعبة بأكملها. يتم عرض الإعلان بواسطة شبكة (Taboola، Outbrain، MGID، Revcontent، Teads، Yahoo، MSN) لكن الشبكة ليست المعلن. المعلن هو من يجلس في نهاية النقرة. عدّ الإبداعات حسب الشبكة لا يخبرك من الذي يشتري فعليًا. تتبع سلسلة إعادة التوجيه، من جانب الخادم ودون إطلاق نقرة حقيقية على حملة حية، هو ما يحول كومة من إبداعات الأدوات المجهولة إلى ذكاء تنافسي يمكنك التصرف بناءً عليه.

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

المدة عمود مفيد، وسهل المبالغة في قراءته#

الطابع الزمني من أكثر الحقول فائدة في مجموعة بيانات الإعلانات الأصلية، لأنه يتيح لك قياس المدة التي لوحظ فيها الإعلان.

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

إعلان SmartAsset "كيف يمكنني تجنب دفع الضرائب على سحوبات IRA؟" كان في قائمة الـ 28 يومًا. وكذلك كانت عدة إعلانات اختبار "ما هو مستوى ذكائك؟" من My IQ على Microsoft Audience Network، وإعلان معينات سمعية من Hidden Hearing بإبداعين مختلفين عند الحد نفسه. معلن لديه عدة متغيرات لوحظت طوال النافذة كان لا يزال يشغّلها. لا يمكننا الجزم بما إذا كان العرض مربحًا، أو ما إذا كانت الميزانية كبيرة، أو ما إذا كانت الادعاءات في الإعلانات دقيقة.

تحذير واحد يستحق الذكر بوضوح. "الفائز لمدة 90 يومًا" الذي تسمعه في أوساط شراء الوسائط هو أسطورة صناعية، وليس قياسنا. ما أمكننا التحقق منه في عمليات الالتقاط ليونيو 2026 هذه هو عمليات تشغيل مستمرة تصل إلى حوالي 28 يومًا لكل إبداع. عامل رقم الـ 90 يومًا كفولكلور حتى تضيف مجموعة البيانات الخاصة بك طابعًا زمنيًا له.

واجهة برمجة تطبيقات مقابل لوحة التحكم: طابق الأداة مع المهمة#

لا خطأ في لوحة التحكم للبحث المخصص. الواجهتان مبنيتان لمهام مختلفة، ودمجهما يمكن أن يدفع الفرق إلى الدفع مقابل أدوات بالكاد يستخدمونها.

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

المؤشر العملي هو التكرار. إذا وجدت نفسك تصدر نفس العرض يدويًا كل يوم اثنين، فليس لديك مشكلة بحث. لديك مشكلة تكامل، وواجهة برمجة تطبيقات تحلها. هذا أيضًا هو الاتجاه الذي يتجه إليه مجال ذكاء الإعلانات الأوسع: تصفح يدوي أقل، وتدفقات برمجية أكثر موصولة مباشرة في سير العمل التنافسية والإبداعية.

خط أنابيب ملموس#

إليك كيف تربط فريق البيانات بيانات الإعلانات الأصلية بشيء مفيد فعليًا. النمط يظل ثابتًا سواء كنت تتابع قطاعًا كاملاً أو منافسًا واحدًا.

1. حدد قائمة المراقبة. مجموعة من المعلنين، أو نطاقات صفحات الهبوط، أو مواقع الناشرين التي تهتم بها. توثّق نقطة نهاية البحث مرشّحات مثل advertiserDomain و landingDomain و publisher، لذا تسحب فقط ما تتابعه.
2. اسحب على جدول زمني. وظيفة ليلية تطلب الإعلانات التي شوهدت آخر مرة منذ الأمس (توثّق نقطة نهاية البحث مرشّح lastSeenFrom، وتأخذ نقطة نهاية منفصلة للتغييرات علامة مائية since) وتحدّثها بواسطة id، حتى لا يُخزَّن الإبداع نفسه مرتين.
3. ادمج مع بياناتك الخاصة. طابق نطاقات صفحات الهبوط مع نظام إدارة علاقات العملاء الخاص بك أو جدول المنافسين. الإبداعات التي يطابق نطاق صفحة الهبوط الخاص بها تُنسب بعد ذلك إلى شركة تتابعها بالفعل.
4. احسب المدة والانتشار المرصودين. جمّع حسب معرف الإبداع. قم بقياس الأيام المرصودة (آخر ظهور ناقص أول ظهور) وعدد الناشرين المتميزين. الإبداعات المرصودة لفترة طويلة والمنتشرة على نطاق واسع مرشحة لنظرة أقرب، وليست فائزين مؤكدين.
5. تصرف. ادفع ملخصًا يوميًا للإبداعات الجديدة المرصودة لفترة طويلة إلى Slack، أو أطعم الإبداعات في نموذج تجميع، أو سلّم الخطة المنظمة إلى وكيل.

الخطوة الرابعة هي حيث تكون مجموعة البيانات المزوّدة بطوابع زمنية مفيدة. إبداع مثل إعلان جهاز السمع Nebroo أعلاه، الذي لوحظ لمدة 26 يومًا، هو نوع السجل الذي يمكن لخط الأنابيب الخاص بك رفعه للمراجعة. المدة مفهومة فقط إذا أضافت مجموعة البيانات الخاصة بك طابعًا زمنيًا لكل ملاحظة، ولهذا، في لقطة يونيو 2026، كانت 5.4 مليون ملاحظة خلف 589,036 إبداعًا. الملاحظات هي السلسلة الزمنية. الإبداع هو مجرد المفتاح. الإشارة دعوة لشخص أو نموذج للنظر عن قرب، وليست حكمًا بأن الإعلان ناجح.

ما يفصل مجموعة بيانات قابلة للاستخدام عن مجموعة صاخبة#

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

• الحداثة. هل يتم التقاط العروض حية، مع تواريخ أول ظهور وآخر ظهور؟ أم أنها تفريغ دوري قديم بالفعل بأسابيع؟
• دقة الإبداع. هل يتم تخزين الصورة الفعلية بجودة كاملة، أم صورة مصغرة منخفضة الجودة غير مجدية للتحليل البصري؟
• عمق الإسناد. هل تتوقف عند الشبكة، أم تتبع النقرة إلى صفحة الهبوط النهائية والمعلن الحقيقي؟
• طريقة الالتقاط. هل تقرأ الإعلانات العامة دون إطلاق نقرات حقيقية على الحملات الحية؟ النقرات الاصطناعية تنفق أموال المعلنين الآخرين وتفسد بياناتهم، وبياناتك.
• اتساع التغطية. هل تمتد عبر شبكات الإعلانات الأصلية الرئيسية وتلتقط عبر المناطق الجغرافية، أم أنها ناشر واحد في بلد واحد؟

لاحظ التفاصيل في إعلان بطارية الطاقة الشمسية ذلك. بالدقة الكاملة يمكنك قراءة العرض، والتأطير، والمعالجة البصرية، وهذا ما يغذي التجميع البصري وتحليل النص. الصورة المصغرة تتخلص من كل ذلك. هذه الاختبارات الخمسة هي أيضًا ما يميز شفافية الإعلانات الحقيقية عن مكتبة لقطات شاشة مع إضافة مربع بحث. لا تملك الإعلانات الأصلية مكتبة رسمية مماثلة لمكتبة Meta أو Google، ودليلنا حول ما هي مكتبة الإعلانات الأصلية وكيف تختلف عن مكتبتي Meta و Google يروي هذه القصة.

لماذا الإعلانات الأصلية أصعب، وأكثر مجزية، مما تبدو عليه#

تنشر Meta و Google و Microsoft (لإعلانات Bing في الاتحاد الأوروبي والمنطقة الاقتصادية الأوروبية) و TikTok مكتبات إعلانات رسمية، وبعضها موجود لأن قانون الخدمات الرقمية في الاتحاد الأوروبي يتطلب مستودع إعلانات عامًا من المنصات ومحركات البحث المعينة كبيرة الحجم جدًا. قائمة المفوضية الأوروبية لهذه الخدمات (المحدثة في 31 أغسطس 2026) لا تشمل Taboola، أو Outbrain/Teads، أو MGID، أو Revcontent، ولا نعلم بوجود مكتبة إعلانات عامة منها، لذا فإن الإعلانات الأصلية البرمجية ليس لها مكتبة رسمية مماثلة لمكتبة Meta. هذه الفجوة هي سبب وجود مجموعات البيانات المستقلة. تُعرض الإعلانات علنًا؛ وتنظيمها مهمة منفصلة.

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

كيف يتناسب OpenAdLibrary#

ينشر OpenAdLibrary هذه المدونة ويبيع المنتج الموصوف هنا. يلتقط إعلانات أصلية عامة من Taboola، و Outbrain، و MGID، و Revcontent، و Teads، و Yahoo، و MSN، بواجهة برمجة التطبيقات أولاً مع زاحف متصفح كخيار احتياطي، ومنذ أكتوبر 2026 تشمل مكتبته أيضًا إعلانات Meta و TikTok. يخزّن الإبداع، ويصنّف سلسلة التوريد، ويتتبع عمليات إعادة التوجيه إلى صفحة الهبوط دون النقر على إعلانات حية. تكشف واجهة برمجة تطبيقات REST وخادم MCP مستضاف البيانات العامة من المكتبة نفسها للمحلل، أو خط الأنابيب، أو وكيل الذكاء الاصطناعي. بيانات الإعلانات والبحث عبر كليهما جزء من خطة Founders: مفتاح الحساب المجاني لا يصل إلا إلى نقاط النهاية الخاصة بذلك الحساب، وكل نقطة نهاية أخرى تجيب باستجابة تتطلب الدفع. وفقًا لـوثائق واجهة برمجة التطبيقات، فإنها تُرجع محتوى الإبداع العام، وعناوين URL للصور المصغرة، والأعداد الإجمالية، وسلسلة إعادة التوجيه خلف الإعلان، بما في ذلك عنوان URL للمعلن الذي تنتهي إليه النقرة. وهي لا تُرجع البيانات الخاصة بـ Meta و TikTok وحدها المعروضة في تطبيق الويب، مثل تقدير الإنفاق على Meta والوصول في الاتحاد الأوروبي، ويُجاب على بحثها النصي الحر من بين 3,000 إعلان مطابق شوهد مؤخرًا بدلاً من المجموعة كاملة. لكل مفتاح حصة طلبات يومية (تسرد مرجعية واجهة برمجة التطبيقات 5,000 طلب يوميًا افتراضيًا). يمكن أن تتضمن نتائج البحث إعلانات Meta و TikTok، التي تبدأ معرفاتها بـ meta- أو tiktok-، ولا يوجد سجل لها في نقطة نهاية الإعلان الواحد.

تبلغ تكلفة خطة Founders $29.99 شهريًا وتشمل واجهة برمجة تطبيقات REST وخادم MCP المستضاف. لا يحتاج الحساب المجاني إلى بطاقة ويعرض أحدث 20 إعلانًا من Meta و TikTok والإعلانات الأصلية في التطبيق، حتى تتحقق مما إذا كانت مجموعة البيانات تبدو ذات صلة بقائمة المراقبة الخاصة بك قبل الدفع؛ أما الفحص الشامل، وأي استخدام لواجهة برمجة التطبيقات، فيحتاج إلى خطة Founders.

ابدأ مجانًا للنظر في البيانات في التطبيق؛ يتطلب الوصول إلى واجهة برمجة التطبيقات خطة Founders.