विज्ञापन दिखने से जुड़ी क्वेरी और अमान्य ट्रैफ़िक मेट्रिक

खास जानकारी

यहां दिए गए निर्देशों में, एपीआई का इस्तेमाल करके मान्य विज्ञापन दिखने लायक ट्रैफ़िक और अमान्य ट्रैफ़िक, दोनों के बारे में क्वेरी करने के उदाहरण दिए गए हैं. ये मेट्रिक, Google Ads और Display & Video 360 का इस्तेमाल करके खरीदी गई इन्वेंट्री तक ही सीमित हैं.

ध्यान दें कि एमआरसी से मान्यता पा चुकी TrueView व्यू मेट्रिक के लिए, ADH API का इस्तेमाल करना ज़रूरी है. ऐसा इसलिए, क्योंकि इससे जुड़ी कोई टेंप्लेट वाली क्वेरी नहीं है. इसके अलावा, TrueView के व्यू मेट्रिक को विज्ञापन दिखने से जुड़े आंकड़े नहीं समझना चाहिए.

वह खरीदारी वाला चैनल चुनें जिसके लिए आपको विज्ञापन दिखने से जुड़ी मेट्रिक की क्वेरी करनी है:

यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके, विज्ञापन दिखने से जुड़े आंकड़ों की मेट्रिक के बारे में क्वेरी करना

टेंप्लेट वाली विज्ञापन दिखने से जुड़ी क्वेरी, एमआरसी से मान्यता पा चुकी मेट्रिक उपलब्ध कराती है.

एमआरसी की मान्यता बाइनरी होती है. इसका मतलब है कि आपके नतीजों को मान्यता मिल सकती है या नहीं. साथ ही, यह आपकी पूरी नतीजों की टेबल पर लागू होती है. आपको टेंप्लेट का इस्तेमाल करके क्वेरी चलानी होगी. साथ ही, इसमें कोई बदलाव नहीं करना होगा. इसके अलावा, आपको नतीजों में अंतर की जांच वाले मोड में क्वेरी चलानी होगी, ताकि आपकी मेट्रिक को एमआरसी से मान्यता मिल सके. Ads Data Hub को एमआरसी से मिली मान्यता, नॉइज़ मोड में की गई क्वेरी पर लागू नहीं होती.

टेंप्लेट की मदद से, एमआरसी से मान्यता वाली क्वेरी चलाने के लिए:

  1. क्वेरी बनाने का तरीका लेख में दिए गए निर्देशों का पालन करें. साथ ही, पक्का करें कि आपने खरीदारी वाले चैनल के तौर पर Google Ads और क्वेरी टेंप्लेट के तौर पर डिवाइस टाइप के हिसाब से वीडियो दिखने की जानकारी को चुना हो.
  2. टेंप्लेट का इस्तेमाल करें के बगल में मौजूद, चलाएं बटन पर क्लिक करें.

एपीआई का इस्तेमाल करके, अमान्य ट्रैफ़िक और विज्ञापन दिखने से जुड़े आंकड़ों की मेट्रिक के बारे में क्वेरी करना

अमान्य ट्रैफ़िक और विज्ञापन दिखने से जुड़ी मेट्रिक को ADH API से वापस पाया जा सकता है. इसके लिए, generateIvtReport , और startAnalysis एंडपॉइंट का इस्तेमाल करें. अमान्य ट्रैफ़िक के लिए, आपकी मेट्रिक generateIvtReport से हासिल की जानी चाहिए. इससे adh-mrc-accredited लेबल लागू किया जा सकेगा और आपकी मेट्रिक को एमआरसी से मान्यता मिल सकेगी. इसी तरह, एमआरसी से मान्यता पाने के लिए, ADH API के ज़रिए विज्ञापन दिखने से जुड़े मेट्रिक के लिए, नीचे दी गई ग्लोबल क्वेरी का इस्तेमाल करना ज़रूरी है. इस सेक्शन में, Python क्लाइंट लाइब्रेरी का इस्तेमाल करके इस एंडपॉइंट पर अनुरोध भेजने का तरीका बताया गया है.

