在 Android 應用程式加入獎勵式影片廣告

Audience Network 可讓您利用 Facebook 廣告，將 Android 應用程式變成您的獲利來源。擁有全螢幕體驗的獎勵式影片廣告，可讓用戶自行選擇是否要透過觀看影片來取得獎勵（例如虛擬貨幣、應用程式內物品和隱藏內容等）。廣告體驗長達 15-30 秒，不可中途略過且會展示附有行動呼籲按鈕的結束圖卡。用戶看完整段影片後，您會收到授予用戶建議獎勵的回呼。

逐步說明

步驟 1：在 Activity 中初始化獎勵式影片廣告

步驟 2：在 Activity 中顯示獎勵式影片廣告

步驟 1：在 Activity 中初始化獎勵式影片廣告

在 Activity 頂部加入下列程式碼，以匯入 Facebook 廣告 SDK：

import com.facebook.ads.*;

接著初始化獎勵式影片物件，設定接聽程式並載入影片廣告創意。獎勵式影片廣告需要 RewardedVideoAdListener 介面來實作下列範例程式碼中的方法，以處理各種不同的事件。以下列 Activity 為例：

private final String TAG = RewardedVideoAdActivity.class.getSimpleName();
private RewardedVideoAd rewardedVideoAd;

@Override
public void onCreate(Bundle savedInstanceState) {
    ...
    // Instantiate a RewardedVideoAd object. 
    // NOTE: the placement ID will eventually identify this as your App, you can ignore it for
    // now, while you are testing and replace it later when you have signed up.
    // While you are using this temporary code you will only get test ads and if you release
    // your code like this to the Google Play your users will not receive ads (you will get
    // a no fill error).
    rewardedVideoAd = new RewardedVideoAd(this, "YOUR_PLACEMENT_ID");
    RewardedVideoAdListener rewardedVideoAdListener = new RewardedVideoAdListener() {
        @Override
        public void onError(Ad ad, AdError error) {
            // Rewarded video ad failed to load
            Log.e(TAG, "Rewarded video ad failed to load: " + error.getErrorMessage());
        }

        @Override
        public void onAdLoaded(Ad ad) {
            // Rewarded video ad is loaded and ready to be displayed  
            Log.d(TAG, "Rewarded video ad is loaded and ready to be displayed!");
        }

        @Override
        public void onAdClicked(Ad ad) {
            // Rewarded video ad clicked
            Log.d(TAG, "Rewarded video ad clicked!");
        }

        @Override
        public void onLoggingImpression(Ad ad) {
            // Rewarded Video ad impression - the event will fire when the 
            // video starts playing
            Log.d(TAG, "Rewarded video ad impression logged!");
        }

        @Override
        public void onRewardedVideoCompleted() {
            // Rewarded Video View Complete - the video has been played to the end.
            // You can use this event to initialize your reward
            Log.d(TAG, "Rewarded video completed!");

            // Call method to give reward
            // giveReward();
        }

        @Override
        public void onRewardedVideoClosed() {
            // The Rewarded Video ad was closed - this can occur during the video
            // by closing the app, or closing the end card.
            Log.d(TAG, "Rewarded video ad closed!");
        }
    };
    rewardedVideoAd.loadAd(
            rewardedVideoAd.buildLoadAdConfig()
                    .withAdListener(rewardedVideoAdListener)
                    .build());
    ...
}

步驟 2：顯示獎勵式影片廣告

案例 1：廣告成功載入後立即顯示。如下修改上方的 onAdLoaded() 方法並顯示：

private RewardedVideoAd rewardedVideoAd;

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    ...
    // Instantiate a RewardedVideoAd object. 
    // NOTE: the placement ID will eventually identify this as your App, you can ignore it for
    // now, while you are testing and replace it later when you have signed up.
    // While you are using this temporary code you will only get test ads and if you release
    // your code like this to the Google Play your users will not receive ads (you will get
    // a no fill error).
    rewardedVideoAd = new RewardedVideoAd(this, "YOUR_PLACEMENT_ID");
    RewardedVideoAdListener rewardedVideoAdListener = new RewardedVideoAdListener() {
        ...
        @Override
        public void onAdLoaded(Ad ad) {
            // Rewarded video ad is loaded and ready to be displayed  
            rewardedVideoAd.show();
        }
        ...
    };
    rewardedVideoAd.loadAd(
            rewardedVideoAd.buildLoadAdConfig()
                    .withAdListener(rewardedVideoAdListener)
                    .build());
    ...
}

案例 2：廣告成功載入幾秒或幾分鐘後顯示。您應該在顯示廣告之前檢查廣告是否已失效。

您應該遵循以下想法，但請不要將程式碼複製到專案中，因為它只是範例：

private RewardedVideoAd rewardedVideoAd;

