Google Analytics SDK สำหรับ Android v1 (เดิม)

ใน การอัปเกรด Universal Analytics เราขอแนะนำให้คุณใช้ไลบรารีเวอร์ชันใหม่กว่า ดูวิธีอัปเกรดเป็น Universal Analytics

สำคัญ: เอกสารนี้อธิบาย SDK เวอร์ชันเดิม ผู้ใช้ใหม่ควรใช้ SDK เวอร์ชันล่าสุด

SDK ของ Google Analytics สำหรับแอปบนอุปกรณ์เคลื่อนที่สำหรับ Android ช่วยให้คุณสามารถใช้ Google Analytics ในแอปพลิเคชันบน Android ได้อย่างง่ายดาย เอกสารนี้จะอธิบายวิธีผสานรวม SDK กับแอปของคุณ

ภาพรวมของ SDK

SDK นี้ใช้รูปแบบการระบุแหล่งที่มาที่ออกแบบมาเพื่อติดตามผู้ใช้ไปยังเว็บไซต์แบบดั้งเดิมและการโต้ตอบกับวิดเจ็ตในหน้าเว็บแบบดั้งเดิม ด้วยเหตุนี้ คำที่ใช้ด้านล่างนี้จึงสะท้อนรูปแบบการระบุการติดตามเว็บไซต์แบบดั้งเดิม และนำไปยังการติดตามแอปพลิเคชันบนอุปกรณ์เคลื่อนที่ คุณควรทำความคุ้นเคยกับการติดตาม Analytics เพื่อทำความเข้าใจวิธีการทำงานของ SDK นี้

ใช้ SDK การติดตามอุปกรณ์เคลื่อนที่เพื่อติดตามแอปพลิเคชันในโทรศัพท์ที่มีการโต้ตอบของ Analytics ประเภทต่อไปนี้

การติดตามการดูหน้าเว็บ

การดูหน้าเว็บเป็นวิธีมาตรฐานในการวัดปริมาณการเข้าชมเว็บไซต์แบบดั้งเดิม เนื่องจากแอปบนอุปกรณ์เคลื่อนที่ไม่มีหน้า HTML คุณจึงต้องตัดสินใจว่าจะเรียกใช้คำขอการดูหน้าเว็บเมื่อใด (และบ่อยแค่ไหน) นอกจากนี้ เนื่องจากคำขอการดูหน้าเว็บออกแบบมาเพื่อรายงานโครงสร้างไดเรกทอรี คุณจึงควรระบุชื่อที่สื่อความหมายสำหรับคำขอนั้นๆ เพื่อใช้ประโยชน์จากการตั้งชื่อเส้นทางหน้าเว็บในรายงานเนื้อหาใน Analytics ระบบจะป้อนข้อมูลชื่อที่คุณเลือกในรายงาน Analytics เป็นเส้นทางหน้าเว็บ แม้ว่าจริงๆ แล้วไม่ใช่หน้า HTML แต่คุณก็ใช้ชื่อนี้ให้เกิดประโยชน์ได้โดยจัดโครงสร้างเส้นทางเพื่อจัดกลุ่มการเรียกเพิ่มเติม

การติดตามเหตุการณ์

ใน Analytics เหตุการณ์ได้รับการออกแบบมาเพื่อติดตามการโต้ตอบของผู้ใช้ต่อองค์ประกอบหน้าเว็บอย่างแตกต่างจากคำขอการดูหน้าเว็บ คุณสามารถใช้ฟีเจอร์การติดตามเหตุการณ์ของ Google Analytics เพื่อทำการโทรเพิ่มเติม ซึ่งจะรายงานในส่วนการติดตามเหตุการณ์ของอินเทอร์เฟซรายงาน Analytics ได้ ระบบจะจัดกลุ่มเหตุการณ์โดยใช้หมวดหมู่ และอาจใช้ป้ายกำกับต่อเหตุการณ์ด้วย ซึ่งช่วยให้การรายงานมีความยืดหยุ่น เช่น แอปมัลติมีเดียอาจมีการกระทำเล่น/หยุด/หยุดชั่วคราวสำหรับหมวดหมู่วิดีโอและกำหนดป้ายกำกับสำหรับชื่อวิดีโอแต่ละชื่อ จากนั้นรายงาน Google Analytics จะรวบรวมเหตุการณ์สําหรับเหตุการณ์ทั้งหมดที่ติดแท็กด้วยหมวดหมู่วิดีโอ ดูข้อมูลเพิ่มเติมเกี่ยวกับการติดตามเหตุการณ์ได้ที่คู่มือการติดตามเหตุการณ์

