Method: advertisers.reachForecast.generateReachForecast

Tạo bản dự đoán phạm vi tiếp cận cho một nhà quảng cáo và cấu hình nhắm mục tiêu cụ thể.

Yêu cầu HTTP

POST https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/reachForecast:generateReachForecast

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Tham số
advertiserId

string (int64 format)

Bắt buộc. Mã nhận dạng của nhà quảng cáo sẽ chạy chiến dịch đã lên kế hoạch.

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu với cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "targeting": {
    object (Targeting)
  },
  "campaignDuration": {
    object (CampaignDuration)
  },
  "currencyCode": string,
  "plannedProducts": [
    {
      object (PlannedProduct)
    }
  ],
  "minEffectiveFrequency": integer
}
Trường
targeting

object (Targeting)

Bắt buộc. Các thông số nhắm mục tiêu của chiến dịch được lên kế hoạch.
campaignDuration

object (CampaignDuration)

Bắt buộc. Thời lượng của chiến dịch đã lên kế hoạch.
currencyCode

string

Bắt buộc. Mã đơn vị tiền tệ của gói theo định dạng ISO 4217.
plannedProducts[]

object (PlannedProduct)

Bắt buộc. Danh sách các mục hàng cần đưa vào bản dự đoán.
minEffectiveFrequency

integer

Không bắt buộc. Tần suất hiệu quả tối thiểu cho các chỉ số phạm vi tiếp cận được báo cáo. Đây là số lần tối thiểu mà khách hàng phải xem quảng cáo để quảng cáo được coi là hiệu quả. Chế độ cài đặt này chỉ ảnh hưởng đến hoạt động báo cáo.

Giá trị phải nằm trong khoảng từ 1 đến 10. Nếu bạn không chỉ định, hệ thống sẽ áp dụng giá trị mặc định là 1.

Nội dung phản hồi

Thông báo phản hồi cho ReachForecastService.GenerateReachForecast.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "onTargetAudienceMetrics": {
    object (OnTargetAudienceMetrics)
  },
  "reachCurve": {
    object (ReachCurve)
  }
}
Trường
onTargetAudienceMetrics

object (OnTargetAudienceMetrics)

Quy mô đối tượng ước tính cho khu vực địa lý được nhắm mục tiêu.
reachCurve

object (ReachCurve)

Đường cong dự đoán được tạo.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/display-video

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.

Nhắm mục tiêu

Chế độ cài đặt tiêu chí nhắm mục tiêu cho một chiến dịch được lên kế hoạch.

Biểu diễn dưới dạng JSON 
{
  "plannableLocationIds": [
    string
  ],
  "ageRange": enum (PlannableAgeRange),
  "genders": [
    enum (Gender)
  ],
  "devices": [
    enum (DeviceType)
  ]
}
Trường
plannableLocationIds[]

string (int64 format)

Bắt buộc. Mã nhận dạng của những vị trí có thể lập kế hoạch để nhắm đến.

Bạn có thể truy xuất các vị trí có thể lên kế hoạch bằng phương thức reachForecast.retrievePlannableLocations.
ageRange

enum (PlannableAgeRange)

Không bắt buộc. Độ tuổi cần nhắm đến.
genders[]

enum (Gender)

Không bắt buộc. Các lựa chọn về giới tính để nhắm đến.
devices[]

enum (DeviceType)

Không bắt buộc. Các thiết bị cần nhắm đến.

CampaignDuration

Thời hạn của kế hoạch tiếp cận.

Biểu diễn dưới dạng JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "durationDays": integer,
  "dateRange": {
    object (DateRange)
  }
  // End of mutually exclusive fields.
}
Trường
Lựa chọn về thời lượng chiến dịch. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi:
durationDays

integer

Bắt buộc. Số ngày mà gói này áp dụng.
dateRange

object (DateRange)

Bắt buộc. Phạm vi ngày mà kế hoạch bao gồm.
Kết thúc các trường loại trừ lẫn nhau.

PlannedProduct

