ตั้งค่าเส้นทางการแสดงโฆษณาของบุคคลที่หนึ่ง

ฟีเจอร์เส้นทางการแสดงโฆษณาของบุคคลที่หนึ่งช่วยให้คุณกู้คืนที่อยู่ IP ของผู้ใช้ที่ไม่ปกปิดได้โดยกำหนดเส้นทางคำขอผ่านเครือข่ายนำส่งข้อมูล (CDN) หรือโครงสร้างพื้นฐานเว็บไปยังเซิร์ฟเวอร์โฆษณา Google

ในคำขอของบุคคลที่สาม ฟีเจอร์ของเบราว์เซอร์และระบบปฏิบัติการ รวมถึงการกำหนดค่าเครือข่ายอาจปิดบังที่อยู่ IP การปกปิดนี้อาจส่งผลต่อรายได้จากโฆษณา การกำหนดเป้าหมายตามภูมิศาสตร์ และการตรวจจับการเข้าชมที่ไม่ถูกต้อง (IVT)

CDN ของคุณได้รับ IP ของไคลเอ็นต์ที่ไม่ปกปิดของผู้ใช้ในคำขอขาเข้าทั้งหมดที่ส่งไปยังโดเมนของคุณ ฟีเจอร์นี้มีประโยชน์ดังต่อไปนี้

  • ไม่มีการเปลี่ยนแปลงโค้ดฝั่งไคลเอ็นต์: คุณไม่ต้องแก้ไข JavaScript หรือส่งพารามิเตอร์ด้วยตนเอง แท็กผู้เผยแพร่โฆษณาผ่าน Google (GPT) จะอ่านเส้นทางที่กำหนดค่าไว้จากการตั้งค่า Google Ad Manager และเรียกใช้คำขอการกู้คืนแบบอะซิงโครนัส
  • ค่าใช้จ่ายในการดำเนินการน้อยลง: คำขอมีขนาดเล็ก แคชไว้ในเครื่องต่อเซสชันการดูหน้าเว็บ และทำงานแบบอะซิงโครนัสควบคู่ไปกับคำจำกัดความของช่องโฆษณา
  • เพย์โหลดที่เข้ารหัส: โดยค่าเริ่มต้น ฟีเจอร์นี้จะแสดงที่อยู่ IP ของผู้ใช้เป็นเพย์โหลดที่เข้ารหัส

หน้านี้ครอบคลุมการกำหนดค่าเส้นทางการแสดงโฆษณาของบุคคลที่หนึ่งไปยัง CDN ที่คุณต้องการ

ข้อกำหนดเบื้องต้น

ก่อนกำหนดค่า CDN ให้ทำดังนี้

  • ระบุเส้นทางการแสดงโฆษณาในบัญชี Ad Manager เช่น /adserver/ หากต้องการระบุเส้นทาง ให้ทำตามขั้นตอนในวิธีที่ 1: เส้นทางการแสดงโฆษณาของบุคคลที่หนึ่ง
    • ตรวจสอบว่าเส้นทางการแสดงโฆษณาไม่ซ้ำกัน และไม่มีการเข้าชมที่คุณส่งใช้เส้นทางนี้
  • มีหรือตั้งค่ารายการต่อไปนี้
    • โฮสต์หรือต้นทางเป้าหมาย: securepubads.g.doubleclick.net
    • เส้นทางเป้าหมาย: /pagead/fpm
    • โปรโตคอล: HTTPS ที่มีพอร์ตเริ่มต้น 443
    • ส่วนหัว: ตั้งค่าส่วนหัวเป็น Host: securepubads.g.doubleclick.net
    • การแคช: กำหนดค่า CDN ให้ข้ามการแคชสำหรับเส้นทาง เช่น ตั้งค่านโยบายแคชให้ข้ามแคชหรือส่วนหัว Cache-Control: no-store
  • หาก CDN ของคุณคือ Cloudflare คุณต้องมีระดับ Cloudflare Enterprise เพื่อสร้างกฎต้นทาง

กำหนดค่า CDN

กำหนดค่า CDN หรือพร็อกซีแบบย้อนกลับเพื่อส่งต่อคำขอที่ตรงกับเส้นทางที่กำหนดค่าไว้ไปยังเซิร์ฟเวอร์โฆษณา Google เลือก CDN ที่ต้องการ ดังนี้

