Colonnes enregistrées

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

Pour générer des rapports sur les activités Floodlight, les objectifs Google Analytics ou les KPI personnalisés, un annonceur peut se connecter à l'interface utilisateur de Search Ads 360, puis créer une ou plusieurs colonnes enregistrées, telles que des colonnes d'activité Floodlight, des colonnes d'activité Google Analytics ou des colonnes de formules. Vous pouvez inclure une colonne enregistrée dans une demande de rapport pour télécharger ses données ou pour filtrer un rapport.

Obtenir la liste des colonnes enregistrées

Pour afficher toutes les colonnes enregistrées créées par un annonceur, envoyez une demande SavedColumns.list() . La réponse inclut la valeur savedColumnName pour chacune des colonnes de l'annonceur.

Demander des rapports sur les colonnes enregistrées

Pour inclure une colonne enregistrée dans une requête de rapport, ajoutez une colonne avec l'attribut savedColumnName défini sur le nom de la colonne: 

{
  "reportType": "advertiser",
  "columns": [
    {
      "savedColumnName": string,
      "headerText": string,
    }
  ],
  "filters": [
    {
      "column": {
        "savedColumnName": string,
      },
      ...
    },
    ...
  ],
  ...
}

Lorsque vous utilisez des colonnes enregistrées, gardez à l'esprit les points suivants:

  • Les colonnes enregistrées sont définies au niveau de l'annonceur. Si vous incluez une colonne enregistrée dans une requête, request.reportScope doit spécifier un annonceur ou un niveau inférieur. Par conséquent, chaque rapport ne peut inclure des colonnes enregistrées que pour un seul annonceur.

  • Les noms de colonnes enregistrés sont sensibles à la casse, aux espaces blancs et à la ponctuation. L'attribut savedColumnName doit correspondre exactement au nom de la colonne enregistrée. Si le nom d'une colonne enregistrée est identique à celui d'une autre colonne de la même demande, Search Ads 360 vous oblige à spécifier une valeur headerText unique et alternative pour l'une des colonnes ou pour les deux.

  • Vous pouvez modifier ou supprimer les colonnes enregistrées à tout moment dans l'interface utilisateur de gestion des campagnes de Search Ads 360. Si une demande spécifiant des colonnes enregistrées échoue, essayez de supprimer les colonnes enregistrées de la demande, puis de la renvoyer.

  • Les rapports incrémentiels ne peuvent pas contenir de métriques qui ne sont pas explicitement compatibles avec l'API (par exemple, des colonnes d'activité Google Analytics). En outre, étant donné que les utilisateurs de Search Ads 360 peuvent redéfinir les colonnes enregistrées, les rapports incrémentiels contenant des colonnes enregistrées risquent de ne pas être précis.