文件Analytics串流媒體收集指南

在 iOS 上追蹤廣告

最後更新： 2024年7月18日
  • 主題：

建立對象：

  • 使用者
  • 管理員
  • 開發人員

下列指示提供使用 2.x SDK 實作的指引。

IMPORTANT
若您正在實作 SDK 1.x 版，您可以在此處下載 1.x 開發人員指南：下載 SDK。

廣告追蹤常數

常數名稱說明
ADBMediaHeartbeatEventAdBreakStart用於追蹤廣告插播開始事件的常數
ADBMediaHeartbeatEventAdBreakComplete用於追蹤廣告插播事件的常數
ADBMediaHeartbeatEventAdStart用於追蹤廣告開始事件的常數
ADBMediaHeartbeatEventAdComplete用於追蹤廣告完成事件的常數
ADBMediaHeartbeatEventAdSkip用於追蹤廣告略過事件的常數

實作步驟

  1. 識別廣告插播界限何時開始 (包括前段)，並使用廣告插播資訊建立 AdBreakObject。

    AdBreakObject 參考資料：

    變數名稱說明必填
    name廣告插播名稱，例如前段、中段和後段。是
    position內容中廣告插播的編號位置從 1 開始。是
    startTime廣告插播開始時的播放點值。是

    廣告插播物件建立：

    id adBreakObject = [ADBMediaHeartbeat createAdBreakObjectWithName:[ADBREAK_NAME]
                            position:[POSITION]
                            startTime:[START_TIME]];

  2. 在 MediaHeartbeat 例項中使用 AdBreakStart 呼叫 trackEvent() 以開始追蹤廣告插播。

    - (void)onAdBreakStart:(NSNotification *)notification {
    [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdBreakStart
                     mediaObject:adBreakObject
                     data:nil];
}

  3. 識別廣告何時開始，並使用廣告資訊建立 AdObject 例項。

    AdObject 參考資料：

    變數名稱
    說明
    必填
    name
    廣告的易記名稱。
    是
    adId
    廣告的唯一識別碼。
    是
    position
    廣告插播中的廣告編號位置從 1 開始。
    是
    length
    廣告長度
    是

    廣告物件建立：

    id adObject = [ADBMediaHeartbeat createAdObjectWithName:[AD_NAME]
                                 adId:[AD_ID]
                                 position:[POSITION]
                                 length:[LENGTH]];

  4. 可選擇透過內容資料變數，將標準和/或廣告中繼資料附加到媒體追蹤工作階段。

    • 在 iOS 上實作標準廣告中繼資料

    • 自訂廣告中繼資料 - 對於自訂中繼資料，請建立自訂資料變數的變數物件，並填入目前廣告的資料：

      NSMutableDictionary *adDictionary = [[NSMutableDictionary alloc] init];
[adDictionary setObject:@"Sample affiliate" forKey:@"affiliate"];
[adDictionary setObject:@"Sample campaign" forKey:@"campaign"];
[adDictionary setObject:@"Sample creative" forKey:@"creative"];

  5. 在 MediaHeartbeat 例項中使用 AdStart 事件呼叫 trackEvent() 以開始追蹤廣告播放。

    將參考加入您的自訂中繼資料變數 (或空白物件)，作為事件呼叫中的第三個參數：

    - (void)onAdStart:(NSNotification *)notification {
    [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdStart
                     mediaObject:adObject
                     data:adDictionary];
}

  6. 當廣告播放達到廣告結尾時，請使用 AdComplete 事件呼叫 trackEvent()。

    - (void)onAdComplete:(NSNotification *)notification {
    [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdComplete
                     mediaObject:nil
                     data:nil];
}

  7. 如果由於使用者選擇略過廣告而導致廣告播放未完成，請追蹤 AdSkip 事件.

    - (void)onAdSkip:(NSNotification *)notification {
    [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdSkip
                     mediaObject:nil
                     data:nil];
}

  8. 如果在相同 AdBreak 內有任何其他廣告，請再次重複步驟 3 到 7。

  9. 當廣告插播完成時，請使用 AdBreakComplete 事件進行追蹤：

    - (void)onAdBreakComplete:(NSNotification *)notification {
    [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdBreakComplete
                     mediaObject:nil
                     data:nil];
}

如需詳細資訊，請參閱追蹤案例具有前段廣告的 VOD 播放。

recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb