ระบุแหล่งที่มาของการติดตั้ง iOS ด้วย SKAdNetwork

Exchange ของ Google รองรับสัญญาณที่ Google Mobile Ads SDK ใช้เพื่อเริ่มการระบุแหล่งที่มาของ SKAdNetwork ด้วย API SKAdNetwork ของ Apple คุณสามารถผสานรวมกับสัญญาณ SKAdNetwork เพื่อให้ผู้ลงโฆษณาวัดความสําเร็จของแคมเปญโฆษณาเพื่อการติดตั้งแอปสําหรับอุปกรณ์ iOS ไปพร้อมกับรักษาความเป็นส่วนตัวของผู้ใช้ได้

รายการต่อไปนี้ครอบคลุมการเปลี่ยนแปลงลักษณะการทำงานของการระบุแหล่งที่มาของการติดตั้งแอปตามเวอร์ชัน SKAdNetwork

  • 2.0-2.1: การระบุแหล่งที่มาของการติดตั้งแอปที่โฆษณาจะอิงตามหน้าผลิตภัณฑ์ใน App Store ที่แสดงผลโดย StoreKit เมื่อผู้ใช้คลิกโฆษณา ซึ่งจะนำไปสู่การติดตั้งแอปของผู้ใช้
  • 2.2 ขึ้นไป: การรองรับเพิ่มเติมสำหรับโฆษณาแบบดูผ่าน ซึ่งจะมีการระบุแหล่งที่มาสำหรับการติดตั้งแอปที่โฆษณาเมื่อผู้ใช้ติดตั้งแอปหลังจากดูโฆษณา

ดูข้อมูลเพิ่มเติมเกี่ยวกับความแตกต่างใน SKAdNetwork เวอร์ชันต่างๆ ได้ที่บันทึกประจำรุ่นของ SKAdNetwork

กําหนดค่ารหัส SKAdNetwork ใน UI

หากต้องการรับคำขอราคาเสนอที่มีรหัส SKAdNetwork คุณต้องระบุรหัส SKAdNetwork ใน Authorized Buyers หรือ UI ของการเสนอราคาแบบเปิด ตัวอย่างเช่น รหัส SKAdNetwork อาจมีค่าเป็น a1b2c3d4e5.skadnetwork

หากต้องการระบุรหัส SKAdNetwork ใน Authorized Buyers หรือ UI การเสนอราคาแบบเปิด ให้ทำดังนี้

  1. ในเมนูการนำทางการตั้งค่าผู้เสนอราคา ให้คลิกการตั้งค่า RTB หน้าการตั้งค่า RTB จะปรากฏขึ้น
  2. ไปที่ช่องรหัส SKAdNetwork ที่อนุญาตของ iOS เพื่อดูและกำหนดค่ารหัส SKAdNetwork

รูปภาพต่อไปนี้แสดงตัวอย่างรหัส SKADNetwork ในช่องรหัส SKAdNetwork ที่อนุญาตของ iOS

การตั้งค่ารหัส SKAdNetwork ที่อนุญาตของ iOS ในการตั้งค่า RTB

กำหนดค่าครีเอทีฟโฆษณาสำหรับการระบุแหล่งที่มา

Google Mobile Ads SDK จะเริ่มการระบุแหล่งที่มาของ SKAdNetwork ก็ต่อเมื่อ URL การคลิกผ่านนำไปยัง Apple App Store เท่านั้น เมื่อคุณส่งครีเอทีฟโฆษณาเพื่อรับการตรวจสอบโดยใช้ Real-time Bidding API ครีเอทีฟโฆษณาต้องใช้ URL การคลิกผ่านที่เป็นลิงก์โดยตรงไปยังแอปที่โฆษณาใน App Store หรือใช้การเปลี่ยนเส้นทาง HTTP ที่มีปลายทางสุดท้ายเป็นแอปที่โฆษณาใน App Store Google Mobile Ads SDK จะเริ่มการระบุแหล่งที่มาหากปลายทางสุดท้ายของ URL การคลิกผ่านของครีเอทีฟโฆษณาขึ้นต้นด้วยคำนำหน้าต่อไปนี้

  • https://apps.apple.com
  • https://itunes.apple.com
  • itms-apps://
  • itms://

หากปลายทางสุดท้ายของ URL การคลิกผ่านของครีเอทีฟโฆษณาไม่ตรงกับคำนำหน้าเหล่านี้ หรือ URL การคลิกผ่านใช้วิธีการเปลี่ยนเส้นทางฝั่งไคลเอ็นต์อื่นๆ ที่ไม่ได้นำไปยัง App Store, Google Mobile Ads SDK อาจไม่เริ่มการระบุแหล่งที่มาของ SKAdNetwork รายการต่อไปนี้ครอบคลุมตัวอย่างที่อาจใช้กระบวนการนี้

  • หน้า HTML ที่ผู้ใช้ต้องดำเนินการเพื่อเปลี่ยนเส้นทางไปยัง App Store
  • หน้า HTML ที่มีสคริปต์การเปลี่ยนเส้นทางที่ใช้ JavaScript อัตโนมัติไปยัง App Store
  • แท็กการรีเฟรชเมตา

เริ่มการระบุแหล่งที่มาตามประเภทครีเอทีฟโฆษณา

คุณตั้งค่าการคลิกเพื่อเริ่มการระบุแหล่งที่มาของ SKAdNetwork สำหรับประเภทครีเอทีฟโฆษณาต่างๆ ได้ดังนี้

HTML
ซึ่งสามารถตั้งค่าเป็น URL ปลายทางในแท็ก Anchor ที่ล้อมรอบองค์ประกอบที่คลิกได้ หรือเป็น URL เป้าหมายของการดำเนินการ window.location จากกิจกรรมการคลิกที่ใช้ JavaScript
MRAID
การคลิกต้องเรียกใช้ Mraid.open() เพื่อเริ่มการระบุแหล่งที่มาของ SKAdNetwork
วิดีโอ VAST
ควรตั้งค่า URL ของ App Store ในองค์ประกอบ ClickThrough ใน VAST XML
เนทีฟ
ต้องตั้งค่า URL ของ App Store ในช่อง BidResponse.seatbid.bid.{adm/adm_native}.link.url

ระบุสัญญาณ BidRequest รายการ

คุณดูข้อมูลเกี่ยวกับรหัส SKAdNetwork ที่ลงทะเบียนไว้ซึ่งแอพของผู้เผยแพร่โฆษณารองรับได้ด้วยช่อง BidRequest.imp.ext.skadn หากระบุช่อง skadn คุณจะใช้แอตทริบิวต์เพื่อสร้างการตอบกลับสำหรับโฆษณาเพื่อการติดตั้งแอปหรือโฆษณาเพื่อการมีส่วนร่วมอีกครั้งที่เชื่อมโยงการติดตั้งหรือ Conversion กับรหัส SKAdNetwork ที่รวมไว้รหัสใดรหัสหนึ่งได้ ฟิลด์ skadn เป็นออบเจ็กต์ SKAdNetworkRequest ที่มีแอตทริบิวต์ต่อไปนี้

