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

نظرة عامة

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

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

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

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

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

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

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

1. اتّبِع التعليمات حول كيفية إنشاء طلب بحث، مع التأكّد من اختيار Google Ads كبوابة الشراء وإمكانية عرض الفيديو حسب نوع الجهاز كنموذج طلب البحث.
2. انقر على الزر Run (تشغيل) بجانب Use template (استخدام النموذج).

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

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

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

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