Tác nhân người dùng ứng dụng
Trong nỗ lực ngăn chặn mánh khóe tăng thứ hạng, chúng tôi đã phát triển một bản đặc tả chuẩn hoá cho tiêu đề User-Agent do một sản phẩm analytics/ads gửi thay mặt cho người dùng ứng dụng. Tác nhân người dùng của ứng dụng có thể được lấy từ mã gốc để tuân thủ thông số kỹ thuật sau:
name version (os_and_version; locale; device; build; Proxy)
Định nghĩa về các trường này như sau:
Thành phần tác nhân người dùng | |
---|---|
name | Tên của sản phẩm analytics/ads. ( Xin lưu ý rằng nếu tác nhân người dùng được tạo ở phía máy khách, Android// Specified by API consumer. iOS// Specified by API consumer. |
version | Phiên bản của sản phẩm analytics/ads.
( Android// Specified by API consumer. iOS// Specified by API consumer. |
os_and_version | Hệ điều hành và phiên bản hệ điều hành mà ứng dụng đang chạy. ( AndroidString osAndVersion = "Android " + Build.VERSION.RELEASE; iOSUIDevice *uid = [UIDevice currentDevice]; NSString *osAndVersion = [NSString stringWithFormat:@"%@ %@", [uid systemName], [uid systemVersion]]; |
locale | Thẻ ngôn ngữ IETF cho thiết bị, sử dụng ngôn ngữ
hai chữ cái và mã quốc gia được phân tách bằng dấu gạch dưới.
( AndroidString locale = Locale.getDefault(); iOSNSString *locale = [[NSLocale currentLocale] localeIdentifier] |
device | Tên của thiết bị thực tế đang chạy sản phẩm analytics/ads.
( AndroidString device = Build.MODEL; iOS@import Darwin.sys.sysctl; NSString *device(void) { size_t bufferSize = 64; NSMutableData *buffer = [[NSMutableData alloc] initWithLength:bufferSize]; int status = sysctlbyname("hw.machine", buffer.mutableBytes, &bufferSize, NULL, 0); if (status != 0) { return nil; } return [[NSString alloc] initWithCString:buffer.mutableBytes encoding:NSUTF8StringEncoding]; } |
build | "Build/" theo sau là số bản dựng của hệ điều hành.
( AndroidString build = "Build/" + Build.ID; iOS@import Darwin.sys.sysctl; NSString *build(void) { size_t bufferSize = 64; NSMutableData *buffer = [[NSMutableData alloc] initWithLength:bufferSize]; int status = sysctlbyname("kern.osversion", buffer.mutableBytes, &bufferSize, NULL, 0); if (status != 0) { return nil; } return [[NSString alloc] initWithCString:buffer.mutableBytes encoding:NSUTF8StringEncoding]; } |
Chỉ đưa ; Proxy
vào cuối tác nhân người dùng ứng dụng khi tạo phía máy chủ tác nhân người dùng ứng dụng. Nếu Tác nhân người dùng ứng dụng được xây dựng hoàn toàn ở phía máy khách, hãy loại trừ ; Proxy
. Do đó, tác nhân người dùng của ứng dụng có thể là:
- Android:
AdMob/7.10.1 (Android 6.0; en_US; SM-G900F; Build/MMB29M; Proxy)
- iOS:
AdMob/7.10.1 (iOS 10.0.2; en_US; iPhone9,1; Build/13D15; Proxy)
Yêu cầu theo dõi lượt chuyển đổi
Mục đích của yêu cầu theo dõi lượt chuyển đổi là thông báo cho Google Ads về một sự kiện ứng dụng cần được theo dõi dưới dạng lượt chuyển đổi và/hoặc dùng để điền danh sách tái tiếp thị, cũng như để truy xuất siêu dữ liệu mô tả mọi lượt nhấp trước sự kiện đó.
Tất cả các lệnh gọi API đều được thực hiện đến miền www.googleadservices.com
. Yêu cầu chuyển đổi là các yêu cầu POST
thông qua HTTPS trên đường dẫn sau:
/pagead/conversion/app/version, trong đó version là phiên bản dự kiến của API theo dõi lượt chuyển đổi. Hiện tại, phiên bản hợp lệ duy nhất là
1.0
.
Yêu cầu chuyển đổi ứng dụng chuẩn sẽ chứa các thông số sau.
Yêu cầu theo dõi lượt chuyển đổi | |
---|---|
dev_token |
Bắt buộc Vị trí: Truy vấn Mã của nhà phát triển tĩnh và duy nhất được cấp cho người dùng API. Z_eErE4DkvcKjDM1OVE4c4 |
link_id |
Bắt buộc Vị trí: Truy vấn Giá trị nhận dạng đường liên kết liên kết mã của người phát triển cho người dùng API với một ứng dụng cụ thể. 31FF8D67E5BB5DD5029DCC2734C2F884 |
app_event_type |
Bắt buộc Vị trí: Truy vấn Tên của sự kiện ứng dụng đã xảy ra. Trường này là một bảng liệt kê và sẽ chỉ chấp nhận các giá trị sau: • first_open • session_start • in_app_purchase • view_item_list • view_item • view_search_results • add_to_cart • ecommerce_purchase • custom Sự kiện |
app_event_name |
Bắt buộc trong một số điều kiện nhất định Vị trí: Truy vấn Tên của bất kỳ sự kiện ứng dụng tùy chỉnh nào không được chấp nhận trong trường level_achieved Level Achieved Trường này không được chứa bất kỳ giá trị nào dành riêng cho |
app_event_data |
Không bắt buộc Vị trí: Nội dung Chuyển tiếp mọi dữ liệu bổ sung về sự kiện phong phú dưới dạng các khoá chuỗi liên kết đối tượng JSON đơn giản tới các giá trị. Các giá trị được chấp nhận được là các chuỗi và dãy chuỗi. {"level": 5, "attempts": 20} |
rdid |
Bắt buộc Vị trí: Truy vấn Chuỗi UUID hợp lệ đại diện cho mã thiết bị thô. f10e1de2-e237-4f50-b6aa-843c45cc63d6 Trong trường hợp thiếu mã thiết bị (chẳng hạn như mã thiết bị của một người dùng không đồng ý theo ATT), hãy đặt tất cả thành 0. 00000000-0000-0000-0000-000000000000 |
id_type |
Bắt buộc Vị trí: Truy vấn Loại giá trị nhận dạng được lưu trữ trong trường Androidadvertisingid iOSidfa |
lat |
Bắt buộc Vị trí: Truy vấn Trạng thái theo dõi quảng cáo giới hạn cho thiết bị.
|
app_version |
Bắt buộc Vị trí: Truy vấn Phiên bản hiện tại của ứng dụng. Phiên bản này phải được chuẩn hóa như sau. AndroidpackageManager.getPackageInfo(packageName(), PackageManager.GET_META_DATA).versionName iOS[[[NSBundle mainBundle] infoDictionary] objectForKey:@"CFBundleShortVersionString"] 1.2.4 |
os_version |
Bắt buộc Vị trí: Truy vấn Phiên bản hiện tại của hệ điều hành lưu trữ của ứng dụng. Việc này phải được chuẩn hoá như sau. Androidandroid.os.Build.VERSION.RELEASE iOS[[UIDevice currentDevice] systemVersion] |
sdk_version |
Bắt buộc Vị trí: Truy vấn Phiên bản SDK đã đo lường sự kiện. Vì phiên bản này chủ yếu dùng để gỡ lỗi, nên phản ánh chính xác phiên bản phát hành khi được phát hành cùng với các bản phát hành SDK của bạn. Nếu ứng dụng không sử dụng SDK, vui lòng chuyển cùng một giá trị như 1.9.5r6 |
timestamp |
Bắt buộc Vị trí: Truy vấn Dấu thời gian UNIX mà sự kiện chuyển đổi đã xảy ra, tính bằng giây với độ chính xác lên đến micrô giây. 1432681913.123456 |
value |
Không bắt buộc Vị trí: Truy vấn Giá trị tiền tệ của sự kiện (nếu có). Giá trị này luôn được định dạng dưới dạng giá trị dấu phẩy động có thể đọc được bằng máy, sử dụng dấu thập phân để phân tách số nguyên và phân số của giá trị. 1.99 |
currency_code |
Bắt buộc trong một số điều kiện nhất định Vị trí: Truy vấn Mã đơn vị tiền tệ ISO 4217 cho tham số USD |
gclid |
Bắt buộc trong một số điều kiện nhất định Vị trí: Truy vấn Giá trị của tham số truy vấn Cj0KEQjw0dy4BRCuuL_e5M |
market_referrer_gclid |
Bắt buộc trong một số điều kiện nhất định Vị trí: Truy vấn Giá trị của tham số truy vấn BX3QojHp4mY5MrJtFM_d1u |
gclid_only_request |
Bắt buộc trong một số điều kiện nhất định Vị trí: Truy vấn Giá trị nhận dạng cho 1 |
gbraid |
Bắt buộc trong một số điều kiện nhất định Vị trí: Truy vấn Giá trị ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O |
app_open_source |
Bắt buộc trong một số điều kiện nhất định Vị trí: Truy vấn Giá trị để xác định đường liên kết sâu của quảng cáo khi nhấp vào quảng cáo hoặc phiên ứng dụng không phải trả tiền. ad_click or organic |
User-Agent |
Bắt buộc Vị trí: Tiêu đề Tác nhân người dùng ứng dụng như đã xác định trong phần trước. AdMob/7.10.1 (Android 6.0; en_US; SM-G900F; Build/MMB29M) |
X-Forwarded-For |
Bắt buộc Vị trí: Tiêu đề Địa chỉ IPv4 hoặc IPv6 công khai của thiết bị đo sự kiện. 216.58.194.174 |
Tất cả các yêu cầu phải được gửi qua HTTPS. Ping nhận được qua HTTP sẽ bị từ chối.
Xin lưu ý rằng nếu phần nội dung yêu cầu trống (trong trường hợp không có dữ liệu sự kiện nhiều định dạng nào được chuyển vào tải trọng app_event_data
), thì máy chủ của chúng tôi sẽ yêu cầu bạn phải đặt tiêu đề Content-Length: 0
một cách rõ ràng trên yêu cầu của mình.
Yêu cầu mẫu
Ví dụ về yêu cầu theo dõi lượt chuyển đổi hợp lệ có loại sự kiện không tùy chỉnh và thông tin doanh thu là:
POST /pagead/conversion/app/1.0 ?dev_token=Z_eErE4DkvcKjDM1OVE4c4 &link_id=31FF8D67E5BB5DD5029DCC2734C2F884 &app_event_type=in_app_purchase &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D &id_type=idfa &lat=0 &app_version=1.2.4 &os_version=9.3.2 &sdk_version=1.9.5r6 ×tamp=1432681913.123456 &value=1.99 ¤cy_code=USD Host: www.googleadservices.com User-Agent: MyAnalyticsCompany/1.0.0 (iOS 10.0.2; en_US; iPhone9,1; Build/13D15; Proxy) X-Forwarded-For: 216.58.194.174 Content-Type: application/json; charset=utf-8
{"app_event_data":{"item_id":["Crayons","Markers"]}}
Ví dụ về yêu cầu theo dõi lượt chuyển đổi hợp lệ có loại sự kiện không tùy chỉnh và thông tin doanh thu có rdid (advertisingid) không có sẵn là:
POST /pagead/conversion/app/1.0 ?dev_token=Z_eErE4DkvcKjDM1OVE4c4 &link_id=31FF8D67E5BB5DD5029DCC2734C2F884 &app_event_type=in_app_purchase &rdid=00000000-0000-0000-0000-000000000000 &id_type=advertisingid &lat=1 &app_version=1.2.4 &os_version=9.3.2 &sdk_version=1.9.5r6 ×tamp=1432681913.123456 &value=1.99 ¤cy_code=USD &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u &gclid=Cj0KEQjw0dy4BRCuuL_e5M &gclid_only_request=1 Host: www.googleadservices.com User-Agent: MyAnalyticsCompany/1.0.0 (iOS 10.0.2; en_US; Android,1; Build/13D15; Proxy) X-Forwarded-For: 216.58.194.174 Content-Type: application/json; charset=utf-8
{"app_event_data":{"item_id":["Crayons","Markers"]}}
Ví dụ về yêu cầu bắt đầu phiên hợp lệ là:
POST /pagead/conversion/app/1.0 ?dev_token=Z_eErE4DkvcKjDM1OVE4c4 &link_id=31FF8D67E5BB5DD5029DCC2734C2F884 &app_event_type=session_start &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D &id_type=idfa &lat=0 &app_version=1.2.4 &os_version=9.3.2 &sdk_version=1.9.5r6 ×tamp=1432681913.123456 Host: www.googleadservices.com User-Agent: MyAnalyticsCompany/1.0.0 (iOS 10.0.2; en_US; iPhone9,1; Build/13D15; Proxy) X-Forwarded-For: 216.58.194.174 Content-Type: application/json; charset=utf-8
Ví dụ về yêu cầu phân bổ lại bắt đầu phiên hợp lệ cho một phiên bắt đầu từ liên kết sâu example://product/123?gclid=Cj0KEQjw0dy4BRCuuL_e5M
là:
POST /pagead/conversion/app/1.0 ?dev_token=Z_eErE4DkvcKjDM1OVE4c4 &link_id=31FF8D67E5BB5DD5029DCC2734C2F884 &app_event_type=session_start &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D &id_type=idfa &lat=0 &app_version=1.2.4 &os_version=9.3.2 &sdk_version=1.9.5r6 ×tamp=1432681913.123456 &gclid=Cj0KEQjw0dy4BRCuuL_e5M Host: www.googleadservices.com User-Agent: MyAnalyticsCompany/1.0.0 (iOS 10.0.2; en_US; iPhone9,1; Build/13D15; Proxy) X-Forwarded-For: 216.58.194.174 Content-Type: application/json; charset=utf-8
Mã hoá dữ liệu sự kiện
Đối với thông số nội dung app_event_data
, vui lòng sử dụng các quy ước sau cho các loại dữ liệu gốc:
Số thực dấu phẩy động
- Sử dụng ký tự dấu chấm làm dấu phân tách số thập phân, độc lập với việc bản địa hoá ứng dụng
- Sử dụng độ chính xác thập phân gồm hai chữ số để biểu thị giá trị tiền tệ, ví dụ: 2,99
- Không sử dụng ký hiệu mũ, ví dụ: 2E+9
- Không sử dụng ký tự dấu phẩy để phân tách các nhóm chữ số, ví dụ: 1.000.000
- Ví dụ hợp lệ:
-0.5
2.99
1000000.123
Integer
- Chỉ gửi toàn bộ giá trị số nguyên không có chữ số thập phân
- Không sử dụng ký tự dấu phẩy để phân tách các nhóm chữ số, ví dụ: 1.000. 000
- Ví dụ hợp lệ:
1000
-11
0
Ngày
- Định dạng ngày: yyyy-mm-dd
yyyy
= năm gồm bốn chữ số, ví dụ: 2016mm
= tháng có 2 chữ số, ví dụ: 09 tháng 9dd
= ngày gồm hai chữ số, ví dụ: 23 cho ngày thứ 23 của tháng
- Luôn gửi số lượng chữ số được chỉ định ở trên, ví dụ: nếu gửi
giá trị cho dd vào ngày thứ 5 của tháng, hãy gửi
05
. - Ví dụ hợp lệ:
"2016-09-23"
"1990-12-31"
- Định dạng ngày: yyyy-mm-dd
Dấu thời gian
- Định dạng thời gian: Dấu thời gian Unix/Epoch được xác định theo múi giờ UTC với độ chính xác lên đến micrô giây
- Ví dụ hợp lệ:
1478713087
cho Thứ Tư, 09 thg 11, 2016 17:38:07 GMT1073513982.123000
cho Thứ Tư, ngày 7 tháng 1 năm 2004 22:19:42.123 GMT
Mảng
- Chỉ gửi các mảng giá trị gốc (chuỗi, số và boolean)
- Ví dụ hợp lệ:
[123, 456, 789]
["abc"]
Phản hồi theo dõi chuyển đổi
Phản hồi theo dõi lượt chuyển đổi có định dạng sau:
{ "ad_events": [<ad event objects>], "errors": [<error strings>], "attributed": true|false }
Cả mảng ad_events và error có thể trống.
Chúng tôi dự kiến rằng lỗi sẽ là mã lỗi máy có thể đọc được, ví dụ: invalid_timestamp
.
Sự kiện quảng cáo là đối tượng cốt lõi của mô hình phân bổ ứng dụng và sẽ chứa các thuộc tính sau.
Phản hồi theo dõi chuyển đổi | |
---|---|
ad_event_id |
Luôn hiển thị string
Q2owS0VRancwZHk0QlJDdXVMX2U1TQ |
conversion_metric |
Luôn hiển thị string Chỉ số chuyển đổi dùng để phân bổ. Ban đầu, chúng tôi sẽ hỗ trợ một chỉ số chuyển đổi. conversion |
timestamp |
Luôn hiển thị số Dấu thời gian UNIX mà sự kiện quảng cáo xảy ra, tính bằng giây với độ chính xác lên đến micrô giây. Bạn nên sử dụng giá trị này cho mô hình phân bổ theo lượt nhấp cuối cùng. 1432681913.123456 |
campaign_type |
Luôn hiển thị string Trường này sẽ xác định loại chiến dịch đã tạo ra sự kiện quảng cáo. Các giá trị có thể có như sau. ACI ACE Search Display Video Shopping Hotel Performance_Max Other ACI là tên viết tắt của Chiến dịch quảng cáo ứng dụng để tăng lượt cài đặt. ACE là từ viết tắt của Chiến dịch quảng cáo ứng dụng để thúc đẩy sự tương tác. |
campaign_id |
Luôn hiển thị số Mã chiến dịch dạng số của chiến dịch đã tạo ra sự kiện quảng cáo. Giá trị này được đảm bảo là duy nhất. 123456789 |
campaign_name |
Luôn hiển thị string Tên chiến dịch do nhà quảng cáo xác định của chiến dịch đã tạo ra sự kiện quảng cáo. Giá trị này không phải lúc nào cũng đúng. Occasional Gamers (Video) |
ad_type |
Luôn hiển thị string Loại quảng cáo đã dẫn đến sự kiện quảng cáo. Giá trị này có thể được dùng để phân biệt các loại khoảng không quảng cáo như sau. Quảng cáo ứng dụngClickToDownloadLượt tương tác với ứng dụng AppDeepLinkLượt tương tác với ứng dụng — Lượt cài đặt và tiếp tục AppDeepLinkContinueTổng hợp các giá trị khác Unknown |
external_customer_id |
Luôn hiển thị số Giá trị nhận dạng nhà quảng cáo cho nhà quảng cáo sở hữu chiến dịch đã tạo ra sự kiện quảng cáo. Giá trị này có thể được dùng để phân biệt các tài khoản Google Ads. 123456789 |
location |
Luôn hiển thị số Mã vị trí cho vị trí địa lý của sự kiện quảng cáo. Tham khảo Tài liệu tham khảo API Google Ads để diễn giải mã vị trí. |
network_type |
Luôn hiển thị string Trường này sẽ xác định mạng quảng cáo trên Google Ads đã xảy ra sự kiện quảng cáo. Các giá trị có thể có như sau. Search Display YouTube |
network_subtype |
Sẽ là string Trường này sẽ xác định “loại phụ” của mạng quảng cáo Google Ads đã xảy ra sự kiện quảng cáo. Các giá trị có thể sử dụng khác nhau tùy theo loại mạng chính. Tìm kiếmGoogle Tìm kiếm thông thườngGoogleSearchĐối tác tìm kiếm của Google SearchPartners Màn hìnhNhà xuất bản web dành cho thiết bị di độngmGDNNhà xuất bản ứng dụng Google AdMob YouTubeMạng video YouTubeYouTubeVideosMạng tìm kiếm YouTube YouTubeSearchĐối tác video VideoPartners |
video_id |
Chỉ được cung cấp khi string Mã video trên YouTube liên kết với sự kiện quảng cáo. dQw4w9WgXcQ |
keyword |
Chỉ được cung cấp khi string Từ khoá tìm kiếm có liên quan đến sự kiện quảng cáo. +food +delivery |
match_type |
Chỉ được cung cấp khi string Kiểu khớp cho từ khoá cho quảng cáo trên mạng tìm kiếm. Chính xáceCụm từ pChiều rộng b |
placement |
Chỉ được cung cấp khi string Vị trí được liên kết với sự kiện quảng cáo. mobileapp::1-343200656 |
ad_group_id |
Luôn hiển thị số Mã dạng số của nhóm quảng cáo được tạo cùng với sự kiện quảng cáo. Giá trị này được đảm bảo là duy nhất. 123456789 |
ad_group_name |
Chỉ được cung cấp khi string Tên nhóm quảng cáo do nhà quảng cáo xác định của nhóm quảng cáo đã tạo sự kiện quảng cáo. Giá trị này không phải lúc nào cũng đúng. My App AdGroup |
creative_id |
Chỉ được cung cấp khi số Mã dạng số của đơn vị quảng cáo đã tạo sự kiện quảng cáo. Giá trị này được đảm bảo là duy nhất. 123456789 |
interaction_type |
Trường này sẽ luôn tương tác. string |
Câu trả lời mẫu
Ví dụ về phản hồi theo dõi lượt chuyển đổi khi yêu cầu chứa lỗi là:
{ "ad_events": [], "errors": ["INVALID_CURRENCY_CODE"], "attributed": false }
Ví dụ về phản hồi theo dõi lượt chuyển đổi phủ định là:
{ "ad_events": [], "errors": [], "attributed": false }
Hệ thống sẽ trả về phản hồi theo dõi lượt chuyển đổi cho tất cả yêu cầu theo dõi lượt chuyển đổi.
Ví dụ về phản hồi theo dõi lượt chuyển đổi rõ ràng cho Chiến dịch quảng cáo ứng dụng toàn cầu:
{ "ad_events": [{ "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ", "conversion_metric": "conversion", "interaction_type": "engagement", "campaign_type": "ACI", "campaign_id": 123456789, "campaign_name": "My App Campaign", "ad_type": "ClickToDownload", "external_customer_id": 123456789, "location": 21144, "network_type": "Search", "network_subtype": "GoogleSearch", "video_id": null, "keyword": null, "match_type": null, "placement": null, "ad_group_id": null, "ad_group_name": "", "creative_id": null, "timestamp": 1432681913.123456 }], "errors": [], "attributed": true }
Ví dụ về phản hồi xác nhận theo dõi lượt chuyển đổi cho Chiến dịch tìm kiếm là:
{ "ad_events": [{ "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ", "conversion_metric": "conversion", "interaction_type": "engagement", "campaign_type": "Search", "campaign_id": 123456789, "campaign_name": "My App Campaign", "ad_type": "ClickToDownload", "external_customer_id": 123456789, "location": 21144, "network_type": "Search", "network_subtype": "GoogleSearch", "video_id": null, "keyword": "+space +birds", "match_type": "b", "placement": null, "ad_group_id": 123456789, "ad_group_name": "My App AdGroup", "creative_id": 123456789, "timestamp": 1432681913.123456 }], "errors": [], "attributed": true }
Ví dụ về phản hồi xác nhận là theo dõi lượt chuyển đổi cho Chiến dịch hiển thị:
{ "ad_events": [{ "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ", "conversion_metric": "conversion", "interaction_type": "engagement", "campaign_type": "Display", "campaign_id": 123456789, "campaign_name": "My App Campaign", "ad_type": "ClickToDownload", "external_customer_id": 123456789, "location": 21144, "network_type": "Display", "network_subtype": "mGDN", "video_id": null, "keyword": null, "match_type": null, "placement": "mobile-app::2-343200656", "ad_group_id": 123456789, "ad_group_name": "My App AdGroup", "creative_id": 123456789, "timestamp": 1432681913.123456 }], "errors": [], "attributed": true }
Ví dụ về phản hồi theo dõi lượt chuyển đổi rõ ràng cho một chiến dịch trên YouTube:
{ "ad_events": [{ "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ", "conversion_metric": "conversion", "interaction_type": "engagement", "campaign_type": "Video", "campaign_id": 123456789, "campaign_name": "My App Campaign", "ad_type": "ClickToDownload", "external_customer_id": 123456789, "location": 21144, "network_type": "YouTube", "network_subtype": "YouTubeVideos", "video_id": "dQw4w9WgXcQ", "keyword": null, "match_type": null, "placement": null, "ad_group_id": 123456789, "ad_group_name": "My App AdGroup", "creative_id": 123456789, "timestamp": 1432681913.123456 }], "errors": [], "attributed": true }
Yêu cầu phân bổ trên nhiều mạng
Khi Google Ads phản hồi yêu cầu theo dõi lượt chuyển đổi một cách khẳng định, người tiêu dùng API phải thông báo cho Google Ads về quyết định phân bổ trên nhiều mạng sau khi xác định lượt nhấp cuối cùng.
Yêu cầu phân bổ trên nhiều mạng giống hệt với yêu cầu theo dõi lượt chuyển đổi ban đầu, nhưng có đường dẫn yêu cầu là:
/pagead/conversion/app/1.0/cross_network
và bổ sung 2 thông số bắt buộc:
Yêu cầu phân bổ trên nhiều mạng | |
---|---|
ad_event_id |
Bắt buộc Vị trí: Truy vấn Giá trị nhận dạng |
attributed |
Bắt buộc Vị trí: Truy vấn Google Ads có nhận được tín dụng cho lượt chuyển đổi của người dùng API không. |
Ví dụ về yêu cầu phân bổ trên nhiều mạng hợp lệ là:
POST /pagead/conversion/app/1.0/cross_network ?dev_token=Z_eErE4DkvcKjDM1OVE4c4 &link_id=31FF8D67E5BB5DD5029DCC2734C2F884 &app_event_type=custom &app_event_name=level_achieved &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D &id_type=idfa &lat=0 &app_version=1.2.4 &os_version=9.3.2 &sdk_version=1.9.5r6 ×tamp=1432681913.123456 &value=1.99 ¤cy_code=USD &ad_event_id=Q2owS0VRancwZHk0QlJDdXVMX2U1TQ &attributed=1 Host: www.googleadservices.com User-Agent: MyAnalyticsCompany/1.0.0 (iOS 10.0.2; en_US; iPhone9,1; Build/13D15; Proxy) X-Forwarded-For: 216.58.194.174 Content-Type: application/json; charset=utf-8
Một yêu cầu phân bổ trên nhiều mạng hợp lệ sẽ luôn nhận được một phản hồi 200 chung mà không có nội dung phản hồi.