ב-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 | כללי תמחור |