Ciblez les personnes qui présentent le plus de caractéristiques communes avec vos clients existants. Pour créer des audiences similaires, Facebook se base sur plusieurs ensembles de personnes constituant des « audiences sources » pour générer une audience composée de personnes présentant des caractéristiques similaires. Vous pouvez utiliser les audiences similaires pour tous les objectifs commerciaux : cibler les personnes similaires à vos clients pour l’acquisition de fans, l’enregistrement de sites, les achats hors Facebook, les réclamations de coupons ou simplement pour augmenter la notoriété d’une marque.
Les audiences sources peuvent appartenir à l’une des catégories suivantes :
Facebook actualise les membres d’une audience similaire tous les trois jours si cette audience appartient à un groupe publicitaire.
Le remplissage complet d’audiences similaires peut prendre entre 1 et 6 heures. Pendant cette opération, vous pouvez créer et diffuser des ensembles de publicités qui ciblent l’audience. Dès que l’audience est prête, Facebook commence la diffusion à destination des personnes qui la composent. La diffusion des publicités va alors se mettre à niveau et fonctionner normalement. Consultez la section État de la diffusion. Créez une audience similaire dans : https://graph.facebook.com/{API_VERSION}/act_{AD_ACCOUNT_ID}/customaudiences
.
Exemple d’appel de création pour une audience similaire à partir d’une audience personnalisée :
use FacebookAds\Object\CustomAudience;
use FacebookAds\Object\Fields\CustomAudienceFields;
use FacebookAds\Object\Values\CustomAudienceSubtypes;
$lookalike = new CustomAudience(null, 'act_<AD_ACCOUNT_ID>');
$lookalike->setData(array(
CustomAudienceFields::NAME => 'My lookalike audience',
CustomAudienceFields::SUBTYPE => CustomAudienceSubtypes::LOOKALIKE,
CustomAudienceFields::ORIGIN_AUDIENCE_ID => <SEED_AUDIENCE_ID>,
CustomAudienceFields::LOOKALIKE_SPEC => array(
'type' => 'similarity',
'country' => 'US',
),
));
$lookalike->create();
from facebookads.adobjects.customaudience import CustomAudience
lookalike = CustomAudience(parent_id='act_<AD_ACCOUNT_ID>')
lookalike.update({
CustomAudience.Field.name: 'My lookalike audience',
CustomAudience.Field.subtype: CustomAudience.Subtype.lookalike,
CustomAudience.Field.origin_audience_id: '<SEED_AUDIENCE_ID>',
CustomAudience.Field.lookalike_spec: {
'type': 'similarity',
'country': 'US',
},
})
lookalike.remote_create()
print(lookalike)
curl \
-F 'name=My lookalike audience' \
-F 'subtype=LOOKALIKE' \
-F 'origin_audience_id=<SEED_AUDIENCE_ID>' \
-F 'lookalike_spec={"type":"similarity","country":"US"}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v2.11/act_<AD_ACCOUNT_ID>/customaudiences
Pour créer des audiences similaires avec le SDK Ads pour PHP ou le SDK Ads pour Python, utilisez CustomAudience
.
La réponse contient les éléments suivants :
Nom | Description |
---|---|
type : nombre entier | ID de l’audience similaire |
Si l’une de vos audiences personnalisées est composée d’au moins 100 personnes, vous pouvez vous en servir pour créer des audiences similaires. Cela inclut les audiences personnalisées pour votre site web et les audiences personnalisées pour votre application mobile.
Nom | Description |
---|---|
type : chaîne | Obligatoire. Nom de l’audience personnalisée. |
type : long | Obligatoire. ID de l’audience personnalisée. Les audiences d’origine doivent comporter au moins 100 membres. |
type : tableau | Obligatoire. Voir la description ci-dessous. |
type : chaîne | Obligatoire. Définissez
|
type : virgule flottante | Facultatif. Pourcentage de départ pour une audience similaire. Par exemple, les valeurs |
type : virgule flottante | Obligatoire. Définissez
|
type : booléen | Facultatif. Au moins 100 membres de l’audience source d’un pays. Dans le cas contraire, la valeur |
type : chaîne | Obligatoire. Définissez Rechercher les membres d’une audience similaire dans ce pays. |
type : tableau | Obligatoire. Rechercher les membres d’une audience dans ces lieux. Liste de pays ou de groupes de pays comme l’ |
type : tableau | Obligatoire. Au moins une entrée sous Lieux à inclure. |
type : tableau de chaînes | Facultatif. Pays cibles. Tableau d’indicatifs pays ; consultez la section API Targeting Search, Pays. Exemple : |
type : tableau de chaînes | Facultatif. Pays cibles dans des régions géographiques et des zones de libre-échange. Tableau de codes de groupes de pays. Pour voir les options complètes, consultez Ciblage, Lieu, |
type : tableau | Facultatif. Lieux à exclure. |
type : tableau de chaînes | Facultatif. Identique à |
type : tableau de chaînes | Facultatif. Identique à |
Vous pouvez optimiser votre audience en optant pour des critères de similarité ou d’extension de la couverture.
Au lieu d’utiliser des types, vous pouvez définir manuellement le ratio
pour représenter les x premiers % de l’audience dans le pays sélectionné. Le ratio
doit être compris entre 1 % et 20 %, avec des intervalles de 1 %.
Facebook propose des audiences similaires pour la conversion d’ensembles de publicités et de campagnes afin de cibler les personnes semblables à celles qui avaient réalisé des conversions lors de campagnes ou d’ensembles de publicités précédents ou actuels, par exemple des campagnes ou des publicités d’optimisation des conversions. Nous mesurons les conversions selon un type de campagne ou d’ensemble de publicités figurant dans les spécifications de conversion. Vous pouvez, par exemple, cibler les personnes qui ont effectué une action sur votre site web ou qui ont installé votre application dans les 28 jours après avoir cliqué sur votre publicité.
use FacebookAds\Object\CustomAudience;
use FacebookAds\Object\Fields\CustomAudienceFields;
use FacebookAds\Object\Values\CustomAudienceSubtypes;
$lookalike = new CustomAudience(null, 'act_<AD_ACCOUNT_ID>');
$lookalike->setData(array(
CustomAudienceFields::SUBTYPE => CustomAudienceSubtypes::LOOKALIKE,
CustomAudienceFields::LOOKALIKE_SPEC => array(
'origin_ids' => <CAMPAIGN_ID>,
'starting_ratio' => 0.03,
'ratio' => 0.05,
'conversion_type' => 'campaign_conversions',
'country' => 'US',
),
));
$lookalike->create();
from facebookads.adobjects.customaudience import CustomAudience
lookalike = CustomAudience(parent_id='act_<AD_ACCOUNT_ID>')
lookalike.update({
CustomAudience.Field.subtype: CustomAudience.Subtype.lookalike,
CustomAudience.Field.lookalike_spec: {
'origin_ids': '<CAMPAIGN_ID>',
'starting_ratio': 0.03,
'ratio': 0.05,
'conversion_type': 'campaign_conversions',
'country': 'US',
},
})
lookalike.remote_create()
print(lookalike)
curl \
-F 'subtype=LOOKALIKE' \
-F 'lookalike_spec={
"origin_ids": "<CAMPAIGN_ID>",
"starting_ratio": 0.03,
"ratio": 0.05,
"conversion_type": "campaign_conversions",
"country": "US"
}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v2.11/act_<AD_ACCOUNT_ID>/customaudiences
Vous devez enregistrer au moins 100 conversions uniques pour vos campagnes ou ensembles de publicités. Plus le nombre de visiteurs ayant déjà réalisé une conversion est élevé, meilleur sera le modèle prédictif ; nous suggérons au moins 200 membres ayant réalisé une conversion. Vous devez également sélectionner des campagnes ou des ensembles de publicités avec des objectifs similaires.
Pour créer cette audience similaire, précisez un ou plusieurs de vos ensembles de publicités ou campagnes. Indiquez, par exemple, une campagne et deux ensembles de publicités d’une autre campagne.
Facebook utilise jusqu’à 180 jours de données de conversion historiques et identifie, comme exemples, les personnes qui réalisent des conversions sur vos campagnes et ensembles de publicités. Nous entraînons le modèle de prévision, puis nous créons une audience similaire. Facebook met continuellement à jour le modèle de prévision sous-jacent à mesure que les campagnes ou ensembles de publicités enregistrent de nouvelles conversions.
Nom | Description |
---|---|
type : tableau | Obligatoire. Voir la description ci-dessous. |
type : tableau de nombres entiers | Obligatoire. Tableau d’ID d’objets publicitaires. Les personnes qui réalisent une conversion relative à ces publicités sont utilisées pour modéliser une audience similaire. Un ou plusieurs ID de campagne ou ID d’ensemble de publicités, ou un mélange des deux. |
type : chaîne | Obligatoire.
|
type : chaîne | Obligatoire. Pays où rechercher des membres similaires. |
type : booléen | Facultatif. Au moins 100 membres de l’audience initiale d’un pays. Dans le cas contraire, la valeur |
type : virgule flottante | Facultatif. Pourcentage de début pour une audience similaire. Par exemple, |
type : virgule flottante | Obligatoire. Plage de valeurs entre |
Actuellement, les types de conversion de campagne suivants sont éligibles pour les audiences similaires :
Vous pouvez créer une audience similaire sur la base des personnes qui aiment votre Page :
use FacebookAds\Object\CustomAudience;
use FacebookAds\Object\Fields\CustomAudienceFields;
use FacebookAds\Object\Values\CustomAudienceSubtypes;
$lookalike = new CustomAudience(null, 'act_<AD_ACCOUNT_ID>');
$lookalike->setData(array(
CustomAudienceFields::SUBTYPE => CustomAudienceSubtypes::LOOKALIKE,
CustomAudienceFields::LOOKALIKE_SPEC => array(
'ratio' => 0.01,
'country' => 'US',
'page_id' => <PAGE_ID>,
'conversion_type' => 'page_like',
),
));
$lookalike->create();
from facebookads.adobjects.customaudience import CustomAudience
lookalike = CustomAudience(parent_id='act_<AD_ACCOUNT_ID>')
lookalike.update({
CustomAudience.Field.name: 'My lookalike audience',
CustomAudience.Field.subtype: CustomAudience.Subtype.lookalike,
CustomAudience.Field.lookalike_spec: {
'ratio': 0.01,
'country': 'US',
'page_id': '<PAGE_ID>',
'conversion_type': 'page_like',
},
})
lookalike.remote_create()
print(lookalike)
curl \
-F 'subtype=LOOKALIKE' \
-F 'lookalike_spec={
"ratio": 0.01,
"country": "US",
"page_id": "<PAGE_ID>",
"conversion_type": "page_like"
}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v2.11/act_<AD_ACCOUNT_ID>/customaudiences
Nom | Description |
---|---|
type : tableau | Obligatoire. Voir la description ci-dessous. |
type : nombre entier | Obligatoire. ID Facebook de la Page dont les fans seront utilisés pour constituer l’audience similaire. |
type : chaîne | Obligatoire.
|
type : chaîne | Obligatoire. Pays dans lequel rechercher des personnes ayant des caractéristiques similaires. Valeur par défaut : US (États-Unis). |
type : booléen | Facultatif. Vous avez besoin d’au moins 100 membres de l’audience source d’un pays. Si ce minimum n’est pas satisfait, la valeur |
type : virgule flottante | Facultatif. Pourcentage de départ de l’audience similaire. Par exemple, une valeur starting_ratio de 0,01 et une valeur ratio de 0,02 créent une audience similaire comprise entre 1 % et 2 % d’un segment similaire. La valeur starting_ratio doit toujours être inférieure à celle définie pour ratio. |
type : virgule flottante | Obligatoire. Plage de valeurs entre 0,01 et 0,20. Indique la proportion du pays que l’audience similaire doit cibler. |
Le ciblage d’audiences similaires est identique au ciblage d’audiences personnalisées. Consultez la section Audiences personnalisées, Ciblage. Cela s’applique également au ciblage par exclusion et au ciblage AND
conjoint. Pour effectuer un ciblage lors de la création d’une publicité, procédez comme suit :
use FacebookAds\Object\AdSet;
use FacebookAds\Object\Fields\AdSetFields;
use FacebookAds\Object\Values\AdSetBillingEventValues;
use FacebookAds\Object\Values\AdSetOptimizationGoalValues;
use FacebookAds\Object\Fields\TargetingFields;
use FacebookAds\Object\Targeting;
$adset = new AdSet(null, 'act_<AD_ACCOUNT_ID>');
$adset->setData(array(
AdSetFields::NAME => 'My AdSet',
AdSetFields::OPTIMIZATION_GOAL => AdSetOptimizationGoalValues::REACH,
AdSetFields::BILLING_EVENT => AdSetBillingEventValues::IMPRESSIONS,
AdSetFields::BID_AMOUNT => 2,
AdSetFields::DAILY_BUDGET => 1000,
AdSetFields::CAMPAIGN_ID => <CAMPAIGN_ID>,
AdSetFields::TARGETING => (new Targeting())->setData(array(
TargetingFields::GEO_LOCATIONS => array(
'countries' => array('US'),
),
TargetingFields::CUSTOM_AUDIENCES => array(
array(
'id' => <LOOKALIKE_AUDIENCE_ID>,
),
),
)),
));
$adset->create(array(
AdSet::STATUS_PARAM_NAME => AdSet::STATUS_ACTIVE,
));
from facebookads.adobjects.adset import AdSet
adset = AdSet(parent_id='act_<AD_ACCOUNT_ID>')
adset.update({
AdSet.Field.name: 'My Adset',
AdSet.Field.daily_budget: 10000,
AdSet.Field.campaign_id: '<CAMPAIGN_ID>',
AdSet.Field.optimization_goal: AdSet.OptimizationGoal.link_clicks,
AdSet.Field.billing_event: AdSet.BillingEvent.link_clicks,
AdSet.Field.bid_amount: 150,
AdSet.Field.daily_budget: 2000,
AdSet.Field.targeting: {
'geo_locations': {
'countries': ['US'],
},
'custom_audiences': [
{
'id': <LOOKALIKE_AUDIENCE_ID>,
},
],
},
})
adset.remote_create(params={
'status': AdSet.Status.paused,
})
AdSet adSet = new AdAccount(act_<AD_ACCOUNT_ID>, context).createAdSet()
.setName("My AdSet")
.setOptimizationGoal(AdSet.EnumOptimizationGoal.VALUE_REACH)
.setBillingEvent(AdSet.EnumBillingEvent.VALUE_IMPRESSIONS)
.setBidAmount(2L)
.setDailyBudget(1000L)
.setCampaignId(<CAMPAIGN_ID>)
.setTargeting(
new Targeting()
.setFieldCustomAudiences(Arrays.asList(
new IDName()
.setFieldId(<LOOKALIKE_AUDIENCE_ID>)
))
.setFieldGeoLocations(
new TargetingGeoLocation()
.setFieldCountries(Arrays.asList("US"))
)
)
.setStatus(AdSet.EnumStatus.VALUE_ACTIVE)
.execute();
String ad_set_id = adSet.getId();
curl \
-F 'name=My AdSet' \
-F 'optimization_goal=REACH' \
-F 'billing_event=IMPRESSIONS' \
-F 'bid_amount=2' \
-F 'daily_budget=1000' \
-F 'campaign_id=<CAMPAIGN_ID>' \
-F 'targeting={
"custom_audiences": [{"id":"<LOOKALIKE_AUDIENCE_ID>"}],
"geo_locations": {"countries":["US"]}
}' \
-F 'status=ACTIVE' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v2.11/act_<AD_ACCOUNT_ID>/adsets
Vous trouverez plus d’exemples dans les spécifications de ciblage.
Vous pouvez obtenir des informations sur les audiences personnalisées utilisées pour créer des audiences similaires, ainsi que sur les audiences similaires. Nous renvoyons les mêmes champs que pour les audiences personnalisées. Vous verrez ci-dessous un exemple de réponse pour une audience personnalisée utilisée pour créer des audiences similaires. lookalike_audience_ids
indique quelles audiences similaires ont été générées à partir de cette audience.
{ "id": "6006164557194", "account_id": 12345, "approximate_count": 816400, "lookalike_audience_ids": [ 6006183285954, 6006183285955 ], "name": "Boys Apparel", "parent_audience_id": 0, "parent_category": "Custom", "status": "ready", "subtype": "CUSTOM", "type": 4, "type_name": "Advertiser Generated", "time_updated": 1362439491 },
Les audiences similaires contiennent un subtype
de 2. Nous renvoyons également une lookalike_spec
, un tableau au format suivant :
Nom | Description |
---|---|
type : chaîne |
|
type : virgule flottante | Renvoyé si le |
type : virgule flottante | Multiple de |
type : chaîne | Indicatif pays |
type : tableau | Voir la description ci-dessous. |
type : booléen |
|
type : nombre entier | ID de l’origine |
type : chaîne | Nom de l’origine |
type : chaîne |
|
type : tableau de chaînes | Tous les pays utilisés pour créer l’audience |
Voici une autre audience dans laquelle le subtype
est LOOKALIKE
:
{ "id": "6006183285954", "account_id": 12345, "approximate_count": 1782100, "name": "Boys Apparel_lookalike_US_Similarity", "origin_audience_id": 6006567610735, "parent_audience_id": 0, "parent_category": "Custom", "status": "ready", "subtype": "LOOKALIKE", "type": 4, "type_name": "Advertiser Generated", "time_updated": 1362506552 },
Après la création d’une audience similaire, un ID d’audience personnalisée est renvoyé. Le remplissage complet d’une audience peut prendre approximativement 1 heure. Vous pouvez obtenir l’état sur : /{lookalike_audience_ID}?fields=delivery_status
. Cela renvoie une réponse JSON avec delivery_status
ou le code 200 si une audience est en cours de remplissage :
"delivery_status": { "code": 200, "description": "This audience is ready for use." },
À des fins de test, vous pouvez consulter le statut de la liste avec le Gestionnaire de publicités.
Pour supprimer une audience similaire, procédez comme pour les audiences personnalisées.
Une audience similaire est considérée inactive lorsqu’elle n’a pas été utilisée dans des publicités actives depuis 90 jours. Les audiences similaires inactives ont des approximate_count
, operation_status
et delivery_estimate
différents.
Champ | Modifications concernant les audiences similaires inactives |
---|---|
| Vous ne pouvez pas récupérer de taille. Un appel pour ce champ renvoie |
|
|
| Vous ne pouvez pas récupérer d’estimation de la diffusion. Un appel pour ce champ renvoie |
| Quand le paramètre |
Vous pouvez toujours lancer une campagne en utilisant une audience similaire inactive. Les informations sur l’estimation de la couverture sont disponibles après la publication de votre nouvelle publicité.
Depuis le 8 juin 2021, les audiences des annonceurs qui sont inactives depuis plus de deux ans sont automatiquement placées dans la catégorie « Audiences arrivées à expiration ». Cela signifie que dès qu’une audience atteint deux ans d’inactivité dans un ensemble de publicités actif, elle est automatiquement marquée comme « Audience arrivée à expiration » et le champ delete_time
indique la date estimée à laquelle l’audience sera supprimée (90 jours après son changement de catégorie).
Vous avez alors la possibilité de supprimer l’audience avant cette date, ou d’utiliser l’audience dans un ensemble de publicités actif pour empêcher sa suppression. Pour savoir quelles audiences sont arrivées à expiration, vous pouvez à tout moment utiliser les filtres des champs operation_status
ou delete_time
.
Pour plus d’informations, consultez la documentation Vue d’ensemble des audiences personnalisées.
MISE À JOUR DU 28 AVRIL 2021 : la suppression des paramètres location_spec
et country
du processus de création des audiences similaires a été différée. La date d’entrée en vigueur de cette modification sera communiquée prochainement.
Les paramètres location_spec
et country
vont être supprimés du processus de création des audiences similaires. La zone géographique concernée par une audience similaire correspondra au pays figurant dans la spécification de ciblage de la campagne. La zone ciblée ne fera pas partie de la spécification de l’audience similaire. L’estimation de la couverture de la campagne utilisant une audience similaire nouvellement créée sera remplie uniquement quelques heures après la publication de la publicité.
Compte tenu de cette modification, l’impact sur les campagnes existantes sera nul. Ce critère n’aura une incidence que sur les campagnes nouvelles et modifiées.
Nous convertirons automatiquement les anciennes audiences similaires en de nouvelles audiences similaires sans zones géographiques cibles.
Point de terminaison : act_{AD_ACCOUNT_ID}/customaudiences
Exemple de requête
curl POST \ -F 'name=My lookalike audience' \ -F 'subtype=LOOKALIKE' \ -F 'origin_audience_id=<SEED_AUDIENCE_ID>' \ -F ‘lookalike_spec={ "is_financial_service":false, "allow_international_seeds":true, "ratio":0.01, "type":"custom_ratio"} ’}\ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/v2.11/act_<AD_ACCOUNT_ID>/customaudiences
Les paramètres suivants seront ignorés s’ils n’ont pas été transmis pendant la création :
lookalike_spec.country
lookalike_spec.location_spec
lookalike_spec.location_spec.geo_locations
lookalike_spec.location_spec.geo_locations.countries
lookalike_spec.location_spec.geo_locations.country_groups
lookalike_spec.location_spec.excluded_geo_locations
lookalike_spec.location_spec.excluded_geo_locations.countries
lookalike_spec.location_spec.excluded_geo_locations.country_groups
Point de terminaison : act_{AD_ACCOUNT_ID}?fields=approximate_count
Il n’y aura pas de taille associée aux nouvelles audiences similaires, et le champ approximate_count
renverra -1
pour toutes les audiences similaires.
Exemple de réponse
{ "approximate_count": -1, "id": "6126486105659", }
Points de terminaison :
{AD_ACCOUNT_ID}?fields=delivery_status
{AD_ACCOUNT_ID}?fields=operation_status
Le champ delivery_status
pour les anciennes audiences similaires avec des spécifications géographiques renverra un code 400
avec une description This audience is disabled.
. Pour les nouvelles audiences similaires, il renverra un code 200
.
Le champ operation_status
renverra une notification de retrait pour les anciennes audiences similaires avec des spécifications géographiques. Pour les nouvelles audiences similaires, il renverra un code 200
et une réponse de description Normal
.
Pour en savoir plus sur ces champs, consultez la page Audiences personnalisées.
Nous mettrons automatiquement à jour les publicités pour utiliser les nouvelles audiences similaires si le ciblage des campagnes existantes contenant l’ancienne audience similaire est modifié. L’ancienne audience similaire ne pourra plus être utilisée dans les campagnes publicitaires nouvellement créées.
Comme les spécifications géographiques sont supprimées du processus de création d’audiences similaires, vous devrez définir des cibles géographiques pendant la création des ensembles de publicités. La création d’un ensemble de publicités sans ciblage géographique provoquera une erreur.
Toutes les modifications ci-dessus seront également applicables si les audiences sont incluses dans les excluded_custom_audiences
, flexible_spec
et exclusions
de la campagne.
Point de terminaison : act_{AD_ACCOUNT_ID}/adsets
Exemple de requête
curl POST \ -F 'targeting={ "geo_locations":{ "countries":["US"], }, "age_min":25, "age_max":40, "custom_audiences":[{"id": <CUSTOM_AUDIENCE_ID>}] ‘}\ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/v2.11/act_<AD_ACCOUNT_ID>/adsets
La création d’un ensemble de publicités sans ciblage géographique provoquera une erreur.
{ "error": { "message": "Invalid parameter", "type": "FacebookApiException", "code": 100, "error_data": { "blame_field_specs": [["targeting" ] ] }, "error_subcode": 192342134, "is_transient": false, "error_user_title": "Missing Location while using Lookalike", "error_user_msg": "You need to use a location with your lookalike audience.", "fbtrace_id": "F78cCCJoZPx" }, "__fb_trace_id__": "F78cCCJoZPx", "__www_request_id__": "AcwlIc7_uK5uTXjzjIa38yc" }
Si vous tentez de modifier un ensemble de publicités contenant une ancienne audience similaire partagée et que vous ne disposez pas d’une nouvelle audience similaire correspondante dans le compte publicitaire propriétaire, une erreur se produira. Demandez à ce que le compte publicitaire propriétaire partage la nouvelle audience similaire avec vous pour résoudre le problème.
{ "error": { "message": "Invalid parameter", "type": "FacebookApiException", "code": 100, "error_data": { "blame_field_specs": [["targeting" ] ] }, "error_subcode": 192342135, "is_transient": false, "error_user_title": "", "error_user_msg": "Please ask the owner of the audience 1234 to share the new lookalike which does not contain location with you. You will be able to use the new audience" "fbtrace_id": "F78cCCJoZPx" }, "__fb_trace_id__": "F78cCCJoZPx", "__www_request_id__": "AcwlIc7_uK5uTXjzjIa38yc" }
Lors de la période de déploiement de ces modifications, le partage d’audiences similaires entre les comptes publicitaires concernés par le déploiement et ceux qui ne le sont pas n’est pas pris en charge par l’API. Pour gérer les partages, veuillez utiliser le Gestionnaire d’audience. À compter du 24 mai 2021, vous pourrez continuer d’utiliser le partage via l’API dans le document suivant destiné aux développeurs pour partager les nouvelles audiences similaires entre les comptes publicitaires.
Point de terminaison :{AD_ACCOUNT_ID}/adaccounts?adaccounts={SHARED_TO_AD_ACCOUNT_ID}
Points de terminaison :
act_{AD_ACCOUNT_ID}/reachestimate
act_{AD_ACCOUNT_ID}/delivery_estimate
Ces points de terminaison renverront un nouveau paramètre targeting_status
avec l’une des descriptions suivantes :
lookalike_container_without_country
: aucun pays n’est spécifié dans le ciblage de campagne d’une nouvelle audience similaire. Pour que vous puissiez voir une estimation du nombre d’utilisateurs, un pays doit être spécifié.lookalike_container_without_delivery_lookalike
: une nouvelle audience similaire ne dispose d’aucune audience similaire backend correspondante. La nouvelle audience similaire doit être utilisée dans un ensemble de publicités pour avoir une couverture réelle.none
: il n’existe aucun problème avec la couverture.Le point de terminaison reachestimate
renverra -1
pour le paramètre users
à la première utilisation d’une nouvelle audience similaire et d’un nouveau pays cible. L’estimation du nombre d’utilisateurs sera ensuite renvoyée.
Les paramètres estimate_dau
et estimate_mau
renverront -1
pour le paramètre users
à la première utilisation d’une nouvelle audience similaire et d’un nouveau pays cible. L’estimation du nombre d’utilisateurs sera ensuite renvoyée.
Exemples de réponses
// Reach estimate response { "users": -1, "estimate_ready": true, "targeting_status": "lookalike_container_without_delivery_lookalike" } // Delivery estimate response { "data": [{ "daily_outcomes_curve": [{ "spend": 0, "reach": 0, "impressions": 0, "actions": 0 }], "estimate_dau": -1, "estimate_mau": -1, "estimate_ready": true , "targeting_status": "lookalike_container_without_delivery_lookalike" }] }
Ces modifications entreront en vigueur à la date de sortie de lʼAPI Marketing v11, et seront appliquées à toutes les versions.
Lors de la période de transition entre la v10 et la v11 de lʼAPI Marketing, le partage d’audiences similaires entre les comptes publicitaires concernés par le déploiement et ceux qui ne le sont pas n’est pas pris en charge par l’API. Pour gérer les partages, veuillez utiliser le gestionnaire d’audience. Une fois l’API Marketing v11 lancée, vous pourrez continuer à utiliser la fonctionnalité de partage via l’API afin de partager de nouvelles audiences similaires entre comptes publicitaires.