การติดตามอีคอมเมิร์ซ

ใช้ฟีเจอร์การติดตามอีคอมเมิร์ซเพื่อติดตามธุรกรรมจากรถเข็นช็อปปิ้งและการซื้อในแอป หากต้องการติดตามธุรกรรม ให้ใช้คลาส Transaction ในการนำเสนอข้อมูลการซื้อโดยรวม และใช้คลาส Item เพื่อแสดงผลิตภัณฑ์แต่ละรายการในรถเข็นช็อปปิ้ง เมื่อรวบรวมแล้ว คุณสามารถดูข้อมูลได้ในส่วนการรายงานอีคอมเมิร์ซของอินเทอร์เฟซ Google Analytics สำหรับข้อมูลเพิ่มเติมเกี่ยวกับการติดตามอีคอมเมิร์ซ โปรดดูคู่มือการติดตามอีคอมเมิร์ซ

ตัวแปรที่กำหนดเอง

ตัวแปรที่กำหนดเองคือแท็กคู่ชื่อ-ค่าที่คุณแทรกในโค้ดติดตามเพื่อปรับแต่งการติดตามของ Google Analytics ได้ สำหรับข้อมูลเพิ่มเติมเกี่ยวกับวิธีใช้ตัวแปรที่กำหนดเอง โปรดอ่านคู่มือตัวแปรที่กำหนดเอง

เริ่มกระบวนการ

ข้อกำหนด

ในการผสานรวมความสามารถในการติดตามของ Google Analytics กับแอป Android คุณต้องมีสิ่งต่อไปนี้

• SDK สำหรับนักพัฒนาซอฟต์แวร์ Android (พร้อมใช้งานสำหรับ Windows, Mac OS X และ Linux)
• SDK ของ Google Analytics สำหรับแอปบนอุปกรณ์เคลื่อนที่

ตั้งค่า

• เพิ่ม libGoogleAnalytics.jar ลงในไดเรกทอรี /libs ของโปรเจ็กต์
• เพิ่มสิทธิ์ต่อไปนี้ลงในไฟล์ Manifest AndroidManifest.xml ของโปรเจ็กต์
  • <uses-permission android:name="android.permission.INTERNET" />
  • <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

แอปพลิเคชันตัวอย่างจะรวมอยู่ใน SDK ซึ่งแสดงให้เห็นว่าโปรเจ็กต์ควรมีลักษณะอย่างไรหากตั้งค่าสำเร็จ คุณใช้อีเมลนี้เป็นเทมเพลตสำหรับแอปที่ผสานรวม Analytics ของคุณเองได้

การใช้ SDK

ก่อนที่คุณจะเริ่มใช้ SDK คุณต้องสร้างบัญชีฟรีที่ www.google.com/analytics ก่อน แล้วสร้างเว็บพร็อพเพอร์ตี้ใหม่ในบัญชีนั้นโดยใช้ URL เว็บไซต์ปลอมแต่มีความหมาย (เช่น http://mymobileapp.mywebsite.com) เมื่อคุณสร้างพร็อพเพอร์ตี้ ให้จดหรือเก็บสำเนารหัสเว็บพร็อพเพอร์ตี้ที่สร้างขึ้นสำหรับพร็อพเพอร์ตี้ที่สร้างใหม่

รหัสเว็บพร็อพเพอร์ตี้เรียกอีกอย่างว่าหมายเลข UA ของโค้ดติดตาม และมีลักษณะคล้ายกับ UA-xxxxx-yy โดยที่ x และ y ระบุจำนวนที่ไม่ซ้ำกันสำหรับข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) ของคุณ คุณต้องระบุรหัสเว็บพร็อพเพอร์ตี้ที่คุณต้องการใช้เมื่อเริ่มต้นอ็อบเจกต์การติดตาม ดูข้อมูลเพิ่มเติมได้ที่เว็บพร็อพเพอร์ตี้

คุณต้องระบุให้ผู้ใช้ทราบในแอปพลิเคชันหรือในข้อกำหนดในการให้บริการของคุณว่าคุณมีสิทธิ์ในการติดตามและรายงานกิจกรรมของผู้ใช้ภายในแอปโดยไม่ระบุตัวตน การใช้ Google Analytics SDK ของคุณอยู่ภายใต้ข้อกำหนดในการให้บริการของ Google Analytics เพิ่มเติม ซึ่งคุณต้องยอมรับเมื่อลงชื่อสมัครใช้บัญชี

ตัวอย่างและแนวทางปฏิบัติแนะนำ

คุณดูโค้ดตัวอย่างและแนวทางปฏิบัติแนะนำได้ที่ code.google.com ภายใต้โปรเจ็กต์ analytics-api-sample

ไลบรารี EasyTracker

ไลบรารี EasyTracker พร้อมใช้งาน โดยมอบการติดตามระดับแอปพลิเคชันและกิจกรรม โดยแทบไม่ต้องใช้ความพยายามในการพัฒนา คุณดูรหัสนี้ได้ในส่วนดาวน์โหลดของโปรเจ็กต์ analytics-api-sample

การเริ่มต้นเครื่องมือติดตาม

รับ Singleton สำหรับการติดตามโดยโทรไปที่ GoogleAnalyticsTracker.getInstance() จากนั้นเรียกใช้เมธอด startNewSession โดยส่งรหัสพร็อพเพอร์ตี้เว็บและกิจกรรมที่ติดตามอยู่ คุณอาจเรียกใช้วิธีการนี้โดยตรงในเมธอด onCreate ของกิจกรรม หากแอปพลิเคชันของคุณมีกิจกรรมเพียงกิจกรรมเดียว เช่น

package com.google.android.apps.analytics.sample;

import com.google.android.apps.analytics.GoogleAnalyticsTracker;

import android.app.Activity;
import android.os.Bundle;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.Button;

public class TestActivity extends Activity {

  GoogleAnalyticsTracker tracker;

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    tracker = GoogleAnalyticsTracker.getInstance();

    // Start the tracker in manual dispatch mode...
    tracker.startNewSession("UA-YOUR-ACCOUNT-HERE", this);

    // ...alternatively, the tracker can be started with a dispatch interval (in seconds).
    //tracker.startNewSession("UA-YOUR-ACCOUNT-HERE", 20, this);

    setContentView(R.layout.main);
    Button createEventButton = (Button)findViewById(R.id.NewEventButton);
    createEventButton.setOnClickListener(new OnClickListener() {
      @Override
      public void onClick(View v) {
        tracker.trackEvent(
            "Clicks",  // Category
            "Button",  // Action
            "clicked", // Label
            77);       // Value
      }
    });

    Button createPageButton = (Button)findViewById(R.id.NewPageButton);
    createPageButton.setOnClickListener(new OnClickListener() {
      @Override
      public void onClick(View v) {
        // Add a Custom Variable to this pageview, with name of "Medium" and value "MobileApp" and
        // scope of session-level.
        tracker.setCustomVar(1, "Navigation Type", "Button click", 2);
        // Track a page view. This is probably the best way to track which parts of your application
        // are being used.
        // E.g.
        // tracker.trackPageView("/help"); to track someone looking at the help screen.
        // tracker.trackPageView("/level2"); to track someone reaching level 2 in a game.
        // tracker.trackPageView("/uploadScreen"); to track someone using an upload screen.
        tracker.trackPageView("/testApplicationHomeScreen");
      }
    });

    Button quitButton = (Button)findViewById(R.id.QuitButton);
    quitButton.setOnClickListener(new OnClickListener() {
      @Override
      public void onClick(View v) {
        finish();
      }
    });

    Button dispatchButton = (Button)findViewById(R.id.DispatchButton);
    dispatchButton.setOnClickListener(new OnClickListener() {
      @Override
      public void onClick(View v) {
        // Manually start a dispatch, not needed if the tracker was started with a dispatch
        // interval.
        tracker.dispatch();
      }
    });
  }

  @Override
  protected void onDestroy() {
    super.onDestroy();
    // Stop the tracker when it is no longer needed.
    tracker.stopSession();
  }
}

