แท็ก Universal Analytics

หากต้องการเปิดใช้การเปลี่ยนแปลงเวลาทำงานในการติดตั้ง Google Analytics ที่คุณไม่จำเป็นต้องสร้างและส่งไบนารีของแอปไปยังตลาดกลางอีกครั้ง ให้ใช้ Universal Analytics (UA) ในแอปด้วย Google Tag Manager (GTM)

คู่มือนี้จะแสดงวิธีใช้แท็ก Universal Analytics และ Google Tag Manager SDK สำหรับ Android เพื่อทำสิ่งต่อไปนี้

• ส่งการดูหน้าจอ
• ส่งกิจกรรม
• ส่งธุรกรรมอีคอมเมิร์ซ

ส่งการดูหน้าจอ

หากต้องการส่งการดูหน้าจอทุกครั้งที่หน้าจอใหม่เปิดขึ้นในแอปไปยัง Google Analytics ให้ทำดังนี้

1. สร้างตัวแปรชื่อหน้าจอ
2. สร้างทริกเกอร์เหตุการณ์หน้าจอเปิด
3. สร้างแท็กการดูหน้าจอของ Universal Analytics
4. พุชเหตุการณ์หน้าจอเปิดและชื่อหน้าจอไปยังชั้นข้อมูล

1. สร้างตัวแปรชื่อหน้าจอ

วิธีสร้างตัวแปรชื่อหน้าจอใน GTM

1. ลงชื่อเข้าใช้บัญชี Google Tag Manager
2. เลือกคอนเทนเนอร์บนอุปกรณ์เคลื่อนที่
3. ในแถบนำทางด้านซ้าย คลิกตัวแปร
4. ในส่วนตัวแปรที่กำหนดโดยผู้ใช้ ให้คลิกใหม่
5. คลิกตัวแปรที่ไม่มีชื่อเพื่อป้อนชื่อตัวแปรชื่อหน้าจอ
6. เลือกตัวแปรชั้นข้อมูลเป็นประเภทตัวแปร
7. ป้อน screenName เป็นชื่อตัวแปรชั้นข้อมูล และตั้งค่าเริ่มต้นเป็นหน้าจอที่ไม่รู้จัก

   ดูภาพหน้าจอของการสร้างตัวแปรชื่อหน้าจอ

   

8. คลิกสร้างตัวแปร

2. สร้างทริกเกอร์เหตุการณ์หน้าจอเปิด

วิธีสร้างทริกเกอร์ใน GTM เพื่อเริ่มการทำงานของแท็กการดูหน้าจอ Universal Analytics

1. ลงชื่อเข้าใช้บัญชี Google Tag Manager
2. เลือกคอนเทนเนอร์บนอุปกรณ์เคลื่อนที่
3. ที่แถบนำทางด้านซ้าย ให้คลิกทริกเกอร์
4. คลิกใหม่
5. คลิกทริกเกอร์ที่ไม่มีชื่อเพื่อป้อนชื่อทริกเกอร์ OpenScreenEvent
6. เลือกเหตุการณ์กําหนดเอง
7. ภายใต้เริ่มทำงานเมื่อ ให้ป้อนเงื่อนไขต่อไปนี้

   

8. คลิกสร้างทริกเกอร์

3. สร้างแท็กการดูหน้าจอของ Universal Analytics

วิธีสร้างแท็กการดูหน้าจอ Universal Analytics ที่เริ่มทำงานโดยเหตุการณ์หน้าจอเปิด

1. ลงชื่อเข้าใช้บัญชี Google Tag Manager
2. เลือกคอนเทนเนอร์บนอุปกรณ์เคลื่อนที่
3. คลิกแท็กในแถบนำทางด้านซ้าย
4. คลิกใหม่
5. คลิกแท็กที่ไม่มีชื่อเพื่อป้อนชื่อแท็ก Open Screen
6. เลือกผลิตภัณฑ์ Google Analytics
7. ป้อนรหัสติดตาม
8. เลือกมุมมองแอปเป็นประเภทการติดตาม
9. คลิกการตั้งค่าเพิ่มเติม
10. คลิกช่องที่จะต้องตั้งค่า
11. คลิก + เพิ่มช่องซ้ำๆ เพื่อเพิ่มช่องต่อไปนี้

    

12. คลิกต่อไป
13. ในส่วนเริ่มทำงานเมื่อ ให้คลิกกำหนดเอง
14. เลือกทริกเกอร์ที่กำหนดเอง OpenScreenEvent
15. คลิกบันทึก
16. คลิกสร้างแท็ก