एपीआई क्विकस्टार्ट में दिए गए सेटअप और अनुमति/पुष्टि करने के निर्देशों का पालन करें.

यहां दिए गए फ़ील्ड में अपने खाते से जुड़ी जानकारी डालने के बाद, नीचे दी गई क्वेरी चलाकर अपने Google Ads कैंपेन के लिए अमान्य ट्रैफ़िक की रिपोर्ट पाई जा सकती है:

  • क्लाइंट सीक्रेट फ़ाइल
  • ग्राहक आईडी
  • एपीआई पासकोड
  • Campaign IDs
  • समय क्षेत्र

सैंपल कोड

अमान्य ट्रैफ़िक

import json
import os.path
from google.auth.transport.requests import Request
from google.oauth2.credentials import Credentials
from google_auth_oauthlib.flow import InstalledAppFlow
from googleapiclient.discovery import build

# If modifying these scopes, delete the file `token.json`.
SCOPES = ['https://www.googleapis.com/auth/adsdatahub']
TOKEN_FILE = 'token.json'

creds = None

# The file token.json stores the user's access and refresh tokens, and is
# created automatically when the authorization flow completes for the first
# time.
if os.path.exists(TOKEN_FILE):
    creds = Credentials.from_authorized_user_file(TOKEN_FILE, SCOPES)
# If there are no (valid) credentials available, let the user log in.
if not creds or not creds.valid:
    if creds and creds.expired and creds.refresh_token:
        creds.refresh(Request())
    else:
        flow = InstalledAppFlow.from_client_secrets_file(
            'YOUR_CLIENT_SECRETS.json', SCOPES)
        creds = flow.run_local_server(port=0)
    # Save the credentials for the next run.
    with open(TOKEN_FILE, 'w') as token:
        token.write(creds.to_json())

service = build('adsdatahub', 'v1', credentials=creds,
                developerKey='YOUR_API_KEY', static_discovery=False)

body = {
    'ads_data_customer_id': YOUR_CUSTOMER_ID,
    'start_date': {
        'year': 2019,
        'month': 12,
        'day': 15
    },
    'end_date': {
        'year': 2019,
        'month': 12,
        'day': 20
    },
    'time_zone': 'YOUR_TIMEZONE',
    # Optional. Defaults to 'DAY' (one set of rows per day). Use
    # 'ENTIRE_DATE_RANGE' for a single set of rows covering the whole range.
    'date_dimension_granularity': 'DAY',
    'google_ads_dimensions': {
        'campaign_ids': [YOUR_CAMPAIGN_IDS],
        'metric_type': 'METRIC_TYPE_IMPRESSION'
    },
    'dest_table': 'YOUR_DESTINATION_TABLE'
}

resp = service.customers().generateIvtReport(
    name='customers/YOUR_CUSTOMER_ID', body=body).execute()
print(json.dumps(resp))

विज्ञापन दिखने की मेट्रिक

import json
import os.path
from google.auth.transport.requests import Request
from google.oauth2.credentials import Credentials
from google_auth_oauthlib.flow import InstalledAppFlow
from googleapiclient.discovery import build

# If modifying these scopes, delete the file `token.json`.
SCOPES = ['https://www.googleapis.com/auth/adsdatahub']
TOKEN_FILE = 'token.json'

creds = None

# The file token.json stores the user's access and refresh tokens, and is
# created automatically when the authorization flow completes for the first
# time.
if os.path.exists(TOKEN_FILE):
    creds = Credentials.from_authorized_user_file(TOKEN_FILE, SCOPES)
