Tujuan Traffic Toko

Tujuan traffic toko memungkinkan Anda untuk membuat kampanye iklan Facebook untuk meningkatkan kunjungan fisik ke toko dan mendongkrak penjualan di toko fisik Anda. Anda bisa memilih tujuan traffic toko untuk kampanye Anda jika memiliki bisnis dengan beberapa toko dan telah menambahkan lokasi toko Anda ke Facebook.

Pelajari selengkapnya tentang Tujuan Traffic Toko, Pusat Bantuan Iklan.

Penempatan

Tersedia untuk Facebook di desktop dan perangkat seluler (Kabar, Cerita, dan Marketplace) serta Instagram (Kabar dan Cerita).

Pengoptimalan Penayangan

• Pengoptimalan Jangkauan - Tersedia bagi semua pengiklan dengan akses ke API ini. Ini mengoptimalkan jangkauan unik harian dan menunjukkan "Impresi" sebagai metrik default dalam pelaporan Pengelola Iklan.

Membuat Iklan Katalog Advantage+

Persyaratan

• objective kampanye harus diatur ke STORE_VISITS.
• promoted_object kampanye harus diatur ke <PARENT_PAGE_ID> yang sesuai.
• promoted_object dan targeting set iklan harus berisi place_page_set_id dari <PAGE_SET_ID>
• optimization_goal set iklan harus diatur ke REACH
• billing_event set iklan seharusnya IMPRESSIONS

Langkah 1. Buat PageSet

Facebook menggunakan PageSet untuk menargetkan iklan dan menggunakannya sebagai objek yang dipromosikan dalam iklan Anda.

Untuk membuat PageSet:

1. Kumpulkan lokasi toko, yang merupakan halaman Facebook untuk setiap lokasi toko dan lokasi bisnis utama Anda. Bisnis utama Anda dikenal sebagai halaman utama.
2. Buat struktur JSON Lokasi untuk mewakili semua lokasi Anda.
3. Buat PageSet dengan stuktur JSON Lokasi.

Kumpulkan semua lokasi toko

<PARENT_PAGE_ID> adalah ID halaman untuk halaman utama bagi semua lokasi toko Anda. Ini mengambil semua halaman toko dan lokasi milik halaman utama dan menampilkan bujur dan lintang untuk setiap lokasi:

curl -X GET \
  -d 'fields="location{latitude,longitude},is_permanently_closed"' \
  -d 'limit=30000' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/{page-id}/locations

Contoh output

{
    "data": [
        {
            "location": {
                "latitude": 29.173384,
                "longitude": 48.098807
            },
            "is_permanently_closed": false,
            "id": "1788030244802584"
        },
        {
            "location": {
                "latitude": 29.303635,
                "longitude": 47.937725
            },
            "is_permanently_closed": false,
            "id": "261533444245300"
        },
        {
            "location": {
                "latitude": 29.302303,
                "longitude": 47.933178
            },
            "is_permanently_closed": false,
            "id": "179435399132774"
        },
        {
            "location": {
                "latitude": 29.302591,
                "longitude": 47.931801
            },
            "is_permanently_closed": false,
            "id": "1790317704582144"
        }
    ],
    "paging": {
        "cursors": {
            "before": "MTc4ODAzMDI0NDgwMjU4NAZDZD",
            "after": "MTA4MTU4NjU5NjA5MDA4"
        }
    }
}

Membuat struktur JSON Lokasi

Iterasi melalui setiap entri di hasil yang dikembalikan dan verifikasi setiap lokasi terbuka untuk bisnis dengan memeriksa kolom is_permanently_closed.

Dapatkan estimasi radius menggunakan dua permintaan GET untuk memperoleh parameter radius dan distance_unit. Atau, Anda dapat melakukan panggilan API batch untuk menghasilkan nilai di bawah ini.

Permintaan Individual

Anda harus membuat permintaan ini menggunakan lintang dan bujur setiap halaman toko dari hasil JSON yang ditampilkan dari halaman utama. Ini menampilkan perkiraan radius untuk setiap lokasi.