หากคุณมีกิจกรรมหลายรายการในแอปพลิเคชัน คุณสามารถใช้ไลบรารี EasyTracker ที่มีให้ในส่วนดาวน์โหลดของโปรเจ็กต์ analytics-api-sample

การติดตามการดูหน้าเว็บและเหตุการณ์

การติดตามการดูหน้าเว็บและเหตุการณ์นั้นทำได้ง่าย เพียงเรียกใช้ trackPageView ของออบเจ็กต์เครื่องมือติดตามทุกครั้งที่คุณต้องการเรียกการดูหน้าเว็บ โทร trackEvent เพื่อบันทึกกิจกรรม ดูข้อมูลเพิ่มเติมเกี่ยวกับการดูหน้าเว็บและเหตุการณ์ได้ที่ภาพรวม SDK ด้านบน

การใช้ตัวแปรที่กำหนดเอง

การเพิ่มตัวแปรที่กำหนดเองก็ทำได้ง่ายเช่นกัน เพียงใช้เมธอด setCustomVar ที่ SDK อุปกรณ์เคลื่อนที่ระบุ คุณจะต้องวางแผนล่วงหน้าว่าระบบจะจัดทำดัชนีตัวแปรที่กำหนดเองแต่ละรายการกับตัวแปรใด เพื่อไม่ให้เขียนทับตัวแปรเดิมที่มีอยู่ ดูข้อมูลเพิ่มเติมเกี่ยวกับตัวแปรที่กำหนดเองได้ที่คู่มือตัวแปรที่กำหนดเอง โปรดทราบว่าเมธอด setCustomVar ไม่ได้ส่งข้อมูลด้วยตัวเองโดยตรง แต่ระบบจะส่งข้อมูลพร้อมกับการดูหน้าเว็บหรือเหตุการณ์ที่ติดตามถัดไป คุณต้องเรียกใช้ setCustomVar ก่อนที่จะติดตามการดูหน้าเว็บหรือเหตุการณ์ โปรดทราบว่าขอบเขตเริ่มต้นของตัวแปรที่กำหนดเองคือขอบเขตระดับหน้า

การใช้การติดตามอีคอมเมิร์ซ

มี 4 วิธีที่คุณใช้เพื่อเปิดใช้การติดตามอีคอมเมิร์ซในแอปพลิเคชันของคุณ ได้แก่

• addTransaction
• addItem
• trackTransactions
• clearTransactions

การเรียก addTransaction และ addItem จะเพิ่มธุรกรรมหรือรายการลงในบัฟเฟอร์อีคอมเมิร์ซภายใน ซึ่งจะเพิ่มรายการและธุรกรรมอื่นๆ ได้ เฉพาะเวลาที่โทรหา trackTransactions ระบบจะส่งธุรกรรมและรายการต่างๆ ไปยังผู้มอบหมายงานและเข้าคิวเพื่อส่งไปยัง Google Analytics

หากต้องการล้างบัฟเฟอร์ ให้เรียกใช้เมธอด clearTransactions หมายเหตุ: จะไม่มีการเรียกคืนธุรกรรมใดๆ ที่เคยได้ส่งไปยังผู้มอบหมายงานก่อนหน้านี้ หรือการทำธุรกรรมใดๆ ที่ Google Analytics รวบรวมไว้แล้ว

โดยโค้ดตัวอย่างต่อไปนี้จะช่วยคุณเริ่มต้นใช้งานได้ เราจะถือว่ามีการเรียกเมธอด onPurchaseCompleted เมื่อการซื้อได้รับการยืนยันหรือถูกปฏิเสธ

  /**
   * The purchase was processed.  We will track the transaction and its associated line items
   * now, but only if the purchase has been confirmed.
   *
   * @param purchase A PurchaseObject containing all of the transaction information needed to
   *     send the ecommerce hit to Google Analytics.
   */
  public void onPurchaseCompleted(PurchaseObject purchase) {
    tracker.addTransaction(new Transaction.Builder(
        purchase.getTransactionId(),
        purchase.getTotal())
        .setStoreName(purchase.getStoreName())
        .setTotalTax(purchase.getTotalTax())
        .setShippingCost(purchase.getShippingCost())
        .build());
    for (PurchaseLineItem lineItem : purchase.getLineItems()) {
        tracker.addItem(new Item.Builder(
            purchase.getTransactionId(),
            lineItem.getItemSKU(),
            lineItem.getItemCost(),
            lineItem.getQuantity())
            .setItemName(lineItem.getItemName())
            .setItemCategory(lineItem.getItemCategory())
            .build());
    }
    if (purchase.isConfirmed()) {
      tracker.trackTransactions();
    } else {
      // The purchase was denied or failed in some way.  We need to clear out
      // any data we've already put in the Ecommerce buffer.
      tracker.clearTransactions();
    }
  }