# If there are no (valid) credentials available, let the user log in.
if not creds or not creds.valid:
    if creds and creds.expired and creds.refresh_token:
        creds.refresh(Request())
    else:
        flow = InstalledAppFlow.from_client_secrets_file(
            'YOUR_CLIENT_SECRETS.json', SCOPES)
        creds = flow.run_local_server(port=0)
    # Save the credentials for the next run.
    with open(TOKEN_FILE, 'w') as token:
        token.write(creds.to_json())

service = build('adsdatahub', 'v1', credentials=creds,
                developerKey='YOUR_API_KEY', static_discovery=False)

name = 'customers/global/analysisQueries/f41320e7296d49158e572aba662f35b1'
body = {
  'spec': {
    'ads_data_customer_id': YOUR_CUSTOMER_ID,
    'start_date': {
      'year': 2019,
      'month': 12,
      'day': 15
    },
    'end_date': {
      'year': 2019,
      'month': 12,
      'day': 20
    },
    'time_zone': 'YOUR_TIMEZONE',
    'parameter_values': {
      'campaign_ids': {
        'array_value': {
          'values': [
            {
              'value': 'YOUR_CAMPAIGN_ID'
            },
          ]
        }
      }
    }
  },
  'dest_table': 'YOUR_DESTINATION_TABLE',
  'customer_id': YOUR_CUSTOMER_ID
}

resp = service.customers().analysisQueries().start(name=name,body=body).execute()
print(json.dumps(resp))

आसानी से पहचान में आने वाले अमान्य ट्रैफ़िक को छोड़कर, विज्ञापन दिखने से जुड़ी मेट्रिक का हिसाब लगाना

एमआरसी से मान्यता पा चुकी, विज्ञापन दिखने से जुड़ी मेट्रिक में से आसानी से पहचान में आने वाले अमान्य ट्रैफ़िक (जीआईवीटी) को हटाने के लिए, इन फ़ॉर्मूलों का इस्तेमाल करें:

  • कुल इंप्रेशन (जीआईवीटी को छोड़कर): कुल इंप्रेशन - आसानी से पहचान में आने वाले अमान्य इंप्रेशन
  • दिखने वाले इंप्रेशन (जीआईवीटी को छोड़कर): दिखने वाले इंप्रेशन + दिखने वाले अमान्य इंप्रेशन - जीआईवीटी से मिले दिखने वाले इंप्रेशन
  • मेज़र किए जा सकने वाले इंप्रेशन (जीआईवीटी को छोड़कर): मेज़र किए जा सकने वाले इंप्रेशन + मेज़र किए जा सकने वाले अमान्य इंप्रेशन - जीआईवीटी से मिले मेज़र किए जा सकने वाले इंप्रेशन
  • अनुमानित इंप्रेशन (जीआईवीटी को छोड़कर): अनुमानित इंप्रेशन + अमान्य अनुमानित इंप्रेशन - जीआईवीटी से मिले अनुमानित इंप्रेशन
  • न दिखने वाला इंप्रेशन (जीआईवीटी को छोड़कर) : मेज़र किए जा सकने वाले इंप्रेशन (जीआईवीटी को छोड़कर) - दिखने वाले इंप्रेशन (जीआईवीटी को छोड़कर)
  • मेज़र न किए जा सकने वाले इंप्रेशन (जीआईवीटी को छोड़कर): अनुमानित इंप्रेशन (जीआईवीटी को छोड़कर) - मेज़र किए जा सकने वाले इंप्रेशन (जीआईवीटी को छोड़कर)
  • मेज़र किए जा सकने वाले इंप्रेशन का प्रतिशत (जीआईवीटी को छोड़कर): मेज़र किए जा सकने वाले इंप्रेशन (जीआईवीटी को छोड़कर) / अनुमानित इंप्रेशन (जीआईवीटी को छोड़कर)
  • % दिखने वाले इंप्रेशन (जीआईवीटी को छोड़कर): दिखने वाले इंप्रेशन (जीआईवीटी को छोड़कर) / मेज़र किए जा सकने वाले इंप्रेशन (जीआईवीटी को छोड़कर)