Anúncios e comércio
The content on this page has been translated from English into another language using AI. The AI translated content may contain errors, omissions, or unintended meanings. Since AI translated language may be inaccurate or unclear, you may refer to the original source content in English for this page to review the intended guidance.
Usuários de público personalizado
Updated: 8 de out de 2025
Adicione pessoas ao público do seu anúncio com um hash de dados da sua empresa. Consulte Públicos personalizados a partir de dados do CRM.
Você pode adicionar um número ilimitado de registros a um público, com o máximo de 10 mil por vez. As alterações nos públicos personalizados não acontecem imediatamente e geralmente levam até 24 horas para serem concluídas.
Públicos personalizados e semelhantes sinalizados
Se o público for sinalizado com
operation_status de 471, você precisará resolver as restrições no público personalizado do arquivo de clientes antes de atualizar ou excluir a participação do usuário. As tentativas de editar a participação do usuário sem resolver as restrições resultarão em um erro.{ "error": { "message": "Invalid parameter", "code": 100, "error_subcode": 1713230, "error_user_title": "Audience Upload Blocked", "error_user_msg": "Before updating user memberships, you must resolve integrity restrictions on this Data File Custom Audience. Go to Audience Manager to appeal the restrictions or create a new audience with updated data", }, }
Leitura
Não é possível executar essa operação no ponto de extremidade.
Criação
Não é possível executar essa operação no ponto de extremidade.
Como atualizar
/{custom_audience_id}/users
É possível atualizar um usuário fazendo uma solicitação POST a /{custom_audience_id}/users.
Exemplo
POST /v25.0/<CUSTOM_AUDIENCE_ID>/users HTTP/1.1 Host: graph.facebook.com payload=%7B%22schema%22%3A%5B%22EMAIL%22%2C%22LOOKALIKE_VALUE%22%5D%2C%22data%22%3A%5B%5B%229b431636bd164765d63c573c346708846af4f68fe3701a77a3bdd7e7e5166254%22%2C44.5%5D%2C%5B%228cc62c145cd0c6dc444168eaeb1b61b351f9b1809a579cc9b4c9e9d7213a39ee%22%2C140%5D%2C%5B%224eaf70b1f7a797962b9d2a533f122c8039012b31e0a52b34a426729319cb792a%22%2C0%5D%2C%5B%2298df8d46f118f8bef552b0ec0a3d729466a912577830212a844b73960777ac56%22%2C0.9%5D%5D%7D
Experimente no Explorador da Graph API
Para saber como usar a Graph API, leia nosso guia Como usar a Graph API
Parâmetros
| Parâmetro | Descrição |
|---|---|
payloadObjeto |
Carga representando os usuários a serem adicionados.
schemastringEMAIL_SHA256, PHONE_SHA256, MOBILE_ADVERTISER_ID. Também é possível passar uma matriz de várias chaves para correspondência de várias chaves. Estes são os tipos de chave compatíveis: EXTERN_IDEMAILPHONEGENDOBYDOBMDOBDLNFNFICTSTZIPMADIDCOUNTRYA matriz de várias chaves tem o formato ["EMAIL", "LN", "FN", "ZIP"]is_rawboolean
A chave é bruta? Se as chaves forem combinacionais, como "LN_FN_ZIP", defina isso como false. Caso contrário, defina como true. O padrão é falso.
datalist<JSON array>
Matriz com dados dos usuários. Se o recurso de várias chaves for usado, uma matriz bidimensional da forma [["<HASHED_EMAIL>", "<HASHED_FN>", "<HASHED_LN>", "<HASHED_ZIP>"], ["", "<HASHED_FN>", "<HASHED_LN>", "<HASHED_ZIP>"]] será transmitida. Caso uma chave seja desconhecida, ela deverá ficar em branco.
app_idslist<int>
Identificações de apps usadas pelos usuários que estão sendo carregados. Este campo é obrigatório quando schema é um UID do Facebook e os IDs foram coletados por uma integração do app. Por exemplo, [1234,5678].
page_idslist<Page ID>
Identificações de Página usadas pelos usuários que estão sendo carregados. Este campo é obrigatório quando schema é um UID do Facebook e os IDs foram coletados por uma integração de webhook de Página, por exemplo, [1234,5678].
ig_account_idslist<numeric string or integer>data_sourceObjeto
Indica por qual método o público personalizado foi criado, definido por type e subtype de data_source.
typeenum {UNKNOWN, FILE_IMPORTED, EVENT_BASED, SEED_BASED, THIRD_PARTY_IMPORTED, COPY_PASTE, CONTACT_IMPORTER, HOUSEHOLD_AUDIENCE}
Tipo de público personalizado.
sub_typeenum {ANYTHING, NOTHING, HASHES, USER_IDS, HASHES_OR_USER_IDS, MOBILE_ADVERTISER_IDS, EXTERNAL_IDS, MULTI_HASHES, TOKENS, EXTERNAL_IDS_MIX, HOUSEHOLD_EXPANSION, SUBSCRIBER_LIST, WEB_PIXEL_HITS, MOBILE_APP_EVENTS, MOBILE_APP_COMBINATION_EVENTS, VIDEO_EVENTS, WEB_PIXEL_COMBINATION_EVENTS, PLATFORM, MULTI_DATA_EVENTS, IG_BUSINESS_EVENTS, STORE_VISIT_EVENTS, INSTANT_ARTICLE_EVENTS, FB_EVENT_SIGNALS, FACEBOOK_WIFI_EVENTS, AR_EXPERIENCE_EVENTS, AR_EFFECTS_EVENTS, MESSENGER_ONSITE_SUBSCRIPTION, WHATSAPP_SUBSCRIBER_POOL, MARKETPLACE_LISTINGS, AD_CAMPAIGN, GROUP_EVENTS, ENGAGEMENT_EVENT_USERS, CUSTOM_AUDIENCE_USERS, PAGE_FANS, CONVERSION_PIXEL_HITS, APP_USERS, S_EXPR, DYNAMIC_RULE, CAMPAIGN_CONVERSIONS, WEB_PIXEL_HITS_CUSTOM_AUDIENCE_USERS, MOBILE_APP_CUSTOM_AUDIENCE_USERS, COMBINATION_CUSTOM_AUDIENCE_USERS, VIDEO_EVENT_USERS, FB_PIXEL_HITS, IG_PROMOTED_POST, PLACE_VISITS, OFFLINE_EVENT_USERS, EXPANDED_AUDIENCE, SEED_LIST, PARTNER_CATEGORY_USERS, PAGE_SMART_AUDIENCE, MULTICOUNTRY_COMBINATION, PLATFORM_USERS, MULTI_EVENT_SOURCE, SMART_AUDIENCE, LOOKALIKE_PLATFORM, SIGNAL_SOURCE, MAIL_CHIMP_EMAIL_HASHES, CONSTANT_CONTACTS_EMAIL_HASHES, COPY_PASTE_EMAIL_HASHES, CUSTOM_DATA_TARGETING, CONTACT_IMPORTER, DATA_FILE}
Subtipo do público personalizado.
Show child parameters metadataObjetocalculated_datedatetimeschema_versionstringShow child parameters Show child parameters |
sessionObjeto |
São informações sobre a sessão. As sessões são usadas quando você tem muitos usuários para carregar. Por exemplo, se você tiver 1 milhão de usuários para carregar, será preciso dividi-los em pelo menos 100 solicitações, já que esse é o máximo que cada solicitação pode aceitar. Especifique as informações da sessão para verificar se ela foi concluída ou não.
session_idint64
Identificador da sessão gerado pelo anunciante, usado para rastrear a sessão. Deve ser único na mesma conta de anúncios.
estimated_num_totalint64
O total estimado de usuários que serão carregados na sessão. Esse número é usado pelos sistemas do Facebook para processar a sessão de forma mais adequada.
batch_seqint64
Um número de sequência baseado em 1 para identificar a solicitação na sessão.
last_batch_flagbooleantrue indica que a solicitação é a última na sessão. É necessário marcar a última solicitação. Caso contrário, o Facebook não saberá que a sessão foi encerrada.
Show child parameters |
Tipo de retorno
Esse ponto de extremidade é compatível com read-after-write e lê o nó no qual você fez um POST.
Struct {
audience_id: numeric string,
session_id: numeric string,
num_received: int32,
num_invalid_entries: int32,
invalid_entry_samples: Map {
string: string},
subscription_info: Struct {
whatsapp: Struct {
error: Struct {
message: string,
code: int32,
},
num_subscribers_received: int32,
num_subscribers_invalid_entries: int32,
invalid_subscribers_entry_samples: Map {
string: string},
},
},
}
Códigos de erro
| Código de erro | Descrição |
|---|---|
100 | Parâmetro inválido. |
200 | Erro de permissões |
2650 | Falha ao atualizar o público personalizado. |
190 | Token de acesso inválido do OAuth 2.0 |
368 | A ação tentada foi considerada abusiva ou não é permitida |
2635 | Você está chamando uma versão obsoleta da API de Anúncios. Atualize para a versão mais recente. |
105 | O número de parâmetros excedeu o máximo permitido para a operação. |
194 | Pelo menos um parâmetro obrigatório está ausente. |
Exclusão
/{custom_audience_id}/users
Você pode desassociar um usuário de um público personalizado fazendo uma solicitação DELETE para /{custom_audience_id}/users.
Parâmetros
| Parâmetro | Descrição |
|---|---|
payloadObjeto |
Carga representando os usuários a serem excluídos.
schemastringEMAIL_SHA256, PHONE_SHA256, MOBILE_ADVERTISER_ID. Também é possível passar uma matriz de várias chaves para correspondência de várias chaves. Confira os tipos de chaves compatíveis: EXTERN_IDEMAILPHONEGENDOBYDOBMDOBDLNFNFICTSTZIPMADIDCOUNTRYA matriz de várias chaves tem o formato ["EMAIL", "LN", "FN", "ZIP"]is_rawboolean
A chave é bruta? Se as chaves forem combinacionais, como "LN_FN_ZIP", defina essa opção como false. Caso contrário, defina como true. O padrão é falso.
datalist<JSON array>
Matriz com dados dos usuários. Se o recurso de várias chaves for usado, uma matriz bidimensional da forma [["<HASHED_EMAIL>", "<HASHED_FN>", "<HASHED_LN>", "<HASHED_ZIP>"], ["", "<HASHED_FN>", "<HASHED_LN>", "<HASHED_ZIP>"]] será transmitida. Caso uma chave seja desconhecida, ela deverá ficar em branco.
app_idslist<int>
Identificações de apps usadas pelos usuários que estão sendo carregados. Este campo é obrigatório quando schema é um UID do Facebook e os IDs foram coletados por uma integração do app. Por exemplo, [1234,5678].
page_idslist<Page ID>
Identificações de Páginas usadas pelos usuários que estão sendo carregados. Este campo é obrigatório quando schema é um UID do Facebook e os IDs foram coletados por uma integração de webhook de Página, por exemplo, [1234,5678].
ig_account_idslist<numeric string or integer>data_sourceObjeto
Indica por qual método o público personalizado foi criado, definido por type e subtype do data_sourcetypeenum {UNKNOWN, FILE_IMPORTED, EVENT_BASED, SEED_BASED, THIRD_PARTY_IMPORTED, COPY_PASTE, CONTACT_IMPORTER, HOUSEHOLD_AUDIENCE}
Tipo de público personalizado.
sub_typeenum {ANYTHING, NOTHING, HASHES, USER_IDS, HASHES_OR_USER_IDS, MOBILE_ADVERTISER_IDS, EXTERNAL_IDS, MULTI_HASHES, TOKENS, EXTERNAL_IDS_MIX, HOUSEHOLD_EXPANSION, SUBSCRIBER_LIST, WEB_PIXEL_HITS, MOBILE_APP_EVENTS, MOBILE_APP_COMBINATION_EVENTS, VIDEO_EVENTS, WEB_PIXEL_COMBINATION_EVENTS, PLATFORM, MULTI_DATA_EVENTS, IG_BUSINESS_EVENTS, STORE_VISIT_EVENTS, INSTANT_ARTICLE_EVENTS, FB_EVENT_SIGNALS, FACEBOOK_WIFI_EVENTS, AR_EXPERIENCE_EVENTS, AR_EFFECTS_EVENTS, MESSENGER_ONSITE_SUBSCRIPTION, WHATSAPP_SUBSCRIBER_POOL, MARKETPLACE_LISTINGS, AD_CAMPAIGN, GROUP_EVENTS, ENGAGEMENT_EVENT_USERS, CUSTOM_AUDIENCE_USERS, PAGE_FANS, CONVERSION_PIXEL_HITS, APP_USERS, S_EXPR, DYNAMIC_RULE, CAMPAIGN_CONVERSIONS, WEB_PIXEL_HITS_CUSTOM_AUDIENCE_USERS, MOBILE_APP_CUSTOM_AUDIENCE_USERS, COMBINATION_CUSTOM_AUDIENCE_USERS, VIDEO_EVENT_USERS, FB_PIXEL_HITS, IG_PROMOTED_POST, PLACE_VISITS, OFFLINE_EVENT_USERS, EXPANDED_AUDIENCE, SEED_LIST, PARTNER_CATEGORY_USERS, PAGE_SMART_AUDIENCE, MULTICOUNTRY_COMBINATION, PLATFORM_USERS, MULTI_EVENT_SOURCE, SMART_AUDIENCE, LOOKALIKE_PLATFORM, SIGNAL_SOURCE, MAIL_CHIMP_EMAIL_HASHES, CONSTANT_CONTACTS_EMAIL_HASHES, COPY_PASTE_EMAIL_HASHES, CUSTOM_DATA_TARGETING, CONTACT_IMPORTER, DATA_FILE}
Subtipo do público personalizado.
Show child parameters metadataObjetocalculated_datedatetimeschema_versionstringShow child parameters Show child parameters |
sessionObjeto |
Informações sobre a sessão. As sessões são usadas quando você precisa carregar muitos usuários. Por exemplo, se você tiver 1 milhão de usuários para carregar, será preciso dividi-los em pelo menos 100 solicitações, já que cada solicitação pode incluir apenas 10 mil usuários. Especifique as informações da sessão para verificar se ela foi concluída ou não.
session_idint64
Identificador de sessão gerado pelo anunciante, usado para rastrear a sessão. Deve ser único na mesma conta de anúncios.
estimated_num_totalint64
O total estimado de usuários que serão carregados na sessão. Esse número é usado pelos sistemas do Facebook para processar a sessão de forma mais adequada.
batch_seqint64
Um número de sequência baseado em 1 para identificar a solicitação na sessão.
last_batch_flagbooleantrue indica que a solicitação é a última na sessão. É necessário marcar a última solicitação. Caso contrário, o Facebook não saberá que a sessão foi encerrada.
Show child parameters |
Tipo de retorno
Struct {
audience_id: numeric string,
session_id: numeric string,
num_received: int32,
num_invalid_entries: int32,
invalid_entry_samples: Map {
string: string},
subscription_info: Struct {
whatsapp: Struct {
error: Struct {
message: string,
code: int32,
},
num_subscribers_received: int32,
num_subscribers_invalid_entries: int32,
invalid_subscribers_entry_samples: Map {
string: string},
},
},
}
Códigos de erro
| Código de erro | Descrição |
|---|---|
80003 | Houve muitas chamadas para esta conta de anúncios. Espere um pouco e tente de novo. Para obter mais informações, consulte /docs/graph-api/overview/rate-limiting#custom-audience. |
100 | Parâmetro inválido. |
200 | Erro de permissões |
2650 | Falha ao atualizar o público personalizado. |
190 | Token de acesso inválido do OAuth 2.0 |
2635 | Você está chamando uma versão obsoleta da API de Anúncios. Atualize para a versão mais recente. |
368 | A ação tentada foi considerada abusiva ou não é permitida |
Você achou esta página útil?