ชื่อแอตทริบิวต์ คำอธิบาย
sourceapp รหัสสตริงของแอปของผู้เผยแพร่โฆษณาใน App Store ของ Apple หากต้องการระบุแอปของผู้เผยแพร่โฆษณา ให้ใช้แอตทริบิวต์นี้
skadnetids รายการสตริงที่แสดงรหัส SKAdNetwork ที่แอปของผู้เผยแพร่โฆษณารองรับ คุณสามารถอ้างอิงข้อมูลนี้เมื่อสร้างการตอบกลับเพื่อเลือกรหัส SKAdNetwork ที่ผู้เผยแพร่โฆษณารองรับเพื่อระบุในช่อง BidResponse.seatbid.bid.ext.skadn.network
versions รายการสตริงที่แสดงเวอร์ชัน SKAdNetwork ที่ผู้เผยแพร่โฆษณารองรับ เวอร์ชัน SKAdNetwork ที่คุณระบุในการตอบกลับด้วยช่อง BidResponse.seatbid.bid.ext.skadn.version ต้องเป็นเวอร์ชันใดเวอร์ชันหนึ่งที่ช่องนี้ระบุ
fidelities รายการค่า enum SKAdNetworkFidelityType ที่แสดงประเภทความแม่นยำที่ผู้เผยแพร่โฆษณารองรับ ข้อมูลต่อไปนี้อธิบายค่า enum เหล่านี้สำหรับปลายทางการเสนอราคาที่กำหนดค่าให้ใช้ OpenRTB ในรูปแบบ Protobuf และ JSON
  • VIEW_THROUGH_ADS (Protobuf) / 0 (JSON): เมื่อคุณชนะการประมูลและลงโฆษณา คุณจะได้รับการระบุแหล่งที่มาสำหรับการแสดงผลภายใน 24 ชั่วโมงเมื่อมีการดูโฆษณาเป็นเวลาอย่างน้อย 3 วินาที โดยทั่วไป คุณต้องแสดง SKOverlay หากรองรับเพื่อให้ผู้ลงโฆษณาได้รับการระบุแหล่งที่มาในรูปแบบนี้
  • STOREKIT_RENDERED_ADS (Protobuf) / 1 (JSON): เมื่อคุณชนะการประมูลและลงโฆษณา การระบุแหล่งที่มาของการติดตั้งแอปหรือ Conversion จะเริ่มต้นโดยหน้าผลิตภัณฑ์ใน App Store ที่แสดงผลโดย StoreKit เมื่อผู้ใช้คลิกโฆษณา
skoverlay บูลีนเมื่อแสดงในรูปแบบ Protobuf ของ OpenRTB หรือจำนวนเต็มเมื่อแสดงในรูปแบบ JSON ของ OpenRTB คุณสามารถใช้บูลีนนี้เพื่อระบุว่าระบบรองรับ SKOverlay หรือไม่ Google รองรับ SKOverlay สำหรับครีเอทีฟโฆษณาวิดีโอและข้อมูลโค้ด HTML ที่วางในพื้นที่โฆษณาคั่นระหว่างหน้าหรือพื้นที่โฆษณาที่มีการให้รางวัลเท่านั้น

ตัวอย่างต่อไปนี้แสดงคำขอราคาเสนอสำหรับพื้นที่โฆษณาบนอุปกรณ์เคลื่อนที่ซึ่งแอปของผู้เผยแพร่โฆษณารองรับรหัส SKAdNetwork ของคุณ

{
  "id": "9NaI48SmPW7Zf3MAHR43DY",
  "imp": [
    {
      "id": "1",
      // OMITTED...
      "ext": {
        // OMITTED...
        "skadn": {
          "sourceapp": "com.google.testapp",
          "skadnetids": [
            "cF58w81X"
          ],
          "versions": [
            "2.0",
            "2.1",
            "4.0"
          ],
          "fidelities": [
            1,
            0
          ]
        }
        // OMITTED...
      }
    }
  ],
  "app": {
    "name": "Test App",
    "ver": "5.6.0",
    "bundle": "com.google.testapp",
    "publisher": {
      "id": "pub-6156239328255091",
      "ext": {
        "country": "JP"
      }
    },
    "content": {
      "url": "https://www.google.com",
      "livestream": 0,
      "language": "ja"
    },
    "storeurl": "https://www.google.com"
  }
  // OMITTED...
}

ป้อนข้อมูลในช่อง BidResponse

คุณสามารถใส่ข้อมูลการระบุแหล่งที่มาในการเสนอราคาตอบที่ช่วยให้ผู้ลงโฆษณาได้รับการแจ้งเตือน Postback เมื่อผู้ใช้โต้ตอบกับโฆษณาของผู้ลงโฆษณา ดูข้อมูลเพิ่มเติมเกี่ยวกับการแจ้งเตือนระบบรายงานผล Conversion ได้ที่การรับการระบุว่าเป็นโฆษณาและระบบรายงานผล Conversion

