Anúncios Colaborativos

Os Anúncios Colaborativos são uma solução desenvolvida a partir dos anúncios de catálogo Advantage+. Ela permite que os anunciantes da marca colaborem com um varejista ou parceiro de marketing de forma segura e atinjam metas de publicidade, como direcionar um produto para a venda usando o conteúdo fornecido pelo varejista.

O varejista ou parceiro de marketing deve compartilhar um segmento do catálogo com o anunciante da marca contendo todos os respectivos produtos. Esse segmento representa uma parte do catálogo ou um superconjunto de conjuntos de produtos. O anunciante da marca pode então aceitar o segmento do catálogo e usá-lo para começar a publicar anúncios de catálogo Advantage+. Os anunciantes da marca não podem editar o segmento do catálogo, mas podem criar os próprios conjuntos de produtos a partir dele.

Basicamente, um anunciante veicula uma campanha de anúncios de catálogo Advantage+ para vendas do catálogo com um catálogo de produtos. Por isso, eles podem usar relatórios padrão de anúncios do Facebook que agora incluem métricas relacionadas ao segmento do catálogo.

Além disso, você pode usar relatórios no nível do produto e do varejista para mostrar apenas as compras da marca ao anunciante.

Etapas gerais

Para revendedores e parceiros de marketing:

  • Etapa 1: fazer a integração com os Anúncios Colaborativos
  • Etapa 2: criar um segmento do catálogo – O segmento deve conter produtos que pertencem a um dos parceiros de marca em potencial.
  • Etapa 3: compartilhar o segmento do catálogo com o parceiro de marca
  • (Apenas para parceiros de marketing) Etapa 4: fornecer ferramentas de descoberta para marcas

Para marcas:

  • Etapa 1: aceitar o segmento do catálogo
  • Etapa 2: criar uma campanha de anúncios com o segmento do catálogo
  • Etapa 3: ver relatórios – Veja relatórios relacionados aos produtos no segmento do catálogo.
  • Etapa 4 (opcional): fazer a depuração – Use as ferramentas para diagnosticar e resolver problemas mencionadas no artigo Ferramentas de depuração dos Anúncios de Catálogo Advantage+.

Etapas para varejistas e parceiros de marketing

Etapa 1: fazer a integração com os Anúncios Colaborativos

Para concluir esta etapa, seu app precisará das permissões business_management e catalog_management.

No momento, não é possível executar essa ação via API. Em vez disso, use a interface do usuário. Para iniciar o processo, clique em "Ser um parceiro varejista" no Diretório do varejista.

Etapa 2: criar um segmento do catálogo

Para concluir esta etapa, seu app precisará das permissões business_management e catalog_management.

Crie um segmento do catálogo a partir de um catálogo atual. O segmento deve conter todos os produtos que você quer compartilhar com seu parceiro de marca.

Para criar um segmento do catálogo via API, faça uma solicitação POST para a borda owned_product_catalogs. Estes campos são obrigatórios para a criação de um segmento do catálogo:

  • parent_catalog_id: o catálogo principal a partir do qual seu segmento foi criado. Esse catálogo precisa estar em conformidade com os Anúncios Colaborativos. É possível encontrar o status do seu catálogo no Gerenciador de Comércio.
  • catalog_segment_filter: uma regra codificada em JSON usada para criar o segmento do catálogo.

Etapa 3: compartilhar o segmento do catálogo

Para concluir esta etapa, seu app precisará das permissões business_management e catalog_management.

Compartilhe o segmento do catálogo com seu parceiro de marca. Para fazer isso via API, faça uma solicitação POST para /{catalog_segment_id}/agencies. Na sua chamada, você pode incluir os seguintes campos:

CampoDescrição

business

Tipo: string numérica ou número inteiro

Obrigatório.

Identificação da empresa com a qual o catálogo será compartilhado.

permitted_tasks

Tipo: matriz < enumeração {MANAGE, ADVERTISE} >

Obrigatório.

