Method: customers.generateIvtReport

מתחיל ביצוע שאילתה כדי לאחזר סיכום יומי של ספירת תנועה לא חוקית עבור פלטפורמה ספציפית. התוצאות ייכתבו לטבלת היעד שצוינה ב-BigQuery. ניתן להשתמש בשם הפעולה שמוחזר כדי לעבור על סטטוס ההשלמה של שאילתה.

טבלת הפלט מכילה 5 שורות לכל יום בטווח התאריכים. שורה אחת לכל אחד מ-4 סוגי המכשירים, ושורה אחת לכל סוגי המכשירים. השורה 'הכול' היא הסכום של 4 סוגי המכשירים עבור אותו יום. כתוצאה מכך, כל עמודה מכילה פי שניים יותר ממספר החשיפות. אם השורה ADH מצונזרת עקב אילוצי פרטיות, סיכום השורה המסוננת (השורה ללא יום) יכלול את סך השורות מצונזרות.

בקשת HTTP

POST https://adsdatahub.googleapis.com/v1/{name=customers/*}:generateIvtReport

כתובת ה-URL כוללת תחביר gRPC קידוד מחדש.

פרמטרים של נתיב

פרמטרים
name

string

הלקוח של Ads Data Hub מבצע את הבקשה. היא בפורמט של 'customers/[customerId]'. לדוגמה 'customers/123'.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "adsDataCustomerId": string,
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  },
  "timeZone": string,
  "destTable": string,

  // Union field platform_dimensions can be only one of the following:
  "googleAdsDimensions": {
    object (GoogleAdsDimensions)
  },
  "dv360YoutubeDimensions": {
    object (Dv360Dimensions)
  },
  "ytReserveDimensions": {
    object (YouTubeReserveDimensions)
  }
  // End of list of possible types for union field platform_dimensions.
}
שדות
adsDataCustomerId

string (int64 format)

מספר הלקוח של חשבון Ads המקושר ב-Ads Ads שבבעלותו נמצאים נתוני המודעות.
startDate

object (Date)

היום הראשון של הדוח שנוצר.
endDate

object (Date)

היום האחרון של הדוח שנוצר, כולל.
timeZone

string

אופציונלי. אזור הזמן של תאריכי ההתחלה והסיום של הדוח. אם לא צוין אחרת, ברירת המחדל היא 'UTC'.
destTable

string

טבלת יעדים של BigQuery לתוצאות שאילתה בפורמט 'project.dataset.table_name'. אם תציינו זאת, הפרויקט חייב להיכלל ברשימת ההיתרים מפורשות לחשבון ADH של הלקוח. אם לא צוין פרויקט, המערכת משתמשת בפרויקט ברירת המחדל עבור הלקוח שסופק. אם לא צוין פרויקט או מערך נתונים, המערכת משתמשת בפרויקט ובמערך הנתונים שמוגדרים כברירת מחדל.
שדה איחוד platform_dimensions. הפלטפורמה שעליה יש לדווח באמצעות פריסה אופציונלית של פלטפורמה ספציפית. אם לא בוחרים פלטפורמה, תופיע הודעת שגיאה. platform_dimensions יכול להיות רק אחד מאלה:
googleAdsDimensions

object (GoogleAdsDimensions)

דיווח על הפלטפורמה של Google Ads.
dv360YoutubeDimensions

object (Dv360Dimensions)

דיווח על הפלטפורמה DV360.
ytReserveDimensions

object (YouTubeReserveDimensions)

דוח על הפלטפורמה YTR.

גוף התגובה

אם התגובה מוצלחת, גוף התגובה מכיל מופע של Operation.

היקפי הרשאה

יש צורך בהיקף OAuth הבא:

  • https://www.googleapis.com/auth/adsdatahub

מאפייני Google Ads

מאפייני סינון לפלטפורמה של Google Ads.

ייצוג JSON 
{
  "campaignIds": [
    string
  ],
  "metricType": enum (MetricType)
}
שדות
campaignIds[]

string (int64 format)

מזהים אופציונליים של קמפיינים ב-Google Ads. אם השדה ריק, מדווח על כל הקמפיינים לתקופת הזמן שצוינה.
metricType

enum (MetricType)

מציין את הפלטפורמה למדידה ולדיווח.

סוג מדד

מציין את הפלטפורמה למדידה ולדיווח.

Enums
METRIC_TYPE_UNSPECIFIED סוג המדד לא צוין.
METRIC_TYPE_IMPRESSION נתוני חשיפות ב-Google Ads.
METRIC_TYPE_YOUTUBE_VIEW צפיות ב-YouTube, נקרא גם צפיות ב-TrueView.

מימדים ב-DV360

מאפייני סינון לפלטפורמה של DV360.

ייצוג JSON 
{
  "lineItemIds": [
    string
  ],
  "metricType": enum (MetricType)
}
שדות
lineItemIds[]

string (int64 format)

מזהים אופציונליים של פריטים ב-DV360. אם המדיניות ריקה, מדווח על כל הפריטים לתקופת הזמן שצוינה.
metricType

enum (MetricType)

מציין את הפלטפורמה למדידה ולדיווח.

מאפיינים שמורים של YouTube

מאפייני סינון לפלטפורמה של YouTube Reserve.

ייצוג JSON 
{
  "orderIds": [
    string
  ],
  "metricType": enum (MetricType)
}
שדות
orderIds[]

string (int64 format)

מזהי הזמנות אופציונליים ב-YouTube Reserve. אם השדה ריק, יישלח דיווח על כל ההזמנות לתקופת הזמן שצוינה.
metricType

enum (MetricType)

מציין את הפלטפורמה למדידה ולדיווח.