Questions fréquentes sur la création de rapports

La nouvelle API Search Ads 360 Reporting est désormais disponible. Cette nouvelle API fournit Plus de flexibilité pour créer des rapports personnalisés et intégrer les données dans vos applications de reporting et processus. En savoir plus sur la migration vers la nouvelle interface Search Ads 360 Reporting et son utilisation API.

Quelle doit être la portée de mon rapport ?

Pour la plupart des rapports, nous vous recommandons de définir Reports.reportScope à un annonceur ou à un compte de moteur spécifique. Pour les très grands rapports sur les mots clés, les conversions et segmentés précisément, nous vous recommandons de limiter la portée un compte de moteur spécifique. L'API peut renvoyer des erreurs pour les rapports dont la taille est supérieure à 10 millions de lignes.

Pourquoi le message d'erreur "Accès interdit (403)" s'affiche-t-il ?

Très probablement, vous devez obtenir un jeton OAuth actualisé.

Où puis-je trouver les identifiants des agences et des annonceurs ?

Si vous ne connaissez pas encore les ID des agences et des annonceurs dont vous disposez l'autorisation d'affichage, demandez un advertiser avec les colonnes agencyId et advertiserId, sans spécifier la reportScope. Search Ads 360 renvoie une liste de toutes les références agence et référence annonceur auxquelles Le compte Google est autorisé à afficher.

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 l'article 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 heures après minuit (fuseau horaire du compte de moteur) avant de demander des rapports de la veille metrics; 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 toujours changer en raison des filtres antispam du moteur ou de l'état hors connexion des conversions importées via l'API. Pour les télécharger progressivement modifications, demandez des rapports sur les données qui ont changé depuis votre dernier téléchargement. Si vous téléchargez des fichiers nous vous recommandons de demander un rapport complet de temps à autre. 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 effectuées par un utilisateur dans Search Ads 360 soient répercutées dans que vous pouvez télécharger via l'API. Les modifications apportées directement sur 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 renvoyer uniquement les données qui ont été modifiées afin d'identifier les entités pour lesquelles des attributs ont été modifiés.

Que sont les annonces et les mots clés non attribués ?

Parfois, Search Ads 360 ne peut pas attribuer de métriques à une annonce spécifique. Par exemple, une annonce avec un ou une URL clickserver erronée peuvent empêcher Search Ads 360 d'attribuer à 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, configurez includeRemovedEntities à true. Pour identifier facilement les annonces non attribuées, incluez le paramètre isUnattributedAd dans la requête.

De même, il arrive que Search Ads 360 ne puisse pas attribuer de statistiques à un mot clé spécifique. Cela se produit lorsque des écarts surviennent dans les rapports. Dans ce cas, le La colonne keywordId pour les mots clés non attribués est définie sur 0.

Les rapports incluent-ils les conversions ajustées ?

Dans certains cas, les conversions sont difficiles à mesurer, par exemple lorsque les cookies des sites 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 directement mesurées. En d'autres termes, Floodlight applique le machine learning aux données historiques pour modéliser le nombre de conversions et le montant des revenus générés par les conversions qui ne peuvent pas être mesurés. Floodlight peut puis ajouter l'estimation obtenue à ses métriques de conversion afin d'obtenir un aperçu plus complet comment vos annonces génèrent des conversions.

Floodlight applique toujours l'ajustement aux colonnes de rapport suivantes:

  • dfaActions
  • dfaRevenue
  • dfaTransactions
  • dfaWeightedActions
  • des colonnes enregistrées qui créer des rapports sur les activités Floodlight ;

conversion n'inclut pas de conversions ajustées. Il n'affiche que les conversions mesurées. directement. Nombre de conversions et montant des revenus dans un rapport "conversion" ne doivent pas correspondre aux conversions et aux revenus indiqués dans les colonnes indiquées ci-dessus.

Pourquoi les conversions brutes ne correspondent-elles pas à la métrique agrégée X ?

Dans les rares cas où des métriques agrégées seraient en désaccord avec des événements bruts dans Search Ads 360, faites confiance aux métrique agrégée. Lors du calcul des métriques agrégées, Search Ads 360 tente de nettoyer les données sources en supprimant les conversions qu'il soupçonne être des doublons.

Que faire si aucune réponse à ma question n'est trouvée ?

Si vous rencontrez un problème que vous ne pouvez pas résoudre après avoir lu les ressources sur ce site, contactez l'assistance et demandez les informations suivantes sont prêtes:

  • Références de l'agence et référence de l'annonceur Search Ads 360 auxquelles vous essayez d'accéder

  • Numéro de 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 l'on a l'autorisation d'accéder à Search Ads 360, qui correspond au compte que vous utilisez configurer les autorisations.

  • Extrait de code de votre requête

  • 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.