Remarketing Audiences

Để biết danh sách các phương thức của tài nguyên này, hãy xem ở cuối trang này.

Biểu thị tài nguyên

Mẫu JSON cho đối tượng tái tiếp thị trong Analytics.

{
  "kind": "analytics#remarketingAudience",
  "id": string,
  "accountId": string,
  "webPropertyId": string,
  "internalWebPropertyId": string,
  "created": datetime,
  "updated": datetime,
  "name": string,
  "description": string,
  "linkedAdAccounts": [
    {
      "kind": "analytics#linkedForeignAccount",
      "id": string,
      "accountId": string,
      "webPropertyId": string,
      "internalWebPropertyId": string,
      "remarketingAudienceId": string,
      "linkedAccountId": string,
      "type": string,
      "status": string,
      "eligibleForSearch": boolean
    }
  ],
  "linkedViews": [
    string
  ],
  "audienceType": string,
  "audienceDefinition": {
    "includeConditions": {
      "kind": "analytics#includeConditions",
      "isSmartList": boolean,
      "segment": string,
      "membershipDurationDays": integer,
      "daysToLookBack": integer
    }
  },
  "stateBasedAudienceDefinition": {
    "includeConditions": {
      "kind": "analytics#includeConditions",
      "isSmartList": boolean,
      "segment": string,
      "membershipDurationDays": integer,
      "daysToLookBack": integer
    },
    "excludeConditions": {
      "segment": string,
      "exclusionDuration": string
    }
  }
}
Tên tài sản Giá trị Nội dung mô tả Ghi chú
accountId string Mã tài khoản chứa đối tượng tái tiếp thị này.
audienceDefinition object Định nghĩa đơn giản về đối tượng sẽ thêm người dùng vào đối tượng. có thể ghi
audienceDefinition.includeConditions nested object Xác định các điều kiện để thêm người dùng vào đối tượng. có thể ghi
audienceDefinition.includeConditions.daysToLookBack integer Thời gian xem lại cho phép bạn chỉ định khung thời gian để đánh giá hành vi làm cho người dùng đủ điều kiện cho đối tượng của bạn. Ví dụ: nếu các bộ lọc của bạn bao gồm người dùng từ Trung Á và Giao dịch lớn hơn 2, đồng thời bạn đặt thời gian xem lại thành 14 ngày, thì bất kỳ người dùng nào từ Trung Á có số giao dịch tích luỹ lớn hơn 2 trong 14 ngày qua sẽ được thêm vào đối tượng. có thể ghi
audienceDefinition.includeConditions.isSmartList boolean Giá trị boolean cho biết phân đoạn này có phải là danh sách thông minh hay không. https://support.google.com/analytics/answer/4628577 có thể ghi
audienceDefinition.includeConditions.kind string Loại tài nguyên cho các điều kiện bao gồm.
audienceDefinition.includeConditions.membershipDurationDays integer Số ngày (trong khoảng từ 1 đến 540) mà người dùng lưu lại trong đối tượng đó. có thể ghi
audienceDefinition.includeConditions.segment string Điều kiện phân đoạn sẽ thêm người dùng vào đối tượng. có thể ghi
audienceType string Loại đối tượng, SIMPLE hoặc STATE_BASED.

Các giá trị có thể chấp nhận là:
  • "SIMPLE"
  • "STATE_BASED"
có thể ghi
created datetime Thời gian tạo đối tượng tái tiếp thị này.
description string Nội dung mô tả về đối tượng tái tiếp thị này.
id string Mã đối tượng tái tiếp thị.
internalWebPropertyId string ID nội bộ cho thuộc tính web chứa đối tượng tiếp thị lại này.
kind string Loại bộ sưu tập.
linkedAdAccounts[] list Các tài khoản quảng cáo được liên kết được liên kết với đối tượng tái tiếp thị này. Một đối tượng tái tiếp thị hiện chỉ có thể có một LinkedAdAccount. có thể ghi
linkedAdAccounts[].accountId string Mã tài khoản của tài khoản nước ngoài được liên kết này.
linkedAdAccounts[].eligibleForSearch boolean Giá trị boolean cho biết giá trị này có đủ điều kiện cho lượt tìm kiếm hay không.
linkedAdAccounts[].id string Mã liên kết tài khoản quảng cáo của thực thể.
linkedAdAccounts[].internalWebPropertyId string Mã nhận dạng nội bộ của tài sản web chứa tài khoản nước ngoài được liên kết này.
linkedAdAccounts[].kind string Loại tài nguyên dành cho tài khoản nước ngoài được liên kết.
linkedAdAccounts[].linkedAccountId string Mã tài khoản nước ngoài. Ví dụ: "linkedAccountId" của Google Ads có định dạng sau: XXX-XXX-XXXX. có thể ghi
linkedAdAccounts[].remarketingAudienceId string Mã đối tượng tái tiếp thị chứa tài khoản nước ngoài được liên kết này.
linkedAdAccounts[].status string Trạng thái của liên kết tài khoản nước ngoài này.

