Type de signalement: visite

Données d'événements brutes concernant les visites. Une visite se produit chaque fois qu'un consommateur clique sur une annonce et est redirigé vers une page de destination.

Ce rapport ne peut être renvoyé que par une demande asynchrone (c'est-à-dire, via la méthode Reports.request()).

Étant donné que les événements se produisent à des dates spécifiques, une demande de ce rapport doit spécifier un timeRange. Vous pouvez spécifier l'un des éléments suivants:

Demander un extrait

Envoyer un Reports.request() corps de la requête, mais spécifiez "reportType": "visit".

{
...
  "reportType": "visit",
  "columns": [
    {
      "columnName": string,
      "headerText": string,
      "startDate": string,
      "endDate": string
    }
  ],
  "filters": [
    {
      "column": {
        "columnName": string,
      },
      ...
    },
    ...
  ],
...
}

Pour chaque colonne que vous souhaitez afficher ou filtrer dans le rapport, spécifiez la valeur columnName indiquée dans le tableau ci-dessous. Vous pouvez également spécifier headerText, startDate, et endDate. Notez que certaines colonnes ne peuvent pas être filtrées. reportez-vous à "Filtrable" dans le tableau ci-dessous.

columnNameDescriptionComportementTypeFiltrable
status État de la visite. Les visites étant immuables, la valeur correspond toujours à Active. attribut Status Oui
deviceSegment Segment d'appareil auquel la visite est attribuée: Desktop, Mobile, Tablet ou Other. attribut Device segment Oui
agency Nom de l'agence. attribut String Oui
agencyId ID d'agence DS. attribut ID Oui
advertiser Nom de l'annonceur. attribut String Oui
advertiserId référence annonceur DS. attribut ID Oui
account Nom du compte de moteur. attribut String Oui
accountId ID de compte de moteur DS. attribut ID Oui
accountEngineId ID du compte dans le compte de moteur externe. attribut String Oui
accountType Type de compte de moteur: Google AdWords, Bing Ads, Yahoo Japan Listing Ads, Yahoo Search Marketing, Yahoo Gemini, Baidu ou Comparison Shopping. attribut Engine type Oui
campaign Nom de la campagne. attribut String Oui
campaignId ID de campagne DS. attribut ID Oui
campaignStatus État de la campagne qui contient cet élément. attribut Status Oui
adGroup Nom du groupe d'annonces. attribut String Oui
adGroupId ID du groupe d'annonces DS. attribut ID Oui
adGroupStatus État du groupe d'annonces incluant cet élément. attribut Status Oui
keywordId ID du mot clé DS. La valeur 0 indique que le mot clé n'est pas attribué. attribut ID Oui
keywordMatchType Type de correspondance des mots clés: Broad, Exact, Phrase ou Content. attribut Match type Oui
keywordText Texte du mot clé. attribut String Oui
productTargetId ID de cible de produits DS. attribut ID Oui
productGroupId ID du groupe de produits associé à cette visite. Seules les visites issues de campagnes Shopping ont un ID de groupe de produits. Les ID de groupe de produits ne doivent pas être utilisés pour rejoindre des groupes. attribut ID Oui
ad Nom de l'annonce. attribut String Oui
adId l'identifiant de l'annonce DS. La valeur 0 indique que l'annonce n'est pas attribuée. attribut ID Oui
isUnattributedAd Indique si les métriques de cette ligne ne sont pas attribuables à une annonce spécifique. Par exemple, une annonce dont le format n'est pas compatible ou dont l'URL clickserver est erronée peut empêcher DS d'attribuer des statistiques à une annonce. attribut Boolean Oui
inventoryAccountId ID du compte d'inventaire DS contenant le produit sur lequel l'utilisateur a cliqué. DS génère cet identifiant lorsque vous associez un compte d'inventaire dans DS. attribut ID Oui
productId Identifiant du produit ayant fait l'objet d'un clic. attribut String Oui
productCountry Pays (format ISO 3166) enregistré pour le flux d'inventaire contenant le produit sur lequel l'utilisateur a cliqué. attribut String Oui
productLanguage Langue (ISO 639-1) définie pour le flux Merchant Center contenant des données sur le produit. attribut String Oui
productStoreId Magasin associé à l'annonce produit en magasin ayant fait l'objet d'un clic. Il doit correspondre aux ID de magasin utilisés dans votre flux de produits en magasin. attribut String Oui
productChannel Canal de ventes du produit sur lequel l'utilisateur a cliqué: Online ou Local. attribut Product channel Oui
visitId ID de visite DS. attribut ID Oui
visitSearchQuery Requête de recherche à l'origine de cette visite. attribut String Oui
visitDate Date à laquelle la visite a eu lieu, dans le fuseau horaire du compte de moteur. Cette date est utilisée pour le regroupement des visites. Par exemple, lorsque DS regroupe les visites pour le 1er mai, il comptabilise toutes les visites dont le visitDate est le 1er mai. attribut Date Oui
visitTimestamp Code temporel UTC du moment où la visite a eu lieu. attribut Timestamp Oui
visitNetworkType Réseau publicitaire ayant généré cette visite: Content, Search ou Other. attribut Network type Oui
visitReferrer URL de provenance de la visite. attribut String Oui
visitExternalClickId Une chaîne unique pour chaque visite, transmise à la page de destination en tant que paramètre d'URL gclid. Activé uniquement pour les annonceurs utilisant l'intégration de l'API de conversion ou de Google Analytics. attribut String Oui
feedItemId ID de la ligne de l'élément de flux associé à cette visite. attribut ID Oui
feedId ID du tableau de flux associé à cette visite. attribut ID Oui
feedType Type de flux associé à la visite. attribut Feed type Oui