Method: customers.generateIvtReport

किसी खास प्लैटफ़ॉर्म के लिए, अमान्य ट्रैफ़िक की गिनती से जुड़ी हर दिन की खास जानकारी पाने के लिए, क्वेरी को लागू करना शुरू करता है. नतीजे, BigQuery की डेस्टिनेशन टेबल में लिखे जाएंगे. लौटाए गए ऑपरेशन के नाम का इस्तेमाल क्वेरी पूरा होने की स्थिति के लिए पोल में करने के लिए किया जा सकता है.

आउटपुट टेबल में तारीख की सीमा के लिए हर दिन की पांच पंक्तियां होती हैं. चार तरह के डिवाइस में से हर एक के लिए एक पंक्ति और सभी तरह के डिवाइस के लिए एक पंक्ति. सभी लाइन उस दिन के लिए चार तरह के डिवाइस का योग है. इस वजह से, हर कॉलम में इंप्रेशन की कुल संख्या का दोगुना होता है. अगर निजता की कमी की वजह से ADH पंक्तियां बदलता है, तो फ़िल्टर की गई पंक्ति की खास जानकारी (बिना दिन वाली पंक्ति) में बदली गई पंक्तियों का योग शामिल होगा.

एचटीटीपी अनुरोध

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

यूआरएल में gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल होता है.

पाथ पैरामीटर

पैरामीटर
name

string

Ads Data Hub का अनुरोध करने वाला ग्राहक. यह इस रूप में है(#&39;customers/[customerId]'. e.g. 'customers/123'.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में ये स्ट्रक्चर शामिल हैं:

जेएसओएन के काेड में दिखाना 
{
  "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 Data Hub का ग्राहक आईडी.
startDate

object (Date)

जनरेट की गई रिपोर्ट का पहला दिन.
endDate

object (Date)

जनरेट की गई रिपोर्ट का आखिरी दिन.
timeZone

string

ज़रूरी नहीं. रिपोर्ट के शुरू और खत्म होने की तारीख का समय क्षेत्र. अगर बताया नहीं गया है, तो डिफ़ॉल्ट रूप से 'UTC' होता है.
destTable

string

क्वेरी के नतीजों के लिए, डेस्टिनेशन BigQuery टेबल का फ़ॉर्मैट #339;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 प्लैटफ़ॉर्म के लिए डाइमेंशन फ़िल्टर करना.

जेएसओएन के काेड में दिखाना 
{
  "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 प्लैटफ़ॉर्म के लिए डाइमेंशन फ़िल्टर करना.

जेएसओएन के काेड में दिखाना 
{
  "lineItemIds": [
    string
  ],
  "metricType": enum (MetricType)
}
फ़ील्ड
lineItemIds[]

string (int64 format)

DV360 के लिए लाइन आइटम के वैकल्पिक आईडी. अगर खाली है, तो बताई गई समयावधि के लिए सभी लाइन आइटम की रिपोर्ट दें.
metricType

enum (MetricType)

प्लैटफ़ॉर्म को मेज़र और रिपोर्ट करने के लिए, मंज़ूरी देता है.

YouTubeReserveडाइमेंशन

YouTube Reserve प्लैटफ़ॉर्म के डाइमेंशन फ़िल्टर करना.

जेएसओएन के काेड में दिखाना 
{
  "orderIds": [
    string
  ],
  "metricType": enum (MetricType)
}
फ़ील्ड
orderIds[]

string (int64 format)

YouTube Reserve के वैकल्पिक ऑर्डर आईडी. अगर खाली है, तो बताई गई समयावधि के लिए सभी ऑर्डर की रिपोर्ट करें.
metricType

enum (MetricType)

प्लैटफ़ॉर्म को मेज़र और रिपोर्ट करने के लिए, मंज़ूरी देता है.