curl -X GET \
  -d 'type="adradiussuggestion"' \
  -d 'latitude=51.5152253' \
  -d 'longitude=-0.1423029' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/search/

Permintaan Batch

Anda juga dapat menggabungkan beberapa permintaan menjadi satu permintaan.

curl \
  -F "access_token=<ACCESS_TOKEN>" \
  -F "include_headers=false" \
  -F "batch=[
    {
      \"method\": \"GET\",
      \"relative_url\": \"/<API_VERSION>/search?type=adradiussuggestion&amp;latitude=29.173384&amp;longitude=48.098807\"
    },
    {
      \"method\": \"GET\",
      \"relative_url\": \"/<API_VERSION>/search?type=adradiussuggestion&amp;latitude=29.303635&amp;longitude=47.937725\"
    }
  ]" \
  "https://graph.facebook.com"

Struktur JSON Lokasi akhir

Gunakan parameter radius dan distance_unit yang diperoleh dari panggilan sebelumnya bersama dengan <CHILD_LOCATION_ID> setiap lokasi sebagai page_id untuk membuat struktur JSON Lokasi akhir.

[
    {
      "page_id": 1788030244802584,
      "radius": 1,
      "distance_unit": "mile"
    },
    {
      "page_id": 261533444245300,
      "radius": 1,
      "distance_unit": "mile"
    }
]

Buat Pageset dengan struktur JSON Lokasi

Anda sekarang dapat membuat PageSet dengan informasi di struktur JSON Lokasi Anda.

Permintaan Asinkron

Anda dapat membuat permintaan asinkron untuk membuat PageSet Anda. Ini memungkinkan Anda untuk membuat PageSets besar dengan lebih dari 1.000 lokasi tanpa mengalami waktu tunggu. Kami rekomendasikan Anda untuk menggunakan permintaan asinkron setiap kali Anda membuat Pageset dengan lebih dari 50 lokasi.

Permintaan

curl -X POST \
  -d 'name=test_2' \
  -d 'parent_page=ID_1' \
  -d 'pages=[{\'page_id':ID_2}]' \
  -d 'metadata={"audience":{"size":5000}}' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/ad_place_page_sets_async/

Catatan: Anda dapat menggunakan /ad_place_page_sets untuk permintaan sinkron; namun, Anda harus menggunakan permintaan asinkron untuk lebih dari 50 lokasi.

Format untuk parameter sama dengan yang Anda gunakan untuk permintaan sinkron.

Di dalam PageSet, Anda dapat menggunakan kolom metadata untuk menentukan radius tetap per lokasi untuk penayangan iklan Anda atau untuk menjangkau ukuran pemirsa tertentu. Jika Anda memilih yang terakhir, Facebook secara otomatis menghitung radius per lokasi untuk mencapai jumlah akun Pusat Akun tersebut.

Dalam contoh ini, opsi metadata diatur ke ukuran audience yang diinginkan (dideskripsikan di bawah). Lihat metadata untuk Radius. Ini memberikan ID ad_place_page_set_async_request.

{
  "id": "405738580111111"
}      

Kemudian, Anda dapat melakukan kueri ID itu dengan izin ads_read untuk mendapatkan ID PageSet.

curl -i -X GET \
 "https://graph.facebook.com/<API_VERSION>/405738580111111?access_token=ACCESS_TOKEN"

Tanggapan

{
  "id": "405738580111111", 
  "place_page_set": {
    "id": "555555791481678",
    "name": "test_2"
  },
  "progress": 1
}

Dengan ketentuan progress adalah dari 0.0 sampai 1, dan 1 berarti kami telah menyelesaikan permintaan Anda dan membuat PageSet.

Menggunakan metadata untuk radius

Kolom metadata memberi tahu Facebook bahwa Anda ingin menggunakan radius tetap untuk lokasi Anda atau Anda ingin Facebook secara otomatis menghitung radius per lokasi berdasarkan ukuran pemirsa tertentu.