สำหรับข้อมูลเพิ่มเติมเกี่ยวกับอีคอมเมิร์ซ โปรดดูคู่มือการติดตามอีคอมเมิร์ซ

ทำให้ IP ไม่ระบุตัวตน

หากต้องการปกปิดข้อมูล IP ของผู้ใช้ ให้ใช้เมธอด setAnonymizeIp การดำเนินการนี้จะทำให้ Google Analytics ลบข้อมูลระบุตัวบุคคลของข้อมูลที่ส่งมาจาก SDK โดยลบอ็อกเท็ตสุดท้ายของที่อยู่ IP ออกก่อนพื้นที่เก็บข้อมูล

คุณสามารถโทรหา setAnonymizeIp ได้ทุกเมื่อ

การตั้งค่าอัตราการสุ่มตัวอย่าง

คุณกำหนดอัตราการสุ่มตัวอย่างได้โดยใช้เมธอด setSampleRate หากแอปพลิเคชันของคุณสร้างการเข้าชม Analytics จำนวนมาก การตั้งค่าอัตราการสุ่มตัวอย่างอาจทำให้สร้างรายงานโดยใช้ข้อมูลตัวอย่างไม่ได้ การสุ่มตัวอย่างจะเกิดขึ้นอย่างสม่ำเสมอในผู้ใช้ที่ไม่ซ้ำ ดังนั้นเมื่อเปิดใช้อัตราการสุ่มตัวอย่างก็จะมีความสมบูรณ์ของแนวโน้มและการรายงาน เมธอด setSampleRate ยอมรับพารามิเตอร์ int 1 รายการ ค่าที่ถูกต้องสำหรับพารามิเตอร์นั้นคือจำนวนเต็มระหว่าง 0 ถึง 100

อัตรา 0 จะปิดการสร้าง Hit ขณะที่อัตรา 100 จะส่งข้อมูลทั้งหมดไปยัง Google Analytics คุณควรโทรหา setSampleRate ก่อนที่จะเรียกใช้วิธีการติดตามใดๆ

ดูข้อมูลเพิ่มเติมเกี่ยวกับการสุ่มตัวอย่างได้จากคู่มือแนวคิดการสุ่มตัวอย่าง

เกมรวมพล

เราขอแนะนำให้รวมคำขอติดตามเป็นกลุ่มๆ เพื่อประหยัดค่าใช้จ่ายในการเชื่อมต่อและแบตเตอรี่ คุณเรียกใช้ dispatch ในออบเจ็กต์การติดตามได้ทุกเมื่อที่ต้องการสร้างคำขอแบบกลุ่ม โดยจะดำเนินการด้วยตนเองหรือในช่วงเวลาที่กำหนดก็ได้

เคล็ดลับ: รวมชุดอุปกรณ์ติดตามเข้ากับคำขอ HTTP อื่นๆ ที่แอปพลิเคชันสร้างขึ้นเพื่อลดค่าใช้จ่าย

ปัญหาที่ทราบ

การเรียกใช้เมธอด GoogleAnalyticsTracker ในเทรดที่ต่างกันอาจทําให้เกิดข้อผิดพลาดที่คลุมเครือ โปรดตรวจสอบว่าได้ทำการโทรทั้งหมดจากชุดข้อความเดียวกัน

การติดตามแคมเปญ

SDK รองรับการติดตามแคมเปญ 2 ประเภท

- การติดตามแคมเปญของ Google Play - ช่วยให้คุณสามารถติดตามการอ้างอิงการติดตั้งผ่าน Google Play
- การติดตามแคมเปญทั่วไป – ช่วยให้คุณสามารถติดตามแคมเปญที่อ้างอิงผู้ใช้ไปยังแอปพลิเคชันของคุณ