Cấu hình cho một sản phẩm cụ thể trong kế hoạch.

Biểu diễn dưới dạng JSON 
{
  "plannableProductCode": string,
  "budgetMicros": string,
  "advancedProductTargeting": {
    object (AdvancedProductTargeting)
  }
}
Trường
plannableProductCode

string

Bắt buộc. Mã của sản phẩm, ví dụ: "VIDEO_REACH_CAMPAIGN".
budgetMicros

string (int64 format)

Bắt buộc. Ngân sách cho sản phẩm này tính bằng micro.
advancedProductTargeting

object (AdvancedProductTargeting)

Không bắt buộc. Tiêu chí nhắm mục tiêu ghi đè ở cấp mục hàng (không bắt buộc).

AdvancedProductTargeting

Tiêu chí nhắm mục tiêu theo sản phẩm cụ thể sẽ ghi đè.

Biểu diễn dưới dạng JSON 
{
  "surfaceTargetingSettings": {
    object (SurfaceTargetingSettings)
  },
  "targetFrequency": {
    object (TargetFrequency)
  },
  "frequencyCap": {
    object (FrequencyCap)
  },
  "ageRange": enum (PlannableAgeRange),
  "genders": [
    enum (Gender)
  ],
  "devices": [
    enum (DeviceType)
  ],
  "userInterestIds": [
    string
  ],
  "userListIds": [
    string
  ],
  "youtubeSelectSettings": {
    object (YouTubeSelectSettings)
  },
  "dateRange": {
    object (DateRange)
  },
  "plannableLocationIds": [
    string
  ],
  "network": enum (PlannableNetwork)
}
Trường
surfaceTargetingSettings

object (SurfaceTargetingSettings)

Không bắt buộc. Các nền tảng có thể lập kế hoạch để nhắm đến.
targetFrequency

object (TargetFrequency)

Không bắt buộc. Số lần trung bình mà quảng cáo sẽ xuất hiện cho cùng một người trong một khoảng thời gian nhất định.
frequencyCap

object (FrequencyCap)

Không bắt buộc. Giới hạn tần suất cho sản phẩm cụ thể.
ageRange

enum (PlannableAgeRange)

Không bắt buộc. Độ tuổi cần nhắm đến.
genders[]

enum (Gender)

Không bắt buộc. Các lựa chọn về giới tính để nhắm đến.
devices[]

enum (DeviceType)

Không bắt buộc. Các thiết bị cần nhắm đến.
userInterestIds[]

string

Không bắt buộc. Mã nhận dạng mối quan tâm của người dùng để nhắm mục tiêu.

Bạn có thể truy xuất mối quan tâm của người dùng có thể lập kế hoạch bằng phương thức reachForecast.retrievePlannableUserInterests.
userListIds[]

string

Không bắt buộc. Mã danh sách người dùng để nhắm mục tiêu.

Bạn có thể truy xuất danh sách người dùng có thể lập kế hoạch bằng phương thức reachForecast.retrievePlannableUserInterests.
youtubeSelectSettings

object (YouTubeSelectSettings)

Không bắt buộc. Chế độ cài đặt YouTube Select.
dateRange

object (DateRange)

Không bắt buộc. Phạm vi ngày để nhắm đến.
plannableLocationIds[]

string (int64 format)

Không bắt buộc. Mã vị trí có thể lập kế hoạch để nhắm đến.
network

enum (PlannableNetwork)

Không bắt buộc. Mạng cần nhắm đến.

SurfaceTargetingSettings

Chọn tiêu chí nhắm mục tiêu theo nền tảng.

Biểu diễn dưới dạng JSON 
{
  "surfaces": [
    enum (PlannableSurface)
  ]
}
Trường
surfaces[]

enum (PlannableSurface)

Không bắt buộc. Các nền tảng để nhắm đến.

YouTubeSelectSettings

Chế độ cài đặt cho Nhóm YouTube Chọn lọc.

Biểu diễn dưới dạng JSON 
{
  "lineupId": string
}
Trường
lineupId

