Primeiros passos

Este guia mostra como criar um novo projeto iOS, incluir o SDK dos anúncios para dispositivos móveis do Google e fazer sua primeira solicitação de banner.

Pré-requisitos

Faça o download de um exemplo de banner do DFP

Como criar um novo projeto

Nesta etapa, criaremos um novo projeto em Xcode. Se você ainda não estiver com o Xcode em execução, abra-o agora.

Crie um novo projeto do Xcode

Acesse Arquivo > Novo > Projeto. Selecione Aplicativo de visualização única nos aplicativos iOS e, em seguida, clique em Próximo.

Nomeie seu projeto

Crie o nome "DFPBannerExample" para o seu projeto. Escolha a linguagem "Swift" ou "Objective-C". Em seguida, clique em Próximo.

Selecione um local para o projeto

Selecione um local para o seu projeto e clique em Criar para concluir a criação do novo projeto.

Crie e execute seu novo projeto

Para usar um simulador, acesse Produto > Destino e selecione um simulador de iPhone. Em seguida, selecione Produto > Executar para verificar se seu aplicativo foi criado e pode ser executado. Neste momento, o aplicativo mostrará somente uma tela em branco. Mas não se preocupe, pois adicionaremos o conteúdo nas próximas etapas.

Como adicionar o SDK ao seu projeto do Xcode

Existem duas formas de adicionar o SDK dos anúncios para dispositivos móveis do Google ao seu projeto do Xcode:

Otimizada, com uso do CocoaPods

Crie o Podfile

No mesmo diretório em que está seu arquivo DFPBannerExample.xcodeproj, crie um arquivo chamado Podfile que inclui o seguinte código:

source 'https://github.com/CocoaPods/Specs.git'

platform :ios, '7.0'

target 'DFPBannerExample' do
  pod 'Google-Mobile-Ads-SDK', '~> 7.8'
end

Execute o pod install

Execute o pod install no terminal, no mesmo diretório que o arquivo Podfile. Quando a instalação for concluída, feche DFPBannerExample.xcodeproj e abra DFPBannerExample.xcworkspace.

Os arquivos do seu projeto devem incluir um projeto Pods com o diretório Pods/Google-Mobile-Ads-SDK.

Recrie seu projeto

Recrie e execute seu projeto. O aplicativo ainda exibirá uma tela em branco, mas agora o SDK dos anúncios para dispositivos móveis do Google é referenciado nele. Agora, continue para fazer sua primeira solicitação de banner.

Manual, fazendo o download do SDK

Se você ainda não tiver o SDK dos anúncios para dispositivos móveis do Google, faça o download dele na página de downloads e descompacte o arquivo zip.

Adicione a estrutura

Clique com o botão direito no projeto "DFPBannerExample" e selecione Adicionar arquivos a "DFPBannerExample".

Adicione o arquivo GoogleMobileAds.framework.

Recrie seu projeto

Recrie e execute seu projeto. O aplicativo ainda exibirá uma tela em branco, mas agora você verá um registro no console do Xcode indicando sua versão do SDK dos anúncios para dispositivos móveis do Google.

Sua primeira solicitação de banner

Agora que você tem um projeto com o SDK referenciado, vamos adicionar anúncios de banner.

É possível criar um DFPBannerView usando o código ou um storyboard. Como de modo geral os layouts são definidos no storyboard, este guia mostrará o método do storyboard.

Adicionar um DFPBannerView no storyboard

Abra Main.storyboard. Na biblioteca de objetos, que fica na parte inferior direita, pesquise UIView e arraste um elemento UIView até seu controlador de visualizações. Em seguida, no Inspetor de identidades, na parte superior direita, atribua uma classe personalizada DFPBannerView a essa visualização.

Adicione restrições ao DFPBannerView

Definiremos restrições ao DFPBannerView para centralizá-lo na parte inferior da tela, com um tamanho de 320 x 50.

Selecione a visualização e clique no ícone Fixar na parte inferior da tela. Adicione uma restrição Espaçamento em relação ao objeto mais próximo na parte inferior do banner com o valor de 0. Assim, você fixará a visualização à parte inferior da tela.

Verifique também as restrições de largura e altura e defina os valores como 320 e 50, respectivamente, para configurar o valor da visualização.

Em seguida, clique no ícone Alinhar à esquerda do ícone Fixar e adicione uma restrição Centro horizontal do contêiner com um valor 0.

Depois de fazer alterações nas restrições, você poderá ver onde sua visualização será posicionada. Para fazer isso, selecione o ícone Solucionar problemas de layout automaticamente à direita de Fixar e, em seguida, Atualizar frames.

