Início rápido: configurar um posicionamento de anúncio
Os anúncios recompensados são uma forma de incentivar seus jogadores a assistir a anúncios em vídeo em troca de uma recompensa. Cada anúncio com suas recompensas associadas é considerado um posicionamento de anúncio. Neste início rápido, você configurará um posicionamento de anúncio e configurará recompensas para ele.Pré-requisitos
- Uma conta de desenvolvedor do PlayFab.
- Uma ID de aplicativo e um tipo de unidade de publicidade do seu provedor de anúncios.
Configurar um posicionamento de anúncio
Na guia Anúncios recompensados, a primeira coisa que você verá é o painel principal dos seus anúncios. Aqui você encontrará KPIs básicos dos seus anúncios, junto com um gráfico que mostra seus eventos de anúncios recentes (eles também aparecem no PlayStream ) Na parte superior, selecione Posicionamentos. Os posicionamentos de anúncios são a parte mais fundamental do sistema. Pense em um único posicionamento como uma “posição de anúncio”: o tipo de anúncio que será exibido (banner, vídeo etc.) e em que ponto do jogo o jogador o verá (intersticial de nível, como resultado de clicar em “mostre-me um anúncio” etc.). No canto superior direito, selecione Novo posicionamento de anúncio. Dê ao seu posicionamento o nome que quiser e insira a ID do aplicativo e o tipo de unidade de publicidade do seu provedor de anúncios. Se você não tiver certeza de onde localizar a ID do aplicativo e o tipo de unidade de publicidade do seu provedor específico, avise-nos e poderemos trabalhar com você para identificá-los.Adicionar recompensas
Agora você precisará adicionar suas recompensas específicas. Para cada recompensa possível para este posicionamento, selecione Nova recompensa. Dê um nome à sua recompensa e insira qualquer texto de descrição e URL de pacote de ativos que você deseja que sejam retornados ao cliente quando a recompensa específica for concedida. Em seguida, em Ações, selecione Adicionar ação. Assim como acontece com as ações normais do PlayStream, você pode executar várias ações diferentes neste momento - executar um manipulador do Cloud Script, conceder itens etc. Normalmente, você concederá moeda virtual ou itens aqui, mas se quiser usar os outros tipos de ação, tudo será processado da mesma forma que em um gatilho de ação normal do PlayStream. Depois de definir algumas recompensas, atribua a cada uma um peso para configurar a distribuição aleatória. Se você definiu Segmentos para seu título, também pode definir substituições na ferramenta Atribuição de segmentos abaixo de Recompensas. Por exemplo, se você tiver um determinado grupo de jogadores que deseja que sempre recebam uma recompensa específica, defina esse segmento para essa recompensa na lista de atribuições. As atribuições de segmentos estão em ordem de prioridade, portanto, o primeiro segmento que corresponder ao jogador atual é o que será usado. O exemplo a seguir define um posicionamento de anúncio que fornece gemas gratuitas 0% das vezes, pontos de experiência bônus 30% das vezes e um item “chave” 70% das vezes.
Recuperando os posicionamentos de anúncios
Depois de definir pelo menos um posicionamento de anúncio, você pode consultar uma lista de posicionamentos disponíveis usando Client/GetAdPlacements. Especifique um Identifier na chamada para garantir que você obtenha informações apenas sobre o posicionamento indicado. Para filtrar por um posicionamento específico, você pode usar o nome que definiu para ele (acima) ou o identificador exclusivo gerado pelo PlayFab para o posicionamento (que você pode ver na URL, no exemplo acima). Caso contrário, todos os posicionamentos disponíveis para os quais o jogador tem uma recompensa válida, incluindo a recompensa para o jogador, o número de visualizações restantes no momento e o tempo até a redefinição do limite de visualizações, são retornados em um objetoAdPlacementDetails.
Quando você tiver selecionado um posicionamento de anúncio no código do cliente, salve o PlacementId e o RewardId. Você os usará nas duas próximas etapas.
Relatando a atividade do anúncio
Definimos quatro estados de atividade para um anúncio - “Opened”, “Closed”, “Start” e “End”. Ao usar os Anúncios recompensados, certifique-se de chamar Client/ReportAdActivityRequest para atualizar o estado de atividade sempre que o SDK do seu anúncio relatar uma alteração de estado.Recompensando a atividade do anúncio
Quando o SDK do seu anúncio relatar que a visualização do anúncio foi concluída com sucesso, chame Client/RewardAdActivity para acionar a recompensa. Essa chamada requer oPlacementId e o RewardId retornados por Client/GetAdPlacements. Primeiro, ela verifica se a recompensa é válida e, em seguida, a processa para o jogador. Os itens são concedidos imediatamente, e a chamada então retorna um conjunto completo de alterações feitas no jogador pelas ações Grant Item, Grant Virtual Currency e Increment Player Statistic.
Por fim, é importante observar que a ID da recompensa não fica vinculada ao jogador como parte da chamada a GetAdPlacements. Com base nos pesos que você forneceu, chamar GetAdPlacements várias vezes pode fazer com que a recompensa mude. A chamada a RewardAdActivity exige apenas que a recompensa seja válida para o jogador, e não que tenha sido a última retornada por GetAdPlacements.