Tài liệu này mô tả cách sử dụng API Quản lý để quản lý đối tượng tái tiếp thị của Google Analytics.
Giới thiệu
API Quản lý cho phép bạn create
, get
, delete
, list
, update
và patch
đối tượng tái tiếp thị cho một tài sản Google Analytics. Để tìm hiểu thêm về cách đối tượng tái tiếp thị hoạt động, hãy xem bài viết Giới thiệu về Đối tượng tái tiếp thị trong Analytics trên trung tâm trợ giúp.
Trường hợp sử dụng
Tài nguyên Đối tượng tái tiếp thị hỗ trợ nhận, xoá, danh sách, bản vá và cập nhật, nhưng các trường hợp sử dụng chính là:
- Liệt kê đối tượng tái tiếp thị.
- Tạo đối tượng tái tiếp thị mới.
- Cập nhật đối tượng tái tiếp thị hiện có.
Liệt kê đối tượng tái tiếp thị
Cách liệt kê tất cả đối tượng tái tiếp thị cho một tài sản:
- Sử dụng API Quản lý hoặc Trình khám phá tài khoản để truy xuất
accountId
vàwebPropertyId
. - Thực hiện phương thức
list
của tài nguyên Đối tượng tái tiếp thị.
Xem tài liệu tham khảo API để biết thông tin chi tiết về phương thức list
cho tài nguyên đối tượng tái tiếp thị.
Tạo đối tượng tái tiếp thị mới
Để tạo đối tượng tái tiếp thị mới cho tài sản, hãy làm như sau:
- Sử dụng API Quản lý hoặc Trình khám phá tài khoản để truy xuất
accountId
vàwebPropertyId
. - Sử dụng API Quản lý hoặc Trình khám phá tài khoản để truy xuất mã chế độ xem (hồ sơ) cho tài sản
linkedViews []
. - Sử dụng bộ sưu tập Đường liên kết đến Google Ads để truy xuất mã tài khoản Google Ads cho
linkedAdAccounts.linkedAccountId
.- Tài sản
linkedAdAccounts[]
hiện chỉ giới hạn ở mộtlinkedForeignAccount
. - Bạn có thể đặt
linkedAdAccounts[].type
thànhADWORDS_LINKS
,DBM_LINKS
,MCC_LINKS
hoặcOPTIMIZE
.
- Tài sản
- Sử dụng bộ sưu tập Phân đoạn cho các tuỳ chọn để đặt thuộc tính
segment
củaincludeConditions
, và nếu tạo đối tượng dựa trên trạng thái, hãy làm tương tự choexcludeConditions
. Ngoài ra, hãy xem tài liệu tham khảo về phân khúc để biết cách xác định phân khúc.includeConditions
có thể tuỳ ý chứa các giá trị chomembershipDurationDays
vàdaysToLookBack
- Bạn có thể đặt
excludeConditions.exclusionDuration
thànhPERMANENT
(không bắt buộc).
- Thực hiện phương thức
insert
của tài nguyên Đối tượng tái tiếp thị.
API này cho phép bạn tạo 2 loại đối tượng: SIMPLE
và STATE_BASED
. Đối với đối tượng SIMPLE
, bạn chỉ cần tạo audienceDefinition
với segment
dương, không có toán tử NOT (ký tự !
). Nếu muốn thêm một điều kiện loại trừ, bạn phải xác định statebasedDefinition
; hãy xem bài viết Đối tượng dựa trên trạng thái để tìm hiểu thêm. Hãy xem ví dụ tham khảo để biết thêm thông tin chi tiết.
Cập nhật đối tượng tái tiếp thị hiện có
Để cập nhật đối tượng tái tiếp thị hiện có cho tài sản:
- Nếu đã có Mã đối tượng tái tiếp thị, thì bạn có thể gọi
get
, nếu không, bạn có thể gọilist
và chọn đối tượng mà mình muốn cập nhật. - Cập nhật bất kỳ trường có thể ghi nào rồi gọi
update
truyền vào đối tượng đối tượng đã cập nhật.