Tarefas que a empresa poderá executar. Estas são as opções disponíveis: ['ADVERTISE', 'MANAGE'].

utm_settings

Tipo: objeto JSON {enum{campaign_source,campaign_medium,campaign_name}: string}

Opcional.

Você pode especificar campaign_source, campaign_medium e campaign_name.


Por exemplo: {campaign_source: “fb_campaign_source”}.

(Apenas para parceiros de marketing) Etapa 4: fornecer ferramentas de descoberta para marcas

Para concluir esta etapa, seu app precisará da permissão business_management. A chamada de API deve incluir um token de acesso do usuário, e esse usuário precisa ter permissão na solicitação de sugestão de parceiro, empresa ou colaboração.

Como parceiro de marketing, você deve fornecer uma maneira para as marcas descobrirem possíveis parceiros de Anúncios Colaborativos. É possível usar os seguintes pontos de extremidade para encontrar varejistas com quem trabalhar:

Se uma marca encontrar um parceiro, você poderá entrar em contato com o varejista com uma solicitação de colaboração. Para fazer isso, envie a solicitação POST a seguir para /{cpas-collaboration-request-id}:

{business-id}/collaborative_ads_collaboration_requests?
brands=”[“[BRAND NAME]”, “[BRAND NAME 2]”]”&
contact_email=[CONTACT_EMAIL]&
contact_first_name=[CONTACT_FIRST_NAME]&
contact_last_name=[CONTACT_LAST_NAME]&
phone_number=[PHONE NUMBER]&
receiver_business=[RECEIVING BUSINESS ID]
requester_agency_or_brand=[REQUESTING ENTITY - AGENCY, BRAND or MERCHANT]

Acompanhe suas solicitações usando os pontos de extremidade a seguir:

Etapas para marcas

Etapa 1: aceitar o segmento do catálogo

Caso sua marca não tenha aceitado os Termos de Serviço da nova empresa compartilhada, você precisará fazer isso.

Confira o que o usuário administrador da empresa deve fazer depois de receber o ativo compartilhado:

  1. Acessar a Central de Colaboração
  2. Selecionar a empresa para a qual você está aceitando os Termos de Serviço
  3. Selecionar Parceiros na barra de navegação do lado esquerdo
  4. Clicar no botão Aceitar ativos para começar o fluxo de trabalho de aceitação

Após aceitar os termos, sua marca poderá adicionar pessoas ao segmento do catálogo usando o ponto de extremidade /{product-catalog-id}/assigned_users. Observação: essa ação exige a permissão business_management.

Etapa 2: criar uma campanha

Para concluir esta etapa, seu app precisará ter as permissões business_management e ads_management.

Sua marca pode usar o segmento do catálogo aceito para criar campanhas de anúncios. Você deve usar uma conta de anúncios específica para cada varejista para o qual deseja veicular Anúncios Colaborativos. Depois que a conta de anúncios dedicada estiver vinculada a um varejista, ela só poderá selecionar segmentos do catálogo pertencentes a esse varejista específico.

Para criar e veicular anúncios, siga o mesmo processo que você usaria no seu catálogo de produtos. Porém, será preciso fornecer a catalog_segment_ID em vez da identificação do catálogo:

curl \
  -F 'name=Product Catalog Sales Campaign' \
  -F 'objective=PRODUCT_CATALOG_SALES' \
  -F 'promoted_object={"product_catalog_id":"<CATALOG_SEGMENT_ID>"}' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/campaigns

Em caso de sucesso, você obterá uma nova identificação da campanha de anúncios:

{
"id": "<CAMPAIGN_ID>"
}

Existem quatro campos que normalmente você pode definir com anúncios de catálogo Advantage+, o que não é possível fazer com um segmento do catálogo:

  • multi_share_end_card é definido como false por padrão e não pode ser alterado.
  • É possível mudar a description no template_data.
  • A template_url_spec, que você pode usar para URLs de deep link, deve direcionar o usuário para o site do comerciante.

Etapa 3: ver relatórios