Các giá trị có thể chấp nhận là:
  • "CLOSED"
  • "OPEN"
linkedAdAccounts[].type string Loại tài khoản nước ngoài. Ví dụ: ` giây_LINKS`, `Display_LINKS`, `MCC_LINKS` hoặc `OPTIMIZE`. có thể ghi
linkedAdAccounts[].webPropertyId string ID thuộc tính web có dạng UA-XXXXX-YY của tài khoản nước ngoài được liên kết này.
linkedViews[] list Chế độ xem (hồ sơ) mà đối tượng tiếp thị lại này được liên kết. có thể ghi
name string Tên của đối tượng tái tiếp thị này. có thể ghi
stateBasedAudienceDefinition object Định nghĩa về đối tượng dựa trên trạng thái sẽ khiến người dùng được thêm vào hoặc bị xoá khỏi đối tượng. có thể ghi
stateBasedAudienceDefinition.excludeConditions object Xác định các điều kiện để loại trừ người dùng khỏi đối tượng. có thể ghi
stateBasedAudienceDefinition.excludeConditions.exclusionDuration string Liệu nên đặt tiêu chí loại trừ là TẠM THỜI hay VĨNH VIỄN.

Các giá trị có thể chấp nhận là:
  • "PERMANENT"
  • "TEMPORARY"
có thể ghi
stateBasedAudienceDefinition.excludeConditions.segment string Điều kiện phân đoạn sẽ khiến người dùng bị xóa khỏi đối tượng. có thể ghi
stateBasedAudienceDefinition.includeConditions nested object Xác định các điều kiện để thêm người dùng vào đối tượng. có thể ghi
stateBasedAudienceDefinition.includeConditions.daysToLookBack integer Thời gian xem lại cho phép bạn chỉ định khung thời gian để đánh giá hành vi làm cho người dùng đủ điều kiện cho đối tượng của bạn. Ví dụ: nếu các bộ lọc của bạn bao gồm người dùng từ Trung Á và Giao dịch lớn hơn 2, đồng thời bạn đặt thời gian xem lại thành 14 ngày, thì bất kỳ người dùng nào từ Trung Á có số giao dịch tích luỹ lớn hơn 2 trong 14 ngày qua sẽ được thêm vào đối tượng. có thể ghi
stateBasedAudienceDefinition.includeConditions.isSmartList boolean Giá trị boolean cho biết phân đoạn này có phải là danh sách thông minh hay không. https://support.google.com/analytics/answer/4628577 có thể ghi
stateBasedAudienceDefinition.includeConditions.kind string Loại tài nguyên cho các điều kiện bao gồm.
stateBasedAudienceDefinition.includeConditions.membershipDurationDays integer Số ngày (trong khoảng từ 1 đến 540) mà người dùng lưu lại trong đối tượng đó. có thể ghi
stateBasedAudienceDefinition.includeConditions.segment string Điều kiện phân đoạn sẽ thêm người dùng vào đối tượng. có thể ghi
updated datetime Thời gian sửa đổi gần đây nhất đối với đối tượng tái tiếp thị này.
webPropertyId string ID thuộc tính web có dạng UA-XXXXX-YY mà đối tượng tiếp thị lại này thuộc về.

Phương thức

xóa
Xoá đối tượng tái tiếp thị.
nhận
Lấy đối tượng tái tiếp thị mà người dùng có quyền truy cập.
chèn
Tạo một đối tượng tái tiếp thị mới.
list
Liệt kê các đối tượng tái tiếp thị mà người dùng có quyền truy cập.
bản vá
Cập nhật đối tượng tái tiếp thị hiện tại. Phương thức này hỗ trợ ngữ nghĩa của bản vá.
cập nhật
Cập nhật đối tượng tái tiếp thị hiện tại.