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:
- startDate et endDate.
- changedMetricsSinceTimestamp (changedAttributesSinceTimestamp n'est pas valide pour les événements).
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.
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 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 |