Données d'événements brutes sur les visites. Une visite se produit chaque fois qu'un internaute clique sur une annonce et est redirigé vers une page de destination.
Ce rapport ne peut être renvoyé que par une requête asynchrone (c'est-à-dire, via la méthode Reports.request()).
Étant donné que des événements se produisent à des dates spécifiques, une requête pour ce rapport doit spécifier un timeRange. Vous pouvez spécifier l'un des éléments suivants:
- startDate et endDate.
- changedMetricsSinceTimestamp (changedAttributesSinceTimestamp n'est pas valide pour les événements)
Demander un extrait
Envoyez un corps de requête Reports.request() standard, 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 les columnName répertoriés dans le tableau ci-dessous.
Vous pouvez également spécifier les en-têtes headerText, startDate et endDate.
Notez que certaines colonnes ne peuvent pas être filtrées. Reportez-vous à la section "Filtrable" du tableau ci-dessous.
columnName | Description | Comportement | Type | Filtrable |
|---|---|---|---|---|
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 de l'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 du 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 qui contient 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 la cible de produits DS. | Attribut | ID |
Oui |
productGroupId |
ID du groupe de produits associé à cette visite. Seules les visites provenant de campagnes Shopping sont associées à des ID de groupes de produits. Les ID de groupe de produits ne doivent pas être utilisés pour l'association. | Attribut | ID |
Oui |
ad |
Nom de l'annonce. | Attribut | String |
Oui |
adId |
ID 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 peuvent pas être attribuées à une annonce spécifique. Par exemple, une annonce dont le format n'est pas compatible ou dont l'URL clickserver est incorrecte 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 ID lorsque vous associez un compte d'inventaire dans DS. | Attribut | ID |
Oui |
productId |
Identifiant du produit sur lequel l'utilisateur a cliqué. | Attribut | String |
Oui |
productCountry |
Pays (format ISO 3166) enregistré pour le flux d'inventaire qui contient 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 dans lequel l'utilisateur a cliqué sur une annonce produit en magasin. 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 les internautes ont cliqué: Online ou Local. |
Attribut | Product channel |
Oui |
visitId |
ID de visite DS. | Attribut | ID |
Oui |
visitSearchQuery |
Requête de recherche ayant généré cette visite. | Attribut | String |
Oui |
visitDate |
Date, dans le fuseau horaire du compte de moteur, à laquelle la visite a eu lieu. Cette date est utilisée pour le regroupement des visites. Par exemple, lorsque DS regroupe les visites du 1er mai, il comptabilise toutes les visites dont le visitDate est le 1er mai. |
Attribut | Date |
Oui |
visitTimestamp |
Horodatage UTC de la visite. | 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 |
Chaîne unique pour chaque visite transmise à la page de destination en tant que paramètre d'URL gclid. Activé uniquement pour les annonceurs ayant intégré l'API de conversion ou l'intégration Google Analytics. | Attribut | String |
Oui |
feedItemId |
Identifiant de la ligne d'élément de flux associée à cette visite. | Attribut | ID |
Oui |
feedId |
Identifiant du tableau de flux associé à cette visite. | Attribut | ID |
Oui |
feedType |
Type de flux associé à cette visite. | Attribut | Feed type |
Oui |