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.
Para revendedores e parceiros de marketing:
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.
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.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:
Campo | Descrição |
---|---|
Tipo: string numérica ou número inteiro | Obrigatório. Identificação da empresa com a qual o catálogo será compartilhado. |
Tipo: matriz < enumeração {MANAGE, ADVERTISE} > | Obrigatório. Tarefas que a empresa poderá executar. Estas são as opções disponíveis: |
Tipo: objeto JSON {enum{campaign_source,campaign_medium,campaign_name}: string} | Opcional. Você pode especificar Por exemplo: |
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:
GET {business-id}?fields=collaborative_ads_suggested_partners
– Encontre parceiros para uma empresa específica.GET collaborative_ads_directory?fields=collaborative_ads_merchants
– Obtenha a lista completa de varejistas de Anúncios Colaborativos.GET {cpas-advertiser-partnership-recommendation-id}?fields=advertiser_business_id,brand_business_id,brands,countries,merchant_business_id,status,status_reason
– Obtenha uma única recomendação de varejista.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:
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:
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
.
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.description
no template_data
.template_url_spec
, que você pode usar para URLs de deep link, deve direcionar o usuário para o site do comerciante.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.
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+.
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:
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.
Metric | Description |
---|---|
| Value from conversion events, including a breakdown of purchases, add-to-carts and view products for the catalog segment at each ad object level. |
| 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. |
| 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. |
| 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. |
| Similar to |
| 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 |
| 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 |
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.
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