Cài đặt Pinterest
Pinterest là mạng quảng cáo có tích hợp với Adjust. Sau khi tích hợp với Adjust, Pinterest sẽ nhận được dữ liệu phân bổ và dữ liệu in-app event qua callback tự động.
Dưới đây là hướng dẫn cài đặt tính năng đo lường Pinterest. Hướng dẫn gồm các bước kích hoạt tích hợp, tạo liên kết chiến dịch, và xác định loại dữ liệu mà Adjust có thể chia sẻ cho Pinterest.
Trước khi bắt đầu
Yêu cầu
- Quyền truy cập Admin, Editor hoặc Custom Editor.
- Adjust SDK phiên bản 4.0.0 trở lên, để liên kết tham số SDK với tham số của Pinterest. Chọn hướng dẫn phù hợp với nền tảng đang sử dụng.
iOS | Android | Windows | Unity | React Native | Flutter | Adobe Air | Cordova | Marmalade | Xamarin | Cocos2d-x | Titanium | Corona
Thông tin tài khoản
TAG ID (required for events), Pinterest Account ID, và Pinterest Authentication Token
- Để được hỗ trợ tìm thông tin tài khoản, vui lòng liên hệ với đại diện Pinterest.
Trên Pinterest dashboard:
Liên kết S2S click của Adjust cần được thiết lập ở dạng parallel click tracker bên phía Pinterest. Xem thêm thông tin tại đây.
Chọn Pinterest và ứng dụng trên Campaign Lab
- Tại mục Campaign Lab , chọn Đối tác.
- Chọn Đối tác mới > Pinterest. Chọn Tiếp theo để chuyển sang màn hình kế tiếp.
- Trên màn hình Lựa chọn ứng dụng , chọn ứng dụng mà bạn muốn tạo liên kết, sau đó kích hoạt tích hợp để chia sẻ dữ liệu cho Pinterest.
- Chọn Tiếp theo.
Kích hoạt tính năng chia sẻ dữ liệu
Kích hoạt tính năng chia sẻ dữ liệu để kích hoạt tích hợp giữa Adjust và Pinterest. Để kích hoạt tính năng chia sẻ dữ liệu:
- Nhập TAG ID (required for events), Pinterest Account ID và Pinterest Authentication Token.
Sau khi bạn kích hoạt tính năng chia sẻ dữ liệu cho Pinterest, Adjust sẽ mặc định gửi các dữ liệu sau cho Pinterest:
Cài đặt tính năng chia sẻ dữ liệu
Nếu ứng dụng của bạn là đa nền tảng (multi-platform app), và tính năng chia sẻ dữ liệu đã được kích hoạt cho các nền tảng này, thì bạn có thể thực hiện các thao tác sau:
- Chọn Sử dụng cài đặt riêng của nền tảng nếu bạn muốn cài đặt tính năng chia sẻ dữ liệu khác nhau cho mỗi nền tảng.
- Chọn Sử dụng cài đặt chung nếu bạn muốn cài đặt tính năng giống nhau cho tất cả nền tảng.
Tại mục Dữ liệu nào sẽ được chia sẻ mặc định? , kiểm tra lại các dữ liệu mà Adjust mặc định chia sẻ cho Pinterest.
- sự kiện
Gửi dữ liệu bổ sung
Chọn số lượng và loại dữ liệu mà bạn muốn chia sẻ cho Pinterest qua callback. Pinterest có thể sử dụng dữ liệu bạn chia sẻ để cải thiện dịch vụ.
- Tại mục Bạn muốn chia sẻ nguồn dữ liệu nào?, chọn nguồn phân bổ của dữ liệu mà bạn đang chia sẻ cho Pinterest:
- Dữ liệu từ tất cả nguồn phân bổ
- Chỉ chia sẻ dữ liệu đã được phân bổ cho Pinterest
Doanh thu in-app (từ giao dịch in-app)
Nếu bạn chọn chia sẻ dữ liệu doanh thu in-app, Pinterest sẽ nhận được dữ liệu số tiền và sự kiện doanh thu. Bạn cần liên kết sự kiện để có thể chia sẻ dữ liệu này; lưu ý, sự kiện phải tạo doanh thu.
Liên kết event
Liên kết sự kiện mà bạn muốn chia sẻ, với giá trị mà Pinterest có thể nhận được. Đối với sự kiện không được liên kết, dữ liệu liên quan đến sự kiện sẽ không được chia sẻ cho Pinterest.
Liên kết các sự kiện riêng lẻ
Nếu bạn sở hữu ứng dụng đa nền tảng (multi-platform app), thì có thể chia sẻ cho Pinterest các sự kiện khác nhau tùy theo từng nền tảng. Tức bạn có thể:
- Cài đặt sự kiện riêng lẻ để quản lý chiến dịch theo từng nền tảng.
- Điều chỉnh tính năng chia sẻ dữ liệu của từng nền tảng.
Để chọn in-app event mà muốn bạn muốn gửi trực tiếp cho Pinterest, thực hiện các bước sau tại mục Liên kết sự kiện .
Chọn Liên kết sự kiện.
Mở danh sách Sự kiện của Adjust , chọn sự kiện mà bạn muốn chia sẻ cho Pinterest.
Tại mục Sự kiện đối tác , chọn sự kiện của Pinterest, đảm bảo sự kiện đó tương ứng với sự kiện của Adjust.
Đối với ứng dụng đơn nền tảng và ứng dụng đa nền tảng nhưng chỉ bật tính năng chia sẻ dữ liệu cho một nền tảng, thì bạn chỉ cần liên kết sự kiện cho nền tảng đó. Còn đối với ứng dụng đa nền tảng nhưng bật tính năng chia sẻ dữ liệu cho nhiều nền tảng, thì bạn có các lựa chọn sau:
- Chọn Sử dụng biểu đồ liên kết riêng của nền tảng để liên kết sự kiện theo từng nền tảng một, hoặc để không liên kết sự kiện cho một số nền tảng nhất định.
- Chọn Sử dụng biểu đồ liên kết chung để liên kết chung sự kiện cho tất cả nền tảng.
Trong danh sách Sự kiện của đối tác , chọn sự kiện có sẵn hoặc nhập sự kiện do bạn đặt tên - sự kiện này sẽ liên kết với sự kiện của Adjust.
Chọn Áp dụng .
Giờ đây, Pinterest sẽ nhận được dữ liệu về in-app event của từng sự kiện được liên kết.
Liên kết tất cả sự kiện
Nếu Pinterest cho phép liên kết tự động tất cả sự kiện, thì tại mục Liên kết sự kiện , chọn Liên kết tất cả sự kiện. Như vậy bạn đỡ mất thời gian liên kết từng sự kiện một.
Sau bước trên, Pinterest sẽ nhận được dữ liệu sự kiện in-app của tất cả sự kiện được liên kết.
Liên kết tham số
Bạn cần liên kết tham số để gửi dữ liệu tùy chỉnh cho Pinterest.
Với tham số đối tác (khả dụng trên Adjust SDK phiên bản 4.0 trở lên), Adjust có thể thu thập và trực tiếp gửi các điểm dữ liệu tùy chỉnh từ ứng dụng đến Pinterest. Như vậy, Pinterest có thể nhận được dữ liệu chi tiết cho từng sự kiện được liên kết.
Trước khi thêm tham số đối tác mới vào SDK, vui lòng đảm bảo rằng, các tham số đối tác hiện có không đáp ứng được yêu cầu.
Để chia sẻ tham số đối tác cho Pinterest, thực hiện các bước sau.
Cài đặt tham số đối tác trong Adjust SDK.
- Xem mục Trước khi bắt đầu của tất cả liên kết nền tảng phát triển SDK.
Tại mục Cài đặt tính năng chia sẻ dữ liệu , chọn Tham số.
Đến mục Liên kết tham số , chọn tham số mà bạn muốn gửi đến mạng quảng cáo:
- Chọn Liên kết tham số.
- Tại trường Tham số SDK , nhập tên tham số SDK mà bạn muốn chia sẻ cho mạng quảng cáo.
- Tại trường Tham số đối tác , nhập tham số mạng quảng cáo tương ứng với tham số SDK.
Nếu bạn cài đặt tham số đối tác trong Adjust SDK nhưng không cài đặt tính năng liên kết tham số đối tác, thì Adjust sẽ chuyển tiếp tham số theo tên được ghi trong Adjust SDK.
Định cấu hình cho liên kết và cài đặt
Bạn có thể cài đặt các thành phần sau:
Tạo liên kết và chia sẻ liên kết cho Pinterest
Trên màn hình Kiểm tra lại cài đặt , kiểm tra lại các thao tác đã thực hiện. Bạn có thể quay lại để thực hiện thay đổi nếu cần:
- Ứng dụng đã chọn
- Cách chia sẻ dữ liệu
- Tham số cấu trúc (Link structure parameters)
- Trang đến (User destination)
- Cài đặt phân bổ
Chọn Tạo liên kết để tạo click URL, impression URL, mã QR và link token. Sau khi liên kết được tạo, tính năng chia sẻ dữ liệu và tích hợp Pinterest sẽ được kích hoạt.
Sau khi tạo xong liên kết, chia sẻ liên kết cho Pinterest để Pinterest đưa liên kết vào chiến dịch quảng cáo.
Hướng dẫn cài đặt đối tác
Tổng quan
Để gửi sự kiện in-app đến Pinterest, bạn cần cung cấp thông tin xác thực, loại thông tin cần cung cấp sẽ tùy vào phiên bản API mà bạn đang sử dụng:
API v5 (Khuyên dùng):
- Ad Account ID
- Access Token
Phiên bản API cũ:
- Tag ID
Để lấy Access Token , thực hiện các bước sau: Truy cập Pinterest Ads Manager , chọn Ad Account Overview> Conversions> Set Up API
Chuyển từ phiên bản API cũ sang phiên bản API mới v5
Pinterest sẽ ngừng hỗ trợ phiên bản API cũ để tập trung hỗ trợ API v5 . Mục này sẽ cung cấp hướng dẫn từng bước thiết lập, gồm xác thực, liên kết sự kiện và loại bỏ cấu hình cũ.
1. Nhập thông tin
Truy cập Campaign Lab, chọn Pinterest và ứng dụng của bạn, sau đó thực hiện nhập các thông tin sau:
- Account ID
- Access token
Hai thông tin này là bắt buộc để thiết lập API v5. Xem hướng dẫn lấy Access Token theo đúng Account ID tại đây.
2. Liên kết sự kiện
Hiểu rõ mục đích của các trường sau
- Tên (Phiên bản cũ) – chỉ sử dụng cho phiên bản API cũ.
- Tên mới (API v5) – giá trị sự kiện bắt buộc để thiết lập API v5.
Tại trường sự kiện của Adjust, chọn sự kiện in-app mà bạn muốn liên kết, sau đó liên kết sự kiện với giá trị nằm trong danh mục Tên mới
Dưới đây là danh sách các sự kiện thuộc Phiên bản cũ (Tên) và Phiên bản API mới v5 (Tên mới) có thể liên kết với nhau. Bạn cũng có thể liên kết các sự kiện của phiên bản cũ với những sự kiện khác của phiên bản API v5 có trên Pinterest.
| Tên (Phiên bản cũ) | Tên mới (API v5) |
| Add to cart | Add to cart |
| Purchase | Checkout |
| Registration | Signup |
| Search | Search |
| Lead | Lead |
| Page visit | Page visit |
3. Loại bỏ Tag ID cũ (không bắt buộc)
API v5 không yêu cầu Tag ID. Cho nên bạn có thể loại bỏ Tag ID ra khỏi cấu hình. Nếu bạn vẫn cung cấp Tag ID cùng với Account ID , Access Token và giá trị cho trường Tên mới , hệ thống sẽ ưu tiên sử dụng API v5 và bỏ qua Tag ID vốn là thông tin của phiên bản API cũ.
Khuyến nghị
Pinterest hỗ trợ đồng thời iOS và Android đối với chiến dịch chuyển đổi người dùng sử dụng “deep linking”. Trước khi kích hoạt tích hợp, vui lòng liên hệ với Pinterest để được hỗ trợ thiết lập loại chiến dịch này.
Tham số có sẵn
Bạn có thể sự kiện kèm theo các tham số có sẵn thông qua Adjust SDK. Nếu được gán vào sự kiện đúng cách, các tham số này sẽ được chuyển tiếp đến Pinterest.
Vui lòng tham khảo tài liệu SDK để biết cách gán tham số đối tác vào sự kiện.
| Tham số | Mô tả | Hỗ trợ trong API v5 | Định dạng / Lưu ý |
| external_id | External user ID | ✅ | Danh sách chuỗi, phân tách chuỗi bằng dấu phẩy hoặc chấm phẩy |
| event_source_url | URL của trang web nơi sự kiện xảy ra | ✅ | Chuỗi (định dạng URL) |
| em | Địa chỉ email, dạng băm (hash) | ✅ | Địa chỉ email, viết thường, mã hóa bằng hàm băn SHA256 |
| ph | Số điện thoại, dạng băm | ✅ | Số điện thoại, chỉ chứa số, mã hóa bằng hàm băn SHA256, gồm mã vùng và mã quốc gia |
| event_id | Mã định danh sự kiện, mã này là duy nhất | ✅ | Chuỗi |
| content_ids | Mã định danh sản phẩm hoặc nội dung | ✅ | Danh sách chuỗi, phân tách chuỗi bằng dấu phẩy hoặc chấm phẩy |
| order_id | Mã định danh đơn hàng | ✅ | Chuỗi |
| value | Giá trị giao dịch hoặc hành động thêm hàng vào giỏ | ✅ | Số (Cũng được hỗ trợ trong API cũ) |
| currency | Đơn vị tiền tệ cho trường "value" | ✅ | Mã ISO 4217 (ví dụ: USD, EUR) – cũng được hỗ trợ trong API cũ |
Để biết thêm thông tin định dạng của các tham số external_id, em và ph, vui lòng tham khảo tài liệu API của Pinterest.
Giá trị của các tham số value và currency sẽ được sử dụng làm giá trị dự phòng , chỉ được gửi đến Pinterest nếu SDK không gửi cho Adjust bất kỳ dữ liệu doanh thu nào liên quan đến sự kiện in-app.
Để biết thêm thông tin, vui lòng tham khảo tài liệu của Adjust về cách ghi nhận dữ liệu doanh thu sự kiện.
Các tham số liên quan đến mặt hàng, gộp lại thành nhóm
Các tham số sau cung cấp thông tin về mặt hàng (item-level metadata) và cần được sắp xếp theo thứ tự tương ứng trong nội dung payload của sự kiện.
| Tham số | Mô tả | Định dạng / Lưu ý |
| ID | Mã định danh mặt hàng, mã này là duy nhất | Danh sách chuỗi, sắp xếp theo thứ tự (phân tách bằng dấu phẩy hoặc chấm phẩy) |
| quantity | Số lượng của từng mặt hàng | Danh sách chuỗi, sắp xếp theo thứ tự |
| item_name | Tên của từng mặt hàng | Danh sách chuỗi, sắp xếp theo thứ tự |
| item_price | Giá của từng mặt hàng | Danh sách chuỗi, sắp xếp theo thứ tự |
| item_category | Phân loại của từng mặt hàng | Danh sách chuỗi, sắp xếp theo thứ tự |
| item_brand | Thương hiệu của từng mặt hàng | Danh sách chuỗi, sắp xếp theo thứ tự |
Giá trị của các trường phải được sắp xếp theo thứ tự tương ứng.
(ví dụ: giá trị đầu tiên của tham số item_price và giá trị đầu tiên của các tham số item_name, id, v.v. đều phải thuộc về cùng mặt hàng)
Danh sách tất cả tham số được chuyển tiếp đến Pinterest
Pinterest yêu cầu Adjust gửi các tham số (điểm dữ liệu) sau trong callback:
| Trường dữ liệu | Thông tin |
{city} | Thành phố |
{country} | Mã quốc gia gồm hai ký tự |
{currency} | Mã tiền tệ gốc theo ISO 4217, do Adjust SDK gửi đến |
{device_name} | Số hiệu của thiết bị |
{gps_adid} | Google Play Store advertising ID |
{idfa} | ID dành cho nhà quảng cáo (advertiser) (chỉ áp dụng với iOS) |
{ip_address} | Địa chỉ IP của thiết bị |
{isp} | Nhà cung cấp dịch vụ internet |
{language} | Mã ngôn ngữ gồm hai ký tự |
{os_name} | Hệ điều hành của thiết bị |
{os_version} | Số phiên bản của hệ điều hành |
{partner_parameters} | Tham số đối tác tùy chỉnh do Adjust SDK hoặc yêu cầu S2S thu thập được, sau đó gửi đến nhà cung cấp dịch vụ bên thứ ba qua postback |
{revenue_usd} | Doanh thu, tính theo đô-la Mỹ |
{revenue} | Doanh thu được gửi từ Adjust SDK, tính theo cent |
{sdk_version} | Phiên bản Adjust SDK (của từng ứng dụng) |
{tracking_limited} | 1 nếu tính năng theo dõi bị hạn chế, 0 nếu tính năng không bị hạn chế |
{user_agent} | User agent đến, dạng thô |
{app_id} | Store App ID hoặc Google Play Store |
{app_name} | Tên của ứng dụng |
{app_version_short} | Số phiên bản ứng dụng (Android), số phiên bản của bản phát hành trong gói (iOS) |
{created_at} | Dấu thời gian của hoạt động |
{impression_based} | 1 nếu là tương tác đến từ việc xem quảng cáo, 0 nếu không phải |