Quelle doit être la portée de mon rapport ?
Pour la plupart des rapports, nous vous recommandons de définir Reports.reportScope sur un compte de moteur ou un annonceur spécifique. Pour les rapports très volumineux (rapports sur les mots clés, rapports sur les conversions ou rapports segmentés avec précision, par exemple), nous vous recommandons de limiter le champ d'application à un compte de moteur spécifique. L'API peut renvoyer des erreurs pour les rapports contenant plus de 10 millions de lignes.
Pourquoi le message d'erreur "Interdit" (403) s'affiche-t-il ?
Vous devez très probablement obtenir un jeton OAuth d'actualisation.
Comment trouver les ID des agences et des annonceurs ?
Si vous ne disposez pas encore des ID des agences et des annonceurs que vous êtes autorisé à afficher, demandez un rapport advertiser contenant les colonnes agencyId et advertiserId, mais sans spécifier la propriété reportScope.
Search Ads 360 renvoie une liste de toutes les références annonceur et d'agence que votre compte Google est autorisé à consulter.
Voici un exemple de requête:
POST https://www.googleapis.com/doubleclicksearch/v2/reports/generate
Authorization: Bearer your OAuth 2.0 access token
Content-type: application/json
{
"reportType": "advertiser",
"columns": [
{ "columnName": "agency" },
{ "columnName": "agencyId" },
{ "columnName": "advertiser" },
{ "columnName": "advertiserId" }
],
"statisticsCurrency": "usd"
}
Fréquence d'actualisation des données des rapports
Certaines métriques sont plus récentes que d'autres. Pour en savoir plus, consultez la section Fréquence d'actualisation des données des rapports dans Search Ads 360.
Pour vous assurer que vos rapports contiennent toutes les métriques disponibles, nous vous recommandons d'attendre environ quatre heures après minuit (fuseau horaire du compte de moteur) avant de demander des rapports sur les métriques de la veille. Pour le rapport conversion, nous vous recommandons d'attendre 12 heures après minuit (fuseau horaire de l'annonceur Campaign Manager). Si vous utilisez l'API pour importer des données de conversion, consultez insert.operation pour en savoir plus sur la disponibilité des données importées.
Même après plusieurs jours, une métrique peut encore changer en raison des filtres antispam du moteur ou des conversions hors connexion importées via l'API. Pour télécharger ces modifications de manière incrémentielle, demandez des rapports sur les données qui ont changé depuis votre dernier téléchargement. Si vous téléchargez des modifications incrémentales, nous vous recommandons de demander un rapport complet de temps en temps. Par exemple, vous pouvez télécharger des modifications incrémentielles tous les deux ou trois jours, puis demander un rapport complet une fois par mois.
Quand les modifications d'attributs apparaîtront-elles dans les rapports ?
Il faut environ une minute pour que les modifications d'attributs apportées par un utilisateur dans Search Ads 360 apparaissent dans les rapports que vous téléchargez via l'API. Les modifications apportées directement dans le moteur externe (et non via Search Ads 360) doivent d'abord être importées dans Search Ads 360 à l'aide de la synchronisation entrante.
Nous vous recommandons de ne renvoyer que les données qui ont été modifiées pour déterminer les entités dont les attributs ont été modifiés.
Que sont les annonces et les mots clés non attribués ?
Il arrive que Search Ads 360 ne puisse pas attribuer de métriques à une annonce spécifique. Par exemple, une annonce dont le format n'est pas compatible ou une URL clickserver comportant une erreur peut empêcher Search Ads 360 d'attribuer des métriques à une annonce. Pour chaque groupe d'annonces, Search Ads 360 enregistre toutes les métriques non attribuées comme appartenant à une "annonce non attribuée". Pour demander ces métriques dans un rapport, définissez includeRemovedEntities sur true. Pour identifier facilement les annonces non attribuées, incluez la colonne isUnattributedAd dans la requête.
De même, Search Ads 360 ne peut parfois pas attribuer de statistiques à un mot clé spécifique.
Cela se produit lorsque des écarts se produisent dans les rapports. Dans ce cas, la colonne keywordId des mots clés non attribués est définie sur 0.
Les rapports incluent-ils des conversions ajustées ?
Dans certains cas, les conversions sont difficiles à mesurer, par exemple lorsque les cookies du site Web qui stockent les informations concernant les clics sur vos annonces ne sont pas disponibles en raison de facteurs tels que les paramètres du navigateur. Dans ce cas, Floodlight utilise l'ajustement pour tenir compte des données de conversion qui ne peuvent pas être mesurées directement. Autrement dit, Floodlight applique le machine learning aux données historiques pour modéliser le nombre de conversions et le montant des revenus issus des conversions qui ne peuvent pas être mesurés. Floodlight peut ensuite ajouter l'estimation obtenue à ses métriques de conversion afin de fournir une vision plus complète de la façon dont votre publicité génère des conversions.
Floodlight applique toujours l'ajustement aux colonnes de rapport suivantes:
- dfaActions
- dfaRevenue
- dfaTransactions
- dfaWeightedActions
- Colonnes enregistrées qui génèrent des rapports sur les activités Floodlight
Le rapport conversion n'inclut pas les conversions ajustées. Il n'affiche que les conversions mesurées directement. Le nombre de conversions et le montant des revenus indiqués dans un rapport conversion ne doivent pas correspondre aux conversions et aux revenus indiqués dans les colonnes listées ci-dessus.
Pourquoi les conversions brutes ne sont-elles pas cumulées dans la métrique cumulée X ?
Dans les rares cas où les métriques agrégées sont en désaccord avec les événements bruts dans Search Ads 360, vous pouvez faire confiance à la métrique agrégée. Lors du calcul des agrégations de métriques, Search Ads 360 tente de nettoyer les sources de données en supprimant les conversions qu'il soupçonne d'être des doublons.
Que faire si je ne réponds pas à ma question ?
Si vous ne parvenez pas à résoudre un problème après avoir consulté les ressources de ce site, contactez l'assistance et munissez-vous des informations suivantes:
Référence agence Search Ads 360 et référence annonceur auxquelles vous essayez d'accéder
Numéro du projet dans la console Google APIs
Le nom d'utilisateur du compte Google que vous utilisez pour accéder à l'API
Il s'agit du compte qui a été autorisé à accéder à Search Ads 360, qui est le même que celui que vous utilisez pour configurer l'autorisation.Extrait de code de votre demande
Réponse JSON
Si la réponse est une erreur, veillez à inclure le message d'erreur, et pas seulement le code d'erreur numérique.