4. พุชเหตุการณ์หน้าจอเปิดและชื่อหน้าจอ ไปยังชั้นข้อมูล

เพิ่มโค้ดลงในแอปเพื่อพุชเหตุการณ์ openScreen และค่า screenName ไปยังชั้นข้อมูล ตัวอย่างเช่น

import com.google.tagmanager.DataLayer;
import com.google.tagmanager.TagManager;

import android.app.Activity;
import android.os.Bundle;

public class MainActivity extends Activity {

  private static final String SCREEN_NAME = "Home Screen";
  private DataLayer mDataLayer;

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

  @Override
  public void onStart() {
    super.onStart();
    mDataLayer = TagManager.getInstance(this).getDataLayer();

    // Push an openScreen event and a screenName value to the data layer.
    // This call assumes the container has already been opened, otherwise events
    // pushed to the data layer will not fire tags in that container.
    mDataLayer.push(DataLayer.mapOf("event", "openScreen", "screenName", SCREEN_NAME));
  }
}

ส่งกิจกรรม

หากต้องการส่งเหตุการณ์ไปยัง Google Analytics เมื่อผู้ใช้โต้ตอบกับตัวควบคุม UI หรือเนื้อหาในแอป ให้ทำดังนี้

1. (ไม่บังคับ) สร้างตัวแปรเหตุการณ์
2. สร้างทริกเกอร์เหตุการณ์
3. สร้างแท็กเหตุการณ์ Universal Analytics
4. พุชเหตุการณ์และค่าตัวแปรเหตุการณ์ไปยังชั้นข้อมูล

ขั้นตอนต่อไปนี้แสดงวิธีส่งเหตุการณ์ไปยัง Google Analytics เมื่อผู้ใช้เริ่มเล่นวิดีโอ

1. (ไม่บังคับ) สร้างตัวแปรเหตุการณ์

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

วิธีสร้างตัวแปรชื่อวิดีโอใน GTM

1. ลงชื่อเข้าใช้บัญชี Google Tag Manager
2. เลือกคอนเทนเนอร์บนอุปกรณ์เคลื่อนที่
3. ในแถบนำทางด้านซ้าย คลิกตัวแปร
4. ในส่วนตัวแปรที่กำหนดโดยผู้ใช้ ให้คลิกใหม่
5. คลิกตัวแปรที่ไม่มีชื่อเพื่อป้อนชื่อตัวแปร ชื่อวิดีโอ
6. เลือกตัวแปรชั้นข้อมูลเป็นประเภทตัวแปร
7. ป้อน videoName เป็นชื่อตัวแปรชั้นข้อมูล และตั้งค่าเริ่มต้นเป็นวิดีโอที่ไม่รู้จัก

   ดูภาพหน้าจอของการสร้างตัวแปรชื่อวิดีโอ

   

8. คลิกสร้างตัวแปร

2. สร้างทริกเกอร์เหตุการณ์

วิธีสร้างทริกเกอร์เหตุการณ์ใน GTM เพื่อเริ่มการทำงานของแท็กเหตุการณ์ Universal Analytics

1. ลงชื่อเข้าใช้บัญชี Google Tag Manager
2. เลือกคอนเทนเนอร์บนอุปกรณ์เคลื่อนที่
3. ที่แถบนำทางด้านซ้าย ให้คลิกทริกเกอร์
4. คลิกใหม่
5. คลิกทริกเกอร์ที่ไม่มีชื่อเพื่อป้อนชื่อทริกเกอร์ VideoPlayEvent
6. เลือกเหตุการณ์กําหนดเอง
7. ภายใต้เริ่มทำงานเมื่อ ให้ป้อนเงื่อนไขต่อไปนี้

   

8. คลิกสร้างทริกเกอร์

3. สร้างแท็กเหตุการณ์ Universal Analytics

วิธีสร้างแท็กเหตุการณ์ Universal Analytics ที่เหตุการณ์การเล่นวิดีโอเริ่มทำงาน

1. ลงชื่อเข้าใช้บัญชี Google Tag Manager
2. เลือกคอนเทนเนอร์บนอุปกรณ์เคลื่อนที่
3. คลิกแท็กในแถบนำทางด้านซ้าย
4. คลิกใหม่
5. คลิกแท็กที่ไม่มีชื่อเพื่อป้อนชื่อแท็กเหตุการณ์การเล่นวิดีโอ
6. เลือกผลิตภัณฑ์ Google Analytics
7. ป้อนรหัสติดตาม
8. เลือกเหตุการณ์เป็นประเภทการติดตาม
9. ป้อนพารามิเตอร์การติดตามเหตุการณ์ต่อไปนี้

   

