المفاهيم الأساسية

تقدّم هذه الصفحة نظرة عامة على بنية واجهة برمجة تطبيقات "مدير إعلانات Google"، وتصف المفاهيم والمصطلحات العامة في "مدير الإعلانات".

بنية واجهة برمجة التطبيقات

في ما يلي رسم بياني مبسّط للفئات الرئيسية في واجهة برمجة تطبيقات "مدير الإعلانات" وكيفية ارتباطها ببعضها البعض:

طلب

يحتوي عنصر Order على معلومات عامة حول الطلب، مثل العملة أو مندوب المبيعات، ويحتوي على حالة LineItem واحدة أو أكثر. في الرموز البرمجية، يحمل كل LineItem رقم التعريف الذي يتضمّن Order بدلاً من Order الذي يتضمّن قائمة من عناصر LineItem.

LineItem

يصف عنصر LineItem مجموعة من المتطلبات لعرض الإعلان، بما في ذلك طريقة ووقت عرض الإعلانات، وأحجام تصاميم الإعلانات التي يجب عرضها وترتيب عرضها (بالترتيب أو الترجيح أو وفقًا لأدائها)، وأولوية هذه الإعلانات، والعديد من الخصائص التي تصف بنية التكلفة. يحتوي LineItem على عنصر InventoryTargeting واحد يصف كائنات AdUnit وPlacement التي يمكنه استهدافها، بالإضافة إلى كائنات Targeting إضافية اختيارية من الفئة الفرعية تمثل معايير جغرافية أو مخصّصة أو أخرى.

LineItemCreativeAssociation

تربط علامة LineItemCreativeAssociation (غالبًا ما تُسمّى LICA) علامة LineItem واحدة بـ Creative. ويمكن ربط العناصر بأكثر من تصميم إعلان واحد، واستنادًا إلى نوع حسابك، قد تتمكّن من ربط تصميم إعلان بأكثر من عنصر واحد. عند إنشاء LineItemCreativeAssociation، يتحقّق "مدير الإعلانات" أولاً ممّا إذا كان تصميم الإعلان والعنصر متوافقَين. وإذا اختلف الحجمان مثلاً، ستظهر لك رسالة خطأ عند محاولة إجراء الربط أو تعديله. يتيح لك هذا الكائن أيضًا إلغاء بعض القيم في LineItem المرتبطة، مثل تاريخَي البدء/الانتهاء، أو الحجم (إذا كان لديك تصميم إعلان لا يناسب الحجم المحدّد في العنصر، ولكنّك مستعد للسماح لـ "مدير الإعلانات" بتعديل حجم تصميم الإعلان ليلائم الوحدة الإعلانية بسرعة). لا تظهر إعلانات الأنشطة التجارية المحلية (LICA) في واجهة مستخدم "مدير إعلانات Google"، بل إنّها تمثّل اصطلاحًا في واجهة برمجة التطبيقات.

تصميم الإعلان

تمثل Creative الإعلان الفعلي. في حال استضافة الإعلان من خلال "مدير إعلانات Google"، يحتفظ هذا العنصر بوحدات البايت الخاصة بالصور أو ملفات الفلاش أو علامات HTML المخصّصة المخزّنة على خوادم "مدير الإعلانات"، وإذا تمت استضافة تصميم الإعلان على موقع إلكتروني خارجي، يكون تصميم الإعلان عبارة عن عنوان URL أو مقتطف HTML الذي ينفِّذ الطلب من الخادم التابع لجهة خارجية.

الفئات الفرعية لاستهداف المستودع الإعلاني

يدرج العنصر InventoryTargeting الوحدات الإعلانية المرتبطة بعنصر LineItem محدّد. يمكنك تحديد معايير استهداف إضافية واختيارية باستخدام مثيلات إضافية لفئة فرعية مناسبة من Targeting.

موضع إعلان

كائن Placement هو مجموعة من عنصر AdUnit واحد أو أكثر.

AdUnit

يمثّل AdUnit موقعًا جغرافيًا للإعلان على صفحة أو أكثر. يمكن أن يكون AdUnit استهدافًا لكائن InventoryTargeting الخاص بالسمة LineItem أو لكائن Placement. يتضمّن الكائن AdUnit حجمًا ومعرّفًا واسمًا فريدًا. يُستخدَم رقم التعريف لتحديد عناصر AdUnit الأخرى ضمن واجهة برمجة التطبيقات. ويُستخدم الاسم كمعرّف فريد في علامات HTML لتحديد عنصر AdUnit محدّد، ويتم إرساله مرة أخرى إلى "مدير إعلانات Google" كجزء من طلب الصفحة.