หมายเหตุ: ในทั้งสองกรณี แคมเปญจะทำงานต่างออกไปจากการอ้างอิงระดับเซสชันตามปกติ แคมเปญดังกล่าวจะใช้ได้ตลอดอายุการใช้งานของแอปพลิเคชันนั้นๆ เว้นแต่ว่าจะมีการเขียนทับโดยแคมเปญในภายหลัง

การติดตามแคมเปญของ Google Play

ระบบปฏิบัติการ Android 1.6 รองรับการใช้พารามิเตอร์ของ URL referrer ในลิงก์ดาวน์โหลดไปยัง Google Play Google Analytics SDK สำหรับ Android ใช้พารามิเตอร์นี้เพื่อป้อนข้อมูลแคมเปญใน Google Analytics สำหรับแอปพลิเคชันของคุณโดยอัตโนมัติ ซึ่งจะทำให้แหล่งที่มาของการติดตั้งแอปพลิเคชันได้รับการบันทึกและเชื่อมโยงกับการดูหน้าเว็บและเหตุการณ์ในอนาคต ซึ่งจะเป็นประโยชน์ในการวัดประสิทธิภาพของโฆษณาที่เจาะจงสำหรับแอปของคุณ เป็นต้น

เพื่อให้การติดตามการอ้างอิงทำงานได้ คุณต้องเพิ่มข้อมูลโค้ดต่อไปนี้ลงในไฟล์ Manifest AndroidManifest.xml ของโปรเจ็กต์

<!-- Used for install referrer tracking -->
<receiver android:name="com.google.android.apps.analytics.AnalyticsReceiver" android:exported="true">
  <intent-filter>
    <action android:name="com.android.vending.INSTALL_REFERRER" />
  </intent-filter>
</receiver>

หมายเหตุ: ระบุ BroadcastReceiver ชั้นเรียนได้เพียง 1 คลาสต่อแอปพลิเคชันเท่านั้น หากต้องรวม BroadcastReceiver อย่างน้อย 2 รายจาก SDK ที่แตกต่างกัน คุณจะต้องสร้างคลาส BroadcastReceiver ของคุณเองซึ่งจะรับการออกอากาศทั้งหมดและเรียกใช้ BroadcastReceivers ที่เหมาะสมสำหรับการออกอากาศแต่ละประเภท

หมายเหตุ: การติดตามแคมเปญของ Google Play รองรับการติดแท็กอัตโนมัติ

หากต้องการตั้งค่าการติดตามแคมเปญ Google Analytics ผ่าน Google Play ให้ใช้เครื่องมือสร้าง URL ด้านล่างเพื่อสร้างลิงก์การอ้างอิง ใช้ลิงก์เพื่อแนะนำให้ผู้ใช้ไปยังแอปพลิเคชันของคุณ Analytics SDK จะแยกวิเคราะห์และบันทึกข้อมูลการอ้างอิงโดยอัตโนมัติ และป้อนข้อมูลลงในรายงาน Analytics ของคุณ

หากต้องการสร้างลิงก์สำหรับแนะนำบอกต่อ ให้ใช้เครื่องมือสร้าง URL ของแคมเปญ Google Play ต้องระบุชื่อแพ็กเกจ แหล่งที่มาของแคมเปญ สื่อของแคมเปญ และชื่อแคมเปญ ดูคำอธิบายโดยละเอียดของพารามิเตอร์แต่ละรายการได้ในตารางด้านล่าง

การติดตามแคมเปญทั่วไป

ด้วย Google Analytics SDK สำหรับ Android เวอร์ชัน 1.3 ตอนนี้คุณสามารถติดตามแคมเปญสำหรับแหล่งที่มาอื่นๆ นอกเหนือจาก Google Play ได้แล้ว ตัวอย่างเช่น หากต้องการทราบว่าแอปพลิเคชันเปิดขึ้นจากลิงก์ในโฆษณา ให้ตรวจสอบข้อมูลการอ้างอิงแคมเปญในเจตนาที่ทำให้แอปพลิเคชันของคุณเปิดตัว แล้วเก็บข้อมูลแคมเปญนั้นไว้ใน Google Analytics

หากต้องการตั้งค่าข้อมูลการอ้างอิงของแคมเปญ ให้ใช้เมธอด setReferrer ดังนี้

  tracker.setReferrer(referrer);