string (int64 format)

Không bắt buộc. Mã nhận dạng của nhóm kênh YouTube Select.

OnTargetAudienceMetrics

Quy mô đối tượng ước tính cho một vị trí địa lý được nhắm mục tiêu.

Biểu diễn dưới dạng JSON 
{
  "youtubeAudienceSize": string,
  "censusAudienceSize": string
}
Trường
youtubeAudienceSize

string (int64 format)

Quy mô đối tượng ước tính trên YouTube.
censusAudienceSize

string (int64 format)

Quy mô của đối tượng dựa trên dữ liệu điều tra dân số của khu vực địa lý được nhắm đến.

ReachCurve

Đường cong phạm vi tiếp cận được tạo.

Biểu diễn dưới dạng JSON 
{
  "reachForecasts": [
    {
      object (ReachForecast)
    }
  ]
}
Trường
reachForecasts[]

object (ReachForecast)

Các điểm dọc theo đường cong, được sắp xếp theo chi phí.

ReachForecast

Một điểm duy nhất trong đường cong phạm vi tiếp cận.

Biểu diễn dưới dạng JSON 
{
  "costMicros": string,
  "plannedProductReachForecasts": [
    {
      object (PlannedProductReachForecast)
    }
  ],
  "forecast": {
    object (PlannedProductForecast)
  }
}
Trường
costMicros

string (int64 format)

Tổng chi phí cho điểm này tính bằng micro.
plannedProductReachForecasts[]

object (PlannedProductReachForecast)

Bảng chi tiết cho từng sản phẩm ở mức chi phí này.
forecast

object (PlannedProductForecast)

Dự báo tổng hợp cho toàn bộ kế hoạch.

PlannedProductReachForecast

Dự báo hiệu quả cho một số sản phẩm.

Biểu diễn dưới dạng JSON 
{
  "costMicros": string,
  "plannableProductCode": string,
  "plannedProductForecast": {
    object (PlannedProductForecast)
  }
}
Trường
costMicros

string (int64 format)

Chi phí tính bằng micro cho sản phẩm này.
plannableProductCode

string

Mã của sản phẩm.
plannedProductForecast

object (PlannedProductForecast)

Chỉ số hiệu suất của sản phẩm.

PlannedProductForecast

Các chỉ số hiệu suất cho một điểm dự báo.

Biểu diễn dưới dạng JSON 
{
  "onTargetReach": string,
  "onTargetImpressions": string,
  "trueviewViews": string,
  "totalReach": string,
  "totalImpressions": string,
  "viewableImpressions": string,
  "onTargetCoviewReach": string,
  "totalCoviewReach": string,
  "onTargetCoviewImpressions": string,
  "totalCoviewImpressions": string
}
Trường
onTargetReach

string (int64 format)

Số người dùng riêng biệt đã tiếp cận được phù hợp với định nghĩa đúng mục tiêu.
onTargetImpressions

string (int64 format)

Số lượt hiển thị đúng mục tiêu.
trueviewViews

string (int64 format)

Số lượt xem theo TrueView.
totalReach

string (int64 format)

Tổng số người dùng riêng biệt đã tiếp cận được.
totalImpressions

string (int64 format)

Tổng số lượt hiển thị.
viewableImpressions

string (int64 format)

Số lần hiển thị có thể xem.
onTargetCoviewReach

string (int64 format)

Số người dùng riêng biệt đã tiếp cận được phù hợp với định nghĩa về phạm vi tiếp cận đúng mục tiêu, bao gồm cả những người cùng xem.
totalCoviewReach

string (int64 format)

Tổng số người dùng riêng biệt đã tiếp cận được, bao gồm cả những người cùng xem.
onTargetCoviewImpressions

string (int64 format)

Số lượt hiển thị đúng mục tiêu, bao gồm cả những người cùng xem.
totalCoviewImpressions

string (int64 format)

Tổng số lượt hiển thị, bao gồm cả người cùng xem.