দর্শনযোগ্যতা এবং অবৈধ ট্রাফিক মেট্রিক্স জিজ্ঞাসা করুন

ওভারভিউ

নীচের নির্দেশাবলী এপিআই ব্যবহার করে বৈধ দর্শনযোগ্যতা ট্রাফিক এবং অবৈধ ট্র্যাফিক উভয়েরই প্রশ্ন করার উদাহরণ প্রদান করে৷ এই মেট্রিকগুলি Google Ads, Display & Video 360 এবং YouTube রিজার্ভ ব্যবহার করে কেনা ইনভেন্টরির মধ্যে সীমাবদ্ধ।

মনে রাখবেন যে MRC-অনুমোদিত TrueView ভিউ ভিউ মেট্রিক্সের জন্য ADH API ব্যবহার করা প্রয়োজন, কারণ সেখানে কোনো সংশ্লিষ্ট টেমপ্লেটেড ক্যোয়ারী নেই। অতিরিক্তভাবে, TrueView ভিউ ভিউ মেট্রিক্সকে দর্শনযোগ্যতা মেট্রিক্সের সাথে বিভ্রান্ত করা উচিত নয়।

কেনার দরজাটি নির্বাচন করুন যেটির জন্য আপনি দর্শনযোগ্যতার মেট্রিক্স জিজ্ঞাসা করতে চান:

স্থানধারক35 l10n-প্লেসহোল্ডার-প্লেসহোল্ডার136 38 l10n-

UI ব্যবহার করে দর্শনযোগ্যতা মেট্রিক্স জিজ্ঞাসা করুন

টেমপ্লেট করা দর্শনযোগ্যতা প্রশ্ন MRC-স্বীকৃত মেট্রিক্স প্রদান করে।

MRC স্বীকৃতি বাইনারি—আপনার ফলাফল স্বীকৃত হতে পারে, বা নাও হতে পারে—এবং আপনার সম্পূর্ণ ফলাফল সারণীতে প্রযোজ্য। BigQuery-এ, adh-mrc-accredited লেবেলটি সমস্ত MRC-স্বীকৃত ফলাফলে প্রয়োগ করা হয়। আপনার মেট্রিক্স MRC-স্বীকৃত হওয়ার জন্য আপনাকে টেমপ্লেটের মাধ্যমে ক্যোয়ারী চালাতে হবে।

টেমপ্লেটের মাধ্যমে এমআরসি-অনুমোদিত প্রশ্ন চালানোর জন্য:

  1. কিভাবে একটি ক্যোয়ারী তৈরি করতে হয় তার নির্দেশাবলী অনুসরণ করুন, নিশ্চিত করুন যে আপনি কেনার দরজা হিসাবে YouTube Reserve নির্বাচন করেছেন এবং ক্যোয়ারী টেমপ্লেট হিসাবে ভিডিও দর্শনযোগ্যতা ।
  2. ইউজ টেমপ্লেটের পাশে রান বোতামে ক্লিক করুন।

API ব্যবহার করে অবৈধ ট্র্যাফিক এবং দর্শনযোগ্যতা মেট্রিক্স জিজ্ঞাসা করুন

generateIvtReport এবং startAnalysis এন্ডপয়েন্ট ব্যবহার করে ADH API থেকে অবৈধ ট্র্যাফিক এবং দর্শনযোগ্যতা মেট্রিকগুলি পুনরুদ্ধার করা যেতে পারে৷ অবৈধ ট্রাফিকের জন্য, adh-mrc-accredited লেবেল প্রয়োগ করার জন্য এবং আপনার মেট্রিকগুলিকে MRC-অনুমোদিত করার জন্য generateIvtReport এর মাধ্যমে আপনার মেট্রিকগুলি পুনরুদ্ধার করতে হবে। একইভাবে, MRC স্বীকৃতির জন্য ADH API-এর মাধ্যমে দৃশ্যমানতা মেট্রিক্সের জন্য নীচে নির্দিষ্ট করা বিশ্বব্যাপী ক্যোয়ারী অবশ্যই ব্যবহার করা উচিত। এই বিভাগে পাইথন ক্লায়েন্ট লাইব্রেরি ব্যবহার করে কিভাবে এই এন্ডপয়েন্টে একটি অনুরোধ পাঠাতে হয় তা কভার করে।

API quickstart- এ সেটআপ এবং অনুমোদন/প্রমাণিকরণ নির্দেশাবলী অনুসরণ করুন।

নিম্নলিখিত ক্ষেত্রগুলিকে আপনার অ্যাকাউন্টের সাথে প্রাসঙ্গিক তথ্য দিয়ে প্রতিস্থাপন করার পরে, আপনি আপনার YouTube Reserve প্রচারাভিযানের জন্য একটি অবৈধ ট্রাফিক রিপোর্ট পুনরুদ্ধার করতে নীচের ক্যোয়ারী চালাতে পারেন:

  • ক্লায়েন্ট গোপন ফাইল
  • গ্রাহক আইডি
  • API কী
  • 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))

সাধারণ অবৈধ ট্রাফিকের দর্শনযোগ্যতা মেট্রিক্স নেট গণনা করুন

সাধারণ অবৈধ ট্রাফিক (GIVT) এর MRC-স্বীকৃত দর্শনযোগ্যতা মেট্রিক্স নেট পেতে নিম্নলিখিত সূত্রগুলি ব্যবহার করুন:

  • মোট ইম্প্রেশন (GIVT এর নেট): মোট ইমপ্রেশন - সাধারণ অবৈধ ইমপ্রেশন
  • দর্শনযোগ্য ইমপ্রেশন (GIVT এর নেট): দর্শনযোগ্য ইমপ্রেশন + অবৈধ দর্শনযোগ্য ইমপ্রেশন - GIVT দর্শনযোগ্য ইমপ্রেশন
  • পরিমাপযোগ্য ইমপ্রেশন (GIVT এর নেট): পরিমাপযোগ্য ইমপ্রেশন + অবৈধ পরিমাপযোগ্য ইমপ্রেশন - GIVT পরিমাপযোগ্য ইমপ্রেশন
  • যোগ্য ইমপ্রেশন (GIVT এর নেট): যোগ্য ইমপ্রেশন + অবৈধ যোগ্য ইমপ্রেশন - GIVT যোগ্য ইমপ্রেশন
  • অ-দর্শনযোগ্য ইমপ্রেশন (GIVT এর নেট) : পরিমাপযোগ্য ইমপ্রেশন (GIVT এর নেট) - দর্শনযোগ্য ইমপ্রেশন (GIVT এর নেট)
  • পরিমাপযোগ্য ইমপ্রেশন (GIVT এর নেট): যোগ্য ইমপ্রেশন (GIVT এর নেট) - পরিমাপযোগ্য ইমপ্রেশন (GIVT এর নেট)
  • % পরিমাপযোগ্য ইমপ্রেশন (GIVT এর নেট): পরিমাপযোগ্য ইমপ্রেশন (GIVT এর নেট) / যোগ্য ইমপ্রেশন (GIVT এর নেট)
  • % দর্শনযোগ্য ইমপ্রেশন (GIVT এর নেট): দর্শনযোগ্য ইমপ্রেশন (GIVT এর নেট) / পরিমাপযোগ্য ইমপ্রেশন (GIVT এর নেট)