คุณต้องส่งข้อมูลการระบุแหล่งที่มาที่สอดคล้องกับข้อมูลที่รวมอยู่ในคำขอราคาเสนอ ข้อมูลการระบุแหล่งที่มาจะระบุไว้ในช่อง BidResponse.seatbid.bid.ext.skadn ซึ่งเป็นออบเจ็กต์ SKAdNetworkResponse ที่มีแอตทริบิวต์ต่อไปนี้

ชื่อแอตทริบิวต์ คำอธิบาย
version สตริงที่แสดงเวอร์ชัน SKAdNetwork ที่ผู้ลงโฆษณารองรับ คุณต้องระบุ SKAdNetwork เวอร์ชันใดเวอร์ชันหนึ่งที่ผู้เผยแพร่โฆษณารองรับ ซึ่งระบุไว้ใน BidRequest.imp.ext.skadn.versions
network สตริงรหัส SKAdNetwork สำหรับผู้ลงโฆษณา คุณต้องระบุรหัส SKAdNetwork รหัสใดรหัสหนึ่งที่รวมอยู่ใน BidRequest.imp.ext.skadn.skadnetids
campaign รหัสสตริงตัวเลข 2 หลักที่แสดงแคมเปญโฆษณาของผู้ลงโฆษณา คุณต้องระบุแอตทริบิวต์นี้แทน sourceidentifier หากการเสนอราคาตอบมีการระบุแหล่งที่มาโดยใช้ SKAdNetwork เวอร์ชัน 3.0 หรือก่อนหน้า
sourceidentifier รหัสสตริงตัวเลข 4 หลักที่แสดงถึงแคมเปญโฆษณาของผู้ลงโฆษณา คุณต้องระบุแอตทริบิวต์นี้แทน campaign หากการเสนอราคาตอบมีข้อมูลการระบุแหล่งที่มาโดยใช้ SKAdNetwork เวอร์ชัน 4.0 ขึ้นไป
itunesitem รหัสสตริงของแอปของผู้ลงโฆษณาใน App Store ของ Apple ซึ่งต้องสอดคล้องกับค่าที่ระบุใน BidResponse.seatbid.bid.bundle
productpageid รหัสสตริงที่ไม่บังคับซึ่งแสดงถึงหน้าสินค้าที่กำหนดเองเพื่อแสดงสำหรับอุปกรณ์ที่ใช้ iOS 15 ขึ้นไป ดูข้อมูลเพิ่มเติมเกี่ยวกับหน้าสินค้าที่กำหนดเองได้ที่หน้าสินค้าที่กำหนดเองใน App Store หากไม่ได้ระบุ ระบบจะแสดงหน้าสินค้าเริ่มต้น
fidelities รายการออบเจ็กต์ Fidelity ที่ระบุประเภทความแม่นยำที่ใช้กับโฆษณาที่ลง และให้ลายเซ็นที่เข้ารหัสซึ่งใช้เพื่อระบุแคมเปญของผู้ลงโฆษณาเมื่อผู้ลงโฆษณาได้รับการแจ้งเตือน Postback คุณต้องระบุแอตทริบิวต์ fidelity ด้วยค่าที่รวมอยู่ใน BidRequest.imp.ext.skadn.fidelities เท่านั้น
sourceapp สตริงที่แสดงแอปของผู้เผยแพร่โฆษณาใน App Store ของ Apple คุณต้องระบุรหัสนี้ด้วยรหัสที่พบใน BidRequest.imp.ext.skadn.sourceapp
skoverlay ออบเจ็กต์ SKOverlay ที่แสดงวิธีนำเสนอแอปที่โฆษณาใน SKOverlay คุณจะระบุแอตทริบิวต์นี้ได้ก็ต่อเมื่อตั้งค่า BidRequest.imp.ext.skadn.skoverlay เป็น true สำหรับปลายทางการเสนอราคาที่ใช้รูปแบบ OpenRTB Protobuf หรือ 1 เมื่อใช้รูปแบบ OpenRTB JSON

ตัวอย่างต่อไปนี้แสดงการเสนอราคาตอบที่มีข้อมูลการระบุแหล่งที่มาของการติดตั้งแอป

