مفاهیم اساسی

این صفحه نمای کلی از معماری Google Ad Manager API را ارائه می دهد و مفاهیم و اصطلاحات کلی را در Ad Manager توضیح می دهد.

معماری API

در اینجا یک نمودار ساده از کلاس های اصلی در Ad Manager API و نحوه ارتباط آنها با یکدیگر آمده است:

اشیاء اصلی در معماری Ad Manager.

سفارش

یک شی Order اطلاعات کلی درباره سفارش مانند واحد پول یا فروشنده را در خود دارد و شامل یک یا چند نمونه LineItem است. در کد، هر LineItem شناسه Order حاوی خود را دارد، نه اینکه Order فهرستی از اشیاء LineItem را در خود داشته باشد.

آیتم خط

یک شی LineItem مجموعه ای از الزامات برای نمایش یک آگهی را توصیف می کند، از جمله نحوه و زمان نمایش تبلیغات، اندازه خلاقیت هایی که باید نمایش داده شود و ترتیب نمایش آنها (به ترتیب، وزن، یا بر اساس آنها عملکرد)، اولویت این تبلیغات، و بسیاری از ویژگی‌هایی که ساختار هزینه را توصیف می‌کنند. یک LineItem دارای یک شی InventoryTargeting است که توضیح می‌دهد کدام اشیاء AdUnit و Placement را می‌تواند هدف قرار دهد، و همچنین اشیاء اضافی اختیاری زیرکلاس Targeting که معیارهای جغرافیایی، سفارشی یا دیگر را نشان می‌دهند.

LineItemCreativeAssociation

LineItemCreativeAssociation (که اغلب LICA نامیده می شود) یک LineItem را به یک Creative پیوند می دهد. موارد خط را می توان به بیش از یک خلاقیت پیوند داد، و بسته به نوع حساب خود، ممکن است بتوانید یک خلاقیت را به بیش از یک مورد خط پیوند دهید. وقتی یک LineItemCreativeAssociation ایجاد می‌کنید، Ad Manager ابتدا بررسی می‌کند که آیا هر دو مورد خلاق و مورد خط سازگار هستند یا خیر. به عنوان مثال، اگر اندازه ها متفاوت است، هنگام ایجاد یا به روز رسانی انجمن با خطا مواجه می شوید. این شیء همچنین به شما امکان می‌دهد برخی از مقادیر را در LineItem مرتبط، مانند تاریخ شروع/پایان، یا اندازه لغو کنید (اگر خلاقیتی دارید که کاملاً با اندازه مشخص‌شده توسط آیتم خط مطابقت ندارد، اما مایلید به Ad Manager اجازه دهید اندازه خلاقیت را طوری تنظیم کنید که با واحد تبلیغاتی در حال پرواز باشد). LICA ها در رابط کاربری Ad Manager نمایش داده نمی شوند. آنها یک قرارداد API هستند.

خلاق

یک Creative نشان دهنده تبلیغ واقعی است. اگر تبلیغ توسط Ad Manager میزبانی شود، این شیء بایت های واقعی تصویر، فایل های فلش یا تگ های HTML سفارشی ذخیره شده در سرورهای Ad Manager را در خود نگه می دارد. اگر خلاقیت در یک سایت شخص ثالث میزبانی شده باشد، خلاقیت یک URL یا قطعه HTML است که درخواست را از سرور شخص ثالث ارسال می کند.

زیر کلاسهای InventoryTargeting و Targeting

شی InventoryTargeting واحدهای تبلیغاتی مرتبط با یک LineItem خاص را فهرست می کند. می‌توانید معیارهای هدف‌یابی اختیاری و اضافی را با استفاده از نمونه‌های اضافی از یک زیر کلاس مناسب از Targeting تعیین کنید.

تعیین سطح

یک آبجکت Placement مجموعه ای از یک یا چند شی AdUnit است.

AdUnit

AdUnit یک مکان تبلیغ را در یک یا چند صفحه نشان می دهد. یک AdUnit می تواند هدف یک شی InventoryTargeting یک LineItem یا یک شی Placement باشد. یک شی AdUnit شامل یک اندازه، یک شناسه و یک نام منحصر به فرد است. شناسه برای شناسایی سایر اشیاء AdUnit در API استفاده می شود. نام به عنوان یک شناسه منحصر به فرد در تگ های HTML برای شناسایی یک شی AdUnit خاص استفاده می شود و به عنوان بخشی از درخواست صفحه به Ad Manager ارسال می شود.
،

