Settings

Cần: tài khoản Google quản lý AdMob, và quyền chỉnh project Google Cloud chứa OAuth client.

1. Mở Google Cloud → Google Auth Platform → Audience (giao diện cũ: APIs & Services → OAuth consent screen), chọn đúng project ở ô chọn project trên cùng.
2. Mục Publishing status nếu đang là Testing → bấm Publish app → Confirm.
   Bắt buộc: ở chế độ Testing, Google tự huỷ refresh token sau 7 ngày.
3. Mở APIs & Services → Library, tìm và bấm Enable cho: AdMob API, Google Ads API.
4. Mở Google Auth Platform → Clients → bấm vào OAuth client (loại Web application; chưa có thì + Create client → Web application) → mục Authorized redirect URIs → + Add URI 2 lần, dán:
   • https://report.leapuptech.com/settings/admob/oauth/callback
   • https://report.leapuptech.com/settings/google-ads/oauth/callback
   → Save. Copy Client ID và Client secret của client này.
5. Ở panel AdMob: điền Publisher ID (AdMob → Settings → Account information, dạng pub-…), OAuth Client ID, Client Secret → Lưu và kiểm tra kết nối (báo lỗi token là bình thường ở bước này).
6. Bấm Kết nối Google (lấy Refresh Token mới) → đăng nhập tài khoản AdMob → nếu hiện "Google hasn't verified this app" bấm Advanced → Go to … (unsafe) → tick cả hai quyền → Continue.
7. Quay về Settings thấy thông báo xanh "Đã lưu Refresh Token mới" là xong → bấm Kích Hoạt Sync Ngay.

Cần: quyền Admin trong Business Manager chứa các tài khoản quảng cáo.

1. Mở Business Settings → Accounts → Apps. Chưa có app nào thì + Add → Connect an app ID (hoặc tạo app loại Business tại developers.facebook.com/apps).
2. Mở Business Settings → Users → System users → + Add → tên appmonetization-sync , role Admin → Create system user.
3. Chọn system user vừa tạo → Assign assets → Ad accounts → tick tất cả tài khoản → bật View performance → Assign changes.
4. Bấm Generate new token → chọn app ở bước 1 → Token expiration: Never → tick ads_read và read_insights → Generate token → Copy (chỉ hiện một lần).
5. Dán vào ô Access token của panel Meta → Lưu token. Trạng thái phải báo "Token hợp lệ, không có ngày hết hạn".
6. Chọn 30 ngày → Sync Meta Now để lấy bù dữ liệu.

Cần: tài khoản Manager (MCC) quản lý các tài khoản quảng cáo. Developer token phải được Google duyệt mức Basic (1–5 ngày làm việc).

1. Mở Google Cloud → Google Auth Platform → Audience (giao diện cũ: APIs & Services → OAuth consent screen), chọn đúng project ở ô chọn project trên cùng.
2. Mục Publishing status nếu đang là Testing → bấm Publish app → Confirm.
   Bắt buộc: ở chế độ Testing, Google tự huỷ refresh token sau 7 ngày.
3. Mở APIs & Services → Library, tìm và bấm Enable cho: AdMob API, Google Ads API.
4. Mở Google Auth Platform → Clients → bấm vào OAuth client (loại Web application; chưa có thì + Create client → Web application) → mục Authorized redirect URIs → + Add URI 2 lần, dán:
   • https://report.leapuptech.com/settings/admob/oauth/callback
   • https://report.leapuptech.com/settings/google-ads/oauth/callback
   → Save. Copy Client ID và Client secret của client này.
5. Chưa có MCC: tạo tại Google Ads Manager accounts → link các tài khoản quảng cáo vào (Accounts → + → Link existing account).
6. Mở Google Ads (đang chọn MCC) → Admin → API Center → điền form lần đầu → copy Developer token. Nếu Access level là Test account → Apply for Basic Access (mục đích: internal reporting, read-only).
7. Ở panel Google Ads bấm Kết nối Google (lấy Refresh Token) → đăng nhập tài khoản có quyền vào MCC → Advanced → Go to … nếu có cảnh báo → Continue.
8. Điền Developer Token, Login Customer ID = ID của MCC (góc trên phải ads.google.com, dạng 123-456-7890), để trống Customer IDs → Lưu và kiểm tra kết nối → Sync Google Ads Now.

Lỗi "developer token is only approved for test accounts" = chờ Google duyệt Basic access.

Cần: tài khoản TikTok for Business quản lý các advertiser.

1. Mở TikTok API for Business → My Apps → app của bạn (chưa có: Create App). Mục Scope of permission tick: Reporting, Ads Management (đọc — để map app tự động), Ad Account Management. Advertiser redirect URL: https://report.leapuptech.com . Chờ trạng thái Approved.
2. Copy App ID và Secret trong trang chi tiết app; copy luôn Advertiser authorization URL.
3. Chrome/Edge: mở tab mới → F12 → tab Network → tick Keep log (Preserve log) → dán authorization URL vào thanh địa chỉ.
4. Chọn các advertiser → Confirm. Trong ô Filter của Network gõ auth_code → chuột phải dòng hiện ra → Copy → Copy URL.
5. Trong 10 phút (code dùng 1 lần): ở panel TikTok điền App ID, Secret và dán URL vừa copy vào ô Auth code / URL → Đổi lấy Access Token. Hệ thống tự đổi code thành token, lưu lại và kiểm tra kết nối.
6. Không có quyền Ads Management: điền Map mã campaign → app (mỗi dòng MÃ = app) → Sync TikTok Now, mã chưa map hiện trong khung vàng.

Cần: quyền Admin Play Console và quyền tạo service account trong Google Cloud.

1. Mở Google Cloud → IAM & Admin → Service Accounts → Create → tên play-reports → Create and continue → bỏ trống phần role → Done.
2. Bấm vào service account vừa tạo → tab Keys → Add key → Create new key → JSON → Create (tải file .json). Copy email dạng play-reports@….iam.gserviceaccount.com.
3. Mở Play Console → Users and permissions → Invite new users → dán email service account → tab Account permissions → tick View financial data, orders, and cancellation survey responses → Invite user. Quyền có hiệu lực sau tối đa 24 giờ.
4. Play Console → Download reports → Financial → Copy Cloud Storage URI (dạng gs://pubsite_prod_rev_…).
5. Ở panel Google Play IAP: dán bucket + toàn bộ nội dung file .json (mở bằng Notepad, Ctrl+A, Ctrl+C) → Lưu và kiểm tra kết nối → Sync Google Play Now.

Báo "chưa có quyền đọc bucket" = quyền Play Console chưa có hiệu lực, thử lại sau vài giờ.