Criteo Source

Renta поддерживает экспорт данных из Criteo в следующие пункты назначения:

  • Google BigQuery
  • Clickhouse
  • SQL Server
  • Google Spreadsheets

Создание интеграции в хранилище данных (DWH)

  1. Перейдите в каталог интеграций;
  2. Выберите Criteo;
  3. Добавьте аккаунт Criteo, в котором находятся необходимые данные;
  4. Выберите добавленный аккаунт Criteo;
  5. Укажите место назначения, в которое вы хотите импортировать данные;
  6. Перейдите на экран настроек и установите необходимую конфигурацию:

Report type

Тип отчета — состоит из уникального набора параметров и метрик, доступных для выгрузки в DWH. Каждый тип отчета соответствует одноименному методу API Criteo. 

NameDescription
CampaignPerformanceContains stats about Criteo Dynamic Remarketing.
TransactionIDContains stats about all transactions.
FacebookDPAContains stats from Facebook Dynamic Ads.

Parameters

Параметры — содержат список параметров и метрик, доступных для экспорта. Укажите необходимые для выгрузки параметры.

В результате Renta создаст таблицу, которая будет содержать данные выбранных параметров. Порядок выбранных параметров в интерфейсе будет соответствовать порядку столбцов таблицы.

Date range type

Диапазон дат — укажите период, за который необходимо экспортировать данные. Вы можете указать любой исторический временной интервал.

Чтобы выбрать необходимое время, введите в поле «From» дату, с которой вы хотите начать выгрузку данных, затем введите дату окончания в поле «To».

Если вы хотите, чтобы данные в таблице обновлялись ежедневно и дополнялись новыми днями, тогда в поле «To» укажите «Yesterday».
Подробная инструкция по работе с диапазоном дат

Integration name

Имя интеграции — при создании интеграции автоматически генерируется её имя. В этом поле вы можете переименовать название интеграции. Разрешены как кириллица, так и латиница, но не более 100 символов.

Название интеграции отображается на странице Integration List.

Table name

Имя таблицы — при создании интеграции автоматически генерируется имя таблицы, которая будет создана в DWH. В этом поле вы можете переименовать её.

Разрешена только латиница, цифры и символ «_».

Update time

Время обновления — вы можете указать любое время обновления, которое вам нужно. Рента обновляет интеграции ежедневно в интервале выбранного часа. 

Обычно наши пользователи выбирают время обновления интеграций рано утром, например, в 5 утра. В этом случае ваша интеграция будет обновляться в период с 5 утра до 6 утра. 

Обновление интеграций происходит по часовому поясу, выбранном в настройках вашего профайла. 

Overwrite period

Период перезаписи данных — это ретроспективное обновление данных за выбранный период.

Например, вы выбираете период перезаписи «Последние 7 дней» — это означает, что все данные за последние 7 дней будут удалены из таблицы и вставлены снова с обновленными данными.

Примечание: данная настройка доступна только в том случае, если был выбран параметр с типом date или dateTime. 

Создание интеграции в Google Spreadsheets

Воспользуйтесь бесплатным расширением, доступным в Google Workspace Marketplace. Для этого:

  1. Установите расширение Renta Spreadsheets Add-on.
  2. Затем зайдите в Google Sheets, и во вкладке Tools выберите Renta, после чего нажмите кнопку Run. 

После чего в правом сайдбаре откроется рабочая область с настройками интеграций. Подробная инструкция по созданию интеграции доступна по данной ссылке. Обратите внимание, что все созданные интеграции в Google Spreadsheets также доступны для управления в веб-версии Renta. 

Структура данных