این صفحه نمای کلی از معماری Google Ad Manager API را ارائه می دهد و مفاهیم و اصطلاحات کلی را در Ad Manager توضیح می دهد.

معماری API

در اینجا یک نمودار ساده از کلاس های اصلی در Ad Manager API و نحوه ارتباط آنها با یکدیگر آمده است:

اشیاء اصلی در معماری Ad Manager.

سفارش

یک شی Order اطلاعات کلی درباره سفارش مانند واحد پول یا فروشنده را در خود دارد و شامل یک یا چند نمونه LineItem است. در کد، هر LineItem شناسه Order حاوی خود را دارد، نه اینکه Order فهرستی از اشیاء LineItem را در خود داشته باشد.

آیتم خط

یک شی LineItem مجموعه ای از الزامات برای نمایش یک آگهی را توصیف می کند، از جمله نحوه و زمان نمایش تبلیغات، اندازه خلاقیت هایی که باید نمایش داده شود و ترتیب نمایش آنها (به ترتیب، وزن، یا بر اساس آنها عملکرد)، اولویت این تبلیغات، و بسیاری از ویژگی‌هایی که ساختار هزینه را توصیف می‌کنند. یک LineItem دارای یک شی InventoryTargeting است که توضیح می‌دهد کدام اشیاء AdUnit و Placement را می‌تواند هدف قرار دهد، و همچنین اشیاء اضافی اختیاری زیرکلاس Targeting که معیارهای جغرافیایی، سفارشی یا دیگر را نشان می‌دهند.

LineItemCreativeAssociation

LineItemCreativeAssociation (که اغلب LICA نامیده می شود) یک LineItem را به یک Creative پیوند می دهد. موارد خط را می توان به بیش از یک خلاقیت پیوند داد، و بسته به نوع حساب خود، ممکن است بتوانید یک خلاقیت را به بیش از یک مورد خط پیوند دهید. وقتی یک LineItemCreativeAssociation ایجاد می‌کنید، Ad Manager ابتدا بررسی می‌کند که آیا هر دو مورد خلاق و مورد خط سازگار هستند یا خیر. به عنوان مثال، اگر اندازه ها متفاوت است، هنگام ایجاد یا به روز رسانی انجمن با خطا مواجه می شوید. این شیء همچنین به شما امکان می‌دهد برخی از مقادیر را در LineItem مرتبط، مانند تاریخ شروع/پایان، یا اندازه لغو کنید (اگر خلاقیتی دارید که کاملاً با اندازه مشخص‌شده توسط آیتم خط مطابقت ندارد، اما مایلید به Ad Manager اجازه دهید اندازه خلاقیت را طوری تنظیم کنید که با واحد تبلیغاتی در حال پرواز باشد). LICA ها در رابط کاربری Ad Manager نمایش داده نمی شوند. آنها یک قرارداد API هستند.

خلاق

یک Creative نشان دهنده تبلیغ واقعی است. اگر تبلیغ توسط Ad Manager میزبانی شود، این شیء بایت های واقعی تصویر، فایل های فلش یا تگ های HTML سفارشی ذخیره شده در سرورهای Ad Manager را در خود نگه می دارد. اگر خلاقیت در یک سایت شخص ثالث میزبانی شده باشد، خلاقیت یک URL یا قطعه HTML است که درخواست را از سرور شخص ثالث ارسال می کند.

زیر کلاس های InventoryTargeting و Targeting

شی InventoryTargeting واحدهای تبلیغاتی مرتبط با یک LineItem خاص را فهرست می کند. می‌توانید معیارهای هدف‌یابی اختیاری و اضافی را با استفاده از نمونه‌های اضافی از یک زیر کلاس مناسب از Targeting تعیین کنید.

تعیین سطح

یک آبجکت Placement مجموعه ای از یک یا چند شی AdUnit است.

AdUnit

AdUnit یک مکان تبلیغ را در یک یا چند صفحه نشان می دهد. یک AdUnit می تواند هدف یک شی InventoryTargeting یک LineItem یا یک شی Placement باشد. یک شی AdUnit شامل یک اندازه، یک شناسه و یک نام منحصر به فرد است. شناسه برای شناسایی سایر اشیاء AdUnit در API استفاده می شود. نام به عنوان یک شناسه منحصر به فرد در تگ های HTML برای شناسایی یک شی AdUnit خاص استفاده می شود و به عنوان بخشی از درخواست صفحه به Ad Manager ارسال می شود.