Contoh

Untuk menentukan radius tetap menggunakan permintaan sinkron:

curl -X POST \
  -d 'name=test_2' \
  -d 'parent_page=238219010666666' \
  -d 'pages=[{\'page_id':405936056444444}]' \
  -d 'metadata={"fixed_radius":{"value":5,"distance_unit":"mile"}}' \
  -d 'access_token=ACCESS_TOKEN' \
  "https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/ad_place_page_sets/"

Ini berarti Anda ingin Facebook mengirimkan iklan Anda kepada orang-orang dalam radius 5 mil dari semua lokasi di PageSet Anda.

Tanggapan

 {
  "id": "1618547271777777"
}

Catatan: Kolom metadata harus diatur ke fixed_radius atau audience.

Jika Anda menggunakan fixed_radius, Anda juga perlu menyediakan distance_unit dan value:

{
  "fixed_radius": {
     "distance_unit": "<distance_unit>"
     "value": <distance>
  }
}

Jika Anda menggunakan audience, Anda perlu menyediakan size sementara max_radius bersifat opsional:

 {
  "audience": {
     "size": <audience size>
     "max_radius": { // optional
       "distance_unit": "<distance_unit>"
       "value": <distance>
     }
  }
}

Praktik Terbaik untuk metadata

• Anda juga harus menyediakan locations; namun, jangan tentukan radius di dalamnya. Atau, jika Anda menggunakan parameter locations dan menyediakan radius, Anda juga tidak harus menyediakannya untuk metadata.
• distance_unit haruslah mile atau kilometer, dan value harus antara 0.7 sampai 50 untuk mile atau 1 sampai 80 untuk kilometer.
• Parameter size di audience adalah jumlah akun Pusat Akun dalam radius asalkan radius tersebut adalah dari 1 sampai 80 kilometer panjangnya. Jika Anda menyediakan max_radius, dalam radius aktual, kami menghitung bervariasi antara 1 dan max_radius.
• Jika Anda menentukan audience untuk metadata, Anda harus membuat permintaan Anda dengan endpoint asinkron (ad_account_ID/ad_place_page_set_async).

Permintaan Sinkron

Anda masih dapat menggunakan permintaan sinkron untuk membuat PageSet.

curl -X POST \
  -d "name=My Grand Pageset" \
  -d "parent_page=<PARENT_PAGE_ID>" \
  -d "pages=<LOCATIONS_JSON_STRUCTURE>" \
  -d "access_token=<ACCESS_TOKEN>" \
 https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/ad_place_page_sets

Ini memberikan ID PageSet yang akan Anda gunakan nanti.

{
  "id": <PAGE_SET_ID>
}

Jika jumlah halaman terlalu besar untuk panggilan cURL, Anda dapat membuat file teks berisi struktur JSON Lokasi dan meneruskannya ke atribut pages dengan -F "pages=<locations_json_structure.txt".

Langkah 2: Buat Kampanye

Buat kampanye iklan dengan tujuan diatur ke STORE_VISITS dan ID halaman utama Anda sebagai objek yang dipromosikan.

Lihat Kampanye Iklan, Referensi.

Langkah 3: Buat Set Iklan

Buat set iklan yang akan berisi iklan Anda. Lihat Referensi, Set Iklan, Referensi, Spesifikasi penargetan dan Referensi, lokasi Halaman.

curl \
  -F 'name=Store Visits Ad Set' \
  -F 'promoted_object={"place_page_set_id":"<PAGE_SET_ID>"}' \
  -F 'optimization_goal=STORE_VISITS' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'is_autobid=true' \
  -F 'daily_budget=1000' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F "targeting={
    'place_page_set_ids': ['<PAGE_SET_ID>'],
    'device_platforms': ['mobile','desktop'],
    'facebook_positions': ['feed']
   }" \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/adsets

Penargetan Geografis

Anda juga dapat menargetkan dengan geo_locations di kampanye traffic toko.