การใช้ฟีเจอร์นี้มีข้อจำกัด 2 ประการ คุณต้องโทรหา startNewSession ก่อนโทรติดต่อ setReferrer คุณต้องดําเนินการนี้เนื่องจากฐานข้อมูล SQLite ที่ Google Analytics ใช้ไม่ได้ตั้งค่าไว้ก่อนที่จะเรียกใช้ startNewSession และ setReferrer จำเป็นต้องใช้ฐานข้อมูลนั้น หากยังไม่ได้โทรหา startNewSession คุณจะได้รับ IllegalStateException

ข้อจำกัดที่ 2 คือสตริงการอ้างอิงที่ส่งผ่านไปยัง setReferrer ต้องเป็นไปตามรูปแบบที่เฉพาะเจาะจง โดยต้องอยู่ในรูปแบบของชุดพารามิเตอร์ของ URL และต้องประกอบด้วยพารามิเตอร์ gclid เป็นอย่างน้อย หรือแต่ละรายการ utm_campaign, utm_medium และ utm_source ซึ่งในกรณีหลังนี้ อาจมีพารามิเตอร์ utm_term และ utm_content ด้วยเช่นกัน

พารามิเตอร์ gclid เป็นส่วนหนึ่งของฟีเจอร์การติดแท็กอัตโนมัติที่ลิงก์ Google Analytics กับ Google Ads โดยอัตโนมัติ ตัวอย่างการอ้างอิงแคมเปญที่ใช้การติดแท็กอัตโนมัติอาจมีลักษณะดังนี้

referrer = “gclid=gclidValue”;

สตริงการอ้างอิงแคมเปญที่กำหนดเองอาจมีลักษณะดังนี้

referrer = “utm_campaign=campaign&utm_source=source&utm_medium=medium&utm_term=term&utm_content=content”;

หากคุณส่งผ่านสตริง URL ที่มาที่มีรูปแบบไม่ถูกต้องไปยัง setReferrer ข้อมูล URL ที่มาจะไม่เปลี่ยนแปลงและคุณจะได้รับค่า "เท็จ" ค่าที่เป็นจริงแสดงให้เห็นว่า URL ที่มาได้รับการอัปเดตแล้วและจะเพิ่มลงใน Hit ทุกรายการนับจากนี้เป็นต้นไป

โปรดทราบว่าเซสชันใหม่จะเริ่มต้นเมื่อคุณเรียกใช้ setReferrer และคืนค่าเป็น true

หมายเหตุ: การตั้งค่า URL ที่มาจะบันทึกเซสชันใหม่สำหรับ Hit ที่ตามมา ดูคำอธิบายโดยละเอียดของพารามิเตอร์แต่ละรายการได้ในตารางด้านล่าง

พารามิเตอร์ลิงก์การอ้างอิง

พารามิเตอร์	จำเป็น	คำอธิบาย	ตัวอย่าง
utm_campaign	ใช่	ชื่อแคมเปญ ใช้เพื่อวิเคราะห์คีย์เวิร์ดเพื่อระบุการโปรโมตผลิตภัณฑ์หรือแคมเปญเชิงกลยุทธ์ที่เฉพาะเจาะจง	utm_campaign=spring_sale
utm_source	ใช่	แหล่งที่มาของแคมเปญ ใช้เพื่อระบุเครื่องมือค้นหา จดหมายข่าว หรือแหล่งที่มาอื่นๆ	utm_source=google
utm_medium	ใช่	สื่อของแคมเปญ ใช้เพื่อระบุสื่อ เช่น อีเมลหรือต้นทุนต่อคลิก (CPC)	utm_medium=cpc
utm_term	ไม่ได้	คำของแคมเปญ ใช้กับการค้นหาที่เสียค่าใช้จ่ายเพื่อระบุคีย์เวิร์ดสำหรับโฆษณา	utm_term=running+shoes
utm_content	ไม่ได้	เนื้อหาแคมเปญ ใช้สำหรับการทดสอบ A/B และโฆษณาที่กำหนดเป้าหมายตามเนื้อหาเพื่อแยกความแตกต่างของโฆษณาหรือลิงก์ที่ชี้ไปยัง URL เดียวกัน	utm_content=logolink utm_content=textlink