เพิ่มโฆษณาแบบวิดีโอที่มีรางวัลหลังชมจบไปยังแอพ Unity

Audience Network ช่วยให้คุณสร้างรายได้จากแอพ Android และ iOS ของคุณได้ด้วยโฆษณาบน Facebook โฆษณาแบบวิดีโอที่มีรางวัลหลังชมจบเป็นประสบการณ์แบบเต็มหน้าจอที่ผู้ใช้สามารถเลือกที่จดูโฆษณาแบบวิดีโอแลกกับสิ่งตอบแทน เช่น สกุลเงินเสมือนจริง ไอเท็มในแอพ เนื้อหาสำหรับสมาชิกโดยเฉพาะ และอื่นๆ ได้ ประสบการณ์การรับชมโฆษณาจะเป็นวิดีโอสั้นๆ และมีการ์ดต่อท้ายเป็นการกระตุ้นให้ดำเนินการ เมื่อผู้ใช้ดูวิดีโอจนจบแล้ว คุณจะได้รับการเรียกกลับให้มอบรางวัลที่แนะนำให้กับผู้ใช้ดังกล่าว

ขั้นตอนของโฆษณาแบบวิดีโอที่มีรางวัลหลังชมจบ

ขั้นตอนที่ 1: การเริ่มต้นโฆษณาแบบวิดีโอที่มีรางวัลหลังชมจบ

ขั้นตอนที่ 2: การเพิ่มเหตุการณ์การเรียกกลับ

ขั้นตอนที่ 3: โหลดโฆษณา

ขั้นตอนที่ 4: การแสดงโฆษณา

ขั้นตอนที่ 1: การเริ่มต้นโฆษณาแบบวิดีโอที่มีรางวัลหลังชมจบ

ขั้นตอนแรกในการแสดงโฆษณาแบบวิดีโอที่มีรางวัลหลังชมจบคือการสร้างอ็อบเจ็กต์ RewardedVideoAd ในสคริปต์ C# ที่แนบมากับ GameObject

...
using AudienceNetwork;
...

public class RewardedVideoAdTest : MonoBehaviour
{
    public void LoadRewardedVideo()
    {
        // Create the rewarded video unit with a placement ID (generate your own on the Facebook app settings).
        // Use different ID for each ad placement in your app.
        this.rewardedVideoAd = new RewardedVideoAd("YOUR_PLACEMENT_ID");

        this.rewardedVideoAd.Register(this.gameObject);

        // Set delegates to get notified on changes or when the user interacts with the ad.
        this.rewardedVideoAd.RewardedVideoAdDidLoad = (delegate() {
            Debug.Log("RewardedVideo ad loaded.");
            this.isLoaded = true;
        });
        this.rewardedVideoAd.RewardedVideoAdDidFailWithError = (delegate(string error) {
            Debug.Log("RewardedVideo ad failed to load with error: " + error);
        });
        this.rewardedVideoAd.RewardedVideoAdWillLogImpression = (delegate() {
            Debug.Log("RewardedVideo ad logged impression.");
        });
        this.rewardedVideoAd.RewardedVideoAdDidClick = (delegate() {
            Debug.Log("RewardedVideo ad clicked.");
        });

        this.rewardedVideoAd.RewardedVideoAdDidClose = (delegate() {
            Debug.Log("Rewarded video ad did close.");
            if (this.rewardedVideoAd != null) {
                this.rewardedVideoAd.Dispose();
            }
        });

        // Initiate the request to load the ad.
        this.rewardedVideoAd.LoadAd();
    }
}

ตัวสร้างสำหรับ RewardedVideoAd จะมีพารามิเตอร์ดังต่อไปนี้

• placementId - ID ตำแหน่งการจัดวาง Audience Network สำหรับหน่วยโฆษณาแบบวิดีโอที่มีรางวัลหลังชมจบนี้

ขั้นตอนที่ 2: การเพิ่มเหตุการณ์การเรียกกลับ

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

...
// Set delegates to get notified on changes or when the user interacts with the ad.
this.rewardedVideoAd.RewardedVideoAdDidLoad = (delegate() {
    Debug.Log("RewardedVideo ad loaded.");
    this.isLoaded = true;
});
this.rewardedVideoAd.RewardedVideoAdDidFailWithError = (delegate(string error) {
    Debug.Log("RewardedVideo ad failed to load with error: " + error);
});
this.rewardedVideoAd.RewardedVideoAdWillLogImpression = (delegate() {
    Debug.Log("RewardedVideo ad logged impression.");
});
this.rewardedVideoAd.RewardedVideoAdDidClick = (delegate() {
    Debug.Log("RewardedVideo ad clicked.");
});

this.rewardedVideoAd.RewardedVideoAdDidClose = (delegate() {
    Debug.Log("Rewarded video ad did close.");
    if (this.rewardedVideoAd != null) {
        this.rewardedVideoAd.Dispose();
    }
});
...

ขั้นตอนที่ 3: โหลดโฆษณา

เมื่อสร้างอินสแตนซ์ RewardedVideoAd แล้ว ขั้นตอนถัดไปคือการโหลดโฆษณา ซึ่งทำได้โดยเรียกเมธอด loadAd

ในตัวอย่างที่แสดงด้านบน นี่คือวิธีการเริ่มโหลดโฆษณา:

