Cette page décrit les limites et les bonnes pratiques pour gérer le ciblage à l'aide de l'API Display & Video 360.
Ciblage attribué lors de la création de l'élément de campagne
Certains types de ciblage ont des valeurs par défaut attribuées lors de la création de l'élément de campagne. Voici les types de ciblage disponibles :
Pour éviter les erreurs, prenez connaissance de la suite complète de ciblage attribuée à vos éléments de campagne lors de leur création. Vous pouvez récupérer tous les ciblages attribués à un élément de campagne à l'aide de bulkListAssignedTargetingOptions.
Certains paramètres sont implicites lorsqu'aucun ciblage d'un type n'est attribué. Par exemple, si aucune option de ciblage TARGETING_TYPE_AUTHORIZED_SELLER_STATUS n'est attribuée à un élément de campagne, celui-ci utilisera "Vendeurs et revendeurs directs autorisés" lors de la diffusion des annonces.
Les options de ciblage peuvent être obsolètes
Les options de ciblage ne sont pas statiques. Il est possible qu'un petit nombre d'options soient abandonnées de temps en temps. Les options de ciblage obsolètes n'ont aucune incidence sur la diffusion des annonces d'un élément de campagne. Une fois ces options obsolètes, elles seront dissociées. Les requêtes qui tentent de récupérer ou d'attribuer ces options généreront des erreurs.
Pour éviter ces erreurs, vérifiez régulièrement les ID des options de ciblage stockées. Pour économiser du quota, nous vous recommandons de mettre en cache les ID fréquemment utilisés.
Si vous stockez des ID, vous risquez de ne pas vous rendre compte qu'une option de ciblage a été abandonnée. Utilisez régulièrement la méthode get pour récupérer tous les ID d'options de ciblage stockés et vérifier qu'ils sont toujours compatibles avec Display & Video 360.
Les demandes de ciblage simultanées pour un même élément de campagne échoueront.
Toute tentative de mise à jour des paramètres ou du ciblage attribué d'un élément de campagne à l'aide de requêtes simultanées générera une erreur.
Pour ajouter ou supprimer plusieurs options de ciblage attribuées pour un seul élément de campagne en même temps, utilisez une seule requête bulkEditAssignedTargetingOptions. Si vous souhaitez mettre à jour les paramètres et le ciblage d'un élément de campagne, mettez vos demandes en file d'attente pour vous assurer qu'elles sont envoyées dans l'ordre.
Erreurs de ciblage courantes
Il existe trois causes courantes d'erreurs lors de la gestion du ciblage à l'aide de l'API Display & Video 360.
Erreurs de configuration
Le ciblage est soumis à des restrictions de configuration. Si une requête tente de mettre à jour le ciblage de manière à enfreindre ces règles, elle renvoie une erreur.
Les erreurs de configuration sont souvent dues à un ciblage existant. Pour éviter cela, procédez comme suit :
- Obtenez le ciblage existant d'un type donné à l'aide d'une requête
list. - Examinez le ciblage existant. Évaluez le ciblage à ajouter ou à supprimer pour obtenir la configuration souhaitée.
- Mettez à jour le ciblage à l'aide d'une requête
bulkEditAssignedTargetingOptions.
Le ciblage hérité des ressources parentes ne peut pas être supprimé, mais peut entraîner ces erreurs.
Erreurs YouTube et partenaires
Vous ne pouvez pas mettre à jour le ciblage YouTube et partenaires à l'aide de l'API Display & Video 360. Les requêtes qui tentent de mettre à jour ce ciblage renverront une erreur.
Ce ciblage est défini comme suit :
- Tout ciblage attribué à un élément de campagne ou à un groupe d'annonces YouTube et partenaires.
- Ciblage des positions de session et des vidéos et chaînes YouTube individuelles par les annonceurs
Erreurs de simultanéité
Les requêtes qui mettent à jour les paramètres ou le ciblage du même élément de campagne en même temps peuvent renvoyer une erreur.
Pour éviter cela :
- Gérez le ciblage de manière groupée à l'aide d'une demande de modification groupée.
- Mettez en file d'attente les requêtes qui mettent à jour le même élément de campagne. N'envoyez pas de requête tant que la précédente n'a pas renvoyé de réponse.