مقاييس إمكانية عرض طلب البحث وعدد الزيارات غير الصالحة

نظرة عامة

تقدّم التعليمات أدناه أمثلة على كيفية إجراء طلبات بحث عن كلٍّ من زيارات إمكانية العرض الصالحة والزيارات غير الصالحة باستخدام واجهة برمجة التطبيقات. تقتصر هذه المقاييس على المستودع الإعلاني الذي يتم شراؤه باستخدام "إعلانات Google" و"مساحة العرض والفيديو 360" وYouTube المحجوزة.

تجدر الإشارة إلى أنّ مقاييس مشاهدة مرّات مشاهدة TrueView المعتمَدة من مجلس تقييم الوسائط (MRC) تتطلّب استخدام واجهة برمجة تطبيقات Ads Data Hub API، نظرًا لعدم توفُّر طلب بحث مصمَّم مرتبط بها. بالإضافة إلى ذلك، يجب الخلط بين مقاييس المشاهدات في TrueView ومقاييس إمكانية العرض.

اختر باب الشراء الذي تريد الاستعلام عن مقاييس إمكانية العرض له:

مقاييس إمكانية العرض لطلب البحث باستخدام واجهة المستخدم

إنّ طلب البحث عن إمكانية العرض المستندة إلى نموذج يوفّر مقاييس معتمَدة من مجلس تقييم الوسائط (MRC).

اعتماد مجلس تقييم الوسائط (MRC) ثنائي - ويمكن أن تكون نتائجك معتمدة أو لا - وينطبق على جدول النتائج بالكامل. في BigQuery، يتم تطبيق التصنيف adh-mrc-accredited على جميع النتائج المعتمدة من مجلس تقييم الوسائط (MRC). يجب تنفيذ طلب البحث من خلال النموذج حتى يتم اعتماد المقاييس من مجلس تقييم الوسائط (MRC).

لتنفيذ طلب بحث معتمد من مجلس تقييم الوسائط (MRC) من خلال النموذج:

  1. اتّبِع التعليمات حول كيفية إنشاء طلب بحث، مع التأكّد من اختيار YouTube Reserve كباب للشراء وإمكانية عرض الفيديو كنموذج طلب البحث.
  2. انقر على الزر تشغيل بجانب استخدام نموذج.

طلب البحث عن مقاييس إمكانية العرض والزيارات غير الصالحة باستخدام واجهة برمجة التطبيقات

يمكن استرداد مقاييس الزيارات وإمكانية العرض غير الصالحة من واجهة برمجة تطبيقات Ads Data Hub باستخدام نقاط النهاية generateIvtReport وstartAnalysis. بالنسبة إلى الزيارات غير الصالحة، يجب استرداد المقاييس من خلال generateIvtReport لكي يتم تطبيق تصنيف adh-mrc-accredited واعتماد المقاييس من مجلس تقييم الوسائط (MRC). وبالمثل، يجب استخدام طلب البحث العام المحدّد أدناه لمقاييس إمكانية العرض من خلال واجهة برمجة تطبيقات Ads Data Hub للحصول على اعتماد مجلس تقييم الوسائط (MRC). يتناول هذا القسم كيفية إرسال طلب إلى نقطة النهاية هذه باستخدام مكتبة برامج 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))

حساب مقاييس إمكانية العرض بعد صافي الزيارات غير الصالحة الناشئة عن تقنيات معروفة

استخدِم الصيغ التالية لاستنتاج مقاييس إمكانية العرض المعتمدة من مجلس تقييم الوسائط (MRC) وخالية من الزيارات غير الصالحة الناشئة عن تقنيات معروفة (GIVT):

  • إجمالي مرات الظهور (الصافي من الزيارات غير الصالحة العامة (GIVT): إجمالي مرات الظهور - مرات الظهور العامة غير الصالحة
  • مرات الظهور القابلة للعرض (الصافية من الزيارات غير الصالحة العامة (GIVT): مرات الظهور القابلة للعرض + مرات الظهور القابلة للعرض غير الصالحة - مرات الظهور القابلة للعرض التي أدت إلى زيارات غير صالحة ناشئة عن تقنيات معروفة (GIVT)
  • مرات الظهور القابلة للقياس (الصافية من الزيارات غير الصالحة العامة (GIVT): مرات الظهور القابلة للقياس + مرات الظهور القابلة للقياس غير الصالحة - مرات الظهور القابلة للقياس التي أدت إلى زيارات غير صالحة ناشئة عن تقنيات معروفة (GIVT)
  • مرات الظهور المؤهَّلة (الخالية من الزيارات غير الصالحة العامة (GIVT): مرات الظهور المؤهَّلة + مرات الظهور المؤهَّلة غير الصالحة - مرات الظهور المؤهَّلة التي أدت إلى زيارات غير صالحة ناشئة عن تقنيات معروفة (GIVT))
  • الظهور غير القابل للعرض (الخالي من الزيارات غير الصالحة العامة (GIVT)) : مرات الظهور القابلة للقياس (الصافي من الزيارات غير الصالحة العامة (GIVT)) - مرات الظهور القابلة للعرض (الخالية من الزيارات غير الصالحة العامة (GIVT))
  • مرات الظهور غير القابلة للقياس (الصافية من الزيارات غير الصالحة العامة (GIVT): مرات الظهور المؤهَّلة (الصافية من الزيارات غير الصالحة العامة (GIVT)) - مرات الظهور القابلة للقياس (الصافية من الزيارات غير الصالحة العامة (GIVT))
  • النسبة المئوية لمرات الظهور القابلة للقياس (الصافي من الزيارات غير الصالحة العامة (GIVT): مرات الظهور القابلة للقياس (الصافي من الزيارات غير الصالحة العامة (GIVT)) / مرات الظهور المؤهَّلة (الخالية من الزيارات غير الصالحة العامة (GIVT))
  • النسبة المئوية لمرات الظهور القابلة للعرض (الصافي من الزيارات غير الصالحة العامة (GIVT): مرات الظهور القابلة للعرض (الصافي من الزيارات غير الصالحة العامة (GIVT)) / مرات الظهور القابلة للقياس (الخالية من الزيارات غير الصالحة العامة (GIVT))