Method: advertisers.reachForecast.generateReachForecast

Tạo dự báo về 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 nhất định.

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 đã lên kế hoạch.
campaignDuration

object (CampaignDuration)

Bắt buộc. Thời lượng của chiến dịch dự kiến.
currencyCode

string

Bắt buộc. Mã đơn vị tiền tệ của gói ở đị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 dự báo.
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 tiếp xúc với 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 vị trí đị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 đã 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 các 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 lượng của kế hoạch tiếp cận.

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

  // Union field duration can be only one of the following:
  "durationDays": integer,
  "dateRange": {
    object (DateRange)
  }
  // End of list of possible types for union field duration.
}
Trường
Trường nhóm duration. Lựa chọn về thời lượng chiến dịch. duration chỉ có thể là một trong những trạng thái sau:
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.

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 phần triệu.
advancedProductTargeting

object (AdvancedProductTargeting)

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

AdvancedProductTargeting

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

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 mục tiêu.
targetFrequency

object (TargetFrequency)

Không bắt buộc. Số lần trung bình quảng cáo sẽ hiển thị 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ã mối quan tâm của người dùng để nhắm đến.

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 Chọn lọc.
dateRange

object (DateRange)

Không bắt buộc. Phạm vi ngày cần 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 vị trí xuất hiện.

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 YouTube Chọn lọc.

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ô ước tính của đối tượng 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 tại mức chi phí này.
forecast

object (PlannedProductForecast)

Thông tin dự đoán tổng hợp cho toàn bộ kế hoạch.

PlannedProductReachForecast

Dự báo hiệu suất cho một sản phẩm cụ thể.

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 phần triệu 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 và phù hợp với định nghĩa về đối tượng đú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 được tiếp cận, 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.