Cloudflare

  1. สร้างกฎในแดชบอร์ดโดยใช้ค่าต่อไปนี้

    • นิพจน์ตัวกรองที่กำหนดเอง: เพิ่มข้อมูลต่อไปนี้
      • ช่อง: URI Path
      • โอเปอเรเตอร์: starts with
      • Value: เส้นทางของคุณ เช่น /adserver/
    • การลบล้างส่วนหัวของโฮสต์: เลือกเขียนใหม่เป็น แล้วเพิ่มโฮสต์เป้าหมาย securepubads.g.doubleclick.net
    • การลบล้าง DNS: เลือกลบล้างเป็น แล้วเพิ่มโฮสต์เป้าหมาย securepubads.g.doubleclick.net

  2. สร้างการเขียนกฎ URL ใหม่ในแดชบอร์ดโดยใช้ค่าต่อไปนี้

    • นิพจน์ตัวกรองที่กำหนดเอง: เพิ่มข้อมูลต่อไปนี้
      • ช่อง: URI Path
      • โอเปอเรเตอร์: starts with
      • Value: เส้นทางของคุณ เช่น /adserver/
    • เส้นทาง: เลือกเขียนใหม่เป็น > คงที่ > และเพิ่มเส้นทางเป้าหมาย /pagead/fpm
    • การค้นหา: เลือกเก็บรักษา

