HUAWEI Ads Global Campaign Configuration

HUAWEI Ads, a paid presentation service, is provided by Huawei for pan-ecosystem partners. It aims to help partners set up a communication bridge with Huawei device users so they can provide valuable information and quality services for users.

Currently, HUAWEI Ads has been integrated into some third-party apps and Huawei apps such as HUAWEI Browser, HUAWEI Video, HUAWEI Assistant, HUAWEI Reader, and HUAWEI Music. It provides slots for displaying mainstream ads such as native ads, rewarded video ads, banner ads, and interstitial ads to more than 570 million Huawei device users around the world.

Setting up HUAWEI Ads

Note: HUAWEI Ads Global require to use OAID to do the attribution, please read in our Android SDK guide how to fetch OAID on HUAWEI devices.

To access HUAWEI Ads settings:

  1. Go to Configuration > Integrated partners.
  2. Search for and select HUAWEI Ads Global.
  3. Update settings (per tab) as required. See the following sections.

Integration tab

The Integration Tab is divided into different sections:

Activate partners

To enable the configuration, activate the partner.

General settings

Secret Key

Enter your HUAWEI Ads secretKey.

To find your secretKey on HUAWEI Ads Platform dashboard:

  • Go to Toolbox > Tracking > Edit > Key page.

Note: to get a secretKey, your account must be allowlisted by HUAWEI Ads team.

Enable view-through attribution

Activate, if you want to attribute view-through installs from HUAWEI Ads. The view-through lookback slider is available in the Attribution link tab.

Default postbacks

AppsFlyer sends automatic postbacks to HUAWEI Ads following user installs – from users attributed to HUAWEI Ads only.

In-app events settings

In this section, you can configure in-app event postbacks that are sent to HUAWEI Ads.

To configure in-app event postbacks:

  1. Enter your HUAWEI Ads secretKey
  2. Activate In-app event postbacks
  3. Click Add event to add an SDK Event to the list.
  4. Fill in the following data:
    Parameter name Description
    SDK event name The name of the event, as received by AppsFlyer either from the SDK, or from server-to-server events.
    Tip: If you don't see the event you want in the list, activate this event on a device with a non-organic installation and recheck.
    Partner event identifier

    Enter the unique name or ID of each event as defined on HUAWEI Ads's side. Select the most suitable pre-defined event for your SDK event:

    • browse (browsing)
    • collection (adding to favorites)
    • addToCart (adding to shopping cart)
    • preOrder (order placement)
    • register (registration)
    • retain (next-day retention)
    • paid (payment occurred)
    • custom (custom-type event)
    Sending option The postbacks can be sent only for the events performed by users attributed to HUAWEI Ads.
    Send event data
    • No values & no revenue: sends only the event itself without the event value.
    • Values & no revenue: sends all the parameters excluding the revenue value.
    • Values & revenue: sends all the event parameters, including the revenue value (if exists in the event).
  5. Click Save.

Attribution link tab

In this tab, you can create the attribution links you want to send to HUAWEI Ads for attributing HUAWEI Ads's campaigns, ad sets, or even single ads. Note that AppsFlyer DOES NOT save your generated partner's attribution links.

More about link structure and parameters.

To generate an attribution link:

  1. Select a parameter from the Parameter name drop-down list and set a value. Note that some of the parameters' values are macros predefined by HUAWEI ADS.
  2. Click Add parameter and repeat the previous step to add more parameters.
  3. Set the duration of the click-through/view-through lookback window.
  4. Copy the attribution link and add it to your campaign on HUAWEI Ads.
    Note: AppsFlyer does not save links.

Attribution link and lookback window

Attribution link type Link activation Lookback window
Click A user clicks on an ad served by the ad network

Click-through lookback window is preset; it is the maximum allowed time from click to install.

HUAWEI Ads gets an attribution if a lead clicks an ad and installs the app before the lookback window expires.

Parameter nameaf_click_lookback 
Default value: 7 days
Range: 1-23 hours or 1-30 days

Impression A user views (for at least one second) an ad served by the ad network

View-through lookback window is preset; it is the maximum allowed time from view to install.

HUAWEI Ads gets an attribution if a lead views an ad and then installs the app before the lookback window expires. This applies if there are no other relevant ad clicks.

Parameter nameaf_viewthrough_lookback 
Default value: 1 day
Range: 1-23 hours or 1-7 days

Typical link parameters

Parameter Parameter name HUAWEI Ads macro Description
Campaign

c
af_c_id

__CID__ Add it to compare different campaigns running with HUAWEI Ads.
Adset

af_adset
af_adset_id

__ADSETID__ Use to differentiate adsets.
Ad

af_ad
af_ad_id

__ADID__ Use to differentiate between creatives within the adset.
 Site and subsite ID af_siteid
af_subsiteid
__SITEID__

Use to attribute installs to specific publishers.

Good practice! If there are multiple publishers,

  • Limit the number of site IDs in use.
  • Use the subsite ID parameter to avoid exceeding the site ID limitation.
Subscriber parameters af_sub1, af_sub2, af_sub3, af_sub4, and af_sub5  

Use to insert additional useful values.

  • Parameters are parsed and included in the raw data report.
  • Use them to perform data aggregation or filtering.

The full list of attribution link parameters.

Cost tab

Cost data is not supported by this partner.

Ad revenue tab

Ad revenue data is not supported by this partner.

Permissions tab

In this tab, you can select the permissions to grant HUAWEI Ads. Note that even if attribution is disabled for HUAWEI Ads, the permissions tab is active and you can grant control to HUAWEI Ads.

Ad network permissions

In this tab, you can select the permissions to grant HUAWEI Ads. Note that even if attribution is disabled for HUAWEI Ads, the permissions tab is active and you can grant control to HUAWEI Ads.

Use these toggles to give the ad network permissions to handle its own configuration for your app:

  • Allow to configure integration: permit the partner to set up the integration tab (except in-app event postbacks)
  • Allow to configure in-app event postbacks: permit the partner to set up in-app event postbacks mapping to itself on the integration tab
  • Allow access to your retention report: only to the partner's own retention data
  • Allow access to your aggregate loyal user data: only to the partner's own loyal user data
  • Allow access to your aggregate in-app events data: only to the partner's own in-app events data
  • Allow access to your aggregate revenue data: only to the revenue data attributed to the partner
  • Allow spend ingestion: permit the partner to send ad spend data in files; for this app only.
  • Allow access to your Protect360 dashboard: only to the partner's own Protect360 data, and providing the feature is enabled for the advertiser

Learn more about granting ad network permissions.

Configuring campaigns on HUAWEI Ads Global

To configure campaigns on HUAWEI Ads:

  1. Create a Promotion Task
  2. Set the tracking URLs:

HW_Ads_dashboard.png

Was this article helpful?