طريقة الاستخدام
- اكتب سجل بائع واحداً في كل سطر من سجلات البائعين، سجل في كل سطر، والحقول مفصولة بفواصل. استبدل أسطر المثال بسجلاتك.
- املأ CONTACT أو SUBDOMAIN أو OWNERDOMAIN أو MANAGERDOMAIN فقط إذا كنت تحتاجها.
- اقرأ الملاحظة أسفل النتيجة لأي سطر استُبعد، وصحّح ذلك السطر.
- انسخ ملف ads.txt، أو نزّله، وارفعه إلى موقعك باسم ads.txt.
الصيغة
تصف مواصفة ads.txt 1.1 الصادرة عن IAB Tech Lab سجل البيانات بأربعة حقول مفصولة بفواصل: نطاق نظام الإعلانات، ورقم حساب الناشر، ونوع الحساب، ومعرّف جهة التصديق الاختياري. نوع الحساب DIRECT أو RESELLER، وتقبل المواصفة كتابته بأي حالة للأحرف (القسم 3.3). ويجوز حذف الحقل الرابع (القسم 4.2).
المتغير يُكتب بالصيغة NAME=value. وتسمّي المواصفة CONTACT وSUBDOMAIN وOWNERDOMAIN وMANAGERDOMAIN وINVENTORYPARTNERDOMAIN (القسم 3.5.1). والسطر الذي يبدأ بـ # تعليق يُتجاهل (القسم 3.2).
ما تتحقق منه الأداة
- نطاق نظام الإعلانات اسم نطاق: أحرف وأرقام وشرطات، ونقاط بينها، دون بروتوكول ولا مسار ولا شرطة سفلية.
- رقم الحساب ومعرّف جهة التصديق لا يحتويان مسافات أو تبويبات أو فواصل. تنص المواصفة على ترميز هذه الأحرف بصيغة URL (القسم 3.4.2)، لذلك تطلب الأداة حذفها بدلاً من ذلك.
- السجل فيه ثلاثة حقول أو أربعة، ونوع الحساب DIRECT أو RESELLER.
- SUBDOMAIN وOWNERDOMAIN وMANAGERDOMAIN أسماء نطاقات. ويجوز أن يتبع MANAGERDOMAIN فاصلة ورمز بلد من حرفين.
ما لا تتحقق منه الأداة
- صحة رقم الحساب: هل هو الرقم الذي أصدره لك نظام الإعلانات. انسخه بالضبط من صفحة حسابك لدى نظام الإعلانات، لأن نظام الإعلانات وحده يستطيع تأكيده.
- هل يقبل نظام الإعلانات سطرك، أو هل يوافق البائع على موقعك. الملف يسرد البائعين لديك، ويقرر كل منهم كيف يقرأ سطره.
مثال محسوب: بائعان ومعرّف اتصال
تبيع عبر adnetwork.example بمعرّف الناشر 12345 بصفة بائع مباشر (DIRECT)، وعبر exchange.example بالمعرّف 67890 بصفة وسيط (RESELLER). تضيف البريد الإلكتروني [email protected] بوصفه CONTACT.
تكتب الأداة السجلين بالترتيب، ثم المتغير، في سطر لكل منها. يحتفظ سجل adnetwork.example بحقله الرابع، وهو معرّف جهة التصديق a1b2c3d4.
| السطر في الملف |
|---|
| adnetwork.example, 12345, DIRECT, a1b2c3d4 |
| exchange.example, 67890, RESELLER |
| [email protected] |
الأسئلة الشائعة
ماذا يعني DIRECT وRESELLER؟
تعني DIRECT أن نظام الإعلانات يبيع مخزونك بنفسه، وتعني RESELLER أنه يمرّر مخزونك إلى بائع آخر. تعرّف المواصفة الاثنين (القسم 3.3). استخدم القيمة التي يعطيك إياها نظام الإعلانات لحسابك.
أين أجد رقم حسابي؟
يأتي من حساب الناشر لدى نظام الإعلانات، أو من تعليمات البائع نفسه. لا تستطيع الأداة التحقق منه، لذلك انسخه بالضبط، بالحروف الكبيرة نفسها والأرقام نفسها.
لماذا يُستبعد سطر من الملف؟
لأن السطر فيه حقول أقل من اللازم أو أكثر منه، أو نطاق ليس اسم نطاق صالحاً، أو نوع حساب غير DIRECT وRESELLER، أو مسافة داخل رقم الحساب أو معرّف جهة التصديق. تعطي الملاحظة أسفل النتيجة رقم السطر.
هل يجعل هذا الملف موقعي معتمداً لدى أنظمة الإعلانات؟
لا. الملف يسرد البائعين الذين لديك بالصيغة التي تصفها المواصفة. يقرر كل نظام إعلانات كيف يقرأ سطرك، وهل يسمح لك بالبيع عبره.
لماذا تُكتب المتغيرات بعد السجلات؟
المواصفة لا تحدد ترتيباً. كل سطر بالصيغة VARIABLE=value يُقرأ متغيراً أينما وقع (القسم 3.5). تكتب الأداة المتغيرات بعد السجلات لتبقى الملفات سهلة القراءة.
هل يمكنني الاحتفاظ بتعليقات داخل الملف؟
تسمح المواصفة بها، فالسطر الذي يبدأ بـ # تعليق يُتجاهل (القسم 3.2). تتجاهل الأداة سطور # في المربع ولا تنسخها إلى الملف، لذلك احتفظ بملاحظاتك خارج الملف.
المصادر
- IAB Tech Lab (باللغة الإنجليزية): مواصفة ads.txt 1.1، الأقسام 3.2 إلى 3.5.1 و4.2 إلى 4.8
- IAB Tech Lab (باللغة الإنجليزية): ads.txt، الإصدارات وتغييراتها
آخر مراجعة للأرقام والنص: الثلاثاء، 30 جمادى الأولى 1448 بعد الهجرة.