Amazon CloudFront

  1. ทำตามขั้นตอนในการตั้งค่าต้นทางโดยใช้ค่าต่อไปนี้

    • โดเมนต้นทาง: securepubads.g.doubleclick.net
    • โปรโตคอล: HTTPS

  2. ทำตามหัวข้อสร้างฟังก์ชันและเพิ่มตัวอย่างต่อไปนี้

    function handler(event) {
    var request = event.request;
    request.uri = '/pagead/fpm';
    return request;
}

    ตัวอย่างนี้จะรับเหตุการณ์คำขอขาเข้า กำหนด URI ให้กับเส้นทางเป้าหมาย และแสดงผลคำขอ

    คลิกบันทึกการเปลี่ยนแปลง ไปที่แท็บเผยแพร่ แล้วคลิกเผยแพร่ฟังก์ชัน

  3. ทำตามอัปเดตการกระจายในคอนโซลด้วยค่าต่อไปนี้

    • รูปแบบเส้นทาง: เส้นทางของคุณ เช่น /adserver/*
    • ต้นทางและกลุ่มต้นทาง: โฮสต์เป้าหมาย securepubads.g.doubleclick.net
    • นโยบายแคช: เลือก CachingDisabled
    • นโยบายคำขอต้นทาง: เลือก AllViewerExceptHostHeader
    • การเชื่อมโยงฟังก์ชัน:
      • คำขอของผู้ดู: เลือกฟังก์ชัน CloudFront แล้วเพิ่มชื่อฟังก์ชัน

Fastly

  1. ทำตามขั้นตอนการเพิ่มโฮสต์โดยใช้ค่าต่อไปนี้

    • โฮสต์เป้าหมาย securepubads.g.doubleclick.net
    • พอร์ต: พอร์ตเริ่มต้น 443
    • เปิดใช้ TLS ไหม: ใช่
      • ชื่อโฮสต์ของใบรับรอง: securepubads.g.doubleclick.net
        • เลือกจับคู่ชื่อโฮสต์ SNI กับชื่อใบรับรอง
      • ชื่อโฮสต์ SNI: securepubads.g.doubleclick.net
      • โฮสต์ที่ลบล้าง: securepubads.g.doubleclick.net

  2. ทำตามการสร้างข้อมูลโค้ด VCL โดยใช้ตัวอย่างต่อไปนี้

    if (req.url ~ "^PATH") {
    set req.backend = F_NAME;
    set req.http.Host = "securepubads.g.doubleclick.net";
    set req.url = regsub(req.url, "^PATH", "/pagead/fpm");
    return(pass);
}

    แทนที่ค่าต่อไปนี้

    • NAME: ชื่อโฮสต์ เช่น Google_GAM_FPM_Backend
    • PATH: เส้นทางของคุณ เช่น /adserver/

Google Cloud

  1. ทำตามขั้นตอนสร้าง NEG และปลายทางอินเทอร์เน็ตโดยใช้ค่าต่อไปนี้

    • ประเภทกลุ่มปลายทางเครือข่าย: เลือก NEG อินเทอร์เน็ต (ทั่วโลก)
    • พอร์ตเริ่มต้น: 443
    • ปลายทางเครือข่ายใหม่: เลือกชื่อโดเมนที่สมบูรณ์ในตัวเอง (FQDN) และพอร์ต
    • FQDN: เพิ่มโฮสต์เป้าหมาย securepubads.g.doubleclick.net

  2. สร้างบริการแบ็กเอนด์ส่วนกลางและกำหนดค่าส่วนหัวของคำขอที่กำหนดเองด้วยค่าต่อไปนี้

    • ประเภทแบ็กเอนด์: เลือกกลุ่มปลายทางเครือข่ายอินเทอร์เน็ต
    • โปรโตคอล: เลือก HTTPS
      • ชื่อส่วนหัว: Host
      • ค่าส่วนหัว: เพิ่มโฮสต์เป้าหมาย securepubads.g.doubleclick.net

  3. ทำตามขั้นตอนในหัวข้อกำหนดค่าการแมป URL

  4. ในกฎการกำหนดเส้นทาง ให้ค้นหากฎโฮสต์เวอร์ชันที่ใช้งานจริงที่ตรงกับโดเมนย่อยของคุณ

    อัปเดตตัวจับคู่เส้นทางด้วยการกำหนดค่า routeRules ดังนี้

    name: NAME
defaultService: projects/PROJECT_ID/global/backendServices/DEFAULT_BACKEND
routeRules:
  - priority: 1
    matchRules:
      - prefixMatch: PATH
    service: projects/PROJECT_ID/global/backendServices/BACKEND_NAME
    routeAction:
      urlRewrite:
        pathPrefixRewrite: /pagead/fpm

    แทนที่ค่าต่อไปนี้

    • BACKEND_NAME: ชื่อของบริการแบ็กเอนด์ที่คุณสร้างในขั้นตอนที่ 2 เช่น gam-fpm-backend-service
    • DEFAULT_BACKEND: บริการแบ็กเอนด์เริ่มต้นที่โฮสต์เว็บไซต์ของคุณ
      • หากโฮสต์เว็บไซต์ใน Cloud Storage ให้แทนที่ backendServices ด้วยพารามิเตอร์ backendBuckets ในเส้นทางทรัพยากรของช่อง defaultService
    • NAME: ชื่อของตัวจับคู่เส้นทาง เช่น gam-fpm-matcher
    • PATH: เส้นทางของคุณ เช่น /adserver/
    • PROJECT_ID: รหัสโปรเจ็กต์

ทดสอบการใช้งาน

หากต้องการยืนยันว่า CDN พร็อกซีคำขอและส่งที่อยู่ IP ให้เรียกใช้การทดสอบโดยใช้คำสั่ง curl ดังนี้

curl -i https://example.comPATH

แทนที่ PATH ด้วยเส้นทางของคุณ เช่น /adserver/

หากดำเนินการสำเร็จ คุณจะได้รับเอาต์พุตต่อไปนี้

  • สถานะ HTTP: 200 OK
  • เนื้อหาการตอบกลับ: เพย์โหลดจากเซิร์ฟเวอร์แบ็กเอนด์ของ Google ที่มีโทเค็น IP ที่เข้ารหัสโดยค่าเริ่มต้น

แก้ปัญหาการใช้งาน

ส่วนนี้จะอธิบายเวิร์กโฟลว์ในการแก้ปัญหาการติดตั้งใช้งานเส้นทางการแสดงโฆษณาของบุคคลที่หนึ่งใน CDN

ตารางต่อไปนี้แสดงรายละเอียดปัญหา สาเหตุ และวิธีแก้ปัญหาเพื่อแก้ปัญหา

ปัญหา สาเหตุ โซลูชัน
คุณได้รับสถานะ HTTP 404 หรือ 502 จาก CDN การเขียนเส้นทางใหม่ไม่ได้ทำงานอยู่หรือไม่มีส่วนหัว Host ยืนยันว่าการแมปการเขียนซ้ำไปยังเส้นทางเป้าหมาย /pagead/fpm และส่วนหัว Host ถูกลบล้างไปยังโฮสต์เป้าหมาย securepubads.g.doubleclick.net
ระบบจะไม่อัปเดตที่อยู่ IP ในคำขอโฆษณา เปิดใช้การแคชในพร็อกซี CDN แล้ว ตรวจสอบว่าคุณได้ตั้งค่านโยบายแคชในเส้นทางเป็นนโยบาย CachingDisabled หรือส่วนหัว Cache-Control: no-store ไคลเอ็นต์ทุกรายต้องเข้าถึงบริการแบ็กเอนด์เพื่อประเมินที่อยู่ IP ที่เฉพาะเจาะจงของตน
แฮนด์เชค SSL หรือ TLS ไม่สำเร็จ SNI ไม่ตรงกันในการเชื่อมต่อต้นทางของแบ็กเอนด์ ตรวจสอบว่าคุณได้กำหนดค่า CDN ให้ส่งโฮสต์เป้าหมาย securepubads.g.doubleclick.net ในส่วนขยาย TLS SNI แล้ว
ไม่มีพารามิเตอร์ ips ในคำขอโฆษณา เส้นทาง Ad Manager ไม่ตรงกับเส้นทาง CDN ตรวจสอบว่าเส้นทางที่ป้อนในหน้าการตั้งค่าส่วนกลางของ UI ของ Ad Manager ตรงกับเส้นทางที่กำหนดค่าไว้ใน CDN ดูรายละเอียดได้ที่ส่ง IP ที่ผู้เผยแพร่โฆษณาจัดหาให้แบบไม่ปกปิด (เบต้า)