HUAWEI Ads高級(jí)設(shè)置,華為c5鍵盤如何使用-ESG跨境

HUAWEI Ads高級(jí)設(shè)置,華為c5鍵盤如何使用

HUAWEI Ads高級(jí)設(shè)置

HUAWEI Ads SDK還提供了一些廣告請(qǐng)求相關(guān)的高級(jí)設(shè)置。

設(shè)置受眾人群

HUAWEI Ads SDK提供了通過設(shè)置RequestOptions對(duì)象，來滿足針對(duì)不同受眾人群請(qǐng)求對(duì)應(yīng)廣告內(nèi)容的能力。該對(duì)象應(yīng)先通過HwAds靜態(tài)方法獲取應(yīng)用的全局受眾人群信息。如果要更新請(qǐng)求配置，請(qǐng)從現(xiàn)有配置中獲取構(gòu)建器，再進(jìn)行設(shè)置更新。

說明

您必須將用戶是否是兒童的標(biāo)識(shí)在setTagForChildProtection方法中如實(shí)的告知HUAWEI Ads。您需要承擔(dān)由于告知錯(cuò)誤或沒有告知導(dǎo)致廣告誤投放到兒童的手機(jī)上導(dǎo)致的一切后果。

示例代碼如下：

//添加面向兒童的設(shè)置

RequestOptions requestOptions=HwAds.getRequestOptions().toBuilder().setTagForChildProtection(TAGFORCHILDPROTECTIONTRUE).build();

HwAds.setRequestOptions(requestOptions);

RequestOptions提供了下面五種方法設(shè)置受眾人群：

示例代碼如下：

//面向兒童的設(shè)置，表明您的廣告內(nèi)容需要符合COPPA的規(guī)定

RequestOptions requestOptions=HwAds.getRequestOptions().toBuilder().setTagForChildProtection(TAGFORCHILDPROTECTIONTRUE).build();

//未達(dá)到法定承諾年齡的用戶的設(shè)置，表明您希望廣告請(qǐng)求符合未達(dá)到法定承諾年齡用戶的廣告標(biāo)準(zhǔn)

RequestOptions requestOptions=HwAds.getRequestOptions().toBuilder().setTagForUnderAgeOfPromise(PROMISETRUE).build();

//廣告內(nèi)容過濾，指定返回的廣告內(nèi)容應(yīng)與分級(jí)標(biāo)簽名稱對(duì)應(yīng)，但不得高于W

RequestOptions requestOptions=HwAds.getRequestOptions().toBuilder().setAdContentClassification(ADCONTENTCLASSIFICATIONW).build();

//請(qǐng)求個(gè)性化廣告與非個(gè)性化廣告

RequestOptions requestOptions=HwAds.getRequestOptions();

requestOptions.toBuilder().setNonPersonalizedAd(ALLOWALL).build();

//設(shè)置TCF2.0用戶同意信息字符串

RequestOptions requestOptions=HwAds.getRequestOptions();

requestOptions.toBuilder().setConsent(tcfString).build();

設(shè)置意見征求

HUAWEI Ads投放的廣告包括個(gè)性化廣告和非個(gè)性化廣告。為了征求用戶意見，HUAWEI Ads提供了Consent SDK。

本章節(jié)介紹了如何使用Consent SDK征求用戶意見，以及在征得用戶意見后如何根據(jù)用戶意見獲取廣告。

Consent SDK使用

1.導(dǎo)入Consent SDK。

在項(xiàng)目級(jí)build.gradle文件中配置Maven倉地址：

