Données d'événement brutes sur les conversions.
Ce rapport ne peut être renvoyé que par une requête asynchrone (c'est-à-dire via la méthode Reports.request()).
Étant donné que les événements se produisent à des dates spécifiques, une requête pour ce rapport doit spécifier une 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": "conversion"
.
{
...
"reportType": "conversion",
"columns": [
{
"columnName":string ,
"headerText":string ,
"startDate":string ,
"endDate":string
}
],
"filters": [
{
"column": {
"columnName":string ,
},
...
},
...
],
...
}
Pour chaque colonne que vous souhaitez renvoyer ou filtrer dans le rapport, spécifiez l'columnName
listée dans le tableau ci-dessous.
Vous pouvez également spécifier facultativement headerText, startDate et endDate.
Notez que certaines colonnes ne peuvent pas être filtrées. Reportez-vous à la colonne "Filtrable" du tableau ci-dessous.
columnName | Description | Comportement | Type | Filtrable |
---|---|---|---|---|
status |
État de la conversion: Active ou Removed . |
attribut | Status |
Oui |
deviceSegment |
Segment d'appareil auquel la conversion est attribuée: Desktop , Mobile , Tablet ou Other . |
attribut | Device segment |
Oui |
floodlightGroup |
Nom du groupe Floodlight. | attribut | String |
Oui |
floodlightGroupConversionType |
Type de conversions générées par les activités Floodlight de ce groupe: Action ou Transaction . |
attribut | Conversion type |
Oui |
floodlightGroupId |
ID du groupe Floodlight DS. | attribut | ID |
Oui |
floodlightGroupTag |
Balise du groupe Floodlight. | attribut | String |
Oui |
floodlightActivity |
Nom de l'activité Floodlight. | attribut | String |
Oui |
floodlightActivityId |
ID de l'activité Floodlight DS. | attribut | ID |
Oui |
floodlightActivityTag |
Balise d'activité Floodlight | attribut | String |
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 associé à un moteur. | attribut | String |
Oui |
accountId |
Numéro 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 la campagne DS. | attribut | ID |
Oui |
campaignStatus |
État de la campagne contenant cet article. | 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 contenant cet élément. | attribut | Status |
Oui |
keywordId |
ID de 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 conversion. Seules les conversions issues de campagnes Shopping comportent des ID de groupe de produits. Les ID de groupe de produits ne doivent pas être utilisés pour la fusion. | attribut | ID |
Oui |
ad |
Nom de l'annonce. | attribut | String |
Oui |
adId |
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 peuvent pas être attribuées à une annonce spécifique. Par exemple, une annonce dont le format n'est pas accepté ou dont l'URL du clickserver est incorrecte peut empêcher le DS d'attribuer des métriques à une annonce. | attribut | Boolean |
Oui |
inventoryAccountId |
ID du compte d'inventaire DS contenant le produit associé à la conversion. DS génère cet identifiant lorsque vous associez un compte d'inventaire dans DS. | attribut | ID |
Oui |
productId |
ID du produit associé à cette conversion. | attribut | String |
Oui |
productCountry |
Pays (au format ISO 3166) enregistré pour le flux d'inventaire qui contient le produit associé à cette conversion. | attribut | String |
Oui |
productLanguage |
Langue (ISO 639-1) du produit associé à cette conversion. | attribut | String |
Oui |
productStoreId |
Magasin associé à l'annonce produit en magasin associée à la conversion. Il doit correspondre aux ID de magasin utilisés dans votre flux de produits en magasin. | attribut | String |
Oui |
productChannel |
Canal de vente du produit associé à la conversion: Online ou Local . |
attribut | Product channel |
Oui |
conversionId |
ID généré par Search Ads 360 pour chaque conversion. | attribut | ID |
Oui |
advertiserConversionId |
Pour les conversions hors connexion, il s'agit d'un identifiant fourni par les annonceurs. Si un annonceur ne spécifie pas un tel identifiant, Search Ads 360 en génère un. Pour les conversions en ligne, il correspond à la colonne "conversionId" ou à la colonne "floodlightOrderId" suivant les instructions Floodlight de l'annonceur. | attribut | String |
Oui |
conversionType |
Type de la conversion: Action ou Transaction . |
attribut | Conversion type |
Oui |
conversionRevenue |
Montant total de la conversion, en dollars. | attribut | Money |
Oui |
conversionQuantity |
Quantité d'articles enregistrés par la conversion, telle que déterminée par le paramètre qty. L'annonceur est responsable du remplissage dynamique du paramètre (par exemple avec le nombre d'articles vendus dans le cadre de la conversion). Sinon, la valeur par défaut est définie sur 1. | attribut | Number |
Oui |
conversionDate |
Date de la conversion, dans le fuseau horaire du réseau Campaign Manager. Cette date est utilisée pour l'agrégation des métriques de conversion. Par exemple, lorsque DS agrège les actions du 1er mai, il comptabilise toutes les conversions d'action dont la valeur conversionDate est le 1er mai. |
attribut | Date |
Oui |
conversionTimestamp |
Code temporel UTC de la conversion. | attribut | Timestamp |
Oui |
conversionLastModifiedTimestamp |
Code temporel UTC de la dernière modification de la conversion. | attribut | Timestamp |
Oui |
conversionAttributionType |
Élément auquel la conversion est attribuée: Visit ou Keyword+Ad . |
attribut | Conversion attribution type |
Oui |
conversionVisitId |
ID de visite DS auquel la conversion est attribuée. | attribut | ID |
Oui |
conversionVisitTimestamp |
Code temporel UTC de la visite à laquelle la conversion est attribuée. | attribut | Timestamp |
Oui |
conversionVisitExternalClickId |
Chaîne unique, pour la visite à laquelle la conversion est attribuée, transmise à la page de destination en tant que paramètre d'URL gclid. Cette fonctionnalité n'est disponible que pour les annonceurs qui ont intégré l'API de conversion ou Google Analytics. | attribut | String |
Oui |
conversionSearchTerm |
Terme de recherche ayant généré la conversion. | attribut | String |
Oui |
floodlightOriginalRevenue |
Revenus initiaux non modifiés associés à l'événement Floodlight (dans la devise du rapport actuel), avant la modification des instructions de devise Floodlight. | attribut | Money |
Oui |
floodlightEventRequestString |
Chaîne de requête Floodlight de la conversion. | attribut | String |
Oui |
floodlightReferrer |
Site Web référent Floodlight de la conversion. | attribut | String |
Oui |
floodlightOrderId |
ID de commande Floodlight fourni par l'annonceur pour la conversion. | attribut | String |
Oui |
feedItemId |
ID de la ligne de l'élément de flux associé à cette conversion. | attribut | ID |
Oui |
feedId |
ID de la table du flux associée à cette conversion. | attribut | ID |
Oui |
feedType |
Type de flux associé à cette conversion. | attribut | Feed type |
Oui |