Các mục tài liệu
Tài chính
Google Ads: kết nối và chuyển đổi
Mọi cài đặt Google nằm tại Nguồn → Tài khoản quảng cáo → Google: ứng dụng OAuth của bạn, tài khoản, hành động, thẻ trình duyệt, chi phí và lịch sử gửi. Trong luồng chỉ chọn nguồn đó. Luồng không có kết nối Google hay ID hành động riêng.
Trong hướng dẫn này: quyền sở hữu tài nguyên · các cách kết nối · điều kiện chuẩn bị · Google Cloud và OAuth · kết nối nguồn · chọn tài khoản · nhập mã hành động thủ công · mã và nhãn · từng luồng riêng · gửi postback · thẻ trình duyệt · chi phí · kiểm tra · khắc phục lỗi · bảo trì · câu hỏi thường gặp.
1. Tài khoản và quyền truy cập thuộc về ai?
| Tài nguyên | Chủ sở hữu và mục đích |
|---|---|
| Dự án Google Cloud | Của bạn. Bạn bật API và quản lý quyền truy cập trong dự án này. |
| OAuth Client ID và Client Secret | Thông tin xác thực của ứng dụng trong dự án Cloud của bạn. Ứng dụng yêu cầu quyền từ người dùng Google mà bạn chọn. |
| Người dùng Google và tài khoản Ads | Người dùng được chọn phải có quyền truy cập tài khoản Ads đích. Địa chỉ email của họ không phải mã tài khoản quảng cáo gồm mười chữ số. |
| Tài khoản người quản lý / MCC | Tài khoản quản lý của bạn hoặc tài khoản mà người dùng Google đã có quyền truy cập, nếu cần đi qua tài khoản quản lý. |
| ArtisanClo | Cung cấp phần mềm, máy chủ và địa chỉ gọi lại OAuth; lưu cài đặt, nhận postback, làm mới token đã được cấp quyền, gửi sự kiện và hiển thị phản hồi. |
Tích hợp Ads này không dùng ứng dụng OAuth, dự án Cloud, developer token hay MCC dùng chung của ArtisanClo. Thông tin xác thực của khách hàng khác không được dùng thay thế. Yêu cầu từ máy chủ vẫn chạy trên hạ tầng ArtisanClo; dùng ứng dụng riêng không có nghĩa là yêu cầu xuất phát từ máy tính của bạn.
Client Secret cùng token truy cập và làm mới được lưu dưới dạng mã hóa. Thông tin bí mật đã lưu không được trả về biểu mẫu cài đặt. Để trống trường bí mật đã lưu sẽ giữ nguyên giá trị cũ. Khách truy cập chỉ nhận mã và nhãn thẻ công khai. Tách riêng tài nguyên không đảm bảo tránh được hạn chế của Google: quy định của Google vẫn áp dụng cho tài khoản, ứng dụng và cách sử dụng dịch vụ.
2. Chọn tính năng bạn cần
| Phương án | Yêu cầu | Cung cấp | Không cung cấp |
|---|---|---|---|
| Chuyển đổi từ máy chủ | Ứng dụng OAuth của bạn, Data Manager API, mã tài khoản Ads và mã hành động | Gửi khách hàng tiềm năng và doanh số sau khi ArtisanClo nhận chuyển đổi | Tự nó không cung cấp danh sách tài khoản hay chi phí |
| Quyền bổ sung Google Ads API | Quyền của dự án Cloud đối với tài khoản đích và quyền OAuth Google Ads | Liệt kê tài khoản, tạo hoặc dùng lại hành động nhập và cho phép nhập chi phí | Quyền truy cập tài khoản mà người dùng Google của bạn không thể quản lý |
| Chỉ trình duyệt | Conversion ID/label và thẻ JavaScript ArtisanClo trên trang | Sự kiện truy cập ưu đãi và gửi biểu mẫu | Postback đến muộn hoặc chi phí; không cần đăng nhập Google |
| Tệp theo lịch | URL nguồn cấp của nguồn và lịch tải lên trong Google Ads | Google lấy các chuyển đổi ngoại tuyến đã chuẩn bị | Cấp quyền OAuth hay gửi ngay khi postback đến |
Bạn có thể bật gửi từ máy chủ và trình duyệt cùng lúc. Hai cách ghi nhận những thời điểm khác nhau và không tự gộp thành một chuyển đổi. Xem chuyển đổi trùng lặp và mục tiêu chuyển đổi.
Google bỏ yêu cầu này từ ngày 9 tháng 9 năm 2026. Quyền truy cập Google Ads API hiện phụ thuộc vào dự án Cloud sở hữu thông tin xác thực OAuth của bạn. Không đăng ký developer token mới qua MCC cho kết nối này; hãy kiểm tra Google Ads API Overview của dự án. Thông báo chuyển đổi của Google. ArtisanClo không yêu cầu và không lưu token này; các token đã lưu trước đây đã bị xóa.
3. Chuẩn bị theo dõi và nguồn
- Gói của bạn phải bao gồm gửi chuyển đổi đến nền tảng quảng cáo. Nhập chi phí là tính năng riêng của gói. Phần cài đặt hiển thị giới hạn gói khi tính năng không khả dụng.
- Dùng luồng đã bật trình theo dõi. Luồng chỉ dùng cloaking không gửi chuyển đổi của nguồn. Chọn nguồn trong cài đặt theo dõi của luồng.
- Cấu hình chuyển đổi đầu vào từ trang web, mạng tiếp thị liên kết hoặc trình theo dõi bên ngoài. Truyền mã nhấp ArtisanClo sang ưu đãi và trả lại mã đó trong postback.
- Kiểm tra lượt truy cập quảng cáo có giữ lại
gclid,gbraidhoặcwbraidthật.click_idnội bộ của ArtisanClo nối postback với lượt truy cập; mã Google nối lượt truy cập với quảng cáo. Cần cả hai liên kết. - Dùng người dùng Google có đủ quyền trong tài khoản Ads đích hoặc MCC có thể truy cập. Chỉ có quyền Cloud không đồng nghĩa với quyền truy cập tài khoản Google Ads.
Không tự tạo mã nhấp Google cho lần gửi thông thường. gad_source, giá trị UTM, email và mã giao dịch không thay thế được mã này. Kết nối Google về sau không khôi phục mã bị thiếu ở lượt truy cập ban đầu.
4. Thiết lập ứng dụng Google Cloud của bạn
- Mở Google Cloud Console rồi chọn hoặc tạo dự án do bạn quản lý.
- Bật Data Manager API trong thư viện API để gửi chuyển đổi từ máy chủ.
- Để liệt kê tài khoản, tự tạo hành động hoặc nhập chi phí, bật thêm Google Ads API. Kiểm tra mức truy cập của dự án trong Google Ads API Overview và hoàn thành yêu cầu của Google cho các tài khoản dự định dùng. Quyền chỉ dành cho thử nghiệm không đủ để dùng với tài khoản quảng cáo thực. Mức truy cập của dự án.
- Thiết lập thông tin nhận diện ứng dụng, email liên hệ và đối tượng trong Google Auth Platform. Đối tượng nội bộ chỉ phục vụ người dùng của tổ chức đó. Ở chế độ Testing, thêm địa chỉ Google sẽ dùng làm người dùng thử nghiệm.
- Tạo OAuth Client ID loại Web application. Trong ArtisanClo, mở nguồn → Tài khoản quảng cáo → Google → chuyển đổi từ máy chủ → ứng dụng OAuth Google Cloud của bạn. Sao chép Authorized redirect URI được hiển thị vào cài đặt của ứng dụng khách OAuth đó.
- Sao chép Client ID và Client Secret vào nguồn. Client ID thường kết thúc bằng
.apps.googleusercontent.com. Không dán khóa API, số tài khoản Ads hay toàn bộ tệp JSON vào những trường này.
Sao chép chính xác URI gọi lại, gồm giao thức, tên miền và đường dẫn. Không thay /en/ bằng ngôn ngữ bảng điều khiển: đường dẫn gọi lại là cố định. Bản cài đặt cục bộ và bản vận hành thực có thể hiển thị địa chỉ khác nhau. Yêu cầu OAuth web của Google.
Kết nối máy chủ yêu cầu openid, email và https://www.googleapis.com/auth/datamanager. Bật tùy chọn Google Ads API sẽ thêm https://www.googleapis.com/auth/adwords. Cấp các quyền cần thiết cho tính năng đã chọn. Quyền Data Manager là bắt buộc để hoàn tất kết nối máy chủ này.
Ứng dụng bên ngoài ở chế độ Testing thường nhận token làm mới có hiệu lực bảy ngày với các phạm vi API này. Để gửi liên tục, thiết lập trạng thái xuất bản ứng dụng và đáp ứng các yêu cầu xác minh tương ứng của Google. Xuất bản/xác minh ứng dụng OAuth và quyền truy cập Ads API của dự án Cloud là hai cài đặt riêng. Thời hạn token OAuth.
Tên màn hình Google có thể thay đổi. Dùng thông tin của chính ứng dụng và chỉ khai báo các miền bạn kiểm soát. Nếu Google yêu cầu xác minh miền hoặc ứng dụng, hãy tuân theo yêu cầu của cấu hình thực tế; kết nối ArtisanClo không thay thế quy trình đó.
5. Kết nối nguồn
- Mở Nguồn rồi tạo hoặc sửa nguồn Google. Đặt tên giúp nhận biết doanh nghiệp hoặc tài khoản.
- Mở khối chuyển đổi/chi phí của tài khoản quảng cáo, chọn Google và bật gửi khách hàng tiềm năng/doanh số từ máy chủ.
- Nhập Client ID và Client Secret. Bật «Danh sách tài khoản, tạo chuyển đổi và chi phí (Google Ads API)» nếu dự án Cloud đã sẵn sàng cho các tính năng này.
- Nhấn «Lưu và kết nối Google của tôi». Nguồn được lưu trước khi mở Google. Chọn đúng người dùng Google và cấp quyền cho ứng dụng của chính bạn.
- Sau khi quay lại, kiểm tra email đã kết nối rồi thiết lập tài khoản quảng cáo và hành động chuyển đổi. «Đã kết nối» xác nhận đã lưu quyền truy cập, không xác nhận việc gửi một chuyển đổi cụ thể.
Đăng nhập bảng điều khiển ArtisanClo bằng Google và cấp quyền cho nguồn quảng cáo là hai thao tác riêng. Kết nối Ads dùng Client ID đã lưu trong nguồn đó.
Hoàn tất cấp quyền trong cùng phiên trình duyệt trong vòng mười phút. Bắt đầu kết nối khác sẽ thay thế kết nối đang chờ. Nếu quay lại tab cũ hoặc yêu cầu hết hạn, hãy bắt đầu lại từ nguồn.
Nếu đăng nhập thất bại, trang quản lý sẽ nêu lý do:
| Lý do | Cách xử lý |
|---|---|
| Quyền gửi chuyển đổi chưa được chọn | Đăng nhập lại và giữ chọn mọi quyền trên màn hình Google |
| Google không cấp quyền truy cập lâu dài | Xóa quyền truy cập của ứng dụng trong Tài khoản Google (Bảo mật → Ứng dụng bên thứ ba) rồi đăng nhập lại |
| Google từ chối Client ID hoặc Client Secret | Đối chiếu với OAuth client trong Google Cloud của bạn |
| Client ID, Secret hoặc quyền của nguồn đã đổi trong lúc đăng nhập | Lưu nguồn rồi đăng nhập lại |
| Google không xác nhận email của tài khoản | Đăng nhập bằng tài khoản có email đã xác minh |
| Google không cấp quyền truy cập | Kiểm tra redirect URI trong OAuth client rồi thử lại |
6. Chọn tài khoản và tự động cấu hình hành động
- Sau khi cấp quyền Google Ads API, nhấn «Hiển thị tài khoản của tôi». Danh sách gồm các tài khoản quảng cáo có thể truy cập, kể cả khách hàng MCC. Nếu danh sách trống, kiểm tra người dùng Google, quyền Ads và quyền truy cập dự án Cloud.
- Đối chiếu mã tài khoản mười chữ số rồi nhấn «Chọn và cấu hình». Nút này có thể tạo hành động chuyển đổi thật trong tài khoản.
- Kiểm tra mã tài khoản đã điền, mã tài khoản quản lý nếu có, cùng mã hành động cho khách hàng tiềm năng và doanh số.
| Trạng thái ArtisanClo | Tên hành động chính xác trong Ads | Hành động được tạo |
|---|---|---|
lead | AC — Lead | Nhập theo lượt nhấp (UPLOAD_CLICKS), danh mục gửi khách hàng tiềm năng, một lần mỗi lượt nhấp |
sale | AC — Sale | Nhập theo lượt nhấp (UPLOAD_CLICKS), danh mục mua hàng, nhiều lần mỗi lượt nhấp |
Hành động đang bật, tương thích và có đúng các tên này sẽ được dùng lại. Loại hoặc trạng thái không tương thích sẽ dừng cấu hình và báo lỗi; hành động hiện có không bị âm thầm sửa đổi. Việc tạo hai hành động là hai thao tác riêng: nếu lần thứ hai lỗi, hành động đầu có thể đã tồn tại và sẽ được dùng lại sau khi bạn sửa lỗi rồi thử lại.
Nếu tính năng theo dõi chuyển đổi thuộc tài khoản khác trong cấu hình MCC, thiết lập tự động trả về google_shared_conversion_account. Trước tiên kiểm tra chủ sở hữu chuyển đổi trong Google Ads; thay mã tài khoản quản lý không chuyển quyền sở hữu hành động.
Thiết lập tự động điền mã hành động phía máy chủ. Nó không tạo hay lấy Conversion ID/label cho trình duyệt. Hãy cấu hình sự kiện trình duyệt riêng và xem lại mục tiêu chuyển đổi cùng cài đặt đặt giá thầu của chiến dịch trong Google Ads.
7. Nhập mã thủ công khi không dùng Google Ads API
Data Manager API cùng quyền OAuth của bạn có thể gửi postback ngay cả khi tính năng liệt kê tài khoản và tạo hành động bị tắt.
- Chuẩn bị các hành động chuyển đổi nhập theo lượt nhấp trong Google Ads. Dùng hành động riêng cho khách hàng tiềm năng và doanh số nếu muốn gửi cả hai trạng thái.
- Nhập số tài khoản quảng cáo vào Google Ads Account ID, ví dụ
123-456-7890. Dấu gạch nối được bỏ khi gửi yêu cầu API. - Nhập mã MCC nếu bạn truy cập qua MCC. Để trống nếu truy cập trực tiếp.
- Mở từng hành động chuyển đổi trong Google Ads rồi sao chép mã số, tức tham số
ctIdtrong URL của trang, vào trường khách hàng tiềm năng hoặc doanh số tương ứng. - Lưu nguồn và chạy xác thực cho từng trạng thái đã bật.
Trường hành động trống sẽ tắt trạng thái đó. Để chỉ gửi doanh số, điền doanh số và để trống khách hàng tiềm năng. Không nhập AW-… hoặc Conversion label vào trường mã hành động phía máy chủ.
8. Phân biệt mã tài khoản, mã hành động và nhãn thẻ
Đây là các giá trị minh họa, không phải thông tin xác thực có thể sử dụng.
| Trường | Ví dụ | Mục đích |
|---|---|---|
| Google Ads Account ID | 1234567890 | Tài khoản quảng cáo nhận sự kiện máy chủ hoặc cung cấp chi phí |
| Tài khoản người quản lý / MCC | 9876543210 | Đường truy cập; không thay thế tài khoản quảng cáo |
| Mã hành động / ctId | 111111111 | Đích nhận khách hàng tiềm năng hoặc doanh số từ máy chủ |
| GTAG ID / Conversion ID | AW-12345678901 | Mã thẻ Google công khai dùng để gửi từ trình duyệt |
| Conversion label | ExampleLeadLabel | Xác định hành động cụ thể trên trình duyệt |
| Đích trình duyệt | AW-12345678901/ExampleLeadLabel | Mã và nhãn kết hợp lấy từ đoạn mã sự kiện |
| Client ID / Client Secret | Thông tin xác thực ứng dụng OAuth của bạn | Cấp quyền và làm mới quyền truy cập; không bao giờ được đặt trong thẻ của khách truy cập |
9. Chọn nguồn trong luồng
Mọi cài đặt Google nằm tại Nguồn → Tài khoản quảng cáo → Google: ứng dụng OAuth của bạn, tài khoản, hành động, thẻ trình duyệt, chi phí và lịch sử gửi. Trong luồng chỉ chọn nguồn đó. Luồng không có kết nối Google hay ID hành động riêng.
Với tài khoản Google hoặc hành động khác, tạo nguồn khác rồi chọn trong luồng. Thay đổi nguồn áp dụng cho mọi luồng chọn nó. Thẻ trình duyệt và postback dùng nguồn đã chọn. Nếu nguồn thay đổi trước khi gửi chuyển đổi đang chờ, lần gửi cũ dừng với google_connection_changed.
10. Theo dõi đường đi của chuyển đổi máy chủ
- Lượt truy cập quảng cáo được lưu với mã nhấp Google thật và mã nhấp nội bộ ArtisanClo.
- Trang web hoặc mạng của bạn báo khách hàng tiềm năng/doanh số qua bộ nhận chuyển đổi đã cấu hình, trả lại mã nhấp ArtisanClo.
- Mọi cài đặt Google nằm tại Nguồn → Tài khoản quảng cáo → Google: ứng dụng OAuth của bạn, tài khoản, hành động, thẻ trình duyệt, chi phí và lịch sử gửi. Trong luồng chỉ chọn nguồn đó. Luồng không có kết nối Google hay ID hành động riêng.
- Máy chủ dùng token OAuth hợp lệ của ứng dụng để gọi Data Manager API cho tài khoản và hành động của bạn.
- Kết quả được ghi vào lịch sử gửi. Google xử lý và phân bổ sự kiện riêng.
Yêu cầu chứa mã nhấp Google, thời gian sự kiện, giá trị chuyển đổi bằng USD và mã sự kiện để chống trùng lặp. Giá trị lấy từ khoản thanh toán của chuyển đổi đã ghi trong ArtisanClo, không phải chi phí quảng cáo. Gửi từ máy chủ không chờ lần nhập chi phí buổi sáng.
Mỗi cặp chuyển đổi/trạng thái được gửi một lần. Chuyển từ khách hàng tiềm năng sang doanh số có thể gửi hai hành động riêng. Hold, rejected và trash không được gửi qua ánh xạ này. Từ chối khách hàng tiềm năng đã gửi không tự rút lại chuyển đổi Google. Gửi lại số tiền thay đổi với cùng trạng thái không phải thao tác điều chỉnh giá trị Google Ads.
Giao diện này không tự thử lại lần gửi thất bại và không tải lịch sử hàng loạt. Kết nối lại khôi phục quyền cho các sự kiện sau này. Lặp lại cùng postback và trạng thái không tương đương nút gửi lại. Dùng xác thực để kiểm tra cấu hình và một chuyển đổi thử nghiệm mới được phép để kiểm tra toàn bộ chuỗi.
11. Sự kiện trình duyệt bằng mã và nhãn Google
Khi bật Google Ads API và chọn tài khoản, nhấn «Thiết lập thẻ từ Google» trong phần trình duyệt của nguồn. Nút tạo hoặc dùng lại AC — Offer visit và AC — Form lead, rồi lấy ID/nhãn. Hành động mới là mục tiêu phụ. Cài thẻ JavaScript ArtisanClo trên trang; nút không cài thẻ. Không có API thì dùng các trường nhập tay bên dưới.
Gửi từ trình duyệt độc lập với OAuth. Nó ghi nhận truy cập ưu đãi và gửi biểu mẫu khi khách còn trên trang; không thể gửi postback đến muộn sau khi khách rời đi.
- Cài thẻ JavaScript ArtisanClo trên trang và bật theo dõi cho luồng.
- Mở chuyển đổi trang web tương ứng trong Google Ads → thiết lập thẻ → «Use Google Tag Manager». Sao chép Conversion ID và Conversion label. Tab này hiển thị các giá trị cần dùng; bản thân việc dùng ArtisanClo không yêu cầu cài GTM.
- Bật chuyển đổi trình duyệt trong nguồn. Điền GTAG ID và GTAG Click Label cho truy cập ưu đãi; điền GTAG Conversion ID và GTAG Conversion Label (Lead) cho biểu mẫu.
- Hoặc mở «Dán đoạn mã sự kiện» và dán đoạn mã của một đích duy nhất. ArtisanClo trích xuất mã/nhãn; JavaScript đã dán không được thực thi.
- Kiểm tra
AW-ID/labelđược hiển thị rồi lưu. Khi bật tính năng, phải có ít nhất một sự kiện đầy đủ. Muốn tắt tất cả sự kiện, hãy tắt tùy chọn trình duyệt.
Ví dụ, gtag('event', 'conversion', {'send_to': 'AW-12345678901/ExampleLeadLabel'}); trở thành đích được lưu AW-12345678901/ExampleLeadLabel. Không trộn hai đích khác nhau trong một trường. Mã không có nhãn là chưa đầy đủ.
Mã chạy tự tải thẻ Google và dùng lại hàm gtag đã có. Trên trang đệm, sự kiện ưu đãi xảy ra khi đi theo liên kết đến ưu đãi, không phải chỉ mở trang đệm. Trước khi chuyển trang, mã chờ hàm gọi lại của sự kiện tối đa 800 ms rồi tiếp tục ngay cả khi Google bị chặn.
Sự kiện biểu mẫu thông thường chạy sau bước kiểm tra trường gốc của trình duyệt khi submit không bị ngăn chặn. Điều đó không chứng minh máy chủ đã chấp nhận biểu mẫu. Với biểu mẫu AJAX, phát sự kiện sau khi nhận phản hồi thành công từ bộ xử lý biểu mẫu:
document.dispatchEvent(new Event('artisanclo:lead'));
Không phát sự kiện chỉ vì nhấn nút, khi kiểm tra dữ liệu thất bại hoặc trước khi nhận phản hồi máy chủ. Nó thông báo cho thẻ Google và không tự tạo chuyển đổi ArtisanClo. Cấu hình chuyển đổi đầu vào riêng.
Thẻ trên trang cha không thể theo dõi biểu mẫu trong iframe bên thứ ba hoặc hành động tiếp theo trên trang ngoài không có thẻ của bạn. Trình chặn quảng cáo, CSP và cài đặt đồng ý có thể ảnh hưởng việc gửi. Tích hợp không ghi đè cấu hình đồng ý của trang web.
12. Tránh trùng lặp và chọn mục tiêu chuyển đổi
Tránh gửi cùng hành động trình duyệt từ cả GTM và ArtisanClo với cùng mã/nhãn. ArtisanClo giới hạn việc lặp lại sự kiện cùng loại cho một lượt nhấp và cung cấp mã giao dịch cho Google.
Sự kiện máy chủ và trình duyệt có cơ chế riêng, không đảm bảo tự loại trùng lặp giữa hai bên. Gửi biểu mẫu trên trình duyệt và postback đã xác nhận có thể là các mục tiêu khác nhau. Kiểm tra hành động nào là chính và được dùng để tối ưu chiến dịch trong Google Ads. Từ chối postback không hủy sự kiện trình duyệt đã gửi.
13. Nhập chi phí
- Cấp quyền Google Ads API cho ứng dụng OAuth của bạn và kiểm tra quyền dự án Cloud đối với tài khoản thực.
- Chọn Google trong khối chi phí tài khoản quảng cáo của nguồn.
- Đặt tài khoản quảng cáo cung cấp chi phí. Kiểm tra số được gợi ý sau thiết lập tài khoản tự động; tài khoản chi phí đã điền trước đó không bị tự ghi đè.
- Lưu nguồn. Chi phí được nhập theo lịch khi gói của bạn có tính năng này.
Mỗi sáng, quá trình nhập đọc lại ba ngày đã hoàn tất trước đó để lấy các điều chỉnh. Đây không phải bộ đếm trực tiếp chi phí hôm nay. Giá trị được đọc bằng tiền tệ của tài khoản quảng cáo rồi quy đổi sang USD theo tỷ giá có sẵn.
Khi nhiều luồng dùng chung nguồn, giữ mã chiến dịch trong các lượt nhấp, thường bằng utm_campaign={campaignid} trong mẫu Google Ads. Chi phí chiến dịch dùng chung được phân bổ theo tỷ lệ lượt nhấp liên quan của mỗi luồng đã đến ưu đãi; nếu không có lượt nào đến ưu đãi, dùng tất cả lượt nhấp liên quan. Chiến dịch không có lượt nhấp khớp sẽ không được phân bổ tùy ý: mã chiến dịch xuất hiện trong lỗi nhập.
Nếu nguồn chỉ có một luồng theo dõi, luồng đó nhận toàn bộ chi phí tài khoản được nhập. Không xem cấu hình này là bộ lọc một chiến dịch trong tài khoản lớn hơn. Giá trị nhập không ghi đè chi phí đã nhập tay. Kiểm tra thời gian đồng bộ gần nhất và lỗi trong cài đặt chi phí.
14. Kiểm tra riêng cấu hình, việc gửi và phân bổ
Mọi cài đặt Google nằm tại Nguồn → Tài khoản quảng cáo → Google: ứng dụng OAuth của bạn, tài khoản, hành động, thẻ trình duyệt, chi phí và lịch sử gửi. Trong luồng chỉ chọn nguồn đó. Luồng không có kết nối Google hay ID hành động riêng.
Xác thực không ghi nhận chuyển đổi. Nhấn «Lưu và gửi xác thực» cạnh trạng thái máy chủ đã điền. Thao tác lưu biểu mẫu và gọi Google với validateOnly = true, chỉ kiểm tra mà không thực hiện chuyển đổi. Không tạo chuyển đổi thật trong ArtisanClo; lịch sử gửi đánh dấu lần xác thực. Tài liệu validateOnly của Google.
Mọi cài đặt Google nằm tại Nguồn → Tài khoản quảng cáo → Google: ứng dụng OAuth của bạn, tài khoản, hành động, thẻ trình duyệt, chi phí và lịch sử gửi. Trong luồng chỉ chọn nguồn đó. Luồng không có kết nối Google hay ID hành động riêng.
Kiểm tra toàn bộ chuỗi. Trong kịch bản thử nghiệm được phép, ghi nhận lượt nhấp quảng cáo, xác minh mã nhấp Google, dùng mã nhấp nội bộ cho chuyển đổi mới, tìm chuyển đổi trong ArtisanClo và xem lần gửi Google thông thường. Xác nhận đích và kết quả, sau đó kiểm tra Google Ads. Đây là lần gửi thật có thể ảnh hưởng báo cáo.
Kiểm tra trình duyệt. Dùng Google Tag Assistant, thực hiện hành động rồi kiểm tra sự kiện conversion và đích send_to. Biểu mẫu thất bại không được phát sự kiện thành công của bạn. Sự kiện trình duyệt không có nhật ký phản hồi Google phía máy chủ hay nút validateOnly.
15. Đọc lịch sử gửi
| Trường hoặc kết quả | Ý nghĩa |
|---|---|
| Thời gian, kênh google, lead/sale | Thời gian và trạng thái của lần thử |
| Xác thực thành công | Yêu cầu xác thực được chấp nhận; không thực hiện chuyển đổi thật |
| Yêu cầu được chấp nhận / OK | API chấp nhận yêu cầu thông thường; phân bổ chưa được xác nhận |
| Trạng thái HTTP và lỗi | Kết quả yêu cầu hoặc lý do không gửi được |
| Phản hồi Google và cảnh báo | Thông tin bổ sung, kể cả cảnh báo trong phản hồi thành công |
| requestId | Mã yêu cầu Google, nếu được trả về, để điều tra lần thử |
Nguồn hiển thị mười lần gửi gần nhất, không phải bản xuất toàn bộ lịch sử. Liên kết giữa lần gửi thông thường và chuyển đổi cũng có trong lịch sử chuyển đổi/lượt nhấp. Khi liên hệ hỗ trợ, cung cấp nguồn, luồng, thời gian, trạng thái, mã HTTP, nội dung lỗi và requestId nếu có. Không gửi Client Secret, token truy cập hoặc token làm mới.
16. Khắc phục lỗi
| Hiện tượng hoặc mã | Cần kiểm tra |
|---|---|
| Nút kết nối không khả dụng | Gửi từ máy chủ đã bật, Client ID/Secret đã điền, gói và vai trò nhóm cho phép tính năng này. |
| redirect_uri_mismatch | Địa chỉ gọi lại hiển thị đã được đăng ký chính xác cho ứng dụng khách OAuth này, gồm giao thức, miền, đường dẫn ngôn ngữ và dấu gạch chéo cuối. |
| Google từ chối người dùng đã chọn | Email, đối tượng ứng dụng, Test users và hạn chế Workspace. Khai báo trung thực chủ sở hữu ứng dụng. |
| 403 sau khi quay lại từ Google | Giới hạn mười phút, cùng trình duyệt/phiên, kết nối khác đang chờ hoặc thông tin xác thực đã đổi. Bắt đầu lại từ nguồn. |
| google_ads_api_disabled | Bật Google Ads API trong dự án và tùy chọn tương ứng của nguồn rồi lưu. |
| google_scope_missing / yêu cầu kết nối lại | Kết nối lại và cấp quyền API. Chỉ bật API trong Cloud không cấp quyền truy cập OAuth. |
| google_auth | Máy chủ không lấy được quyền truy cập Google. Phản hồi trong nhật ký nêu lý do: quyền bị thu hồi hoặc hết hạn, Client ID/Secret bị từ chối, hoặc Google đã ngắt kết nối trong nguồn. Khắc phục rồi kết nối lại. |
| CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION | Quyền Google Ads API của dự án Cloud không bao gồm tài khoản thực. Xem Google Ads API Overview và yêu cầu truy cập. Developer token không giải quyết được vấn đề này. |
| Thiếu tài khoản hoặc lỗi quyền Google | Người dùng, quyền trực tiếp/qua MCC, trạng thái tài khoản và quyền thực hiện thao tác. Quyền Cloud không thêm người dùng vào Ads. |
| google_shared_conversion_account | Chủ sở hữu chuyển đổi khác tài khoản được chọn; kiểm tra theo dõi chuyển đổi trên nhiều tài khoản. |
| google_incompatible_conversion | Hành động có tên đó phải được bật và thuộc loại nhập theo lượt nhấp. Dùng hành động tương thích hoặc nhập mã phù hợp thủ công. |
| no_click_id | Lượt nhấp gốc thiếu gclid/gbraid/wbraid. Kiểm tra URL quảng cáo, việc giữ tham số và liên kết giữa postback với lượt nhấp. |
| Đã ghi nhận chuyển đổi, không có lần thử gửi | Kiểm tra nguồn đã chọn, chế độ theo dõi, gói, công tắc máy chủ, quyền Google và hành động trạng thái. Nếu đúng, nhờ hỗ trợ kiểm tra hàng đợi gửi. |
| Yêu cầu được chấp nhận, không có chuyển đổi Ads | Loại trừ validateOnly rồi kiểm tra tài khoản/hành động, mã nhấp thật, chẩn đoán nhập, khoảng báo cáo, thời lượng chuyển đổi và quá trình xử lý Google. Chỉ HTTP 200 không chứng minh phân bổ. |
| Không có sự kiện trình duyệt | Thẻ JS, tùy chọn trình duyệt, mã/nhãn đầy đủ, CSP, trình chặn, đồng ý, ranh giới iframe và phát sự kiện AJAX thành công. Kiểm tra Tag Assistant. |
| Thiếu chi phí | Gói, quyền Google Ads API, số tài khoản, ngày đã hoàn tất, ghép chiến dịch với lượt nhấp và lỗi nhập gần nhất. |
| 429 / giới hạn yêu cầu | Chờ trước khi lặp lại yêu cầu từ giao diện. Kiểm tra hạn ngạch dự án theo giới hạn Google. Lần gửi thông thường thất bại không tự thử lại. |
17. Kết nối lại, ngắt kết nối và chuyển từ JSON
Thêm Google Ads API. Bật trong dự án và nguồn rồi kết nối lại. Lưu tùy chọn không mở rộng quyền đã cấp trước đó.
Đổi Client ID hoặc Secret. Lưu thông tin xác thực ứng dụng đã thay đổi sẽ xóa quyền OAuth hiện có. Kết nối lại và cân nhắc mọi luồng dùng chung nguồn trước khi thay đổi.
Chỉ dừng gửi postback. Tắt gửi từ máy chủ rồi lưu. Sự kiện trình duyệt, tệp theo lịch và chi phí có cài đặt riêng. Tắt từng tính năng đang dùng để dừng toàn bộ hoạt động của nguồn với Google.
Ngắt quyền truy cập. Xóa quyền OAuth đã lưu của nguồn này. Không xóa ứng dụng hay hành động trong Google Ads. Không gọi thao tác thu hồi quyền toàn cục của Google, vốn có thể ảnh hưởng nguồn khác dùng cùng ứng dụng khách hàng. Nếu tự thu hồi quyền trong Google, hãy kiểm tra tất cả các nguồn đó.
Khóa JSON hiện có của tài khoản dịch vụ khách hàng. Nguồn đã kết nối trước đây vẫn được hỗ trợ. Để chuyển đổi, cấu hình và cấp quyền cho ứng dụng OAuth của bạn trong nguồn. Nhập OAuth Client ID sẽ chọn cách dùng OAuth; không mong đợi tự quay lại khóa JSON cũ khi đăng nhập chưa hoàn tất. Cấp quyền thành công sẽ xóa khóa chuyển đổi máy chủ trước đó. Cũng kiểm tra chi phí, quyền Ads API và từng hành động.
Tệp Google Ads theo lịch. Phương án độc lập này chứa tối đa 90 ngày sự kiện đủ điều kiện có gclid và dùng tên chuyển đổi trong cài đặt nguồn cấp. Những tên đó không phải ctId hay nhãn trình duyệt. Chọn một cách gửi chính cho cùng các sự kiện để tránh nhập trùng ngoài ý muốn.
18. Câu hỏi thường gặp
- Có thể không dùng Google Cloud không?
- Có, nếu gửi bằng mã/nhãn trình duyệt hoặc tệp theo lịch. Gửi tự động từ máy chủ qua OAuth cần dự án Cloud của riêng bạn.
- Có thể không dùng JSON không?
- Có. Kết nối mới dùng Client ID, Client Secret và cấp quyền Google, không dùng khóa tài khoản dịch vụ tải xuống.
- Mọi thứ đều tự động sao?
- Khi bật Google Ads API và chọn tài khoản, nhấn «Thiết lập thẻ từ Google» trong phần trình duyệt của nguồn. Nút tạo hoặc dùng lại
AC — Offer visitvàAC — Form lead, rồi lấy ID/nhãn. Hành động mới là mục tiêu phụ. Cài thẻ JavaScript ArtisanClo trên trang; nút không cài thẻ. Không có API thì dùng các trường nhập tay bên dưới. - Có cần MCC của ArtisanClo không?
- Không. Với quyền trực tiếp, bạn cũng không cần MCC riêng. Chỉ dùng mã tài khoản quản lý khi cách truy cập yêu cầu.
- Một luồng có thể dùng tài khoản khác không?
- Với tài khoản Google hoặc hành động khác, tạo nguồn khác rồi chọn trong luồng. Thay đổi nguồn áp dụng cho mọi luồng chọn nó. Thẻ trình duyệt và postback dùng nguồn đã chọn. Nếu nguồn thay đổi trước khi gửi chuyển đổi đang chờ, lần gửi cũ dừng với
google_connection_changed. - Khách hàng tiềm năng có được gửi sau khi khách rời đi không?
- Có, nếu postback khớp đến và đáp ứng điều kiện gửi từ máy chủ. Cấu hình chỉ trình duyệt không làm được điều này.
- Tại sao sự kiện trình duyệt không có trong chuyển đổi ArtisanClo?
- Thẻ Google không thay bộ nhận chuyển đổi. Cấu hình postback/bộ xử lý trang web và mã nhấp nội bộ.
- Xác thực thành công có chứng minh phân bổ không?
- Không. Kiểm tra toàn bộ chuỗi bằng lượt nhấp quảng cáo thật được phép và xác nhận kết quả cuối cùng trong Google Ads.
Liên quan: nguồn, theo dõi luồng, chuyển đổi đầu vào, lịch sử chuyển đổi, báo cáo và chi phí. Yêu cầu API bên ngoài đã được đối chiếu với tài liệu Google ngày 19 tháng 10 năm 2026; xem giao diện Google hiện tại để biết cài đặt dự án và tên màn hình.
ArtisanClo · Tài liệu cabinet. Câu hỏi — info@artisanclo.com hoặc @artisanclo_support trên Telegram.