...
this.rewardedVideoAd.LoadAd();
...

ขั้นตอนที่ 4: การแสดงโฆษณา

ขั้นตอนสุดท้าย หลังจากมีการโหลดโฆษณาแล้ว คุณจะสามารถเรียกเมธอด Show เพื่อแสดงโฆษณาแบบวิดีโอที่มีรางวัลหลังชมจบบนหน้าจอได้ เช่น คุณสามารถสร้างฟังก์ชั่นสำหรับ ShowRewardedVideo และเรียกฟังก์ชั่นนี้ได้เมื่อถึงเวลาแสดงโฆษณา

public void ShowRewardedVideo()
{
    if (this.isLoaded) {
        this.rewardedVideoAd.Show();
        this.isLoaded = false;
    } else {
        Debug.Log("Ad not loaded. Click load to request an ad.");
    }
}

การตรวจสอบความถูกต้องของรางวัลในฝั่งเซิร์ฟเวอร์

ภาพรวม

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

1. SDK ของ Audience Network ส่งคำขอโฆษณาแบบวิดีโอที่มีรางวัลหลังชมจบด้วยพารามิเตอร์ต่อไปนี้
   • placementId: ID ตำแหน่งการจัดวาง Audience Network
   • RewardData - อ็อบเจ็กต์ RewardData ประกอบด้วย UserId ที่แสดง ID ผู้ใช้ และ Currency ที่แสดงรางวัลจริงในเกม
2. เมื่อรับชมวิดีโอจนจบแล้ว เซิร์ฟเวอร์ของ Facebook จะส่งค่าเหล่านี้ไปยังตำแหน่งข้อมูลที่คุณระบุพร้อมกับข้อมูลลับของแอพและ ID ธุรกรรมที่ไม่ซ้ำกัน
3. เมื่อได้รับแล้ว เซิร์ฟเวอร์จะตรวจสอบความถูกต้องของคำขอและตอบกลับดังนี้
   • 200 response: คำขอถูกต้องและควรส่งรางวัล
   • Non 200 response: คำขอไม่ถูกต้องและไม่ควรส่งรางวัล
4. เมื่อชมวิดีโอจบแล้ว การ์ดต่อท้ายจะปรากฏขึ้นและหนึ่งในเหตุการณ์ต่อไปนี้จะทำงาน
   • RewardedVideoAdDidSucceed - มีการทริกเกอร์ก็ต่อเมื่อได้รับ 200 response ในระหว่างขั้นตอนที่ 3
   • RewardedVideoAdDidFail - มีการทริกเกอร์ก็ต่อเมื่อได้รับ Non 200 response ในระหว่างขั้นตอนที่ 3

ขั้นตอนการทำงานของคุณจะมีลักษณะดังนี้

การนำไปใช้งาน

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

public class RewardedVideoAdTest : MonoBehaviour
{
  ...
  private bool isLoaded;
  private RewardedVideoAd rewardedVideoAd;

  public void LoadRewardedVideo()

    //Set the rewarded ad data
    RewardData rewardData = new RewardData();
    rewardData.UserId = "USER_ID";
    rewardData.Currency = "REWARD_ID";

    // Instantiate RewardedVideoAd with reward data
    this.rewardedVideoAd = new RewardedVideoAd("YOUR_PLACEMENT_ID", rewardData);
    this.rewardedVideoAd.Register(this.gameObject);

    // Set delegates to get notified on changes or when the user interacts with the ad.
    this.rewardedVideoAd.RewardedVideoAdDidLoad = (delegate() {
        Debug.Log("RewardedVideo ad loaded.");
        this.isLoaded = true;
    });
    this.rewardedVideoAd.RewardedVideoAdDidFailWithError = (delegate(string error) {
        Debug.Log("RewardedVideo ad failed to load with error: " + error);
    });
    this.rewardedVideoAd.RewardedVideoAdWillLogImpression = (delegate() {
        Debug.Log("RewardedVideo ad logged impression.");
    });
    this.rewardedVideoAd.RewardedVideoAdDidClick = (delegate() {
        Debug.Log("RewardedVideo ad clicked.");
    });
    this.rewardedVideoAd.RewardedVideoAdDidClose = (delegate() {
        Debug.Log("Rewarded video ad did close.");
        if (this.rewardedVideoAd != null) {
            this.rewardedVideoAd.Dispose();
        }
    });

    // For S2S validation you need to register the following two callback
    this.rewardedVideoAd.RewardedVideoAdDidSucceed = (delegate() {
        Debug.Log("Rewarded video ad validated by server");
    });
    this.rewardedVideoAd.RewardedVideoAdDidFail = (delegate() {
        Debug.Log("Rewarded video ad not validated, or no response from server");
    });       

    this.rewardedVideoAd.loadAd();
  }
  ...
}

เพื่อให้แอพของคุณได้รับแจ้งว่ารางวัลผ่านการตรวจสอบหรือไม่ คุณจะต้องใช้การเรียกกลับ RewardedVideoAdDidSucceed และ RewardedVideoAdDidFail นอกเหนือจากการเรียกกลับอื่นๆ สำหรับ RewardedVideoAd

หลังจากมีการโหลดโฆษณาแล้ว คุณจะสามารถแสดงโฆษณาด้วยเมธอด Show เช่นเดียวกับ RewardedVideoAd ปกติ