Notificar actividad de anuncios

Report player’s ad activity

Error codes

This operation may return the following PlayFab errors:

Error	Code
InvalidAdPlacementAndReward	1268

POST

Client

ReportAdActivity

Report Ad Activity

curl --request POST \
  --url https://{titleId}.playfabapi.com/Client/ReportAdActivity \
  --header 'Content-Type: application/json' \
  --header 'X-Authorization: <api-key>' \
  --data '
{
  "PlacementId": "A124572382B",
  "RewardId": "B2674981A",
  "Activity": "End"
}
'

import requests

url = "https://{titleId}.playfabapi.com/Client/ReportAdActivity"

payload = {
    "PlacementId": "A124572382B",
    "RewardId": "B2674981A",
    "Activity": "End"
}
headers = {
    "X-Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-Authorization': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({PlacementId: 'A124572382B', RewardId: 'B2674981A', Activity: 'End'})
};

fetch('https://{titleId}.playfabapi.com/Client/ReportAdActivity', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{titleId}.playfabapi.com/Client/ReportAdActivity",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'PlacementId' => 'A124572382B',
    'RewardId' => 'B2674981A',
    'Activity' => 'End'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://{titleId}.playfabapi.com/Client/ReportAdActivity"

	payload := strings.NewReader("{\n  \"PlacementId\": \"A124572382B\",\n  \"RewardId\": \"B2674981A\",\n  \"Activity\": \"End\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-Authorization", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://{titleId}.playfabapi.com/Client/ReportAdActivity")
  .header("X-Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"PlacementId\": \"A124572382B\",\n  \"RewardId\": \"B2674981A\",\n  \"Activity\": \"End\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://{titleId}.playfabapi.com/Client/ReportAdActivity")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"PlacementId\": \"A124572382B\",\n  \"RewardId\": \"B2674981A\",\n  \"Activity\": \"End\"\n}"

response = http.request(request)
puts response.read_body

{
  "code": 200,
  "status": "OK",
  "data": {}
}

{
  "code": 123,
  "errorCode": 123,
  "status": "<string>",
  "error": "<string>",
  "errorMessage": "<string>",
  "errorDetails": {}
}

Autorizaciones

X-Authorization

string

header

requerido

This API requires a client session ticket, available from any Client Login function.

Cuerpo

application/json

Report ad activity

Activity

enum<string>

requerido

Type of activity, may be Opened, Closed, Start or End

Opciones disponibles:

Opened,

Closed,

Start,

End

PlacementId

string

requerido

Unique ID of the placement to report for

RewardId

string

requerido

Unique ID of the reward the player was offered

CustomTags

object

The optional custom tags associated with the request (e.g. build number, external trace identifiers, etc.).

Respuesta

Report ad activity response has no body

code

integer

The Http status code. If X-ReportErrorAsSuccess header is set to true, this will report the actual http error code.

status

string

The Http status code as a string.

data

object

Report ad activity response has no body

Ejemplo:

{}

Última modificación el 6 de octubre de 2026

Temas relacionados

Recompensar actividad de anuncios Introducción a los anuncios con recompensa.Información general de la característica Multiplayer Activity (MPA)Configurar notificaciones de cambio de estadística en Partner Center Notificar artículo

⌘I

Report Ad Activity

curl --request POST \
  --url https://{titleId}.playfabapi.com/Client/ReportAdActivity \
  --header 'Content-Type: application/json' \
  --header 'X-Authorization: <api-key>' \
  --data '
{
  "PlacementId": "A124572382B",
  "RewardId": "B2674981A",
  "Activity": "End"
}
'

import requests

url = "https://{titleId}.playfabapi.com/Client/ReportAdActivity"

payload = {
    "PlacementId": "A124572382B",
    "RewardId": "B2674981A",
    "Activity": "End"
}
headers = {
    "X-Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-Authorization': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({PlacementId: 'A124572382B', RewardId: 'B2674981A', Activity: 'End'})
};

fetch('https://{titleId}.playfabapi.com/Client/ReportAdActivity', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{titleId}.playfabapi.com/Client/ReportAdActivity",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'PlacementId' => 'A124572382B',
    'RewardId' => 'B2674981A',
    'Activity' => 'End'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://{titleId}.playfabapi.com/Client/ReportAdActivity"

	payload := strings.NewReader("{\n  \"PlacementId\": \"A124572382B\",\n  \"RewardId\": \"B2674981A\",\n  \"Activity\": \"End\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-Authorization", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://{titleId}.playfabapi.com/Client/ReportAdActivity")
  .header("X-Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"PlacementId\": \"A124572382B\",\n  \"RewardId\": \"B2674981A\",\n  \"Activity\": \"End\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://{titleId}.playfabapi.com/Client/ReportAdActivity")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"PlacementId\": \"A124572382B\",\n  \"RewardId\": \"B2674981A\",\n  \"Activity\": \"End\"\n}"

response = http.request(request)
puts response.read_body

{
  "code": 200,
  "status": "OK",
  "data": {}
}

{
  "code": 123,
  "errorCode": 123,
  "status": "<string>",
  "error": "<string>",
  "errorMessage": "<string>",
  "errorDetails": {}
}

PlayFab API

PlayFab REST API References

Notificar actividad de anuncios

Error codes

Autorizaciones

Cuerpo

Respuesta