Agora, o banner estará posicionado corretamente.

Como adicionar uma referência ao seu DFPBannerView no código

Para carregar anúncios, o DFPBannerView precisa de uma referência no código. Acesse Visualização > Editor assistente > Exibir editor assistente para abrir o editor assistente. No editor assistente, verifique se o arquivo ViewController.h é exibido. Em seguida, segurando a tecla Ctrl, clique no DFPBannerView e arraste o cursor do mouse até ViewController.h. Para um projeto do Swift, siga as etapas acima, mas adicione uma referência ao DFPBannerView no arquivo ViewController.swift.

O Xcode criará e conectará uma propriedade para você. Atribua o nome "bannerView" a ela e selecione Conectar.

Objective-C

ViewController.m
#import <UIKit/UIKit.h>

@import GoogleMobileAds;

@interface ViewController : UIViewController

@property (weak, nonatomic) IBOutlet DFPBannerView  *bannerView;

@end

Swift

ViewController.swift
import UIKit
import GoogleMobileAds

class ViewController: UIViewController {

  @IBOutlet weak var bannerView: DFPBannerView!

} 

Para solucionar um erro de compilação, inclua também @import GoogleMobileAds ao ViewController.h ou import GoogleMobileAds ao ViewController.swift para que o compilador saiba que DFPBannerView é uma classe válida.

Carregar um anúncio no DFPBannerView

Finalmente, adicionar um código a ViewController.m ou ViewController.swift que carrega um anúncio na visualização de banner.

Objective-C

ViewController.m
- (void)viewDidLoad {
  [super viewDidLoad];

  NSLog(@"Google Mobile Ads SDK version: %@", [DFPRequest sdkVersion]);
  self.bannerView.adUnitID = @"/6499/example/banner";
  self.bannerView.rootViewController = self;
  [self.bannerView loadRequest:[DFPRequest request]];
}

Swift

ViewController.swift
override func viewDidLoad() {
  super.viewDidLoad()

  print("Google Mobile Ads SDK version: \(DFPRequest.sdkVersion())")
  bannerView.adUnitID = "/6499/example/banner"
  bannerView.rootViewController = self
  bannerView.loadRequest(DFPRequest())
}

Faça estas três alterações:

  1. No método viewDidLoad, defina um ID do bloco de anúncios no banner. Em algum momento, você precisará trafegar seu próprio item de linha na IU do DFP, fazer a segmentação desse item de linha com um bloco de anúncios e usar esse ID de bloco de anúncios no seu aplicativo. No entanto, por conveniência, é possível usar a amostra de bloco de anúncios fornecida acima, que é trafegada para um item de linha de teste.

  2. Defina o principal controlador de visualizações que conterá o DFPBannerView. Esse controlador de visualizações é usado para apresentar uma sobreposição quando o anúncio recebe um clique.

  3. Chame loadRequest: no DFPBannerView com um objeto DFPRequest.

Como executar o aplicativo

Crie e execute o aplicativo. Desta vez, você verá um anúncio de banner de teste na parte inferior da tela.

Parabéns, você fez sua primeira solicitação de anúncio.

Ver o exemplo completo no GitHub

Objective-C

Swift

Consulte a implementação completa do exemplo de banner no GitHub:

Objective-C Swift

O que vem a seguir

Para saber mais sobre os anúncios intersticiais de tela cheia, consulte o Guia de anúncios intersticiais.

Para ajustar a implementação do seu banner, consulte os seguintes guias:

Perguntas frequentes

Eu uso o CocoaPods. Como posso atualizar o SDK?
No terminal, execute pod update no mesmo diretório do Podfile.
Como posso criar um ID do bloco de anúncios do DFP?
O formato do ID do bloco de anúncios do DFP é: /networkCode/adUnitName. É possível gerar o ID do bloco de anúncio no DFP. Primeiro, faça login na sua conta do DFP. Na guia Inventário, navegue até o bloco de anúncios e clique em Gerar tags. Se preferir, você pode encontrar o código de rede da sua conta na guia Administrador em Configurações de rede.
Sempre recebo a mensagem "Erro de solicitação desconhecida inválida: não foi possível determinar o tipo da solicitação. O ID do bloco de anúncios está correto?"
Verifique se seu ID de bloco de anúncios está correto. Ele deve estar no formato /<network_code>/<ad_unit_path>.

Enviar comentários sobre…

SDK for DFP Users on iOS
Precisa de ajuda? Acesse nossa página de suporte.