Colonnes enregistrées

La nouvelle API Search Ads 360 Reporting est désormais disponible. La 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.

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

Obtenir la liste des colonnes enregistrées

Pour voir toutes les colonnes enregistrées qu'un annonceur a créées, envoyez une SavedColumns.list() requête. La réponse inclut savedColumnName pour chacune des colonnes de l'annonceur.

Demander des rapports pour les colonnes enregistrées

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

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

Gardez à l'esprit les points suivants lorsque vous utilisez les colonnes enregistrées:

  • Les colonnes enregistrées sont définies au niveau de l'annonceur. Si vous utilisez inclure une colonne enregistrée dans une requête, request.reportScope doit spécifier un annonceur ou un niveau inférieur le champ d'application. Chaque rapport ne peut donc inclure des colonnes enregistrées que pour une un seul annonceur.

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

  • Vous pouvez modifier ou supprimer les colonnes enregistrées dans la gestion des campagnes Search Ads 360 UI à tout moment ; Si une requête spécifiant des colonnes enregistrées échoue, essayez en supprimant les colonnes enregistrées de la demande et en la renvoyant.

  • Les rapports incrémentiels ne peuvent pas contenir de métriques qui ne sont pas explicitement prises en charge par l'API (par exemple, les colonnes d'activité Google Analytics). Dans car les utilisateurs de Search Ads 360 peuvent redéfinir les colonnes enregistrées, les données les rapports contenant des colonnes enregistrées peuvent ne pas être exacts.