ב-Google Ad Manager יש SOAP API גם לדיווח וגם למניפולציה של ישויות לניהול טראפיק, כמו LineItems.
ספריות לקוח זמינות בכמה שפות. בדומה ל-AdX Seller API, Ad Manager API משתמש ב-OAuth2 לאימות.
כדי להתחיל עם בקשת ה-API הראשונה, ראו תחילת העבודה.
דיווח ב-Ad Manager API
ReportService בממשק ה-API של Ad Manager כולל שתי דרכים להפעלה ולהורדה של דוחות:
- יצירת שאילתה בממשק המשתמש והרצתה על סמך המזהה שלה.
- יצירת ReportQuery אד-הוק.
בכל אחת מהאפשרויות, תהליך העבודה של ה-API כולל ארבעה שלבים:
- להתקשר אל runReportJob.
- סקר לגבי סטטוס הדוח באמצעות getReportJobStatus.
- קבל את כתובת האתר לדוח המלא באמצעות getReportDownloadUrlWithOptions.
- מורידים את הדוח מכתובת ה-URL שהוחזרה.
פרטים נוספים זמינים במדריך לדיווח.
אזורי זמן לדיווח
בניגוד ל-Ad Exchange Seller API, הדוחות של Ad Manager API מוגדרים לפי אזור הזמן של הרשת שלכם כברירת מחדל. כדי לשנות זאת, מגדירים את השדה TimeZoneType.
מיפוי מדדים ומימדים מ-AdX ל-Ad Manager
כל המדדים והמאפיינים הנתמכים של Ad Exchange Seller API ל-REST מופיעים עכשיו ב-Reporting API של Ad Manager. חלק מהשמות השתנו וחלק הוצאו משימוש. הפרטים מופיעים בטבלאות שבהמשך.
מדדים / עמודות
בטבלה הזו מתבצע מיפוי של מדדי AdX לעמודות של Ad Manager.
| ערך של AdX | עמודה של Ad Manager | השם של כלי השאילתות ב-Ad Manager |
|---|---|---|
| ACTIVE_VIEW_ELIGIBLE_COUNT | AD_EXCHANGE_ACTIVE_VIEW_ENABLED_IMPRESSIONS | חשיפות שהופעלו ב-Active View |
| ACTIVE_VIEW_MEASURABLE_COUNT | AD_EXCHANGE_ACTIVE_VIEW_MEASURED_IMPRESSIONS | חשיפות שנמדדו ב-Active View |
| ACTIVE_VIEW_MEASURABLE_RATIO | (הוצא משימוש) | (הוצא משימוש) |
| ACTIVE_VIEW_VIEWABLE_COUNT | AD_EXCHANGE_ACTIVE_VIEW_VIEWED_IMPRESSIONS | חשיפות שנצפו ב-Active View |
| ACTIVE_VIEW_VIEWABLE_RATIO | (הוצא משימוש) | (הוצא משימוש) |
| ACTIVE_VIEW_VIEWABLE_TIME | AD_EXCHANGE_AVERAGE_VIEWABLE_TIME | זמן ממוצע של חשיפה ניתנת לצפייה (שניות) |
| AD_IMPRESSIONS | AD_EXCHANGE_IMPRESSIONS | חשיפות של מודעות |
| AD_IMPRESSIONS_RPM | AD_EXCHANGE_AD_ECPM | עלות בפועל לאלף חשיפות (eCPM) של המודעה |
| AD_REQUESTS | AD_EXCHANGE_AD_REQUESTS | בקשות להצגת מודעות |
| AD_REQUESTS_COVERAGE | AD_EXCHANGE_COVERAGE | כיסוי |
| AD_REQUESTS_CTR | AD_EXCHANGE_AD_REQUEST_CTR | שיעור הקליקים של בקשה למודעה |
| AD_REQUESTS_RPM | AD_EXCHANGE_AD_REQUEST_ECPM | עלות בפועל לאלף חשיפות של בקשות להצגת מודעה |
| קליקים | AD_EXCHANGE_CLICKS | קליקים |
| COST_PER_CLICK | AD_EXCHANGE_CPC | מחיר לקליק |
| DEALS_AD_REQUESTS | AD_EXCHANGE_DEALS_AD_REQUESTS | בקשות להצגת מודעות של מבצעים |
| DEALS_BID_RESPONSES | AD_EXCHANGE_DEALS_BID_RESPONSES | תגובות להצעת מחיר על עסקאות |
| DEALS_MATCH_RATE | AD_EXCHANGE_DEALS_MATCH_RATE | שיעור הבקשות שמולאו במבצעים |
| DEALS_MATCHED_REQUESTS | AD_EXCHANGE_DEALS_MATCHED_REQUESTS | בקשות להצגת עסקאות שמולאו |
| רווחים | AD_EXCHANGE_ESTIMATED_REVENUE | אומדן ההכנסות |
| INDIVIDUAL_AD_IMPRESSIONS | (הוצא משימוש) | (הוצא משימוש) |
| INDIVIDUAL_AD_IMPRESSIONS_CTR | AD_EXCHANGE_AD_CTR | שיעור קליקים של המודעה |
| INDIVIDUAL_AD_IMPRESSIONS_RPM | (המלצה חדשה) AD_EXCHANGE_AD_ECPM | (המלצה חדשה) עלות בפועל לאלף חשיפות (eCPM) של מודעה |
| LIFT_RATE | AD_EXCHANGE_LIFT | הרמה |
| MATCHED_AD_REQUESTS | AD_EXCHANGE_MATCHED_REQUESTS | בקשות שמולאו |
| MATCHED_AD_REQUESTS_CTR | AD_EXCHANGE_CTR | CTR |
| MATCHED_AD_REQUESTS_RPM | AD_EXCHANGE_MATCHED_ECPM | עלות תואמת בפועל לאלף חשיפות |
| VIDEO_AD_ABANDONMENT_RATIO | AD_EXCHANGE_VIDEO_ABANDONMENT_RATE | שיעור הנטישה של הסרטון |
| VIDEO_AD_DROPOFF_RATIO | AD_EXCHANGE_VIDEO_DROPOFF_RATE | שיעור הנשירה מתהליך המרה של סרטון |
| VIDEO_AD_QUARTILE_ONE | AD_EXCHANGE_VIDEO_QUARTILE_1 | רבעון 1 של סרטון |
| VIDEO_AD_QUARTILE_THREE | AD_EXCHANGE_VIDEO_QUARTILE_3 | רבעון 3 של סרטון |
| VIDEO_AD_SKIPPABLE_SKIP_RATIO | AD_EXCHANGE_VIDEO_TRUEVIEW_SKIP_RATE | שיעור הדילוגים של TrueView |
| VIDEO_AD_SKIPPABLE_VIEWS | AD_EXCHANGE_VIDEO_TRUEVIEW_VIEWS | צפיות ב-TrueView |
| VIDEO_AD_SKIPPABLE_VTR | AD_EXCHANGE_VIDEO_TRUEVIEW_VTR | שיעור צפייה ב-TrueView |
מאפיינים
בטבלה הזו מתבצע מיפוי של מאפייני AdX למאפיינים ב-Ad Manager .
| המאפיין של AdX | המאפיין של Ad Manager | השם של כלי השאילתות ב-Ad Manager |
|---|---|---|
| AD_CLIENT_ID | AD_EXCHANGE_WEB_PROPERTY_CODE | נכס אינטרנט |
| AD_LOCATION | AD_EXCHANGE_AD_LOCATION | מיקומי מודעות |
| AD_TAG_NAME | AD_EXCHANGE_TAG_NAME | תגים |
| AD_UNIT_SIZE_CODE | AD_EXCHANGE_INVENTORY_SIZE_CODE | (האפשרות לא זמינה) |
| AD_UNIT_SIZE_NAME | AD_EXCHANGE_INVENTORY_SIZE | גדלים של מלאי שטחי פרסום |
| ADVERTISER_DOMAIN | AD_EXCHANGE_ADVERTISER_DOMAIN | דומיינים של מפרסם |
| ADVERTISER_NAME | AD_EXCHANGE_ADVERTISER_NAME | מפרסמים |
| ADVERTISER_VERTICAL | AD_EXCHANGE_ADVERTISER_VERTICAL | ענף המפרסם |
| AGENCY_NAME | AD_EXCHANGE_AGENCY | סוכנויות |
| BID_TYPE_CODE | AD_EXCHANGE_BID_TYPE_CODE | (האפשרות לא זמינה) |
| BRAND_NAME | AD_EXCHANGE_BRAND_NAME | חברות |
| BRANDING_TYPE_CODE | AD_EXCHANGE_BRANDING_TYPE_CODE | (האפשרות לא זמינה) |
| BRANDING_TYPE_NAME | AD_EXCHANGE_BRANDING_TYPE | סוגי מיתוג |
| BUYER_NETWORK_ID | AD_EXCHANGE_BUYER_NETWORK_ID | (האפשרות לא זמינה) |
| BUYER_NETWORK_NAME | AD_EXCHANGE_BUYER_NETWORK_NAME | רשתות של קונים |
| COUNTRY_CODE | AD_EXCHANGE_COUNTRY_CODE | (האפשרות לא זמינה) |
| COUNTRY_NAME | AD_EXCHANGE_COUNTRY_NAME | מדינות |
| CREATIVE_SIZE | AD_EXCHANGE_CREATIVE_SIZES | גדלים של קריאייטיבים |
| CUSTOM_CHANNEL_CODE | AD_EXCHANGE_CUSTOM_CHANNEL_CODE | (האפשרות לא זמינה) |
| CUSTOM_CHANNEL_ID | AD_EXCHANGE_CUSTOM_CHANNEL_ID | (האפשרות לא זמינה) |
| CUSTOM_CHANNEL_NAME | AD_EXCHANGE_CHANNEL_NAME | ערוצים |
| תאריך | AD_EXCHANGE_DATE | ימים |
| DEAL_ID | AD_EXCHANGE_DEAL_ID | מזהי עסקה |
| DEAL_NAME | AD_EXCHANGE_DEAL_NAME | שמות המבצעים |
| DFP_AD_UNIT_ID | AD_EXCHANGE_DFP_AD_UNIT_ID | (האפשרות לא זמינה) |
| DFP_AD_UNITS | AD_EXCHANGE_DFP_AD_UNIT | יחידות מודעות של DoubleClick לבעלי אתרים |
| DFP_REQUEST_SOURCE | AD_EXCHANGE_REQUEST_SOURCES | מקורות הבקשה |
| DOMAIN_NAME | AD_EXCHANGE_SITE_NAME | אתרים |
| DSP_NAME | AD_EXCHANGE_DSP_BUYER_NETWORK_NAME | פלטפורמות בצד הביקוש |
| EXPANSION_TYPE_NAME | AD_EXCHANGE_EXPANSION_TYPE | סוגים מתרחבים |
| INVENTORY_OWNERSHIP | AD_EXCHANGE_INVENTORY_OWNERSHIP | בעלות על מלאי |
| INVENTORY_PARTNER_NAME | AD_EXCHANGE_NETWORK_PARTNER_NAME | שמות שותפי הרשת |
| MOBILE_APP_NAME | AD_EXCHANGE_MOBILE_APP_NAME | שמות אפליקציות |
| MOBILE_CARRIER_NAME | AD_EXCHANGE_MOBILE_CARRIER_NAME | שמות הספקים |
| MOBILE_DEVICE_NAME | AD_EXCHANGE_MOBILE_DEVICE_NAME | מכשירים |
| MOBILE_INVENTORY_TYPE | AD_EXCHANGE_MOBILE_INVENTORY_TYPE | סוגים של מלאי שטחי פרסום |
| MOBILE_OS_VERSION | AD_EXCHANGE_OPERATING_SYSTEM | מערכות הפעלה |
| MOBILE_USER_BANDWIDTH | AD_EXCHANGE_USER_BANDWIDTH_NAME | רוחב פס |
| חודש | AD_EXCHANGE_MONTH | חודשים |
| PLATFORM_TYPE_NAME | AD_EXCHANGE_DEVICE_CATEGORY | קטגוריות מכשירים |
| PRODUCT_CODE | AD_EXCHANGE_PRODUCT_CODE | (האפשרות לא זמינה) |
| PRODUCT_NAME | AD_EXCHANGE_PRODUCT_NAME | מוצרים |
| TARGETING_TYPE_CODE | AD_EXCHANGE_TARGETING_TYPE_CODE | (האפשרות לא זמינה) |
| TARGETING_TYPE_NAME | AD_EXCHANGE_TARGETING_TYPE | סוגי מיקוד |
| TRANSACTION_TYPE_CODE | AD_EXCHANGE_TRANSACTION_TYPE_CODE | (האפשרות לא זמינה) |
| TRANSACTION_TYPE_NAME | AD_EXCHANGE_TRANSACTION_TYPE | סוגי עסקאות |
| URL_CHANNEL_ID | AD_EXCHANGE_URL_ID | (האפשרות לא זמינה) |
| URL_CHANNEL_NAME | AD_EXCHANGE_URL | כתובות URL |
| VIDEO_AD_DURATION | AD_EXCHANGE_VIDEO_AD_DURATION | (האפשרות לא זמינה) |
| VIDEO_AD_DURATION_RAW | AD_EXCHANGE_VIDEO_AD_DURATION_RAW | משך הזמן של מודעת הווידאו |
| VIDEO_AD_FORMAT | AD_EXCHANGE_VIDEO_AD_TYPE | סוגים של מודעות וידאו |
| שבוע | AD_EXCHANGE_WEEK | שבוע |
| WINNING_BID_RULE_ID | AD_EXCHANGE_PRICING_RULE_ID | (האפשרות לא זמינה) |
| WINNING_BID_RULE_NAME | AD_EXCHANGE_PRICING_RULE_NAME | כללי תמחור |