NameDescriptionType
Displays - testNumber of times your Criteo ad is displayed to a user on publishers’ websites.INTEGER
ClicksNumber of times that your Criteo ads have been clicked.INTEGER
AdvertiserCostTotal cost of your campaigns.FLOAT
CurrencyCurrency.STRING
SalesPcThe total number of purchases completed via the same device your Criteo ads were clicked. Sales are attributed within 30 days after a user clicks on your Criteo ad.INTEGER
SameSalesPcThe total number of purchases completed via the same device your Criteo ads were clicked. Sales are attributed within 30 days after a user clicks on your Criteo ad.INTEGER
SalesPcNdPost-click sales that are non-deduplicated.INTEGER
SalesPvAll sales that occurred on your website within 24 hours after a user sees a Criteo ad of your campaign. Post-view sales do not include sales from users who clicked an ad, which are counted as sales.INTEGER
SalesPvNdAll non-deduplicated post-view sales that occurred on your website within 24 hours after a user sees a Criteo ad of your campaign. Post-view sales do not include sales from users who clicked an ad, which are counted as salesINTEGER
SalesPcPvThe total amount of sales generated both post-click and post-viewINTEGER
SalesAllPcThe total number of purchases completed via the same device your Criteo ads were clicked, or a different one. Sales are attributed within 30 days after a user clicks on your Criteo ad.INTEGER
RevenueGeneratedPcTotal revenue of your campaigns generated from post-click salesFLOAT
RevenueGeneratedPvTotal revenue of your campaigns generated from post-view salesFLOAT
RevenueGeneratedPcPvPost-click + post-view revenue is the total revenue of your campaigns generated from post-click and post-view sales. This number is computed based on the prices provided by your conversion trackersFLOAT
RevenueGeneratedPcNdTotal revenue of your campaigns generated from post-click sales non-deduplicatedFLOAT
RevenueGeneratedPvNdTotal revenue of your campaigns generated from post-view sales non-deduplicatedFLOAT
ExposedUsersNumber of distinct cookies that have seen at least one Criteo displayFLOAT
OverallCompetitionWinPercentage of impressions/ad placements won, out of all impressions/ad placements that were bid on. For example, Criteo bid on 10 ad placements and won 2, so the Overall Competition Win is 20%. Higher CPC bids result in increased competition win.FLOAT
AudienceNumber of distinct cookies to which Criteo had the opportunity to make a displayFLOAT
ReachShare of the audience exposed to at least one Criteo display ad (percentage)FLOAT
AverageCartAverage revenue generated by a campaign’s sales. This number is calculated by dividing the total revenue by the total salesFLOAT
ClickThroughRateThe number of times your Criteo ads are clicked, divided by the number of times your ad is displayed (impressions). Each campaign has its own CTRFLOAT
ConversionRateNumber of sales generated by users who clicked on your campaign’s ad, divided by the campaign’s number of clicksFLOAT
ConversionRatePvConversion rate post-view is the number of post-view sales generated by users who viewed on your campaign’s ad, divided by the campaign’s number of impressionsFLOAT
ECosThe ratio between the total cost of the campaign and the sales amount that the campaign generated. COS provides a good indication of your campaign’s ROIFLOAT
ECosPvThe ratio between the total cost of the campaign and the post-view sales amount that the campaign generated. This number provides a good indication of your campaign’s ROI.FLOAT
ECosPcPvCost of sale post-click + post-view is the ratio between the total cost of the campaign and the post-click and post-view sales amount that the campaign generated. This number provides a good indication of your campaign’s ROIFLOAT
CostPerOrderCost per order is the amount of money (cost) spent to generate post-click salesFLOAT
CostPerOrderPvThe amount of money (cost) spent to generate post-view salesFLOAT
CostPerOrderPcPvCost per order post-click + post-view is the amount of money (cost) spent to generate post-click and post-view salesFLOAT
ECpcThe price you pay each time a user clicks your Criteo ad. Depending on your campaign’s business model, you can change the CPC on the Campaigns tab for each campaignFLOAT
ECpmCost per mille is the cost of your campaign for 1,000 impressionsFLOAT
ReturnOnAdvertisingSpendingCorresponds to the ratio between the sales amount the campaign generated and the total cost of the campaign (ROAS = 1/COS)FLOAT
AdvertiserValueThe total value generated by the campaign. It is equal to the sum of revenues generated by each product multiplied by their corresponding Value coefficient as defined in the advertiser's feed.FLOAT
CostOfAdvertiserValueThe ratio between the total cost of the campaign and the Advertiser Value of the campaign.FLOAT
DayDay.DATE
Campaign NameCampaign Name.STRING
Transaction dateTransaction date.DATE
CatalogNameCatalog Name.STRING
ClickDateThe date of click.DATE
TransactionIdTransaction id.STRING
AmountAmount.FLOAT
IsAttributedAttribution status.BIT
MatchingTypeMatching Type.STRING
PartnerCurrencyPartner Currency.STRING
DayDay.DATE
DisplaysNumber of times your ad is displayed.INTEGER
ClicksNumber of times that your ads have been clicked.INTEGER
FB costFB cost.FLOAT
Advertiser NameAdvertiser Name.STRING
ClickThroughRateThe number of times your ads are clicked, divided by the number of times your ad is displayed (impressions). Each campaign has its own CTR.FLOAT
Total costTotal cost.FLOAT

Квоты и лимиты

Важное примечание: Renta не предусматривает никакие ограничения, такие как количество учетных записей или временной промежуток выгрузки данных.

Лимиты Criteo:

  • Не более 200 запросов в минуту на одного клиента

Ссылка на официальную документацию Criteo.

_______________________________________________
Если у вас есть вопросы — свяжитесь с нами!