ประเภทตัวแปรที่กำหนดโดยผู้ใช้สำหรับอุปกรณ์เคลื่อนที่

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

วิธีสร้างตัวแปรที่กำหนดโดยผู้ใช้ใหม่

1. ในการนำทางด้านซ้าย คลิกตัวแปร
2. ในส่วนตัวแปรที่กำหนดโดยผู้ใช้ คลิกใหม่
3. คลิกการกำหนดค่าตัวแปร และเลือกประเภทตัวแปรที่ต้องการ
4. เลือกตัวเลือกสำหรับประเภทตัวแปรที่เลือกให้เสร็จสมบูุรณ์
5. ตั้งชื่อตัวแปร ใช้รูปแบบการตั้งชื่อที่อธิบายถึงฟังก์ชันของตัวแปร เช่น "ตัวแปรชั้นข้อมูล - ชื่อผลิตภัณฑ์ "
6. คลิกบันทึก

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

• Firebase
  • ชื่อเหตุการณ์
  • พารามิเตอร์เหตุการณ์
  • พร็อพเพอร์ตี้ผู้ใช้ของ Firebase
• ยูทิลิตี
  • เปิดใช้การติดตามผู้ลงโฆษณา
  • ค่าคงที่
  • การตั้งค่า Google Analytics
  • ตารางตรวจสอบ
  • ตัวเลขสุ่ม
• ข้อมูลคอนเทนเนอร์
  • รหัสคอนเทนเนอร์
  • หมายเลขเวอร์ชันคอนเทนเนอร์
• แอปพลิเคชัน
  • รหัสแอป
  • ชื่อแอป
  • รหัสเวอร์ชันของแอป
  • รหัสสำหรับการโฆษณา
  • เวอร์ชัน SDK
• อุปกรณ์
  • ชื่ออุปกรณ์
  • ภาษา
  • เวอร์ชันของระบบปฏิบัติการ
  • แพลตฟอร์ม
  • ความละเอียดของหน้าจอ
• อื่นๆ
  • การเรียกฟังก์ชัน
  • ชุดค่า (เดิม)

Firebase

ชื่อเหตุการณ์

ค่านี้จะตั้งเป็น "eventNameXYZ" เมื่อมีการเรียกใช้โค้ดต่อไปนี้ในแอป

Android:
FirebaseAnalytics.getInstance(mContext).logEvent("eventNameXYZ", null);

iOS:
[FIRAnalytics logEventWithName:@"eventNameXYZ" parameters:parameters];

ในกรณีส่วนใหญ่ คุณควรใช้ตัวแปรบิวท์อินที่เทียบเท่า

พารามิเตอร์เหตุการณ์:

ค่านี้จะตั้งเป็นค่าพารามิเตอร์เหตุการณ์ของ Google Analytics (Firebase) สำหรับคีย์ที่ระบุ

พร็อพเพอร์ตี้ผู้ใช้ของ Firebase

ค่านี้จะตั้งเป็นค่าพร็อพเพอร์ตี้ผู้ใช้ของ Google Analytics (Firebase) สำหรับคีย์ที่ระบุ

ยูทิลิตี

เปิดใช้การติดตามผู้ลงโฆษณา

สำหรับ Android ตัวแปรนี้จะส่งคืนค่าเป็นจริง (true) ถ้ามีการเปิดใช้การติดตามโฆษณา และเป็นเท็จ (false) ถ้าผู้ใช้เลือกไม่รับโฆษณาตามความสนใจ ดูข้อมูลเพิ่มเติมในศูนย์นักพัฒนาซอฟต์แวร์สำหรับ Android SDK เวอร์ชันก่อนหน้า v4 จะส่งคืน false เสมอ สำหรับ iOS เวอร์ชัน 6 ขึ้นไป ค่านี้จะตั้งเป็นคุณสมบัติ advertisingTrackingEnabled หรือมิฉะนั้น จะตั้งเป็น true ในกรณีส่วนใหญ่ คุณควรใช้ตัวแปรบิวท์อินที่เทียบเท่า

ค่าคงที่

ค่านี้จะตั้งเป็นสตริงที่คุณระบุ

การตั้งค่า Google Analytics

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

ตารางตรวจสอบ

ค่านี้จะตั้งตามวิธีการในตารางตรวจสอบ ตารางตรวจสอบประกอบด้วย 2 คอลัมน์ (ตารางว่างเปล่าเพื่อแสดงวิธีการใช้ข้อมูลในภายหลัง)

เมื่อ [ตัวแปรที่เลือก] เท่ากับ	ตั้ง [ตัวแปรนี้] เป็น

ตารางตรวจสอบช่วยให้คุณสร้างตัวแปรที่มีค่าผันแปรไปตามค่าในตัวแปรอื่นได้ ซึ่งจะมีประโยชน์หากแอปได้รับการตั้งค่าให้จับคู่ค่าที่เหมาะสม (เช่น รหัสเครื่องมือวัด Conversion) กับรหัสเวอร์ชันของแอปหรือลักษณะอื่นของแอป ในตัวอย่างนี้ มีการสร้างตัวแปรชื่อรหัส Conversion ถ้ารหัสเวอร์ชันของแอปคือ 1.0 ค่าจะถูกตั้งเป็น “12345” ถ้ารหัสเวอร์ชันของแอปคือ 1.1 ค่าจะถูกตั้งเป็น “34567” ตารางตรวจสอบสามารถมีแถวได้ไม่จำกัดจำนวน โดยข้อมูลในช่องจะพิจารณาตัวพิมพ์เล็กและตัวพิมพ์ใหญ่