@Override
protected void onCreate(@Nullable Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    ...
    // Instantiate a RewardedVideoAd object. 
    // NOTE: the placement ID will eventually identify this as your App, you can ignore it for
    // now, while you are testing and replace it later when you have signed up.
    // While you are using this temporary code you will only get test ads and if you release
    // your code like this to the Google Play your users will not receive ads (you will get
    // a no fill error).
    rewardedVideoAd = new RewardedVideoAd(this, "YOUR_PLACEMENT_ID");
    RewardedVideoAdListener rewardedVideoAdListener = new RewardedVideoAdListener() {
        ...
    };
    // load the ad
    rewardedVideoAd.loadAd(
            rewardedVideoAd.buildLoadAdConfig()
                    .withAdListener(rewardedVideoAdListener)
                    .build());

    // Here is just an example for displaying the ad with delay
    // Please call this method at appropriate timing in your project
    showAdWithDelay();
}

private void showAdWithDelay() {
    /**
     * Here is an example for displaying the ad with delay;
     * Please do not copy the Handler into your project
     */
    // Handler handler = new Handler();
    handler.postDelayed(new Runnable() {
        public void run() {
            // Check if rewardedVideoAd has been loaded successfully
            if (rewardedVideoAd == null || !rewardedVideoAd.isAdLoaded()) {
                return;
            }
            // Check if ad is already expired or invalidated, and do not show ad if that is the case. You will not get paid to show an invalidated ad.
            if (rewardedVideoAd.isAdInvalidated()) {
                return;
            }
            rewardedVideoAd.show();
        }
    }, 1000 * 60 * 15); // Show the ad after 15 minutes
}

最後在您 Activity 的 onDestroy 方法中，使用其 destroy 方法來清除物件。請注意，將 destroy 方法指派至新的執行個體時，您也應使用此方法來清除舊的廣告物件，以免記憶體流失。

@Override
protected void onDestroy() {
    if (rewardedVideoAd != null) {
        rewardedVideoAd.destroy();
        rewardedVideoAd = null;
    }
    super.onDestroy();
}

伺服器端獎勵驗證

總覽

若您負責管理用戶獎勵的伺服器端，可參考 Facebook 提供的解決方案，透過驗證技術安全地執行此流程。我們的伺服器會與指定的 https 端點通訊，以驗證各次廣告曝光，確認是否應授予獎勵。

1. Audience Network SDK 利用下列參數來要求獎勵式影片廣告：
   • Audience Network 版位編號
   • 專屬的用戶編號 — 一種用來識別個別用戶的屬性，例如識別碼
   • 獎勵值 — 您要授予用戶的獎勵值，例如 100 金幣
2. 用戶看完整段影片後，Facebook 伺服器會將這些值連同應用程式密鑰和專屬交易編號轉送到您指定的端點。
3. 伺服器收到這些資料後，即會驗證要求並回應下列內容：
   • 200 回應：有效的要求且應給予獎勵
   • 非 200 回應：無效的要求且不應給予獎勵。
4. 影片播放結束後會顯示結束圖卡，並觸發下列其中一個事件。
   • onRewardServerSuccess - 若在步驟 3 收到 200 回應便會觸發此事件。
   • onRewardServerFailed - 若在步驟 3 收到非 200 回應便會觸發此事件。

工作流程如下所示：

實作方式

初始化獎勵式影片物件後，您需要在廣告載入前，將用戶編號和獎勵金額傳入獎勵式廣告資料；用戶編號及獎勵金額皆為字串，例如：

private RewardedVideoAd rewardedVideoAd;

private void loadRewardedVideoAd { 
    // Instantiate a RewardedVideoAd object. 
    // NOTE: the placement ID will eventually identify this as your App, you can ignore it for
    // now, while you are testing and replace it later when you have signed up.
    // While you are using this temporary code you will only get test ads and if you release
    // your code like this to the Google Play your users will not receive ads (you will get
    // a no fill error).
    rewardedVideoAd = new RewardedVideoAd(this, "YOUR_PLACEMENT_ID");
    RewardedVideoAdListener rewardedVideoAdListener = new RewardedVideoAdListener() {
        ...
    };

    // Create the rewarded ad data
    RewardData rewardData = new RewardData("YOUR_USER_ID", "YOUR_REWARD");

    rewardedVideoAd.loadAd(
            rewardedVideoAd.buildLoadAdConfig()
                    .withAdListener(rewardedVideoAdListener)
                    .withRewardData(rewardData)
                    .build());
}

您必須實作 S2SRewardedVideoAdListener 介面，應用程式才能收到通知，得知獎勵的驗證結果。這包括所有在 RewardedVideoAdListener 介面上方的事件通知，以及額外兩項事件。以下事件可與上述事件搭配使用。

@Override
public void onRewardServerSuccess() {
    // Rewarded video ad validated
}

@Override
public void onRewardServerFailed() {
    // Rewarded video ad not validated or no response from server  
}