Usar as práticas recomendadas para inventário de apps para dispositivos móveis

Neste guia, descrevemos as práticas recomendadas para dar lances em inventários de apps para dispositivos móveis, incluindo anúncios de alto engajamento, de instalação de apps e de reengajamento.

Dar lances em anúncios de alto engajamento

Os anúncios de alto engajamento (HEA, na sigla em inglês) são um tipo de inventário de anúncios intersticiais de app com maior visibilidade ou requisitos de interação do usuário. Por exemplo, o inventário de HEA é adequado para colocar um criativo que inclui uma breve demonstração jogável do app anunciado antes de solicitar que o usuário instale o app anunciado. Se a configuração de pré-segmentação permitir que o endpoint de lances receba solicitações de lances para um ou mais formatos compatíveis, o inventário recebido nas solicitações de lances para esses formatos poderá ser de anúncios de alto engajamento. Os anúncios de alto engajamento são compatíveis com anúncios intersticiais de apps e premiados de apps que usam o formato de criativo de vídeo VAST.

Para saber mais sobre o comportamento de renderização dos anúncios de alto engajamento, consulte Sobre os anúncios de alto engajamento.

Dar lances com criativos de vídeo VAST

As solicitações de lance que você recebe para inventário de anúncios de alto engajamento no formato de vídeo VAST definem os seguintes campos:

Campo Descrição
BidRequest.imp.ext.highengagement Defina como true se o endpoint de lances tiver o campo bidProtocol definido como o valor de tipo enumerado OPENRTB_PROTOBUF ou 1 se o campo bidProtocol estiver definido como o valor de tipo enumerado OPENRTB_JSON.
BidRequest.imp.instl Defina como true se o endpoint de lances tiver o campo bidProtocol definido como o valor de tipo enumerado OPENRTB_PROTOBUF ou 1 se o campo bidProtocol estiver definido como o valor de tipo enumerado OPENRTB_JSON.
BidRequest.imp.video.companionad Contém tamanhos qualificados para o card final que você pode incluir no vídeo na resposta à solicitação de lance.
BidRequest.imp.video.companiontype Se o endpoint de lances tiver o campo bidProtocol definido como o valor de tipo enumerado OPENRTB_PROTOBUF, ele será definido como o valor de tipo enumerado HTML ou COMPANION_IFRAME. Se o endpoint de lances tiver o campo bidProtocol definido como o valor de tipo enumerado OPENRTB_JSON, ele será definido como 2 ou 3.
BidRequest.imp.video.maxduration Tem uma duração máxima maior do que os anúncios em vídeo VAST intersticiais padrão. Você pode colocar vídeos mais longos no inventário de anúncios de alto engajamento.

A resposta à solicitação de lance precisa incluir os seguintes campos:

Campo Descrição
BidResponse.seatbid.bid.crid Defina esse valor como o ID do criativo de vídeo que você quer inserir. O criativo precisa ser um criativo de vídeo aprovado. Caso contrário, seu lance não poderá vencer o leilão.
BidResponse.seatbid.bid.adm Defina esse campo como o XML VAST ou o URL do vídeo que leva a um documento XML VAST para o criativo de vídeo que você quer veicular. Se o vídeo incluir um anúncio complementar, o anúncio complementar especificado no XML VAST do criativo de vídeo precisará ser consistente com os campos BidRequest.imp.video.companionad e BidRequest.imp.video.companiontype da solicitação de lance.
BidResponse.seatbid.bid.bundle Defina esse campo como o ID do app anunciado na app store correspondente.
  • Para apps Android, esse campo é um ID de pacote encontrado no URL da Play Store. Por exemplo, se o URL da Google Play Store for https://play.google.com/store/apps/details?id=com.example.myawesomeapp, o ID do pacote será com.example.myawesomeapp.
  • Para apps iOS, esse campo é um ID de string numérica do app encontrado no URL da App Store da Apple. Por exemplo, se o URL da App Store da Apple for https://apps.apple.com/app/id123456789, o ID da string numérica será 123456789.