เมื่อ {{รหัสเวอร์ชันของแอป}} เท่ากับ	ตั้ง {{รหัส Conversion}} เป็น
1.0	12345
1.1	34567
1.2	56789

ตัวเลขสุ่ม

ค่านี้จะตั้งเป็นตัวเลขสุ่มที่อยู่ระหว่าง 0 ถึง 2147483647 ในกรณีส่วนใหญ่ คุณควรใช้ตัวแปรบิวท์อินที่เทียบเท่า

ข้อมูลคอนเทนเนอร์

รหัสคอนเทนเนอร์

ค่านี้คือรหัสสาธารณะของคอนเทนเนอร์ (เช่น GTM-ABC42) ในกรณีส่วนใหญ่ คุณควรใช้ตัวแปรบิวท์อินที่เทียบเท่า

หมายเลขเวอร์ชันคอนเทนเนอร์

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

แอปพลิเคชัน

รหัสแอป

ค่านี้ตั้งเป็นชื่อแพ็กเกจ (Android) หรือรหัสแอป (iOS) ในกรณีส่วนใหญ่ คุณควรใช้ตัวแปรบิวท์อินที่เทียบเท่า

ชื่อแอป

ค่านี้จะตั้งเป็นชื่อแอป ในกรณีส่วนใหญ่ คุณควรใช้ตัวแปรบิวท์อินที่เทียบเท่า

รหัสเวอร์ชันของแอป

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

รหัสสำหรับการโฆษณา

สำหรับ Android ค่านี้จะตั้งเป็นรหัสโฆษณา โดย SDK เวอร์ชันก่อน v4 จะส่งคืนค่าสตริงว่างเปล่าเสมอ สำหรับ iOS เวอร์ชัน 6 ขึ้นไป ค่านี้จะตั้งเป็นตัวระบุสำหรับการโฆษณา (IDFA) หรือมิฉะนั้น ค่านี้จะตั้งเป็นสตริงว่างเปล่า

เวอร์ชัน SDK

ค่านี้จะตั้งเป็นเวอร์ชัน SDK ของระบบปฏิบัติการที่ติดตั้งแอปพลิเคชัน ในกรณีส่วนใหญ่ คุณควรใช้ตัวแปรบิวท์อินที่เทียบเท่า

อุปกรณ์

ชื่ออุปกรณ์

ค่านี้จะตั้งเป็นชื่ออุปกรณ์ของแอปพลิเคชันที่ทำงานอยู่ในปัจจุบัน (เช่น "Samsung Android", "Pixel 2") ในกรณีส่วนใหญ่ คุณควรใช้ตัวแปรบิวท์อินที่เทียบเท่า

ภาษา

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

เวอร์ชันของระบบปฏิบัติการ

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

แพลตฟอร์ม

ค่านี้จะตั้งเป็นแพลตฟอร์มที่แอปพลิเคชันทำงานอยู่ในขณะนี้ (เช่น "Android", "iOS") ในกรณีส่วนใหญ่ คุณควรใช้ตัวแปรบิวท์อินที่เทียบเท่า

ความละเอียดของหน้าจอ

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

อื่นๆ

การเรียกฟังก์ชัน

ค่านี้จะตั้งเป็นค่าส่งคืนของการเรียกไปยังฟังก์ชันที่บันทึกไว้ล่วงหน้า หากต้องการดูข้อมูลเพิ่มเติม โปรดดูเอกสาร SDK Android หรือ iOS

ชุดค่า (คอนเทนเนอร์เดิมเท่านั้น)

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

{
  "max-fuel": 200,
  "starting-fuel": 100,
  "fuel-burn-rate": 20
}
แอปบนอุปกรณ์เคลื่อนที่ดึงค่าในตัวแปรได้ด้วยการระบุคีย์ เช่น

public class MainActivity {

  // เพิ่มรหัสสาธารณะของคอนเทนเนอร์
  private static final String CONTAINER_ID = "XXX-YYY";
  
  // คีย์ค่าของการกำหนดค่าคอนเทนเนอร์ ใช้ในภายหลัง
  // สำหรับการเรียกข้อมูลค่า
  private static final String MAX_FUEL_KEY = "max-fuel";
  private static final String INIT_FUEL_KEY = "init-fuel";
  private static final String FUEL_BURN_KEY = "fuel-burn-rate";

  // โค้ด onCreate ส่วนที่เหลือ
  }
}

/*
* วิธีการอัปเดตค่าของการกำหนดค่าเกมโดยใช้
* คอนเทนเนอร์ของ Google เครื่องจัดการแท็ก
*/
public void updateConfigurationFromContainer(Container container) {

  // รับข้อมูลอ้างอิงมาที่คอนเทนเนอร์
  Container container = mFutureContainer.get();

  // อัปเดตการตั้งค่าเกมโดยใช้คอนเทนเนอร์ 
  // คีย์ค่าของการกำหนดค่า
  maxFuel = mContainer.getDoubleValue(MAX_FUEL_KEY);
  startingFuel = mContainer.getDoubleValue(INIT_FUEL_KEY);
  burnRate = mContainer.getDoubleValue(FUEL_BURN_KEY);
}

ตัวแปรชุดค่ามีทริกเกอร์เชื่อมโยงอยู่ สำหรับการกำหนดค่าที่นำไปใช้กับทุกอินสแตนซ์และทุกเวอร์ชันของแอป ให้ตั้งค่าการเปิดใช้ทริกเกอร์เป็น "เสมอ" โปรดดูเอกสารสำหรับนักพัฒนาซอฟต์แวร์ (Android หรือ iOS) สำหรับรายละเอียดเกี่ยวกับวิธีใช้ตัวแปรชุดค่า