Bên thứ ba không phải là người dùng trực tiếp của Ad Manager, do họ có thể không có mạng Ad Manager của riêng họ. Thay vào đó, họ tạo các dịch vụ hoặc chế độ tích hợp với Ad Manager cho khách hàng của họ, những khách hàng hiện là khách hàng Ad Manager. Hướng dẫn này trình bày những thông tin cơ bản về việc tích hợp với bên thứ ba thông qua các phương pháp, mẹo và thủ thuật hay nhất.
Hướng dẫn này giả định rằng bạn đã có kiến thức thực tế về API Ad Manager. Nếu bạn chưa quen với API Ad Manager, vui lòng xem tài liệu bắt đầu sử dụng của chúng tôi.
Bắt đầu với tư cách là bên thứ ba
Để sử dụng API Ad Manager nhằm truy cập vào mạng của khách hàng Ad Manager, chỉ cần tuân theo các nguyên tắc bên dưới. Bạn không cần phải được Google phê duyệt thêm. Tuy nhiên, xin lưu ý rằng bằng cách truy cập và/hoặc sử dụng API Ad Manager, bạn đồng ý với các điều khoản và điều kiện của API Ad Manager.
Cách kiểm tra quá trình tích hợp Ad Manager của bạn với tư cách là bên thứ ba
Là bên thứ ba, bạn có thể muốn biết cách thử nghiệm chức năng tích hợp Ad Manager trước khi chạy trên mạng sản xuất của khách hàng. Phương pháp đề xuất là tạo một mạng kiểm thử. Bạn không cần phải là khách hàng Ad Manager để làm được điều này. Bất kỳ ai có Tài khoản Google đều có thể tạo một mạng thử nghiệm.
Tuy nhiên, hãy lưu ý sự khác biệt giữa mạng kiểm thử và mạng sản xuất. Mạng thử nghiệm không thể phân phát quảng cáo. Mạng kiểm thử cũng không nhất thiết phải chứa tất cả các tính năng mà ứng dụng khách của bạn có thể có trên mạng sản xuất của họ. Nếu cần kiểm thử các tính năng của Ad Manager không có trên mạng kiểm thử, thì bạn có thể chọn mua quyền truy cập vào một mạng không kiểm thử thông qua đại lý Ad Manager.
Ngoài ra, bạn nên giải thích rõ với máy khách về những tính năng họ cần có trên mạng sản xuất để ứng dụng của bạn hoạt động đúng cách. Ứng dụng của bạn phải xử lý các trường hợp mà các tính năng có thể không tồn tại, bằng cách phát hiện các ngoại lệ và không thành công một cách linh hoạt hoặc giữ lại một danh sách các ứng dụng cũng như những tính năng mà mỗi ứng dụng có hoặc không có. Khách hàng của bạn có trách nhiệm làm việc với người liên hệ của họ tại Google để quản lý các tính năng trên mạng của họ.
Xác thực: Cách truy cập đúng cách vào mạng Ad Manager của ứng dụng
Để ứng dụng truy cập vào mạng Ad Manager của khách hàng, bạn cần thiết lập quy trình xác thực một cách an toàn.
Quá trình này bao gồm 2 bước:
- Tạo địa chỉ email của Tài khoản Google mà bạn sẽ sử dụng để truy cập vào mạng của khách hàng.
- Yêu cầu khách hàng thêm tài khoản này làm người dùng trong mạng Ad Manager của họ.
Ở bước 1, bạn có thể tạo một Tài khoản Google riêng cho từng khách hàng hoặc một tài khoản chính mà bạn sẽ sử dụng cho tất cả khách hàng. Lựa chọn cũ an toàn hơn trong trường hợp một trong các tài khoản của bạn bị xâm phạm. Sau đó có nghĩa là bạn chỉ cần thực hiện bước 1 một lần.
Bất kể bạn có làm gì ở bước 1, ở bước 2, bạn sẽ cần yêu cầu từng khách hàng mới thêm Tài khoản Google thích hợp mà bạn đã tạo cho họ với tư cách là người dùng vào mạng Ad Manager của họ.
1. Tạo Tài khoản Google
Có nhiều cách để tạo Tài khoản Google có thể thêm vào mạng Ad Manager.
Cách 1: Tạo một tài khoản dịch vụ OAuth2. Thao tác này sẽ tạo một địa chỉ email tài khoản dịch vụ cho bạn. Tài khoản này hoạt động như một Tài khoản Google. Hướng dẫn tạo tài khoản dịch vụ mới.
Cách 2: Bạn có thể tạo một Tài khoản Google thông thường (tài khoản "Gmail") bằng cách đăng ký dưới dạng một người dùng mới. Nếu bạn đã có Tài khoản Google, hãy hoàn tất quy trình đăng ký này trong một cửa sổ ẩn danh hoặc phiên trình duyệt mới. Hoặc nếu công ty của bạn sử dụng Google Workspace, bạn có thể tạo một Tài khoản Google trong miền của công ty và sử dụng tài khoản đó. Trong phạm vi của hướng dẫn này, chúng tôi sẽ gọi cả hai tài khoản này là Tài khoản Google "thông thường".
2. Đề nghị khách hàng thêm Tài khoản Google của bạn vào mạng của họ
Sau khi bạn có Tài khoản Google để truy cập vào mạng của khách hàng, hãy yêu cầu họ thêm tài khoản làm người dùng mới trong mạng Ad Manager của họ.
Nếu bạn đang cung cấp cho họ địa chỉ email tài khoản dịch vụ OAuth2, hãy yêu cầu họ thêm địa chỉ đó vào mạng của họ.
Nếu bạn đang cung cấp cho họ một Tài khoản Google thông thường, hãy yêu cầu họ thêm tài khoản của bạn làm người dùng vào mạng của họ.
Bất kể bạn đi theo tuyến đường nào, hãy đảm bảo rằng bạn thảo luận với ứng dụng khách về những vai trò và quyền mà tài khoản của bạn cần có để ứng dụng của bạn có thể truy cập vào dữ liệu cần thiết trên mạng của ứng dụng.
Bây giờ, bạn có thể bắt đầu thực hiện lệnh gọi API đến mạng Ad Manager của khách hàng. Đảm bảo bạn đã đặt tiêu đề SOAP củanetworkCode thành mã mạng của máy khách mà bạn đang thực hiện lệnh gọi API. Tất cả thư viện ứng dụng của chúng tôi đều cho phép thiết lập tính năng này theo phương thức lập trình. Ví dụ: trong thư viện ứng dụng Java của quảng cáo, bạn có thể đặt mã mạng theo phương thức lập trình khi tạo thực thể DFPSession.
Luôn cập nhật API
Điều quan trọng là bạn phải luôn cập nhật thông tin về các phiên bản API không còn được dùng hoặc ngừng hoạt động cũng như thời điểm các phiên bản mới được phát hành. Bạn không nên cảnh giác khi một phiên bản ngừng cung cấp và có nguy cơ làm hỏng ứng dụng. Không phải lúc nào chúng tôi cũng có thể liên hệ với bên thứ ba về việc sắp ngừng sử dụng và sắp ngừng hoạt động như đối với khách hàng của mình. Do đó, bạn có trách nhiệm đăng ký một trong ba kênh chính của chúng tôi để cập nhật API và điều chỉnh chế độ cài đặt thông báo:
- Nhóm thông báo ngừng cung cấp API Ad Manager của chúng tôi.
- Blog nhà phát triển quảng cáo của chúng tôi.
Chúng tôi cũng cung cấp lịch ngừng sử dụng trên trang web của nhà phát triển mà bạn nên thường xuyên theo dõi.
Yêu cầu hỗ trợ
Nếu bạn gặp sự cố với quá trình tích hợp Ad Manager, chúng tôi cung cấp các kênh hỗ trợ sau đây tùy thuộc vào vấn đề của bạn. Nếu bạn có câu hỏi ở cấp sản phẩm, vui lòng gửi tới diễn đàn sản phẩm Ad Manager. Nếu bạn có câu hỏi cụ thể về API, vui lòng gửi đến diễn đàn API Ad Manager. Vui lòng xem bài đăng trên blog này để biết các mẹo phân biệt giữa câu hỏi ở cấp sản phẩm hay câu hỏi dành riêng cho API.