10. คลิกการตั้งค่าเพิ่มเติม
11. คลิกช่องที่จะต้องตั้งค่า
12. คลิก + เพิ่มช่องซ้ำๆ เพื่อเพิ่มช่องต่อไปนี้

    

13. คลิกต่อไป
14. ในส่วนเริ่มทำงานเมื่อ ให้คลิกกำหนดเอง
15. เลือกทริกเกอร์ที่กำหนดเอง VideoPlayEvent
16. คลิกบันทึก
17. คลิกสร้างแท็ก

4. พุชเหตุการณ์และค่าตัวแปรเหตุการณ์ ไปยังชั้นข้อมูล

เขียนโค้ดเพื่อพุชเหตุการณ์ videoPlay และค่า videoName ไปยังชั้นข้อมูล เช่น

import com.google.tagmanager.DataLayer;
import com.google.tagmanager.TagManager;

public class VideoPlayer {

  // Called when a user starts a video playback.
  public void onPlay(Video v) {
    DataLayer dataLayer = TagManager.getInstance(this).getDataLayer();

    // Push a videoPlay event and a videoName value to the data layer.
    // This call assumes the container has already been opened, otherwise events
    // pushed to the data layer will not fire tags in that container.
    dataLayer.push(DataLayer.mapOf("event", "videoPlay", "videoName", v.getName());
    play(v);
  }

  // Rest of the implementation.
  // ...
}

ส่งธุรกรรมอีคอมเมิร์ซ

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

1. สร้างทริกเกอร์ธุรกรรม
2. สร้างแท็กธุรกรรม Universal Analytics
3. พุชเหตุการณ์ธุรกรรม ธุรกรรม และรายการต่างๆ ไปยังชั้นข้อมูล

ดูรายการชื่อตัวแปรธุรกรรมและรายการที่รองรับได้ที่ตัวแปรชั้นข้อมูลอีคอมเมิร์ซที่รองรับ

1. สร้างทริกเกอร์ธุรกรรม

วิธีสร้างทริกเกอร์ธุรกรรมใน GTM เพื่อเริ่มการทำงานของแท็กธุรกรรม Universal Analytics

1. ลงชื่อเข้าใช้บัญชี Google Tag Manager
2. เลือกคอนเทนเนอร์บนอุปกรณ์เคลื่อนที่
3. ที่แถบนำทางด้านซ้าย ให้คลิกทริกเกอร์
4. คลิกใหม่
5. คลิกทริกเกอร์ที่ไม่มีชื่อเพื่อป้อนชื่อทริกเกอร์ Transactionเสร็จสิ้นแล้ว
6. เลือกเหตุการณ์กําหนดเอง
7. ภายใต้เริ่มทำงานเมื่อ ให้ป้อนเงื่อนไขต่อไปนี้

   

8. คลิกสร้างทริกเกอร์

2. สร้างแท็กธุรกรรม Universal Analytics

วิธีสร้างแท็กธุรกรรม Universal Analytics ที่เริ่มทำงานโดยเหตุการณ์ธุรกรรม

1. ลงชื่อเข้าใช้บัญชี Google Tag Manager
2. เลือกคอนเทนเนอร์บนอุปกรณ์เคลื่อนที่
3. คลิกแท็กในแถบนำทางด้านซ้าย
4. คลิกใหม่
5. คลิกแท็กที่ไม่มีชื่อเพื่อป้อนชื่อแท็กธุรกรรมเสร็จสมบูรณ์
6. เลือกผลิตภัณฑ์ Google Analytics
7. ป้อนรหัสติดตาม
8. เลือกธุรกรรมเป็นประเภทการติดตาม
9. คลิกการตั้งค่าเพิ่มเติม
10. คลิกช่องที่จะต้องตั้งค่า
11. คลิก + เพิ่มช่องซ้ำๆ เพื่อเพิ่มช่องต่อไปนี้

    

12. คลิกต่อไป
13. ในส่วนเริ่มทำงานเมื่อ ให้คลิกกำหนดเอง
14. เลือกทริกเกอร์ที่กำหนดเอง TransactionCompleted
15. คลิกบันทึก
16. คลิกสร้างแท็ก

3. พุชเหตุการณ์ธุรกรรม ธุรกรรม และรายการต่างๆ ไปยังชั้นข้อมูล

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

// Called when a user completes a transaction.
public void onPurchaseCompleted(Purchase p) {

  DataLayer dataLayer = TagManager.getInstance(this).getDataLayer();

  // Put maps of item data into an array to be pushed to the data layer.
  ArrayList<Map<String, String>> purchasedItems = new ArrayList<Map<String, String>>();
  for (Item i : p.items) {
    HashMap<String, String> currentItem = new HashMap<String, String>();

    currentItem.put("name", i.getProductName());
    currentItem.put("sku", i.getProductSku());
    currentItem.put("category", i.getProductCategory());
    currentItem.put("price", i.getProductPrice());
    currentItem.put("currency", "USD");
    currentItem.put("quantity", i.getProductQty());

    purchasedItems.add(currentItem);
  }

  // This call assumes the container has already been opened, otherwise events
  // pushed to the [DataLayer] data layer will not fire tags in that container.
  dataLayer.push(DataLayer.mapOf("event", "transaction",
                                 "transactionId", p.getTransId(),
                                 "transactionTotal", p.getTotal(),
                                 "transactionAffiliation", "In-app Store",
                                 "transactionTax", p.getTax(),
                                 "transactionShipping", p.getShippingCost(),
                                 "transactionCurrency", "USD",
                                 "transactionProducts", purchasedItems));

  // Because the data layer is persistent, you should reset fields to null
  // after you are done pushing the transaction.
  dataLayer.push(DataLayer.mapOf("transactionId", null,
                                 "transactionTotal", null,
                                 "transactionAffiliation", null,
                                 "transactionTax", null,
                                 "transactionShipping", null,
                                 "transactionCurrency", null,
                                 "transactionProducts", null));
}

ดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้ Google Tag Manager SDK สำหรับ Android เพื่อใช้ฟีเจอร์อีคอมเมิร์ซที่เพิ่มประสิทธิภาพของ Universal Analytics ได้ที่อีคอมเมิร์ซที่เพิ่มประสิทธิภาพ

ตัวแปรชั้นข้อมูลอีคอมเมิร์ซที่รองรับ

แท็กธุรกรรมสากลรองรับชื่อตัวแปรธุรกรรม และรายการดังต่อไปนี้

ข้อควรระวัง: เนื่องจากชั้นข้อมูลเป็นแบบถาวร ให้รีเซ็ตค่าธุรกรรมและตัวแปรรายการเป็น null หลังจากที่พุชธุรกรรมไปยังชั้นข้อมูลแล้ว

ตัวแปรธุรกรรม

ชื่อตัวแปร	คำอธิบาย	Type	จำเป็น
transactionId	รหัสระบุธุรกรรมที่ไม่ซ้ำกัน	สตริง	มี
transactionAffiliation	คู่ค้าหรือร้านค้า	สตริง	ไม่ได้
transactionTotal	มูลค่ารวมของธุรกรรม	สตริง	ไม่ได้
transactionTax	จำนวนภาษีสำหรับธุรกรรม	สตริง	ไม่ได้
transactionShipping	ค่าจัดส่งสำหรับธุรกรรม	สตริง	ไม่ได้
transactionCurrency	สกุลเงินของธุรกรรม	สตริง	ไม่ได้
transactionProducts	รายการสินค้าที่ซื้อในธุรกรรม	อาร์เรย์ที่มีตัวแปร item	ไม่ได้

ตัวแปรของรายการ

ชื่อตัวแปร	คำอธิบาย	Type	จำเป็น
name	ชื่อผลิตภัณฑ์	สตริง	มี
sku	SKU ของผลิตภัณฑ์	สตริง	ไม่ได้
category	หมวดหมู่ผลิตภัณฑ์	สตริง	ไม่ได้
price	ราคาผลิตภัณฑ์	สตริง	ไม่ได้
currency	ประเภทสกุลเงินของ price	สตริง	ไม่ได้
quantity	จำนวนสินค้า	สตริง	ไม่ได้

การติดตั้งการระบุแหล่งที่มาของการอ้างอิง

หากคุณลงทะเบียนบริการและรีซีฟเวอร์ต่อไปนี้ในไฟล์ AndroidManifest.xml ข้อมูลผู้อ้างอิงการติดตั้งที่มีอยู่จะรวมอยู่ใน Hit ของ Google Analytics หรือคำขอพิกเซลรีมาร์เก็ตติ้งของ AdWords โดยอัตโนมัติ

<service android:name="com.google.tagmanager.InstallReferrerService" />
<receiver android:name="com.google.tagmanager.InstallReferrerReceiver" android:exported="true">
  <intent-filter>
    <action android:name="com.android.vending.INSTALL_REFERRER" />
  </intent-filter>
</receiver>

หมายเหตุ: คุณควรลงทะเบียนตัวรับ URL ที่มาของการติดตั้งแทน CampaignTrackingReceiver ของ Google Analytics