Trong Google Ads, việc theo dõi các thay đổi trong tài khoản quảng cáo là yếu tố quan trọng giúp quản trị viên duy trì hiệu quả hoạt động của chiến dịch. Thông qua API Google Ads, bạn có thể theo dõi chi tiết trạng thái thay đổi của các tài nguyên trong tài khoản, từ các nhóm quảng cáo, chiến dịch, đến nguồn cấp dữ liệu. Bằng cách truy xuất thông tin về các thay đổi, bạn có thể quyết định khi nào cần đồng bộ hóa cơ sở dữ liệu cục bộ với các giá trị cập nhật. Bài viết này sẽ cung cấp hướng dẫn chi tiết về cách sử dụng API để theo dõi và quản lý trạng thái thay đổi trong Google Ads.
Video: Trạng thái thay đổi trong Google Ads
Thay đổi trạng thái là một cách hiệu quả để theo dõi các tài nguyên đã thay đổi trong tài khoản Google Ads trong một khoảng thời gian cụ thể. Nếu một tài nguyên có nhiều thay đổi trong thời gian được chỉ định, chỉ thay đổi gần nhất sẽ được hiển thị. Điều này cho phép bạn xác định xem có cần đồng bộ hóa cơ sở dữ liệu cục bộ với các giá trị mới trong khoảng thời gian đó hay không.
Ví dụ: nếu trong một khoảng thời gian, bạn thêm và sau đó cập nhật một chiến dịch, chỉ trạng thái thay đổi cho UPDATE sẽ được trả về, không phải trạng thái ADD. Tuy nhiên, nếu bạn điều chỉnh khoảng thời gian kết thúc trước khi cập nhật, thao tác ADD sẽ xuất hiện.
Nếu bạn muốn có cái nhìn chi tiết về các thay đổi ở cấp độ từng trường, tương tự như trên trang “Nhật ký thay đổi”, bạn nên tham khảo bài viết về “Sự kiện thay đổi”.
Lưu ý quan trọng: Không phải tất cả các mục trong trạng thái thay đổi đều có thông tin chi tiết đầy đủ trong sự kiện thay đổi. Để biết thêm chi tiết, hãy xem các giới hạn trong sự kiện thay đổi. Ngoài ra, một số mục trong trạng thái thay đổi có thể không xuất hiện trong Nhật ký thay đổi của giao diện Google Ads do logic nghiệp vụ và quy tắc hiển thị khác nhau.
Thay đổi loại trạng thái trong Google Ads
Các loại tài nguyên dưới đây được theo dõi trong Google Ads. Lưu ý rằng mã loại tài nguyên có thể khác so với giá trị enum của ChangeStatusResourceType.
| Loại tài nguyên | Giá trị | Mã loại tài nguyên |
|---|---|---|
| Nhóm quảng cáo | AD_GROUP | 2 |
| Quảng cáo trong nhóm quảng cáo | AD_GROUP_AD | 3 |
| Hệ số sửa đổi giá thầu | AD_GROUP_BID_MODIFIER | 11 |
| Tiêu chí nhóm quảng cáo | AD_GROUP_CRITERION | 4 |
| Nguồn cấp dữ liệu nhóm quảng cáo | AD_GROUP_FEED | 12 |
| Nhóm thành phần quảng cáo | ASSET_BUNDLE | 19 |
| Chiến dịch | CAMPAIGN | 5 |
| Tiêu chí chiến dịch | CAMPAIGN_CRITERION | 6 |
| Nguồn cấp dữ liệu chiến dịch | CAMPAIGN_FEED | 9 |
| Nguồn cấp dữ liệu | FEED | 8 |
| Mục nguồn cấp dữ liệu | FEED_ITEM | 10 |
| Nhóm chia sẻ | SHARED_SET | 17 |
| Nhóm chia sẻ chiến dịch | CAMPAIGN_SHARED_SET | 18 |
| Thành phần | ASSET | 13 |
| Thành phần của khách hàng | CUSTOMER_ASSET | 14 |
| Thành phần của chiến dịch | CAMPAIGN_ASSET | 15 |
| Thành phần nhóm quảng cáo | AD_GROUP_ASSET | 16 |
Xác định loại tài nguyên theo mã nhận dạng
API Google Ads có thể trả về các hàng với giá trị loại tài nguyên là UNKNOWN. Điều này thường xảy ra khi loại tài nguyên được hỗ trợ trong các phiên bản API tương lai nhưng chưa được hỗ trợ đầy đủ trong phiên bản hiện tại. Tuy nhiên, bạn vẫn có thể xác định loại tài nguyên bằng cách phân tích cú pháp resource_name được trả về.
Định dạng tên tài nguyên:
customers/{customer_id}/changeStatus/{timestamp}-{resource_type_id}-{additional_ids}
Trong định dạng này, mã nhận dạng chính là resource_type_id (vị trí thứ hai sau dấu gạch chéo cuối cùng). Bảng trên đã liệt kê tất cả mã loại tài nguyên tương ứng để bạn dễ dàng tra cứu.
Truy xuất các thay đổi trong Google Ads
Bạn có thể truy xuất và lọc danh sách các thay đổi dựa trên ngày và loại tài nguyên cụ thể. Mỗi thay đổi sẽ thuộc vào một trong ba trạng thái: ADDED (thêm mới), CHANGED (thay đổi), hoặc REMOVED (đã xóa).
Hệ thống Google Ads cho phép bạn lấy danh sách tất cả các thay đổi trên các loại tài nguyên khác nhau. Mỗi thay đổi trả về sẽ bao gồm resource_type để xác định trường nào đã được thay đổi, và các trường liên quan khác cũng sẽ được cập nhật. Ví dụ: nếu ad_group_criterion được thay đổi, trường ad_group sẽ được điền tự động.
Các thay đổi có thể mất đến 3 phút để phản ánh vào hệ thống sau khi diễn ra.
Truy vấn phải lọc theo ngày, tối đa là 90 ngày gần nhất, và không bắt buộc phải lọc theo thời gian cụ thể. Bên cạnh đó, yêu cầu truy vấn phải có mệnh đề LIMIT để giới hạn kết quả trả về không vượt quá 10.000 bản ghi.
Ví dụ mã truy vấn bằng các ngôn ngữ lập trình như Java, C#, PHP, Python, Ruby và Perl để truy xuất các thay đổi trong Google Ads:
private void runExample(GoogleAdsClient googleAdsClient, long customerId) {
String query =
"SELECT change_status.resource_name, "
+ "change_status.last_change_date_time, "
+ "change_status.resource_status, "
+ "change_status.resource_type, "
+ "change_status.ad_group, "
+ "change_status.ad_group_ad, "
+ "change_status.ad_group_bid_modifier, "
+ "change_status.ad_group_criterion, "
+ "change_status.ad_group_feed, "
+ "change_status.campaign, "
+ "change_status.campaign_criterion, "
+ "change_status.campaign_feed, "
+ "change_status.feed, "
+ "change_status.feed_item "
+ "FROM change_status "
+ "WHERE change_status.last_change_date_time DURING LAST_14_DAYS "
+ "ORDER BY change_status.last_change_date_time "
+ "LIMIT 10000";googleAdsClient.getLatestVersion().createGoogleAdsServiceClient()) {
SearchPagedResponse response = client.search(String.valueOf(customerId), query);
Optional<String> resourceNameOfChangedEntity =
getResourceNameForResourceType(row.getChangeStatus());
“On ‘%s’, change status ‘%s’ shows a resource type of ‘%s’ “
+ “with resource name ‘%s’ was ‘%s’.%n”,
row.getChangeStatus().getLastChangeDateTime(),
row.getChangeStatus().getResourceName(),
row.getChangeStatus().getResourceType().name(),
resourceNameOfChangedEntity.orElse(“”),
row.getChangeStatus().getResourceStatus().name());
}
}
}
Đồng bộ hóa cục bộ trong Google Ads
Sau khi xác định resource_name chính xác, bạn có thể tạo một truy vấn mới để lấy tất cả các giá trị hiện tại của tài nguyên đó. Trạng thái thay đổi không theo dõi các giá trị cụ thể đã thay đổi bên trong tài nguyên, mà chỉ xác định tài nguyên nào đã bị thay đổi. Việc xác định sự khác biệt giữa giá trị cũ và giá trị mới là nhiệm vụ của chương trình hoặc hệ thống gọi lệnh.
Thời gian thay đổi
last_change_date_time xác định thời điểm diễn ra thay đổi gần nhất đối với tài nguyên. Bạn có thể sử dụng trường này để so sánh với dữ liệu được lưu trữ cục bộ, giúp xác định xem dữ liệu cục bộ có bị lỗi thời hay không.
Ngoài ra, trường last_change_date_time còn có thể được dùng trong mệnh đề WHERE của truy vấn Ngôn ngữ truy vấn Google Ads (GAQL), cho phép bạn lọc và truy vấn những thay đổi đã diễn ra trong khoảng thời gian nhất định.
Ví dụ: Để tìm tất cả các thay đổi đã diễn ra đối với một loại tài nguyên cụ thể trong tuần trước, bạn có thể sử dụng mệnh đề GAQL sau:
WHERE change_status.last_change_date_time DURING LAST_7_DAYSViệc theo dõi trạng thái thay đổi của tài nguyên trong Google Ads giúp bạn duy trì sự chính xác và hiệu quả trong quản lý chiến dịch quảng cáo. Sử dụng API để truy vấn và quản lý các thay đổi này không chỉ giúp tiết kiệm thời gian mà còn đảm bảo rằng mọi thay đổi trong tài khoản đều được đồng bộ hóa kịp thời. Hãy đảm bảo bạn thực hiện đồng bộ hóa thường xuyên và áp dụng các truy vấn hợp lý để theo dõi toàn bộ hoạt động trong chiến dịch của mình. Với kiến thức và công cụ đúng đắn, bạn sẽ có thể tối ưu hóa chiến dịch Google Ads của mình một cách hiệu quả.
