Hệ phân cấp tên
Tên tài nguyên dùng trong API Google Ads mang tính phân cấp, phản ánh
hệ thống của các pháp nhân trong Google Ads. Hầu hết mọi tài nguyên đều là tài nguyên phụ
của Customer
phản ánh thực tế là hầu hết mọi lệnh gọi API đều phải nhắm mục tiêu một
tài khoản Google Ads cụ thể. Ví dụ: chiến dịch, nhóm quảng cáo, quảng cáo và từ khoá
đều là các tài nguyên phụ của một tài nguyên của khách hàng gốc.
| Tài nguyên | Tên tài nguyên |
|---|---|
| Khách hàng | customers/1234567890
|
| Chiến dịch | customers/1234567890/campaigns/8765432109
|
| Nhóm Quảng cáo | customers/1234567890/adGroups/54321098765
|
| AdGroupAd | customers/1234567890/adGroupAds/54321098765~2109876543210
|
Mã tài nguyên
Các thực thể Google Ads (khách hàng, chiến dịch, v.v.) được gọi theo tài nguyên tên xuyên suốt API. Tuy nhiên, điều quan trọng cần lưu ý là tài nguyên tên riêng có thể có tài nguyên số duy nhất Mã nhận dạng giúp xác định từng đối tượng trong hệ phân cấp. Trong những trường hợp này, có thể bạn nên phân tích cú pháp tên tài nguyên để trích xuất các mã nhận dạng tài nguyên này rồi tập hợp một mã mới.
Ví dụ: kiểm tra tên tài nguyên AdGroupAd trong bảng trước:
customers/1234567890/adGroupAds/54321098765~2109876543210
Tài nguyên này có thể được chia nhỏ thành từng mã nhận dạng tài nguyên riêng lẻ (được phân tách bằng mã bộ sưu tập) như sau:
| Thành phần tên tài nguyên | |||||||
|---|---|---|---|---|---|---|---|
| Mã nhận dạng tài nguyên |
|
||||||
| Mã bộ sưu tập |
|
||||||
Khi phân tích cú pháp mã nhận dạng cá nhân, bạn có thể lấy được tên tài nguyên mới để tham chiếu
khách hàng của quảng cáo trong nhóm quảng cáo (customers/1234567890) hoặc nhóm quảng cáo của nhóm quảng cáo
(customers/1234567890/adGroupAds/54321098765).
Giá trị nhận dạng của đối tượng dùng chung
Hầu hết các đối tượng trong API đều được liên kết với một tài khoản Google Ads cụ thể khách hàng. Tuy nhiên, có một số loại đối tượng có thể được chia sẻ giữa nhiều tài khoản. Trong thực tế, đây là những việc như từ khoá phủ định danh sách hoặc nhiều tài khoản hành động chuyển đổi thường do người quản lý tạo và sau đó được chia sẻ với nhiều tài khoản khách hàng.
Tên tài nguyên của những đối tượng như thế này sẽ khác nhau, tuỳ thuộc vào việc mà bạn đang gửi lệnh gọi API tới.
Ví dụ: Hành động chuyển đổi trên nhiều tài khoản
Giả sử chúng ta có tài khoản người quản lý 987-654-3210 dùng chung nhiều tài khoản
hành động chuyển đổi với một trong các tài khoản khách hàng khách hàng 123-456-7890:
Thực hiện lệnh gọi API đến tài khoản người quản lý để chẳng hạn như cập nhật lượt chuyển đổi
giai đoạn xem lại của hành động sẽ tham chiếu đến đối tượng được chia sẻ bằng cách sử dụng tên tài nguyên:
customers/9876543210/conversionActions/257733534.
Thực hiện lệnh gọi API tới tài khoản khách hàng để chọn tham gia sử dụng tài khoản được chia sẻ
hành động chuyển đổi sẽ tham chiếu hành động đó bằng cách sử dụng tên tài nguyên:
customers/1234567890/conversionActions/257733534.
Đây là cùng một hành động chuyển đổi cơ bản, nhưng tên tài nguyên của hành động này là tương đối với tài khoản dùng để truy cập vào email đó.