Données d'événements brutes concernant les conversions
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": "conversion"
.
{ ... "reportType": "conversion", "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 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 conversion généré par les activités Floodlight de ce groupe: Action ou Transaction . |
attribut | Conversion type |
Oui |
floodlightGroupId |
ID de groupe Floodlight DS. | attribut | ID |
Oui |
floodlightGroupTag |
Balise de groupe Floodlight. | attribut | String |
Oui |
floodlightActivity |
Nom de l'activité Floodlight. | attribut | String |
Oui |
floodlightActivityId |
ID d'activité Floodlight DS. | attribut | ID |
Oui |
floodlightActivityTag |
Balise d'activité Floodlight. | attribut | String |
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 conversion. Seules les conversions issues des campagnes Shopping disposent d'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 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 (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 indiqué dans l'annonce produit en magasin associé à la conversion. 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 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", en fonction des instructions Floodlight de l'annonceur. | attribut | String |
Oui |
conversionType |
Type de conversion: Action ou Transaction . |
attribut | Conversion type |
Oui |
conversionRevenue |
Montant total en dollars de la conversion. | attribut | Money |
Oui |
conversionQuantity |
Nombre d'articles enregistrés par la conversion, tel que déterminé 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, dans le fuseau horaire du réseau Campaign Manager, à laquelle la conversion a eu lieu. Cette date est utilisée pour l'agrégation des métriques de conversion. Par exemple, lorsque DS regroupe les actions pour le 1er mai, il comptabilise toutes les conversions d'action dont la valeur conversionDate correspond au 1er mai. |
attribut | Date |
Oui |
conversionTimestamp |
Code temporel UTC du moment où la conversion s'est produite. | 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, qui est 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 |
conversionSearchTerm |
Terme de recherche à l'origine de 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 de provenance 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 d'élément de flux associée à cette conversion. | attribut | ID |
Oui |
feedId |
ID du tableau de flux associé à cette conversion. | attribut | ID |
Oui |
feedType |
Type de flux associé à cette conversion. | attribut | Feed type |
Oui |