खास जानकारी
यहां दिए गए निर्देशों में, एपीआई का इस्तेमाल करके, मान्य विज्ञापन दिखने के ट्रैफ़िक और अमान्य ट्रैफ़िक, दोनों के बारे में क्वेरी करने का तरीका बताया गया है. ये मेट्रिक, Google Ads, Display & Video 360, और YouTube Reserve का इस्तेमाल करके खरीदी गई इन्वेंट्री तक ही सीमित हैं.
ध्यान दें कि एमआरसी से मान्यता प्राप्त TrueView व्यू व्यू मेट्रिक के लिए, ADH API का इस्तेमाल करना ज़रूरी है. इसकी वजह यह है कि इनसे जुड़ी कोई टेंप्लेट की गई क्वेरी नहीं है. इसके अलावा, TrueView व्यू की मेट्रिक को विज्ञापन दिखने से जुड़ी मेट्रिक के साथ नहीं जोड़ा जाना चाहिए.
वह बिडिंग डोर चुनें जिसके लिए आपको व्यूबिलिटी मेट्रिक की क्वेरी करनी है:
यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके, विज्ञापन दिखने से जुड़ी मेट्रिक के बारे में क्वेरी करना
टेंप्लेट वाली व्यूबिलिटी क्वेरी, MRC से मान्यता वाली मेट्रिक उपलब्ध कराती है.
एमआरसी से मान्यता मिलने की स्थिति दो तरह की होती है—आपके नतीजों को मान्यता मिल सकती है या नहीं. यह मान्यता, आपकी पूरी नतीजों की टेबल पर लागू होती है. BigQuery में, एमआरसी से मान्यता प्राप्त सभी नतीजों पर लेबल adh-mrc-accredited
लागू होता है. एमआरसी से मान्यता पाने के लिए, आपको टेंप्लेट की मदद से क्वेरी चलानी होगी.
टेंप्लेट की मदद से, MRC से मान्यता वाली क्वेरी चलाने के लिए:
- क्वेरी बनाने का तरीका जानने के लिए दिए गए निर्देशों का पालन करें. साथ ही, यह पक्का करें कि आपने खरीदारी के लिए YouTube Reserve और क्वेरी टेंप्लेट के तौर पर वीडियो व्यूबिलिटी को चुना हो.
- टेंप्लेट का इस्तेमाल करें के बगल में मौजूद, चालू करें बटन पर क्लिक करें.
एपीआई का इस्तेमाल करके, अमान्य ट्रैफ़िक और विज्ञापन दिखने की मेट्रिक के बारे में क्वेरी करना
अमान्य ट्रैफ़िक और विज्ञापन दिखने की मेट्रिक को ADH API से generateIvtReport
, और startAnalysis
एंडपॉइंट का इस्तेमाल करके वापस पाया जा सकता है. अमान्य ट्रैफ़िक के लिए, adh-mrc-accredited
लेबल लागू करने और एमआरसी से मान्यता पाने के लिए, आपकी मेट्रिक को generateIvtReport
के ज़रिए वापस पाना ज़रूरी है. इसी तरह, एमआरसी से मान्यता पाने के लिए, ADH API की मदद से वीडियो में दिखने से जुड़ी मेट्रिक के लिए, यहां दी गई ग्लोबल क्वेरी का इस्तेमाल किया जाना चाहिए. इस सेक्शन में, Python क्लाइंट लाइब्रेरी का इस्तेमाल करके इस एंडपॉइंट को अनुरोध भेजने का तरीका बताया गया है.
एपीआई क्विकस्टार्ट में दिए गए सेटअप और अनुमति/पुष्टि करने के निर्देशों का पालन करें.
नीचे दिए गए फ़ील्ड को अपने खाते से जुड़ी जानकारी से बदलने के बाद, अपने YouTube Reserve कैंपेन के लिए अमान्य ट्रैफ़िक की रिपोर्ट पाने के लिए, नीचे दी गई क्वेरी चलाएं:
- क्लाइंट सीक्रेट फ़ाइल
- ग्राहक आईडी
- एपीआई पासकोड
- Order IDs
- समय क्षेत्र
नमूना कोड
अमान्य ट्रैफ़िक
from __future__ import print_function
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',
discoveryServiceUrl='https://adsdatahub.googleapis.com/$discovery/rest?version=v1&labels=')
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',
'yt_reserve_dimensions': {
'order_ids': [YOUR_ORDER_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))
विज्ञापन दिखने की मेट्रिक
from __future__ import print_function
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',
discoveryServiceUrl='https://adsdatahub.googleapis.com/$discovery/rest?version=v1&labels=')
name = 'customers/global/analysisQueries/ad88e8562a8f4baa9c8522945fe95522'
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': {
'line_item_ids': {
'array_value': {
'values': [
{
'value': 'YOUR_LINE_ITEM_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))
आसानी से पहचान में आने वाले अमान्य ट्रैफ़िक को हटाकर, व्यू की जाने की संभावना से जुड़ी मेट्रिक का हिसाब लगाना
आसानी से पहचान में आने वाले अमान्य ट्रैफ़िक (जीआईवीटी) को छोड़कर, एमआरसी से मान्यता प्राप्त विज्ञापन दिखने की दर की मेट्रिक का हिसाब लगाने के लिए, ये फ़ॉर्मूले इस्तेमाल करें:
- कुल इंप्रेशन (जीआईवीटी को छोड़कर): कुल इंप्रेशन - सामान्य अमान्य इंप्रेशन
- दिखने वाले इंप्रेशन (जीआईवीटी को छोड़कर): दिखने वाले इंप्रेशन + दिखने वाले अमान्य इंप्रेशन - जीआईवीटी से मिले दिखने वाले इंप्रेशन
- मेज़र किए जा सकने वाले इंप्रेशन (जीआईवीटी को छोड़कर): मेज़र किए जा सकने वाले इंप्रेशन + मेज़र किए जा सकने वाले अमान्य इंप्रेशन - जीआईवीटी से मिले मेज़र किए जा सकने वाले इंप्रेशन
- ज़रूरी शर्तें पूरी करने वाले इंप्रेशन (जीआईवीटी को छोड़कर): ज़रूरी शर्तें पूरी करने वाले इंप्रेशन + ज़रूरी शर्तें पूरी करने वाले अमान्य इंप्रेशन - ज़रूरी शर्तें पूरी करने वाले ऐसे इंप्रेशन जो जीआईवीटी से मिले हैं
- न दिखने वाले इंप्रेशन (जीआईवीटी को छोड़कर) : मेज़र किए जा सकने वाले इंप्रेशन (जीआईवीटी को छोड़कर) - दिखने वाले इंप्रेशन (जीआईवीटी को छोड़कर)
- मेज़र न किए जा सकने वाले इंप्रेशन (जीआईवीटी को छोड़कर): ज़रूरी शर्तें पूरी करने वाले इंप्रेशन (जीआईवीटी को छोड़कर) - मेज़र किए जा सकने वाले इंप्रेशन (जीआईवीटी को छोड़कर)
- मेज़र किए जा सकने वाले इंप्रेशन का प्रतिशत (जीआईवीटी को छोड़कर): मेज़र किए जा सकने वाले इंप्रेशन (जीआईवीटी को छोड़कर) / ज़रूरी शर्तें पूरी करने वाले इंप्रेशन (जीआईवीटी को छोड़कर)
- दिखने वाले इंप्रेशन का प्रतिशत (जीआईवीटी को छोड़कर): दिखने वाले इंप्रेशन (जीआईवीटी को छोड़कर) / मेज़र किए जा सकने वाले इंप्रेशन (जीआईवीटी को छोड़कर)