Skip to content

optimization

Jump to bottom
Yasuyuki Kamata edited this page Apr 9, 2021 · 1 revision

/ * Tiêu đề: Các tính năng tối ưu hóa Mô tả: Tối ưu hóa chiến lược đấu thầu của bạn Phân loại: 7 */

Tổng quan

Đấu giá Thống nhất cung cấp tính năng bổ sung cho phép đối tác tối ưu hóa chiến lược mua của họ trên sàn giao dịch. Bài viết này bao gồm những nội dung sau:

Tiện ích dữ liệu theo ngữ cảnh

Unity cung cấp các tín hiệu chỉ số bổ sung trên ứng dụng hoặc người dùng mang đến lượt xem, để giúp tinh chỉnh các chiến lược đấu thầu của bạn. Hãy liên hệ với người quản lý tài khoản của bạn để bật các tập dữ liệu sau đây:

Thuộc tính Kiểu Dữ liệu Ví dụ Mô tả
mediationOrdinal int "mediationOrdinal": 1 Nhà phát triển triển khai Mediation Ordinal. Thuộc tính này biểu thị số lượng quảng cáo hiện có trong phiên trò chơi trên các mạng quảng cáo khác.
mute bool "mute": true Trạng thái tắt tiếng hiện tại trên thiết bị khi yêu cầu được thực hiện.
gameCategory chuỗi "gameCategory": "Games" Định nghĩa danh mục của Google Play và Cửa hàng Ứng dụng Apple
subGameCategory chuỗi "subGameCategory": "Simulation" Định nghĩa danh mục Trò chơi con của Google Play và Cửa hàng Ứng dụng Apple.
sessionDepth int "sessionDepth": 1 Số lần phân phối một quảng cáo trong phiên hiện tại.
bAge chuỗi "bAge": "17+" Xếp hạng độ tuổi theo nội dung bị chặn bởi đơn vị phát hành. Nếu ứng dụng của bạn có xếp hạng độ tuổi (như được xác định trên trang cửa hàng của ứng dụng đó) vượt quá giá trị này, giá thầu của bạn sẽ bị lọc bỏ.

Lưu ý: Unity sẽ không chuyển bất kỳ tín hiệu dữ liệu nào trong số này nếu chúng không có trong yêu cầu.

Ví dụ về yêu cầu giá thầu có dữ liệu theo ngữ cảnh

{ 
    "id": "ABCDEfghijkLMNOPqrstUV", 
        "imp": [{ 
            "id": "1", 
                "banner": { 
                    "w": 320, 
                    "h": 480, 
                    "battr": [1, 3, 5, 6, 8, 9], 
                    "pos": 7 
                }, 
            "instl": 1, 
            "tagid": "com.unity.example-vast", 
            "secure": 1 
        }], 
        "app": { 
            "id": "123abc4d5e0aa0473a80e9e1f43528d8", 
            "name": "Example Game", 
            "bundle": "123456789", 
            "storeurl": "https://itunes.apple.com/us/app/ExampleGame/id123456789?mt=8" 
        }, 
        "device": { 
            "ua": "Mozilla/5.0 (iPhone; CPU iPhone OS 11_2_5 like Mac OS X) AppleWebKit/604.5.6 (KHTML, like Gecko) Mobile/15D60", 
            "geo": { 
                "lat": 50.0144, 
                "lon": -50.2772, 
                "type": 2, 
                "country": "USA", 
                "city": "San Francisco", 
                "utcoffset": -480 
            }, 
            "ip": "123.123.12.123", 
            "devicetype": 4, 
            "model": "iPhone7,2", 
            "os": "ios", 
            "osv": "11.2.5", 
            "hwv": "iPhone 6", 
            "h": 667, 
            "w": 375, 
            "language": "en", 
            "carrier": "ATT", 
            "connectiontype": 2, 
            "ifa": "12345AB-C6789-DEFG-0123" 
        }, 
    "at": 2, 
    "tmax": 200, 
    "regs": {}, 
    "ext": { 
        "mediationOrdinal": 1, 
        "mute": true, 
        "gameCategory": "Games", 
        "subGameCategory": "Simulation", 
        "sessionDepth": 1,
        "bAge": "17+" 
    } 
}

Trở lại đầu trang

Tiện ích Đo lường Mở

Unity Ads hỗ trợ quảng cáo có khả năng Đo lường Mở. SDK Đo lường Mở của IAB (OM SDK) cung cấp mã và thư viện chung để tạo điều kiện cho bên thứ ba truy cập vào dữ liệu đo lường. Các trang web và ứng dụng có tích hợp OM SDK có thể gửi tín hiệu đo lường tới API Định nghĩa Giao diện Đo lường Mở (OMID). Các nhà cung cấp dịch vụ đo lường có thể đặt các thẻ mang nhiệm vụ thu thập những tín hiệu này. Để nhập và thực hiện các yêu cầu giá thầu có hỗ trợ quảng cáo OM, Unity đã cập nhật thông số kỹ thuật OpenRTB của mình để phản ánh những thay đổi liên quan đối với các trường yêu cầu giá thầu và phản hồi.