Seu vídeo pode ter um card final com um snippet HTML que aparece depois que o vídeo termina. O Google também mostra um card final gerado com base no app especificado no campo BidResponse.seatbid.bid.bundle.

Para incluir cards finais no seu criativo em vídeo, adicione nós Companion ao XML VAST do vídeo. Se você quiser mostrar um card final, seu lance precisa incluir um vídeo com um anúncio complementar que corresponda a um ou mais tipos especificados no campo BidRequest.imp.video.companiontype. Para mais informações sobre cards finais, consulte Renderizar um card final para um anúncio em vídeo para dispositivos móveis.

Aumentar as instalações com anúncios de instalação de apps

Os anúncios de instalação de apps incentivam os usuários do app para dispositivos móveis de um publisher a baixar e instalar um app anunciado. Eles são compatíveis com todo o inventário de anúncios intersticiais de apps nos seguintes formatos de criativo:

Identificar indicadores de BidRequest

É possível dar lances com anúncios de instalação de apps em resposta a solicitações de lance para inventário de intersticiais de apps para dispositivos móveis Android e iOS. Os campos a seguir são sempre definidos para o inventário de intersticiais de apps para dispositivos móveis:

Campo Descrição
BidRequest.app.bundle Um identificador para o app do editor. Defina um nome de pacote como o que aparece na Google Play Store, como com.google.android.youtube para apps Android. Defina como um ID numérico, conforme mostrado na App Store da Apple para apps iOS.
BidRequest.imp.instl Defina como true se o endpoint de lances tiver o campo bidProtocol definido como o valor de tipo enumerado OPENRTB_PROTOBUF ou 1 se o campo bidProtocol estiver definido como o valor de tipo enumerado OPENRTB_JSON.
BidRequest.device.devicetype Defina como o valor de tipo enumerado HIGHEND_PHONE ou TABLET se o endpoint de lances tiver o campo bidProtocol definido como o valor de tipo enumerado OPENRTB_PROTOBUF. Defina como 4 ou 5 se o endpoint tiver o campo bidProtocol definido como o valor de tipo enumerado OPENRTB_JSON.

Preencher campos de BidResponse

Você pode dar lances com anúncios de instalação de apps para inventário de dispositivos móveis de qualquer formato intersticial que aceite os formatos de criativo compatíveis. Sua resposta à solicitação de lance precisa definir os campos a seguir para dar lances em um anúncio de instalação de apps:

Campo Descrição
BidResponse.seatbid.bid.bundle Defina esse campo como o ID do app anunciado na app store correspondente.
  • Para apps Android, esse campo é um ID de pacote encontrado no URL da Play Store. Por exemplo, se o URL da Google Play Store for https://play.google.com/store/apps/details?id=com.example.myawesomeapp, o ID do pacote será com.example.myawesomeapp.
  • Para apps iOS, esse campo é um ID de string numérica do app encontrado no URL da App Store da Apple. Por exemplo, se a App Store da Apple for https://apps.apple.com/app/id123456789, o ID da string numérica será 123456789.
BidResponse.seatbid.bid.ext.clickurl

Defina esse campo como o URL do destino final, excluindo chamadas intermediárias para um servidor de anúncios que não estejam relacionadas à página de destino final. Defina esse campo com um valor consistente com o valor fornecido no campo BidResponse.seatbid.bid.bundle. Por exemplo, para um app Android encontrado na Google Play Store, isso pode ser definido como https://play.google.com/store/apps/details?id=com.example.myawesomeapp&referrer=utm_source%3Dgoogle_ab%26utm_medium%3Dcpc%26utm_campaign%3Dinstall_campaign_1.

BidResponse.seatbid.bid.ext.app_promotion_type Defina esse campo como o valor de tipo enumerado INSTALLS se o endpoint de lances tiver o campo bidProtocol definido como o valor de tipo enumerado OPENRTB_PROTOBUF ou 1 se o campo bidProtocol estiver definido como o valor de tipo enumerado OPENRTB_JSON. Esse campo indica que você quer que o criativo especificado seja renderizado como um anúncio de instalação de apps.

Usar URLs de clique consistentes