{
  "id": "9NaI48SmPW7Zf3MAHR43DY",
  "seatbid": [
    {
      "bid": [
        {
          "id": "9NaI48SmPW7Zf3MAHR43DY",
          // OMITTED...
          "ext": {
            // OMITTED...
            "skadn": {
              "version": "4.0",
              "network": "cF58w81X",
              "itunesitem": "788729094",
              "sourceapp": "1422994973",
              "fidelities": [
                {
                  "fidelity": 0,
                  "nonce": "017e597c-3c7d-4a44-afeb-41cd9a17066f",
                  "timestamp": "1757235407882",
                  "signature": "11iF1L96q2cw8tu790p301c10530ogr7h250k1P9pLxqcJ2qe37klG8xB3M592YbpafQ9861493838C521XA6AEF4A40DK8X"
                },
                {
                  "fidelity": 1,
                  "nonce": "017e597c-3c7d-4a44-afeb-41cd9a17066f",
                  "timestamp": "1757235407882",
                  "signature": "f67L3C138Y6XB7940141011Pd58AZbdBk9Xo1Mlf1973706DsB5808ILLKumU2ic9fr72b9bSs3CD25CCZo8DJB65JB0615L"
                }
              ],
              "sourceidentifier": "5507"
            },
            "app_promotion_type": 1
            // OMITTED...
          }
        }
      ]
      // OMITTED...
    }
  ]
  // OMITTED...
}

รายการต่อไปนี้จะแชร์ลักษณะการทำงานที่คาดไว้ของ SKAdNetwork ที่สอดคล้องกับการเสนอราคาตอบ

  • เมื่อมีการติดตั้งแอปที่โฆษณาภายใน 24 ชั่วโมงหลังจากดูโฆษณาอย่างน้อย 3 วินาที ระบบจะส่งการแจ้งเตือน Postback ของการระบุแหล่งที่มาของการดูผ่านใน SKAdNetwork ไปยังผู้ลงโฆษณา
  • เมื่อผู้ใช้คลิกโฆษณา ระบบจะแสดงโฆษณาซ้อนทับของ App Store ในหน้าสำหรับแอปที่โฆษณา และจะส่งการแจ้งเตือนระบบรายงานผล Conversion สำหรับการระบุแหล่งที่มาของการคลิกผ่าน SKAdNetwork ไปยังผู้ลงโฆษณาหากผู้ใช้ติดตั้งและเปิดแอปที่โฆษณา

เพิ่มการระบุแหล่งที่มาด้วย SKOverlay

คุณสามารถเพิ่มการระบุแหล่งที่มาของโฆษณาที่แสดงผลด้วย StoreKit ที่คุณลงได้โดยการแสดง SKOverlay เมื่อระบบรองรับ SKOverlay SKOverlay ช่วยให้แอปของผู้เผยแพร่โฆษณาแสดงโฆษณาซ้อนทับที่ช่วยให้ผู้ใช้ดาวน์โหลดแอปที่โฆษณาได้โดยไม่ต้องออกจากแอปของผู้เผยแพร่โฆษณา ดูข้อมูลเพิ่มเติมเกี่ยวกับ SKOverlay ได้ที่ SKOverlay

เมื่อเป็นไปตามเงื่อนไขต่อไปนี้ทั้งหมด คุณจะได้รับการระบุแหล่งที่มาสำหรับการติดตั้งแอปที่โฆษณา

  • SKOverlay แสดงเป็นเวลา 3 วินาทีขึ้นไป
  • มีการติดตั้งแอปที่โฆษณาภายใน 30 วันนับจากที่ SKOverlay แสดง
  • SKOverlay ของคุณแสดงเป็นรายการสุดท้ายก่อนที่จะมีการติดตั้งแอปที่โฆษณา

Google รองรับ SKOverlay สำหรับข้อมูลโค้ด HTML และครีเอทีฟโฆษณาวิดีโอ VAST ที่วางในโฆษณาคั่นระหว่างหน้าหรือโฆษณาที่มีการให้รางวัล

ตรวจสอบว่ารองรับ SKOverlay หรือไม่