buildscript {

  repositories {

    google()

    jcenter()

    maven { url https://developer.huawei.com/repo/ }

  }

  ...

}

allprojects {

  repositories {

    google()

    jcenter()

    maven { url https://developer.huawei.com/repo/ }

  }

}

在應(yīng)用級(jí)的build.gradle文件中添加編譯依賴：

將{version}替換為實(shí)際的版本號(hào)，版本號(hào)索引請(qǐng)參見版本更新說明，修改如下：

dependencies{

     implementationcom.huawei.hms:adsconsent:3.4.34.301

}

保存build.gradle文件，點(diǎn)擊“Sync Now”等待同步完成。

2.更新用戶意見狀態(tài)。

使用Consent SDK時(shí)，都應(yīng)確保Consent SDK獲得的是HUAWEI Ads廣告技術(shù)提供商的最新信息。如果在征求用戶意見后，廣告技術(shù)提供商的列表發(fā)生改變，則Consent SDK會(huì)自動(dòng)將用戶意見置為未知狀態(tài)。因此在每次啟動(dòng)應(yīng)用時(shí)都必須通過調(diào)用requestConsentUpdate()方法確定用戶的意見狀態(tài)。

示例代碼如下：

...

import com.huawei.hms.ads.consent.*;

...

public class ConsentActivity extends AppCompatActivity {

  ...

  @Override

  protected void onCreate(Bundle savedInstanceState) {

    ...

    // 檢查consent狀態(tài)

    checkConsentStatus();

    ...

  }

  ...

  private void checkConsentStatus() {

    ...

    Consent consentInfo = Consent.getInstance(this);

    ...

    consentInfo.requestConsentUpdate(new ConsentUpdateListener() {

      @Override

      public void onSuccess(ConsentStatus consentStatus, boolean isNeedConsent, ListAdProvider adProviders) {

        // 獲取用戶意見狀態(tài)成功

        ...

      }

      @Override

      public void onFail(String errorDescription) {

        // 獲取用戶意見狀態(tài)失敗

        ...

      }

    });

   ...

  }

  ...

}

如果成功更新用戶意見信息，那么會(huì)通過ConsentUpdateListener的onSuccess()方法提供更新后的用戶意見狀態(tài)參數(shù)consentStatus、是否需要Consent參數(shù)isNeedConsent和廣告技術(shù)提供商的adProviders列表。

ConsentStatus具有以下三種狀態(tài)：

·如果回調(diào)參數(shù)isNeedConsent取值為false，則表明可以向HUAWEI Ads SDK請(qǐng)求個(gè)性化廣告。

·如果回調(diào)參數(shù)isNeedConsent取值為true，表明該用戶在歐洲經(jīng)濟(jì)區(qū)內(nèi)或其他敏感地區(qū)內(nèi)，需要進(jìn)一步確認(rèn)用戶意見。

·當(dāng)返回的ConsentStatus為PERSONALIZED或NONPERSONALIZED，則表明已征求過用戶意見，不需要再次征求。

·當(dāng)返回的ConsentStatus為UNKNOWN，則需要通過彈框等方式征求用戶意見。

·如果ConsentUpdateListener返回onFail()時(shí)，則直接請(qǐng)求非個(gè)性化廣告。

AdProvider為廣告技術(shù)提供商信息，參數(shù)定義如下：

說明

requestConsentUpdate()方法每次會(huì)請(qǐng)求網(wǎng)絡(luò)以更新廣告技術(shù)提供商列表，為了保障用戶體驗(yàn)，媒體可以自行實(shí)現(xiàn)超時(shí)控制。

3.征求用戶意見。

您需要通過彈框等方式向用戶征求意見，并展示廣告技術(shù)提供商的完整列表。

以下是通過彈框征求用戶意見的樣例：

a.彈框征求用戶意見。

示例代碼如下：

...

import com.huawei.hms.ads.consent.*;

...

public class ConsentActivity extends AppCompatActivity {

  ...

  @Override

  protected void onCreate(Bundle savedInstanceState) {

    ...

    // 檢查consent狀態(tài)

    checkConsentStatus();

    ...

  }

  ...

  private void checkConsentStatus() {

    ...

    Consent consentInfo = Consent.getInstance(this);

    ...

    consentInfo.requestConsentUpdate(new ConsentUpdateListener() {

      @Override

      public void onSuccess(ConsentStatus consentStatus, boolean isNeedConsent, ListAdProvider adProviders) {

        ...

        // 此返回參數(shù)代表是否需要consent

        if (isNeedConsent) {

          // UNKNOWN狀態(tài)，需要重新收集用戶信息

          if (consentStatus == ConsentStatus.UNKNOWN) {

          ...

            showConsentDialog();

          }

          // 如果是PERSONALIZED或者NONPERSONALIZED狀態(tài)，則不需要彈框收集用戶意見

          else {

            ...

          }

        } else {

          ...

        }

      }

      @Override

      public void onFail(String errorDescription) {

       ...

      }

    });

    ...

  }

  ...

  private void showConsentDialog() {

    // 開始Consent彈出框處理

    ConsentDialog dialog = new ConsentDialog(this, mAdProviders);

    dialog.setCallback(this);

    dialog.setCanceledOnTouchOutside(false);

    dialog.show();

  }

}

對(duì)話框效果圖如下：

“here”后，頁面跳轉(zhuǎn)至更多信息頁面：

b.展示廣告技術(shù)提供商列表。

您需要將廣告技術(shù)提供商的名稱展示給用戶，并提供訪問廣告技術(shù)提供商隱私政策的入口。

通過點(diǎn)擊上述更多信息頁面中的here鏈接彈出廣告技術(shù)提供商列表對(duì)話框，效果如下：

c.設(shè)置用戶意見。

征得用戶意見后，請(qǐng)使用setConsentStatus()方法設(shè)置用戶的選擇。

Consent.getInstance(getApplicationContext()).setConsentStatus(ConsentStatus.PERSONALIZED);

說明

請(qǐng)務(wù)必讓用戶可以隨時(shí)更改或撤消意見，并將用戶更新后的意見設(shè)置給Consent SDK。

d.（可選）未達(dá)到法定承諾年齡的用戶。

如果您需要針對(duì)未達(dá)到法定承諾年齡的用戶請(qǐng)求對(duì)應(yīng)的廣告，則在調(diào)用requestConsentUpdate()前必須通過調(diào)用setUnderAgeOfPromise設(shè)置是否“未達(dá)到法定承諾年齡用戶”的標(biāo)記。

//設(shè)置“未達(dá)到法定承諾年齡用戶”的標(biāo)記

Consent.getInstance(getApplicationContext()).setUnderAgeOfPromise(true);

一旦將此設(shè)置為true，則每次requestConsentUpdate()請(qǐng)求均會(huì)回調(diào)onFail(String errorDescription)方法，并提供給用戶錯(cuò)誤描述參數(shù)errorDescription，此時(shí)不需要再展示征求用戶意見彈框。設(shè)置為false表明用戶已達(dá)到法定承諾年齡。

說明

當(dāng)Consent SDK設(shè)置了此標(biāo)記后，在請(qǐng)求廣告時(shí)，設(shè)置受眾人群中setTagForUnderAgeOfPromise的參數(shù)應(yīng)與Consent參數(shù)保持一致。

4.根據(jù)用戶意見獲取廣告。

請(qǐng)求廣告時(shí)，默認(rèn)不設(shè)置setNonPersonalizedAd方法，請(qǐng)求個(gè)性化廣告與非個(gè)性化廣告。如果用戶在Consent階段沒有做出選擇，則只能請(qǐng)求非個(gè)性化廣告。

如果設(shè)置setNonPersonalizedAd方法且值為：

·ALLOWALL：個(gè)性化廣告與非個(gè)性化廣告

·ALLOWNONPERSONALIZED：非個(gè)性化廣告

示例代碼如下：

//setNonPersonalizedAd設(shè)置為ALLOWNONPERSONALIZED時(shí)，只請(qǐng)求非個(gè)性化廣告

RequestOptions requestOptions=HwAds.getRequestOptions();

requestOptions=requestOptions.toBuilder().setNonPersonalizedAd(ALLOWNONPERSONALIZED).build();

HwAds.setRequestOptions(requestOptions);

AdParam adParam=new AdParam.Builder().build();

adView.loadAd(adParam);

Consent SDK測試

為了讓您能輕松地測試應(yīng)用，Consent SDK提供了可設(shè)置的調(diào)試選項(xiàng)。

1.調(diào)用getTestDeviceId()獲取設(shè)備ID。

String testDeviceId=Consent.getInstance(getApplicationContext()).getTestDeviceId();

2.使用獲取的設(shè)備ID將您的設(shè)備作為調(diào)試設(shè)備列入允許清單。

Consent.getInstance(getApplicationContext()).addTestDeviceId(testDeviceId);

3.調(diào)用setDebugNeedConsent設(shè)置是否需要Consent。

//設(shè)置調(diào)試需要Consent，此時(shí)ConsentUpdateListener方法返回的isNeedConsent參數(shù)為true

Consent.getInstance(getApplicationContext()).setDebugNeedConsent(DebugNeedConsent.DEBUGNEEDCONSENT);

//設(shè)置調(diào)試不需要Consent，此時(shí)ConsentUpdateListener方法返回的isNeedConsent參數(shù)為false

Consent.getInstance(getApplicationContext()).setDebugNeedConsent(DebugNeedConsent.DEBUGNOTNEEDCONSENT);

4.完成這些步驟后，調(diào)用更新用戶意見狀態(tài)時(shí)會(huì)根據(jù)您的調(diào)試狀態(tài)返回isNeedConsent的值。

說明

如果把設(shè)備設(shè)置為測試設(shè)備，那么會(huì)返回固定的測試廣告技術(shù)提供商列表，無法驗(yàn)證真實(shí)廣告技術(shù)提供商列表變化的場景。

特別聲明：以上文章內(nèi)容僅代表作者本人觀點(diǎn)，不代表ESG跨境電商觀點(diǎn)或立場。如有關(guān)于作品內(nèi)容、版權(quán)或其它問題請(qǐng)于作品發(fā)表后的30日內(nèi)與ESG跨境電商聯(lián)系。