ב-Google Ad Manager יש SOAP API לדיווח ולניהול של ישויות לניהול קמפיינים, כמו LineItems.
ספריות לקוח זמינות בכמה שפות. כמו AdX Seller API, גם Ad Manager API משתמש ב-OAuth2 לצורך אימות.
כדי להתחיל לעבוד עם בקשת ה-API הראשונה, קראו את המאמר תחילת העבודה.
דיווח ב-Ad Manager API
ReportService ב-Ad Manager API מציע שתי דרכים להפעיל ולהוריד דוחות:
- יצירת שאילתה בממשק המשתמש והרצה שלה על סמך המזהה שלה.
- יצירת ReportQuery אד-הוק.
בשתי האפשרויות, תהליך העבודה של ה-API מורכב מארבעה שלבים:
- מפעילים את runReportJob.
- מבצעים סקר לגבי סטטוס הדוח באמצעות getReportJobStatus.
- מקבלים את כתובת ה-URL של הדוח המוכן באמצעות getReportDownloadUrlWithOptions.
- מורידים את הדוח מכתובת ה-URL שהוחזרה.
פרטים נוספים זמינים במדריך הדיווח.
אזורי הזמן שמוגדרים לדיווח
בניגוד ל-Ad Exchange Seller REST API, ב-Ad Manager API הדוחות מוגדרים כברירת מחדל לאזור הזמן של הרשת שלכם. כדי לשנות את זה, צריך להגדיר את השדה TimeZoneType.
מיפוי המדדים והמאפיינים של AdX ל-Ad Manager
כל המדדים והמאפיינים הנתמכים של Ad Exchange Seller API בארכיטקטורת REST קיימים עכשיו ב-Ad Manager reporting API. חלק מהשמות השתנו, וחלק הוצאו משימוש. פרטים נוספים מופיעים בטבלאות הבאות.
מדדים או עמודות
בטבלה הזו מפורטים המדדים של 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 | הכנסה מכל אלף חשיפות של המודעה (Ad 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 | (המלצה חדשה) הכנסה מכל אלף חשיפות של המודעה (Ad eCPM) |
| LIFT_RATE | AD_EXCHANGE_LIFT | הרם |
| MATCHED_AD_REQUESTS | AD_EXCHANGE_MATCHED_REQUESTS | בקשות שמולאו |
| MATCHED_AD_REQUESTS_CTR | AD_EXCHANGE_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 | צפיות תקפות |
| 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 | יחידות מודעות ב-DFP |
| 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 | כללי תמחור |