O URL de clique especificado no campo BidResponse.seatbid.bid.ext.clickurl precisa ser idêntico ao URL da página de destino especificado no criativo. Para ver exemplos de criativos em formatos compatíveis que são consistentes com o campo clickurl, consulte Usar URLs de clique consistentes.

Reengajar usuários com anúncios de reengajamento

Os anúncios de reengajamento segmentam um usuário do app para dispositivos móveis de um editor que já baixou e instalou o app anunciado e direcionam o usuário para um local específico no app anunciado usando um link direto. Para saber mais sobre links diretos, consulte os seguintes artigos:

Os anúncios de reengajamento são compatíveis com todo o inventário de anúncios intersticiais de apps nos seguintes formatos de criativo:

Identificar indicadores de BidRequest

É possível dar lances com anúncios de reengajamento em resposta a solicitações de lance para inventário intersticial de apps para dispositivos móveis. Os campos a seguir são sempre definidos para o inventário de intersticiais de apps para dispositivos móveis:

Campo Descrição
BidRequest.app.bundle Um identificador para o app do editor. Defina um nome de pacote como o que aparece na Google Play Store, como com.google.android.youtube para apps Android. Defina como um ID numérico, conforme mostrado na App Store da Apple para apps iOS.
BidRequest.imp.instl Defina como true se o endpoint de lances tiver o campo bidProtocol definido como o valor de tipo enumerado OPENRTB_PROTOBUF ou 1 se o campo bidProtocol estiver definido como o valor de tipo enumerado OPENRTB_JSON.
BidRequest.device.devicetype Defina como o valor de tipo enumerado HIGHEND_PHONE ou TABLET se o endpoint de lances tiver o campo bidProtocol definido como o valor de tipo enumerado OPENRTB_PROTOBUF. Defina como 4 ou 5 se o endpoint tiver o campo bidProtocol definido como o valor de tipo enumerado OPENRTB_JSON.

Preencher campos de BidResponse

É possível dar lances com anúncios de reengajamento para inventário de dispositivos móveis de qualquer formato intersticial que aceite os formatos de criativo compatíveis. Sua resposta à solicitação de lance precisa definir os seguintes campos para dar lances em um anúncio de reengajamento:

Campo Descrição
BidResponse.seatbid.bid.bundle Defina esse campo como o ID do app anunciado na app store correspondente.
  • Para apps Android, esse é um ID de pacote encontrado no URL da Google Play Store. Por exemplo, se o URL da Google Play Store for https://play.google.com/store/apps/details?id=com.google.android.youtube, o ID do pacote será com.google.android.youtube.
  • Para apps iOS, é um ID de string numérica do app encontrado no URL da App Store da Apple. Por exemplo, se o URL da App Store da Apple for https://apps.apple.com/us/app/id123456789, o ID da string numérica será 123456789.
BidResponse.seatbid.bid.ext.clickurl Defina esse campo como um link direto de URL que abre um conteúdo específico no app anunciado. O Google recomenda usar links universais para iOS e links do app Android para Android. Não há suporte para esquemas de URL personalizados. Por exemplo, se você veicular um anúncio de reengajamento para o app YouTube, poderá vincular a um vídeo específico definindo o campo clickurl com um valor como https://www.youtube.com/watch?v=a1b2c3d4e5f.
BidResponse.seatbid.bid.ext.app_promotion_type Defina esse campo como o valor de tipo enumerado ENGAGEMENT se o endpoint de lances tiver o campo bidProtocol definido como o valor de tipo enumerado OPENRTB_PROTOBUF ou 2 se o campo bidProtocol estiver definido como o valor de tipo enumerado OPENRTB_JSON. Esses valores indicam que você quer que o criativo especificado seja renderizado como um anúncio de reengajamento.
BidResponse.seatbid.bid.ext.engagementclickfailureurl Se quiser, defina esse campo como um URL que recebe um ping quando o SDK do Google Mobile Ads não consegue abrir o app pelo URL de clique especificado. O SDK dos anúncios para dispositivos móveis do Google pode não abrir o app quando ele não está instalado ou o URL de clique especificado não é um link direto válido.