يستخدم منتجا AdSense للفيديو وAdSense للألعاب بنية وضع علامات مختلفة جدًا عن منتج AdSense للمحتوى. ويتطلب هذان المنتجان علامة لإعلانات الوسائط التفاعلية (IMA)، ولا يعرضان سوى الإعلانات عند استدعائها باستخدام مشغِّل فيديو أو مشغِّل ألعاب قادر على دمج أداة تطوير البرامج لإعلانات الوسائط التفاعلية من Google و/أو التوافق مع VAST وVPAID (على سبيل المثال، مهايئ إعلانات الوسائط التفاعلية).
يمكنك عادةً إنشاء هذه العلامات من خلال منشئ علامات AdSense للألعاب. وستجد في ما يلي قائمة شاملة بالمعايير المختلفة التي يمكنك إعدادها لعلامات الإعلانات هذه. ولا يوجد سوى عدد قليل من المعلمات المطلوبة لعلامة AdSense للألعاب لعرض الإعلانات، ولكن يمكنك تحقيق استجابات الإعلانات المطلوبة عن طريق إضافة معلمات اختيارية مثل أرقام تعريف القنوات، والحد الأدنى/الأقصى لمدة الإعلان، واللغة، وما إلى ذلك.
| معلَّمة علامة إعلانات الوسائط التفاعلية | معلمة مطلوبة |
|---|---|
| ad_type | نعم |
| client | نعم |
| description_url | نعم - يجب أن يكون بترميز عنوان URL |
| channel | لا - مُوصى بها إذا كانت متوفرة |
| adsafe | لا - مُوصى بها |
| videoad_start_delay | لا - مُوصى بها |
| hl | لا - مُوصى بها |
| max_ad_duration | لا - مُوصى بها |
| min_ad_duration | لا - مُوصى بها |
| sdmax | لا - مُوصى بها |
| adtest | لا |
| cust_age | لا |
| cust_gender | لا |
| host | لا |
| h_ch | لا |
عنوان URL الأساسي
يوفر عنوان URL التالي أساسًا لجميع معلمات طلبات البحث الموصوفة أدناه:
https://googleads.g.doubleclick.net/pagead/ads?
ad_type
(سلسلة) تحدد نوع الإعلان المطلوب. يتم الجمع بينهم باستخدام شرطة سفلية ('_').
القيم
- video: جميع إعلانات الفيديو: مكافئة لـ standardvideo_skippablevideo_bumpervideo.
- skippablevideo: إعلانات الفيديو القابلة للتخطي فقط. وقد يتطلب هذا أذونات إضافية من الناشر لتلقي إعلانات يمكن تخطيها.
- bumpervideo: السماح بإعلانات الفيديو غير القابلة للتخطي والتي تبلغ مدتها ست ثوانٍ.
- standardvideo: إعلانات الفيديو غير القابلة للتخطي فقط.
- image: السماح بالإعلانات المصوّرة التي توافق حجم الشريحة غير الخطية المحددة.
- text: السماح بالإعلانات النصية.
أمثلة
- &ad_type=video_text_image
- تسمح بجميع أشكال الإعلانات
- &ad_type=video_text
- تسمح بأي تنسيق فيديو وإعلانات نصية.
- &ad_type=standardvideo_image
- تسمح فقط بإعلانات الفيديو والإعلانات المصورة القياسية غير القابلة للتخطي.
client
(سلسلة): معرّف موقع الويب للناشر.
مثال: &client=ca-games-pub-4968145218643279
description_url
(سلسلة) عنوان URL كامل بترميز URL لصفحة HTML تصف الفيديو. يمكن إنشاء القيمة description_url بشكل ديناميكي باستخدام لغة البرمجة المستخدمة بالخادم، أو يدويًا باستخدام أداة ترميز عنوان URL عبر الإنترنت.
مثال: &description_url=http%3A%2F%2Fmyurl.com%2Fpage%3Fkey%3Dvalue%26key2%3Dvalue2
مثال لعنوان URL
في ما يلي مثال على عنوان URL يحتوي على الحد الأدنى من المعلَّمات المطلوبة. https://googleads.g.doubleclick.net/pagead/ads?client=ca-video- afvtest&ad_type=video&description_url=http%3A%2F%2Fmyurl.com%2Fpage%3Fkey%3Dvalu e%26key2%3Dvalue2
يتطلب إعلانات فيديو للناشر، ca-video-afvtest، مع عنوان URL وصفي لـ http:// myurl.com/page?key=value&key2=value2
channel
(سلسلة) قائمة محددة إضافية من القنوات تُستخدم لإعداد التقارير والاستهداف في AdSense. قد يتم تمرير ما يصل إلى خمس قنوات لكل طلب إعلان.
مثال: &channel=mychannel+otherchannel+targetingchannel
adsafe
(سلسلة) تحدد الإعداد المستخدم لفلترة الإعلانات التي يتم عرضها. وتكون القيمة الافتراضية هي "high".
القيم:
- high – (القيمة الافتراضية) لعرض إعلانات مناسبة لجميع أفراد العائلة. لا يتم عرض الإعلانات غير المناسبة للأطفال أو إعلانات المحتوى الجنسي الخاص بالبالغين.
- medium – لعرض إعلانات مناسبة لجميع أفراد العائلة بالإضافة إلى إعلانات غير مناسبة للأطفال (مثل إعلانات المقامرة أو إعلانات العقاقير التي لا تُصرف إلا بأمر الطبيب). لا يتم عرض إعلانات المحتوى الجنسي والخاص بالبالغين.
مثال: &adsafe=high
adtest
(سلسلة) تحدّد ما إذا كان هذا تنفيذ اختبار أو لا. القيم المحتملة هي "تشغيل" أو "إيقاف". إذا تم التعيين على "تشغيل"، فلن يتم تسجيل مرات الظهور والنقرات في حساب AFV. يجب أن تستخدم هذه المعلمة أثناء الاختبار. إعداد القيمة الافتراضية على "off" إذا لم يتم التعيين.
القيم:
- off – (القيمة الافتراضية) يتم تحرير فواتير لجميع الإعلانات على النحو المعتاد. وهذا هو الإعداد الذي يجب استخدامه في الإنتاج.
- on – يضمن هذا الإعداد عدم تسجيل الإعلانات لمرات ظهور أو نقرات للاستخدام خلال الاختبار.
مثال: &adtest=on
videoad_start_delay
(عدد صحيح) عدد المللي ثانية في الفيديو التي سيتم خلالها عرض الإعلان. إعداد الوضع الافتراضي على قيمة إعلان أثناء التشغيل، "1"، على وجه التحديد.
القيم:
- -1 --تحديد إعلان ما بعد التشغيل الذي سيتم عرضه عند نهاية المحتوى.
- 0 --تحديد إعلان ما قبل التشغيل الذي سيتم عرضه قبل بدء تشغيل المحتوى
- أي عدد صحيح موجب --تحديد إعلان أثناء التشغيل الذي سيتم عرضه بعد مرور هذا العدد من المللي ثانية من تشغيل المحتوى.
مثال:
- &videoad_start_delay=-1 --إعلان ما بعد التشغيل.
- &videoad_start_delay=15000 --سيُعرض الإعلان في الثانية 15 من المحتوى.
cust_age
(عدد صحيح) تحدد عمر المستخدم. يتم دعم العمر الفعلي، وكذلك فئة عمرية محددة في com.google.ads.ima.api.المعلومات السكانية.
مثال:
- &cust_age=1001 --العمر من 18 إلى 24
- &cust_age=38 --38 بالضبط
cust_gender
(عدد صحيح) تحدد جنس المستخدم كما هو محدد في com.google.ads.ima.api.المعلومات السكانية.
القيم:
- 1 --ذكر
- 2 -- أنثى
مثال:
- &cust_gender=1 --ذكر
- &cust_gender=2 --أنثى
host
(سلسلة) معرِّف المضيف للاستخدام لمشاركة الأرباح ثلاثية الاتجاهات.
مثال: &host=ca-host-test --تقسيم الربح مع هذا المضيف.
h_ch
(سلسلة) قائمة محددة إضافية من السلاسل تمثل معرّفات قنوات الاستهداف أو إعداد التقارير في AdSense للمضيف.
مثال: &h_ch=channel1+channel2+channel3 --إعداد تقارير حول هذه القنوات الإضافية واستهدافها للمضيف.
ht_id
(عدد) رقم تعريف الطبقة المستخدم لتحديد مستوى مشاركة الأرباح بين الناشر والمضيف.
مثال: &ht_id=2 --مضيف الطبقة 2.
hl
(سلسلة) رمز لغة يُستخدم لطلب الإعلانات بتلك اللغة. قد يكون هذا أحد رموز ISO 639-1 (من حرفين) أو ISO 639-2 (من ثلاثة أحرف). قائمة من الرموز الصالحة.
مثال:
- &hl=en --اللغة الإنجليزية.
- &hl=ar --اللغة العربية
max_ad_duration
(عدد صحيح) تحدد الحد الأقصى لطول الفيديو الذي يجب أن يعرض بالمللي ثانية. إعداد القيمة الافتراضية على 100 ثانية إذا لم يتم التعيين.
مثال: &max_ad_duration=30000 --الحد الأقصى لمدة الإعلان غير القابل للتخطي ستكون 30 ثانية.
min_ad_duration
(عدد صحيح) تحدد الحد الأدنى لطول الفيديو الذي يجب أن يعرض بالمللي ثانية. إعداد القيمة الافتراضية على 0 ثانية إذا لم يتم التعيين.
مثال:
- &min_ad_duration=15000 --يجب أن تكون مدة عرض الإعلان غير القابل للتخطي 15 ثانية أو لفترة أطول.
- &min_ad_duration=0 --لن تُقيد المدة إلا بواسطة قيمة max_ad_duration.
sdmax
(عدد صحيح) تحدد الحد الأقصى لطول الفيديو للإعلانات القابلة للتخطي بالمللي ثانية. إعداد القيمة الافتراضية على "غير محددة" إن لم يتم التعيين.
مثال: &sdmax=120000 --لا يمكن أن تتجاوز مدة عرض الإعلان القابل للتخطي دقيقتين.
