Criação e relacionamentos de recursos

Neste guia, descrevemos cada um dos recursos do Waze Ads, como eles estão conceitualmente relacionados e a ordem correta de criação deles.

Recursos do Waze Ads

Veja na lista a seguir as definições dos principais recursos do Waze Ads.

Conta

Os recursos de Account do Waze Ads são a base dos recursos dele. Uma Account encapsula todos os outros recursos do Waze Ads, como instâncias de Ad, BudgetPlan, Location, Campaign, RoleAssignment e Invitation.

  • Crie uma Account para cada empresa que você quer anunciar. Se você é um revendedor, crie muitos recursos de Account. Caso você gerencie uma única empresa com várias lojas, poderá usar uma única Account e associar todas as instâncias de Location a essa Account.
  • Todos os recursos de Location associados a uma Account precisam estar na mesma região especificada por Account.advertisingRegionCode.
  • É necessário especificar uma única Account.Category para cada Account. Se você tiver empresas em diferentes categorias, crie instâncias de Account distintas para todas elas.
  • Relatórios gerados com o método accounts.generateReport só podem incluir dados de uma única Account.
  • Os recursos de RoleAssignment determinam a role, como VIEWER ou EDITOR, que um usuário tem em uma Account específica.
  • Os recursos de Invitation convidam um usuário a ter uma role de uma Account específica.

Ad
Os recursos Ad incluem call-to-action (CTA), texto do criativo e imagens. Eles determinam a apresentação visual e o comportamento de um anúncio. É possível criar até 500 recursos Ad em uma conta.
Plano de orçamento
O BudgetPlan especifica o orçamento para um período em que uma Campaign é exibida. É possível criar até 500 recursos BudgetPlan em uma conta.
Local
Instâncias de Location são compostas por um conjunto de coordenadas de longitude e latitude, além de metadados sobre o Location, como o nome de uma empresa. Quando você cria um Location, o escopo dele fica restrito a uma Account. Os recursos de Location são necessários para veicular os anúncios. Eles são a primeira camada de segmentação e determinam onde os anúncios podem aparecer. Até 10.000 recursos Location podem ser usados em uma conta.
Campanha
Os recursos de Campaign conectam as instâncias de Location e Ad e associam um BudgetPlan. Os recursos de Campaign permitem que os anúncios sejam veiculados. Até 500 recursos de Campaign são compatíveis em uma conta.

API Waze: fluxo de dependência de criação de recursos

Veja a seguir a ordem de criação de recursos:

  1. Crie uma Account. Depois disso, uma RoleAssignment será criada automaticamente com seu e-mail, nome e a Role EDITOR, dando a você permissões de leitura e gravação na nova Account.
  2. Crie os recursos BudgetPlan, Ad e Location em qualquer ordem. Cada recurso está associado à Account.
  3. Por fim, crie os recursos de Campaign e associe-os à Account, um único Ad e um único BudgetPlan. É possível criar instâncias de Campaign sem um Location. No entanto, para veicular anúncios, é necessário segmentar pelo menos um Location.

A imagem a seguir mostra o fluxo de dependência de criação de recursos:

O diagrama do fluxo de dependência de criação de recursos descreve a ordem em que os recursos precisam ser criados.

Criar uma campanha

Os recursos de Campaign do Waze Ads são criados no escopo ou no contexto de uma Account do Waze Ads. Uma Campaign segmenta um local específico ou todas as instâncias de Location. É possível segmentar até 50 instâncias de Location específicas. Vários recursos de Campaign podem compartilhar o mesmo conjunto de instâncias de Location, mas cada Campaign pode ter apenas um tipo de bloco de anúncios, como Pin, Takeover, seta ou pesquisa.