Catatan: Untuk tujuan ini, Anda hanya dapat menggunakan geo_locationsatauplace_page_set_ids dalam penargetan set iklan.

Kami mendukung semua jenis penargetan geo_location di Penargetan dan Penempatan Lanjut, termasuk penargetan berdasarkan negara, kota, dan kode pos. Anda juga dapat memilih location_types, seperti recent, home, atau travel_in.

Anda harus masih menyediakan place_page_set_id di promoted_object. PageSet ini harus berupa set halaman tanpa set lokasi yang eksplisit. Lihat Membuat PageSet dengan struktur JSON Lokasi untuk membuat PageSet ini. Namun, dalam kasus ini, jangan berikan halaman parameter.

Pertama-tama, buatlah PageSet yang nanti Anda sediakan di objek yang dipromosikan:

curl -X POST \
  -d "name=My geo targeting page set" \
  -d "parent_page=<PARENT_PAGE_ID>" \
  -d "access_token=<ACCESS_TOKEN>" \
  https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/ad_place_page_sets/

Catatan: Anda tidak perlu menyediakan parameter pages seperti biasa.

Lalu, buat satu set iklan dengan tujuan traffic toko, yang menargetkan geo_locations:

curl \
  -F 'name=Store Traffic Ad Set' \
  -F 'promoted_object={"place_page_set_id":"<PAGE_SET_ID>"}' \
  -F 'optimization_goal=STORE_VISITS' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'is_autobid=true' \
  -F 'daily_budget=1000' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F "targeting={
    'geo_locations': {"countries":["US"],"location_types": ["home"]}, 
    'device_platforms': ['mobile','desktop'],
    'facebook_positions': ['feed']
  }" \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/adsets

Kami secara otomatis mengirimkan iklan untuk toko yang terdekat dengan orang yang melihat iklan Anda.

Langkah 4: Sediakan Materi Iklan

Anda dapat memasukkan materi iklan secara dinamis berdasarkan lokasi seseorang. Sesuaikan materi iklan Anda menggunakan set placeholder template, dan Facebook menggantikan placeholder di iklan Anda saat runtime dengan data dari lokasi halaman terdekat.

Placeholder yang tersedia:

• {{page.hours.today}}
• {{page.location.city}}
• {{page.location.region}}
• {{page.location.postcode}}
• {{page.location.street_address}}
• {{page.name}}
• {{page.phone_number}}

Kolom dynamic_ad_voice memungkinkan Anda mengontrol suara iklan Anda:

• Jika dynamic_ad_voice diatur ke DYNAMIC, nama halaman dan gambar profil dalam postingan iklan Anda berasal dari lokasi halaman terdekat.
• Jika dynamic_ad_voice diatur ke STORY_OWNER, nama halaman dan gambar profil dalam postingan iklan Anda berasal dari lokasi halaman utama.

Ajakan Bertindak

Anda juga dapat secara dinamis mengiklankan tombol ajakan bertindak (CTA) berdasarkan lokasi seseorang:

• Saat menggunakan GET_DIRECTIONS atau CALL_NOW, kolom value CTA tidak diperlukan. Pengguna secara otomatis akan diarahkan ke lokasi terdekat atau diminta untuk menghubungi nomor telepon lokasi terdekat.
• MESSAGE_PAGE hanya diizinkan jika dynamic_ad_voice diatur ke STORY_OWNER. Pesan akan dikirim ke halaman utama.
• Kolom opsional. Jika tidak ditentukan untuk iklan individual, kami menampilkan tombol Like Page.

Untuk detailnya, lihat Referensi, Materi Iklan

Contoh

Sediakan materi iklan menggunakan nama halaman dinamis dan kota:

curl \
  -F 'dynamic_ad_voice=DYNAMIC' \
  -F 'object_story_spec={ 
    "page_id": "<PARENT_PAGE_ID>", 
    "template_data": { 
      "description": "Ad Description", 
      "link": "<URL>", 
      "message": "Ad Message for {{page.location.city}}", 
      "name": "{{page.name}}", 
      "picture": "<IMAGE_URL>" 
    } 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/adcreatives

