Anúncios de parceiros gerenciados

Verificar a qualificação do vendedor

Esta página fornece orientações sobre quais vendedores integrar a anúncios de parceiros gerenciados e como verificar a respectiva qualificação. Você pode começar a integrar qualquer vendedor qualificado, mas considere priorizar vendedores com um valor médio de compra mais alto, já que eles tendem a gerar um maior retorno sobre o investimento em publicidade.

Antes de começar

Antes de verificar a qualificação de um vendedor, conclua estas etapas:

  1. Crie um usuário administrador do sistema.
  2. Atribua permissões ao usuário administrador do sistema.
  3. Gere um token de acesso para o usuário administrador do sistema.

Critérios de qualificação do vendedor

Um vendedor é considerado qualificado com base nos seguintes critérios:

  • Valor médio de compra nos últimos 28 dias
  • Número de compras nos últimos 28 dias

Observação: vendedores com um valor médio de compra mais alto tendem a gerar um maior retorno sobre o investimento em publicidade e podem ser melhores parceiros para integração. Você pode baixar uma lista de vendedores qualificados e recomendados na página Descobrir da Central de Colaboração.

Permissões necessárias

Para fazer chamadas à API de Qualificação do Vendedor, você precisará das seguintes permissões:

  • Administrador da empresa
  • Administrador do catálogo
  • Gerenciamento de crédito
  • Desenvolvedor do app

Chamada da API de Qualificação do Vendedor

Solicitação

curl -X GET \
 "https://graph.facebook.com/v<API_VERSION>/<Business_ID>?fields=collaborative_ads_managed_partner_eligibility.vendor_id(<INSERT_VENDOR_ID>).catalog_id(<INSERT_CATALOG_ID>)&access_token=<ACCESS_TOKEN>"

Parâmetros

NomeDescrição

catalog_id

string numérica

Obrigatório.
A identificação do catálogo do marketplace, referido como catálogo principal.
Durante a integração, esse catálogo pode ser filtrado usando vendor_id=<child_business_external_id> a fim de criar um segmento do catálogo para o vendedor.

marketplace_bm_id

string

Obrigatório.
A identificação do Gerenciador de Negócios do marketplace. Consulte Como encontrar a identificação da empresa para saber mais.

vendor_id

string

Obrigatório.
A identificação única do vendedor em um marketplace.

Resposta

{
  "is_eligible": bool,
  "reason_code": "enum string",
  "reason_description": "enum string",
}

Parâmetros

NomeDescrição

is_eligible

booleano

Indica se o vendedor está qualificado.

reason_code

string de enumeração

O código do motivo da qualificação do vendedor.
Vazio se o vendedor estiver qualificado.

reason_description

string de enumeração

A descrição do motivo da qualificação do vendedor.
Vazio se o vendedor estiver qualificado.

Códigos de erro

Código de erroSubcódigo de erroDescrição

1800000

2310114

Conclua o processo de integração de anúncios de parceiros gerenciados na Central de Colaboração.

1800012

2310173

Verifique o marketplace em que você entrou ({marketplace_id}). Se for a identificação correta, peça a uma pessoa com controle total para acessar as configurações do negócio no Gerenciador de Negócios e conceder a você acesso de administrador. Quando a atribuição for concluída, faça a solicitação novamente.

1800101

2310116

Sua empresa {business_id} não gerencia o catálogo {catalog_id} inserido. Insira a identificação de um catálogo gerenciado pela sua empresa.

Saiba mais