เมื่อได้รับคำขอราคาเสนอ คุณจะดูได้ว่าระบบรองรับ SKOverlay หรือไม่โดยตรวจสอบค่าของช่อง BidRequest.imp.ext.skadn.skoverlay ระบบรองรับ SKOverlay ในกรณีที่มีการตั้งค่าช่อง skoverlay เป็น true สำหรับปลายทางการเสนอราคาที่ใช้รูปแบบ OpenRTB Protobuf หรือ 1 สำหรับปลายทางการเสนอราคาที่ใช้รูปแบบ OpenRTB JSON

ลงโฆษณาด้วย SKOverlay

เมื่อระบบรองรับ SKOverlay คุณสามารถระบุช่อง BidResponse.seatbid.bid.ext.skadn.skoverlay เพื่อระบุว่าต้องการแสดง SKOverlay ช่อง skoverlay มีแอตทริบิวต์ต่อไปนี้

  • delay: จำนวนเต็มที่แสดงถึงการหน่วงเวลาเป็นวินาทีระหว่างเวลาที่โฆษณาแสดงกับเวลาที่ SKOverlay แสดง สำหรับครีเอทีฟโฆษณาวิดีโอ เวลาที่แสดงคือเวลาที่วิดีโอเริ่มเล่น หากไม่ได้ตั้งค่าช่องนี้ ระบบจะไม่แสดง SKOverlay
  • endcarddelay: จำนวนเต็มที่แสดงถึงความล่าช้าเป็นวินาทีระหว่างเวลาที่การ์ดตอนจบของครีเอทีฟโฆษณาวิดีโอแสดงกับเวลาที่ SKOverlay แสดง หากไม่ได้ตั้งค่าช่องนี้ ระบบจะไม่แสดง SKOverlay หลังจากการ์ดตอนจบ ใช้ได้กับครีเอทีฟโฆษณาวิดีโอ VAST ที่ลงในโฆษณาคั่นระหว่างหน้าหรือโฆษณาที่มีการให้รางวัลเท่านั้น
  • dismissible: บูลีนที่แสดงว่าผู้ใช้ปิด SKOverlay ได้หรือไม่

ตัวอย่างต่อไปนี้แสดงการเสนอราคาตอบ

{
  // OMITTED...
  "seatbid": [
    {
      "bid": [
        {
          // OMITTED...
          "ext": {
            // OMITTED...
            "skadn": {
              // OMITTED...
              "itunesitem": "422689480",
              "skoverlay": {
                "delay": 5,
                "endcarddelay": 0
              },
              "productpageid": "some_id"
            }
          }
        }
      ]
    }
  ]
}

ตรวจสอบลักษณะการทำงานที่คาดหวังของ SKOverlay

ลักษณะการทำงานที่คาดไว้ของ SKOverlay ที่สอดคล้องกับการเสนอราคาตอบข้างต้นมีดังนี้

  • แสดง SKOverlay 5 วินาทีหลังจากวิดีโอเริ่มเล่น
  • แสดง SKOverlay ทันทีหลังจากการ์ดตอนจบ

  • เปิด App Store เมื่อผู้ใช้คลิก SKOverlay

  • หากระบุ BidResponse.seatbid.bid.ext.skadn.productpageid ข้อมูลแอปใน SKOverlay จะเป็นไอคอนในหน้าสินค้าที่กำหนดเอง

  • สำหรับครีเอทีฟโฆษณาวิดีโอ VAST เมื่อผู้ใช้คลิก SDKoverlay ระบบจะส่งคําสั่ง ping ไปยัง URL การคลิกผ่านและ URL ติดตามการคลิก

  • สำหรับครีเอทีฟโฆษณาวิดีโอ VAST แม้ว่าผู้ใช้จะปิด SKOverlay ในระหว่างที่วิดีโอเล่นอยู่ แต่ SKOverlay จะยังคงแสดงหลังจากการ์ดตอนจบหากมีการตั้งค่าช่อง BidResponse.seatbid.bid.ext.skadn.skoverlay.endcarddelay ไว้