Materi iklan dengan kartu peta

Untuk menggunakan kartu peta, tambahkan struktur place_data dalam lampiran di kolom child_attachments untuk materi iklan Anda.

Dalam contoh ini, peta, dengan tautan pencari toko Facebook, adalah item kedua di array child_attachments. Anda harus menyediakan setidaknya satu item selain kartu peta.

curl \
  -F 'dynamic_ad_voice=DYNAMIC' \
  -F 'object_story_spec={ 
    "page_id": "<PARENT_PAGE_ID>", 
    "template_data": { 
      "description": "Ad Description", 
      "link": "<URL>", 
      "message": "Ad Message for {{page.location.city}}", 
      "name": "{{page.name}}", 
      "child_attachments":[
        {
          "description": "Come visit us!",
          "link": "http://yourweburl.com",
          "name": "{{page.location.street_address}} - {{page.location.city}}",
          "call_to_action": {
            "type":"GET_DIRECTIONS"
          },
        },
        {
          "link": "https://fb.com/store_locator",
          "name": "Check out our stores.",
          "place_data": {
            "type":"DYNAMIC"
          },
        }
      ]
    } 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/adcreatives

Pencari Lokasi Toko, Destinasi Tautan

Saat Anda membuat iklan, jika Anda mengatur link ke 'https://fb.com/store_locator', iklan muncul dengan pencari toko sebagai destinasi tautan.

Langkah 5: Buat Iklan

Buat iklan sebagai berikut:

curl \
  -F 'name=My Ad' \
  -F 'adset_id=<AD_SET_ID>' \
  -F 'creative={"creative_id":"<CREATIVE_ID>"}' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/ads

Untuk membuat iklan untuk traffic toko, halaman dan akun iklan Anda harus disetujui untuk pengukuran kunjungan toko. Jika tidak, kesalahan serupa Reach estimate isn't available because 'store_visits' isn't a valid action type akan ditampilkan.

Pengukuran Kunjungan Toko

Kunjungan toko adalah perkiraan metrik berdasarkan data dari pengguna yang mengaktifkan layanan lokasi. Ini pada akhirnya menawarkan pengukuran dan pengoptimalan kunjungan toko untuk tujuan traffic toko. Pengukuran kunjungan toko hanya tersedia untuk kampanye dengan tujuan traffic toko.

Kunjungan toko didasarkan pada klik dan tampilan pada iklan menggunakan tujuan traffic toko. Ini adalah estimasi jumlah kunjungan ke toko pengiklan oleh akun Pusat Akun yang telah melihat atau mengeklik iklan di setiap toko. Anda dapat mengonfigurasi periode atribusi; Anda dapat memilih untuk menyesuaikannya berdasarkan klik atau tampilan selama 1, 7, atau 28 hari. Atribusi default akun iklan berlaku kecuali Anda menyesuaikan konfigurasinya. Lihat Insights API, Jendela Atribusi.

Fitur terkait dengan pelaporan untuk item berikut:

• Kunjungan Toko — Estimasi jumlah kunjungan ke toko Anda yang diatribusikan ke iklan Anda.
• Biaya per Kunjungan Toko — Biaya rata-rata untuk setiap estimasi kunjungan ke toko Anda karena iklan Anda.

Dengan Pengelola Iklan

Lihat kolom di bawah ENGAGEMENT: ACTIONS. Kolom ini muncul di antarmuka pelaporan untuk kunjungan toko dan biaya per kunjungan toko.

Catatan: Data kunjungan toko hanya tersedia untuk toko yang dikonfirmasikan oleh tim Facebook sebagai dapat diukur untuk kampanye.

Dengan Insights API

Anda bisa mendapatkan data tentang kunjungan toko dari Insights API. Kami menyediakan kolom tambahan ini dalam panggilan insight umum: cost_per_store_visit_action dan store_visit_actions. Lihat Insight, Referensi.

Parameter