Đối tượng cha Thuộc tính Kiểu Ví dụ Mô tả
[bid.source](https://unityads.unity3d.com/help/programmatic/bid-requests#source-objects) omidpn chuỗi "omidpn": "Unity3d" Mã định danh dành cho tích hợp SDK Đo lường Mở. Đây là tham số giống với tham số namecủa đối tượng Đối tác OMID.
[bid.source](https://unityads.unity3d.com/help/programmatic/bid-requests#source-objects) omidpv chuỗi "omidpv": "1.2.10" Phiên bản của tích hợp SDK Đo lường Mở. Đây là tham số giống với tham số versionStringcủa đối tượng Đối tác OMID.
[bid.imp.video](https://unityads.unity3d.com/help/programmatic/bid-requests#video-objects) api mảng int "api": [7] Khung API được hỗ trợ cho lượt xem này. Giá trị 7 biểu thị khả năng hỗ trợ Đo lường Mở.
[response.seatbid.bid](https://unityads.unity3d.com/help/programmatic/bid-responses#bid-objects) api int "api":7 Khung API được hỗ trợ cho lượt xem này. Giá trị 7biểu thị khả năng hỗ trợ Đo lường Mở (OM). Để biết thêm thông tin, tham khảo mục Khung API trong cẩm nang SDK Đo lường mở của IAB.

Lưu ý: Unity mong đợi giá trị Khung API OMID-1 (7) cho mỗi giá thầu trong phản hồi. Điều này cho phép SDK xử lý quảng cáo OM đúng cách.

Xem thêm Thông số kỹ thuật OM cho các định dạng quảng cáo.

Ví dụ về yêu cầu giá thầu

{
    "id": "ABCDEfghijkLMNOPqrstUV",
    "imp": [{
        "id": "1",
        "video": {
            "mimes": ["video/mp4"],
            "minduration": 5,
            "maxduration": 30,
            "protocols": [2, 3, 5, 6],
            "w": 320,
            "h": 480,
            "linearity": 1,
            "sequence": 1,
            "battr": [1, 3, 5, 6, 8, 9, 13],
            "pos": 7,
            "api": [7]
        },
        "pmp": {},
        "displaymanager": "unity sdk",
        "displaymanagerver": "3200",
        "instl": 1,
        "tagid": "com.example.enterprise-vast",
        "secure": 1
    }],
    "app": {
        "id": "1",
        "publisher": {
            "id": "12345"
        }
    },
    "device": {
        "ua": "Mozilla/5.0 (iPhone; CPU iPhone OS 11_3 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E302",
        "geo": {
            "lat": 55.5555,
            "lon": 11.1111,
            "type": 2,
            "country": "DNK",
            "region": "84",
            "metro": "0",
            "city": "Copenhagen",
            "utcoffset": 60
        },
        "ip": "111.222.111.222",
        "devicetype": 4,
        "model": "iPhone10,1",
        "os": "ios",
        "osv": "11.3.1",
        "hwv": "iPhone10,1",
        "h": 647,
        "w": 375,
        "language": "en",
        "carrier": "Sprint",
        "connectiontype": 2,
        "ifa": "A123456B-7C89-01D2-3456-E7F890123GH4"
    },
    "at": 2,
    "tmax": 500,
    "source": {
        "pchain": "11111:12345",
        "omidpn": "Unity3d",
        "omidpv": "1.2.10"
    },
    "regs": {
        "ext": {}
    },
    "ext": {
        "placementType": "",
        "gameCategory": "Games",
        "subGameCategory": "Casual",
        "sessionDepth": 0
    }
}

Trở lại đầu trang

Thông báo thua thầu

Unity luôn cố gắng mang lại thành công cho đối tác trên sàn giao dịch của mình bằng cách gửi thông báo thua thầu theo thời gian thực. Những thông báo này cho biết lý do tại sao giá thầu tham gia bị thua trong phiên đấu giá. Các đối tác quảng cáo có thể tận dụng thông tin theo thời gian thực để thông báo chiến lược đấu thầu của họ một cách hiệu quả trên khoảng không quảng cáo của Unity.

Tích hợp

Để nhận thông báo thua thầu, hãy thêm thuộc tính lurl(URL thua thầu) tùy chọn vào đối tượng giá thầu trong phản hồi của bạn (để được hướng dẫn đầy đủ về cách tạo phản hồi giá thầu, hãy xem thông số kỹ thuật (phản hồi giá thầuhttps://unityads.unity3d.com/help/programmatic/bid-responses)[] OpenRTB của Unity). Điều này cho phép Unity điền mã lý do thua thầu trong phản hồi giá thầu.

Thuộc tính Kiểu Ví dụ Mô tả
lurl chuỗi "lurl": "http://example.com/?bid=123456&loss=${AUCTION_LOSS}" URL thông báo thua thầu được gọi bởi sàn giao dịch khi một giá thầu thua trong phiên đấu giá.

Unity sẽ trả về mã lý do thua thầu trong macro ${AUCTION_LOSS}.

Mã lý do thua thầu

Sau đây là các mã lý do thua thầu Unity có thể trả về. Lưu ý rằng các mã dưới1001 là các lý do thua thầu tùy chỉnh, không được xác định trong thông số kỹ thuật OpenRTB 2.5.

Mã Lý do Mô tả
1 Lỗi nội bộ Lỗi nội bộ Unity.
2 Cơ hội tính lượt xem đã hết hạn Lượt xem mất quá nhiều thời gian để hiển thị đến mức trình theo dõi lượt xem không còn hợp lệ.
3 Phản hồi giá thầu không hợp lệ Đối tác trả về phản hồi trống, hoàn toàn không phản hồi hoặc [trình xác thực OpenRTB] của Unity không thành công(https://unityads.unity3d.com/help/programmatic/endpoint-test-tool).
4 ID Giao dịch không hợp lệ [ID Giao dịch] (https://unityads.unity3d.com/help/programmatic/bid-requests#deal-objects)trong phản hồi giá thầu không khớp với (các) giao dịch trong yêu cầu giá thầu.
5 ID đấu giá không hợp lệ [ID] (https://unityads.unity3d.com/help/programmatic/bid-requests#request-objects)trong yêu cầu giá thầu không giống với ID trong phản hồi giá thầu.
6 Tên miền của đơn vị quảng cáo không hợp lệ (sai định dạng) Trường thuộc tínhadomain(https://unityads.unity3d.com/help/programmatic/bid-responses#bid-objects) [] (tên miền quảng cáo) trong phản hồi giá thầu là định dạng không hợp lệ.
7 Thiếu chênh lệch giá quảng cáo Trường thuộc tínhadm(https://unityads.unity3d.com/help/programmatic/bid-responses#bid-objects) [] (chênh lệch giá quảng cáo) trống.
8 Thiếu ID quảng cáo Trường thuộc tínhcrid(https://unityads.unity3d.com/help/programmatic/bid-responses#bid-objects) [] (ID quảng cáo) trống.
9 Thiếu mức giá đấu thầu Trường thuộc tínhprice(https://unityads.unity3d.com/help/programmatic/bid-responses#bid-objects) [] (mức giá đấu thầu) trống.
101 Giá thầu thấp hơn giá sàn Mức giá đấu thầu thấp hơn giá sàn được thiết lập trong yêu cầu.
102 Thua trước giá thầu cao hơn Giá thầu đã thua trước một mức giá đấu thầu cao hơn trong phiên đấu giá.
104 Suất bên mua bị chặn Đơn vị phát hành đã chặn người mua hoặc đối tác.
200 Quảng cáo bị lọc bỏ (lý do không xác định) Tổng hợp các quảng cáo bị lọc bỏ với lý do không xác định.
201 Quảng cáo bị lọc bỏ (chờ được chấp thuận) Quảng cáo đang ở trạng thái chờ được chấp thuận để lên sàn giao dịch.
202 Quảng cáo bị lọc bỏ (từ chối chấp thuận) Quá trình đánh giá sàn giao dịch của Unity đã từ chối quảng cáo.
203 Quảng cáo bị lọc bỏ (kích thước không hợp lệ) [Chiều rộng và chiều cao] (https://unityads.unity3d.com/help/programmatic/bid-responses#bid-objects)của quảng cáo không khớp với kích thước được xác định trong yêu cầu.
205 Quảng cáo bị lọc bỏ (loại trừ đơn vị quảng cáo) Đơn vị phát hành đã loại trừ đơn vị quảng cáo.
206 Quảng cáo bị lọc bỏ (loại trừ gói ứng dụng) Đơn vị phát hành đã chặn gói ứng dụng.
209 Quảng cáo bị lọc bỏ (loại trừ danh mục) Đơn vị phát hành đã chặn danh mục nội dung quảng cáo.
212 Quảng cáo bị lọc bỏ (thời lượng video) [Thời lượng video] (https://unityads.unity3d.com/help/programmatic/bid-responses#bid-ext-objects)vượt quá 30 giây.
1000 Trình xác thực Unity không thành công Giá thầu xác thực không thành công do vấn đề tuân thủ các tiêu chuẩn OpenRTB của Unity được mô tả trong hướng dẫn tích hợp yêu cầu-phản hồi.
1001 Định dạng JSON không hợp lệ Phản hồi giá thầu là JSON sai định dạng.
1002 Khối quy tắc chung của thị trường Lỗi tổng hợp của các khối thị trường xảy ra trong Unity Auction.
1003 Vượt quá xếp hạng độ tuổi tối đa Đơn vị phát hành đã chặn giá thầu do xếp hạng độ tuổi của ứng dụng được quảng cáo.
1004 Thiếu crypte trong tiện ích giá thầu Tiện ích giá thầu không có crypte khi phản hồi yêu cầu giá thầu tổng hợp.
1005 Crypte trong tiện ích giá thầu không hợp lệ ID crypte không hợp lệ hoặc không khớp với bất kỳ loại quảng cáo nào được gửi trong yêu cầu giá thầu tổng hợp.

Trở lại đầu trang

Clone this wiki locally