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

نظرة عامة

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

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

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

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

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

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

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

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

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

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

اتّبِع تعليمات الإعداد والترخيص/المصادقة في دليل التشغيل السريع لـ واجهة برمجة التطبيقات.

بعد استبدال الحقول التالية بمعلومات ذات صلة بحسابك، يمكنك تشغيل طلب البحث أدناه لاسترداد تقرير عن الزيارات غير الصالحة لحملاتك Google Ads :

• ملف أسرار العميل
• الرقم التعريفي للعميل
• مفتاح واجهة برمجة التطبيقات
• Campaign 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',
    '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))

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/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):

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