使用 SKAdNetwork 歸因 iOS 安裝

Google 廣告交易平台支援 Google Mobile Ads SDK 用來透過 Apple SKAdNetwork API 啟動 SKAdNetwork 歸因的信號。您可以整合 SKAdNetwork 信號，讓廣告主評估 iOS 裝置應用程式安裝廣告活動的成效，同時維護使用者隱私。

以下清單說明應用程式安裝歸因行為如何因 SKAdNetwork 版本而異：

• 2.0-2.1：使用者點按廣告後，系統會透過 StoreKit 顯示應用程式商店產品頁面，並在使用者安裝應用程式後，將安裝歸因給廣告宣傳的應用程式。
• 2.2+：新增影片觀看廣告支援，如果使用者在瀏覽廣告後安裝廣告應用程式，系統會將安裝歸因於該廣告。

如要進一步瞭解 SKAdNetwork 版本差異，請參閱 SKAdNetwork 版本資訊。

在使用者介面中設定 SKAdNetwork ID

如要接收含有 SKAdNetwork ID 的出價要求，請務必在 Authorized Buyers 或公開出價使用者介面中指定 SKAdNetwork ID。舉例來說，SKAdNetwork ID 的值可能是 a1b2c3d4e5.skadnetwork。

如要在 Authorized Buyers 或公開出價使用者介面中指定 SKAdNetwork ID，請按照下列步驟操作：

1. 在「出價方設定」導覽選單中，按一下「RTB 設定」。「RTB 設定」頁面隨即顯示。
2. 前往「Allowed iOS SKAdNetworks IDs」方塊，查看及設定 SKAdNetwork ID。

下圖顯示「允許的 iOS SKAdNetwork ID」方塊中的 SKADNetwork ID 範例：

設定廣告素材歸因

只有在點閱網址導向 Apple App Store 時，Google Mobile Ads SDK 才會啟動 SKAdNetwork 歸因。使用即時出價 API 提交廣告素材送審時，廣告素材必須使用到達網址，直接連結至應用程式商店中的廣告應用程式，或使用 HTTP 重新導向，最終到達網頁為應用程式商店中的廣告應用程式。如果廣告素材到達網址的最終到達網頁開頭為下列任一前置字元，Google Mobile Ads SDK 就會啟動歸因：

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

如果廣告素材到達網址的最終到達網頁不符合這些前置字元，或到達網址使用任何其他不會導向應用程式商店的用戶端重新導向方法，Google Mobile Ads SDK 可能不會啟動 SKAdNetwork 歸因。以下列舉可能適用這項程序的例子：

• 需要使用者操作才能重新導向至應用程式商店的 HTML 網頁。
• HTML 網頁，其中包含以 JavaScript 為基礎的自動重新導向指令碼，可將使用者導向應用程式商店。
• 中繼重新整理標記。

依廣告素材類型啟動歸因

您可以為不同的廣告素材類型設定點擊動作，以啟動 SKAdNetwork 歸因，如下所示：

HTML

這可以設為可點擊元素周圍錨定標記上的到達網頁網址，或設為 JavaScript 點擊事件中 window.location 作業的目標網址。

MRAID

點擊動作需要呼叫 Mraid.open()，才能啟動 SKAdNetwork 歸因。

VAST 影片

應用程式商店網址應在 VAST XML 的 ClickThrough 元素中設定。

原生

應用程式商店網址必須設定在 BidResponse.seatbid.bid.{adm/adm_native}.link.url 欄位中。

找出BidRequest信號

您可以使用 BidRequest.imp.ext.skadn 欄位，查看發布商應用程式支援的已註冊 SKAdNetwork ID 相關資訊。如果指定 skadn 欄位，您可以使用屬性為應用程式安裝廣告或再參與廣告建立回應，將安裝或轉換與其中一個 SKAdNetwork ID 建立關聯。skadn 欄位是 SKAdNetworkRequest 物件，具有下列屬性：

以下範例顯示行動廣告空間的出價要求，其中發布商的應用程式支援您的 SKAdNetwork ID：

{
  "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 欄位

您可以在出價回應中加入歸因資訊，讓廣告主在使用者與廣告互動時收到回傳通知。如要進一步瞭解回傳通知，請參閱「接收廣告標示和回傳」。

您必須傳遞與出價要求中包含的資訊一致的歸因資訊。出處資訊是在 BidResponse.seatbid.bid.ext.skadn 欄位中指定，該欄位是具有下列屬性的 SKAdNetworkResponse 物件：

以下範例顯示包含應用程式安裝歸因資訊的出價回應：

{
  "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 小時內安裝廣告宣傳的應用程式，系統就會向廣告主傳送 SKAdNetwork 瀏覽後歸因回傳通知。
• 使用者點按廣告後，系統會顯示廣告應用程式的內嵌商店疊加層。如果使用者安裝並開啟廣告應用程式，系統會將 SKAdNetwork 點閱歸因回傳通知傳送給廣告主。

使用 SKOverlay 提高歸因

在支援 SKOverlay 的情況下，您可以顯示 SKOverlay，提高 StoreKit 算繪廣告的歸因。SKOverlay 可讓發布商應用程式顯示疊加層，讓使用者下載廣告應用程式，而不必離開發布商應用程式。如要進一步瞭解 SKOverlay，請參閱 SKOverlay。

符合下列所有條件時，您會獲得廣告應用程式安裝的歸因：

• SKOverlay 顯示時間達三秒以上。
• 在 SKOverlay 顯示後的 30 天內，使用者安裝了廣告宣傳的應用程式。
• 在安裝廣告應用程式前，最後顯示的是您的 SKOverlay。

Google 支援在插頁式或獎勵廣告中，為 HTML 程式碼片段和 VAST 影片廣告素材使用 SKOverlay。

判斷是否支援 SKOverlay

收到出價要求時，您可以查看 BidRequest.imp.ext.skadn.skoverlay 欄位的值，確認是否支援 SKOverlay。如果出價工具端點使用 OpenRTB Protobuf 格式，且 skoverlay 欄位設為 true，或出價工具端點使用 OpenRTB JSON 格式，且欄位設為 1，則支援 SKOverlay。

使用 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。
• 在片尾卡後立即顯示 SKOverlay。

• 使用者點按 SKOverlay 時，開啟應用程式商店。

• 如果指定 BidResponse.seatbid.bid.ext.skadn.productpageid，SKOverlay 上的應用程式資訊資料會是自訂產品頁面中的圖示。

• 如果是 VAST 影片廣告素材，使用者點按 SDK 重疊廣告時，系統會對點閱和點擊追蹤網址進行連線偵測 (ping)。

• 如果是 VAST 影片廣告素材，即使使用者在影片播放期間關閉 SKOverlay，只要設定 BidResponse.seatbid.bid.ext.skadn.skoverlay.endcarddelay 欄位，SKOverlay 仍會在片尾卡後顯示。