Reporting API for Re-Engagement

142 views 31/12/2018 Shay Karpeles 0

Objective

This document provides directions on how to access YouAppi’s reporting API for Re-engagement.

API Request

Request URL Format

Access to the YouAppi reporting API for Re-engagement is via http GET, using the following URL:

https://reports.youappi.com/advertiser/reengagement?

Mandatory Parameters

  • apiKey – apiKey is a unique API key that will be provided to the advertiser by YouAppi and will look similar to this: 888777666-987-4268-b99c-e24f9b286bc5. The advertiser must replace the xxx placeholder in the example below with the token provided. Please note that the value for this parameter should be hardcoded into the link once.
  • start (for example, 2018-04-24)
  • end (for example, 2018-04-24)

Example

https://reports.youappi.com/advertiser/reengagement?apiKey=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx&start=2018-06-12&end=2018-06-12

API Response

Response Format

The response of the API is in JSON format. YouAppi’s response looks like this:

{
  "count": 2,
  "results": Array[2][
    {
      "day": "2018-06-12",
      "campaign_name": "aaaaa",
      "campaign_id": 12345,
      "country": "us",
      "promoted_item": "bbbbbb",
      "os": "iOS",
      "device_type": "Mobile Applications",
      "publisher_id": "123456",
      "creative_name": "1st creative",
      "clicks": 12,
      "installs": 4,
      "spend": 2.0
    },
    {
      "day": "2018-06-12",
      "campaign_name": "ccccccc",
      "campaign_id": 1234567,
      "country": "fr",
      "promoted_item": "dddddddd",
      "os": "Android",
      "device_type": "Mobile Applications",
      "publisher_id": "987654",
      "creative_name": "my creative",
      "clicks": 1000,
      "installs": 20,
      "spend": 5.0
    }
  ]
}

Available Parameters

The table below contains information about the parameters that are available through the API.

 

Field Name Description Value Type Values
day Integer
campaign_name String
campaign_id Double
country
promoted_item
os String

iphone

ipad

android

device_type
publisher_id Array of strings
clicks
installs
spend
creative_name