Hướng dẫn cho nhà phát triển về Đối tượng tái tiếp thị

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.

Lưu ý: Khi sử dụng API này, bạn phải tuân thủ Chính sách về tính năng quảng cáo của Google Analytics, bao gồm cả các quy tắc về danh mục nhạy cảm.

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ó.

Lưu ý: Đối tượng tái tiếp thị của bạn sẽ vẫn trống và chiến dịch tái tiếp thị có thể không chạy nếu bạn không bật thẻ để thu thập dữ liệu thích hợp. Bắt đầu bằng cách bật Tính năng quảng cáo trong phần Cài đặt tài sản Google Analytics.

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:

1. Sử dụng API Quản lý hoặc Trình khám phá tài khoản để truy xuất accountId và webPropertyId.
2. 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:

1. Sử dụng API Quản lý hoặc Trình khám phá tài khoản để truy xuất accountId và webPropertyId.
2. 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 [].
3. 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ột linkedForeignAccount.
   • Bạn có thể đặt linkedAdAccounts[].type thành ADWORDS_LINKS, DBM_LINKS, MCC_LINKS hoặc OPTIMIZE.
4. 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ủa includeConditions, và nếu tạo đối tượng dựa trên trạng thái, hãy làm tương tự cho excludeConditions. 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ị cho membershipDurationDays và daysToLookBack
   • Bạn có thể đặt excludeConditions.exclusionDuration thành PERMANENT (không bắt buộc).
5. 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.

Lưu ý: Bạn có thể xác định audienceDefinition hoặc stateBasedAudienceDefinition và đặt audienceType thành giá trị tương ứng. Ngoài ra,bạn chỉ được phép có tối đa 2.000 đối tượng tái tiếp thị. Hãy thận trọng khi tự động tạo đối tượng tái tiếp thị.

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:

1. 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ọi list và chọn đối tượng mà mình muốn cập nhật.
2. 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.

Lưu ý: Sau khi tạo đối tượng, bạn không thể thay đổi audienceType của đối tượng đó. Nói cách khác, nếu một đối tượng có giá trị cho audienceDefinition, thì bạn không thể gọi lệnh cập nhật bằng giá trị cho stateBasedAudienceDefinition. 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ông tin chi tiết.