מושגים בסיסיים

דף זה מספק סקירה כללית של הארכיטקטורה של Google Ad Manager API ומתאר מושגים ומונחים כלליים ב-Ad Manager.

ארכיטקטורת API

לפניכם תרשים פשוט של המחלקות הראשיות ב-Ad Manager API, והאופן שבו הן קשורות זו לזו:

אובייקטים עיקריים בארכיטקטורה של Ad Manager.

הזמנה

אובייקט Order מכיל מידע כללי על ההזמנה, כמו המטבע או איש המכירות, ומכיל לפחות מופע אחד של LineItem. בקוד, כל LineItem מכיל את המזהה של ה-Order שלו, ולא את Order שמכיל רשימה של LineItem אובייקטים.

LineItem

אובייקט LineItem מתאר קבוצה של דרישות בנוגע להצגה של מודעה, כולל האופן והמועד שבהם צריך להציג את המודעות, הגדלים של נכסי הקריאייטיב שבהם הן יוצגו והסדר שבו הן יוצגו (לפי הסדר, לפי שקלול או בהתאם לביצועים שלהן), העדיפות של המודעות האלה ומאפיינים רבים שמתארים את מבנה העלויות. ל-LineItem יש אובייקט InventoryTargeting אחד שמתאר לאילו אובייקטים AdUnit ו-Placement הוא יכול לטרגט, ואובייקטים אופציונליים של Targeting של מחלקה משנית שמייצגים קריטריונים גיאוגרפיים, מותאמים אישית או אחרים.

LineItemCreativeAssociation

LineItemCreativeAssociation (שנקרא גם LICA) מקשר בין LineItem לבין Creative. פריטים יכולים להיות מקושרים ליותר מקריאייטיב אחד, ובהתאם לסוג החשבון, ייתכן שתהיה אפשרות לקשר קריאייטיב ליותר מפריט אחד. כשיוצרים LineItemCreativeAssociation, מערכת Ad Manager בודקת קודם אם גם הקריאייטיב וגם הפריט תואמים. אם הגדלים שונים, למשל, תופיע הודעת שגיאה כשתנסו ליצור את השיוך או לעדכן אותו. באמצעות האובייקט הזה אפשר גם לשנות ערכים מסוימים בשדה LineItem המשויך, כמו תאריכי התחלה וסיום או גודל (אם יש לך קריאייטיב שלא מתאים בדיוק לגודל שצוין על ידי הפריט, אבל ברצונך לאפשר ל-Ad Manager להתאים את גודל הקריאייטיב תוך כדי תנועה) מספרי LICA לא נחשפים בממשק המשתמש של Ad Manager. מדובר במוסכמה של API.

Creative

Creative מייצג את המודעה עצמה. אם המודעה מתארחת ב-Ad Manager, האובייקט הזה מכיל את הבייטים של התמונות, קובצי ה-Flash או תגי ה-HTML המותאמים אישית שמאוחסנים בשרתים של Ad Manager. אם הקריאייטיב מתארח באתר של צד שלישי, הקריאייטיב הוא כתובת URL או קטע קוד HTML ששולח את הבקשה מהשרת של הצד השלישי.

מחלקות משנה של טירגוט וטירגוט של מלאי שטחי פרסום

האובייקט InventoryTargeting מפרט אילו יחידות מודעות משויכות אל LineItem ספציפי. אפשר לציין קריטריוני טירגוט אופציונליים נוספים באמצעות מופעים נוספים של סוג המשנה המתאים של Targeting.

מיקום המודעה

אובייקט Placement הוא אוסף של אובייקט AdUnit אחד או יותר.

AdUnit

AdUnit מייצג מיקום מודעה בדף אחד או יותר. AdUnit יכול להיות יעד של אובייקט InventoryTargeting של LineItem או אובייקט Placement. אובייקט AdUnit כולל גודל, מזהה ושם ייחודי. המזהה משמש לזיהוי אובייקטים אחרים של AdUnit ב-API. השם משמש כמזהה ייחודי בתגי ה-HTML כדי לזהות אובייקט AdUnit ספציפי, והוא נשלח חזרה אל Ad Manager כחלק מבקשת הדף.