Depois que os anúncios estiverem sendo veiculados, os anunciantes da marca poderão obter métricas sobre o desempenho da publicidade. Temos várias novas métricas de insights em diferentes níveis do objeto do anúncio. Veja o catalog_segment_value e as métricas relacionadas para:

O catalog_segment_value mostra um detalhamento dos eventos de conversão, incluindo compras, adição ao carrinho e visualização de produtos para o segmento do catálogo em cada nível do objeto do anúncio. Ele agrega eventos de fontes como sites, dispositivos móveis e omnicanais. Saiba mais sobre as métricas de insights estimadas e em desenvolvimento.

Etapa 4: fazer a depuração e diagnosticar problemas

As marcas devem resolver e depurar problemas ao veicular os anúncios de catálogo Advantage+ para o segmento do catálogo.

Consulte Ferramentas de depuração dos Anúncios de Catálogo Advantage+.

Insights

As seguintes métricas estimadas estão relacionadas aos Anúncios Colaborativos (veja Sobre métricas estimadas, em desenvolvimento e de terceiros).

Para consultar uma das nossas métricas de relatórios:

  • Seu app precisa ter as permissões ads_management e business_management. Consulte Análise do app.
  • É preciso ter um token de acesso de usuário, e esse usuário deve ter permissão para ver relatórios da conta de anúncios em questão.

As consultas podem ser feitas nos seguintes objetos: conta de anúncios, campanha de anúncios, conjunto de anúncios e anúncio.

Não há compatibilidade com o detalhamento action_converted_product_id no nível da conta de anúncios.

MetricDescription

catalog_segment_value

Value from conversion events, including a breakdown of purchases, add-to-carts and view products for the catalog segment at each ad object level.

catalog_segment_value_omni_purchase_roas

Total return on ad spend (ROAS) from purchases of items shared between Brand and Retailer. This number is based on information received from one or more Retailer' connected Facebook Business Tools. The amount is attributed to your ads.

catalog_segment_value_website_purchase_roas

Total return on ad spend (ROAS) from website purchases of items shared between Brand and Retailer. This number is based on information received from one or more Retailers' connected Facebook Business Tools. The amount is attributed to your ads.

catalog_segment_value_mobile_purchase_roas

The total return on ad spend (ROAS) from mobile app purchases of items shared between Brand and Retailer. This number is based on information received from one or more Retailers' connected Facebook Business Tools. The amount is attributed to your ads.

catalog_segment_actions

Similar to catalog_segment_value, when using this metric a breakdown of actions is given for the catalog segment at each ad object level.

converted_product_value

Value of conversions driven by your ads for a given product ID. This number is recorded by your Retailer partner's Pixel or App SDK.


The API only returns Product IDs —see /{product-item-id} for information. If you want to get brand names as well, please use Ads Manager.

converted_product_quantity

Quantity of conversions driven by your ads for a given product ID. This number is recorded by your Retailer partner's Pixel or App SDK.


The API only returns Product IDs —see /{product-item-id} for information. If you want to get brand names as well, please use Ads Manager.

Detalhamentos

Os detalhamentos são usados para agrupar os resultados das suas estatísticas em diferentes conjuntos (veja Detalhamentos da API de Insights). Você pode usar os seguintes detalhamentos com métricas de Anúncios Colaborativos:

  • Data: obtenha estatísticas para um intervalo de datas específico. Para usar esse detalhamento, adicione time_range à sua consulta. Por exemplo: &time_range[since]=2020-03-01&time_range[until]=2020-04-01.

  • Nível do produto: obtenha insights para um produto específico. Use esse detalhamento para converted_product_value e converted_product_quantity metrics adicionando &action_breakdowns=action_converted_product_id à sua consulta.

Como combinar detalhamentos

Use as seguintes combinações de detalhamentos para Anúncios Colaborativos:

Não há compatibilidade com o detalhamento action_converted_product_id no nível da conta de anúncios.

  • action_converted_product_id
  • action_type, action_converted_product_id