Anúncios em vídeo com incentivo para um app do Unity

O Audience Network permite que você monetize seus aplicativos para Android e iOS usando os anúncios do Facebook. Os anúncios em vídeo com incentivo são uma experiência em tela cheia na qual os usuários optam por visualizar um anúncio em vídeo em troca de algo de valor, como moeda virtual, itens no app, conteúdo exclusivo e muito mais. A experiência do anúncio é um vídeo curto e um cartão ao final com uma chamada para realizar uma ação. Após a visualização completa do vídeo, você receberá um retorno de chamada para dar a recompensa sugerida ao usuário.

Etapas para anúncios em vídeo com incentivo

Etapa 1. Inicializar anúncios em vídeo com incentivo

Etapa 2. Adicionar eventos de retorno de chamada

Etapa 3. Carregar um anúncio

Etapa 4. Exibir o anúncio

Etapa 1. Inicializar anúncios em vídeo com incentivo

A primeira etapa para exibir um anúncio em vídeo com incentivo é criar um objeto RewardedVideoAd em um script C# anexado a um 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();
    }
}

O construtor de um RewardedVideoAd tem os seguintes parâmetros:

• placementId: a identificação do posicionamento do Audience Network para essa unidade de anúncio em vídeo com incentivo.

Etapa 2. Adicionar eventos de retorno de chamada

Em seguida, você pode implementar alguns retornos de chamada para assinar os eventos do ciclo de vida do anúncio. Acompanhe esses eventos registrando um delegado para o evento, como exibido no exemplo abaixo:

...
// 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();
    }
});
...

Etapa 3. Carregar um anúncio

Assim que o RewardedVideoAd for instanciado, carregue o anúncio. Faça isso chamando o método loadAd.

No exemplo acima, veja como iniciar o carregamento do anúncio:

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

Etapa 4. Exibir o anúncio

Depois de fazer o carregamento, chame o método Show para renderizar o anúncio em vídeo com incentivo na tela. Você pode criar uma função para ShowRewardedVideo e chamá-la na hora de exibir o anúncio:

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

Validação de recompensa do lado do servidor

Visão geral

Se você gerencia o lado do servidor das recompensas para os usuários, o Facebook oferece uma solução para executar isso de forma segura usando uma técnica de validação. Nosso servidor se comunicará com um ponto de extremidade https específico para validar cada impressão de anúncio e validar se uma recompensa deve ser concedida.

1. O SDK do Audience Network solicita um anúncio em vídeo com incentivo usando os seguintes parâmetros:
   • placementId: a identificação do posicionamento do Audience Network.
   • RewardData: um objeto RewardData consiste em UserId que representa o número de identificação do usuário e Currency que indica a recompensa real.
2. Ao término do vídeo, o servidor do Facebook repassará esses valores para seu ponto de extremidade especificado, junto com a chave secreta do aplicativo e um ID de transação exclusivo.
3. Ao recebê-los, o servidor valida a solicitação e responde da seguinte maneira:
   • 200 response: a solicitação é válida, e a recompensa deve ser entregue.
   • Non 200 response: a solicitação não é válida, e a recompensa não deve ser entregue.
4. Quando a reprodução do vídeo é concluída, o cartão final é apresentado, e um dos seguintes eventos é disparado.
   • RewardedVideoAdDidSucceed: será acionado somente quando uma resposta 200 for retornada durante a etapa 3.
   • RewardedVideoAdDidFail: será acionado quando uma resposta diferente do código 200 for retornada durante a etapa 3.

O fluxo de trabalho terá esta aparência:

Implementação

Após inicializar o objeto de vídeo com incentivo, você precisará colocar um ID de usuário e o valor da recompensa nos dados do anúncio com incentivo antes de carregar um anúncio. Isso pode ser feito com a classe RewardData. O ID do usuário e o valor de recompensa são cadeias de caracteres. Por exemplo:

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();
  }
  ...
}

Além do retorno de chamada para RewardedVideoAd, implemente retornos de chamada para RewardedVideoAdDidSucceed e RewardedVideoAdDidFail se quiser que o aplicativo seja notificado sobre a validação da recompensa.

Depois que o anúncio for carregado, será possível renderizá-lo com o método Show como um RewardedVideoAd normal.